docs: document deprecated aliases
This commit is contained in:
		
							parent
							
								
									8327a7a8fa
								
							
						
					
					
						commit
						0cd863197b
					
				
					 1 changed files with 170 additions and 23 deletions
				
			
		|  | @ -135,7 +135,6 @@ false</literal>.</para> | |||
| 
 | ||||
|   </varlistentry> | ||||
| 
 | ||||
| 
 | ||||
|   <varlistentry xml:id="conf-builders"> | ||||
|     <term><literal>builders</literal></term> | ||||
|     <listitem> | ||||
|  | @ -159,7 +158,6 @@ false</literal>.</para> | |||
| 
 | ||||
|   </varlistentry> | ||||
| 
 | ||||
| 
 | ||||
|   <varlistentry xml:id="conf-build-users-group"><term><literal>build-users-group</literal></term> | ||||
| 
 | ||||
|     <listitem><para>This options specifies the Unix group containing | ||||
|  | @ -210,7 +208,6 @@ false</literal>.</para> | |||
| 
 | ||||
|   </varlistentry> | ||||
| 
 | ||||
| 
 | ||||
|   <varlistentry xml:id="conf-connect-timeout"><term><literal>connect-timeout</literal></term> | ||||
| 
 | ||||
|     <listitem> | ||||
|  | @ -243,7 +240,6 @@ false</literal>.</para> | |||
| 
 | ||||
|   </varlistentry> | ||||
| 
 | ||||
| 
 | ||||
|   <varlistentry xml:id="conf-extra-sandbox-paths"> | ||||
|     <term><literal>extra-sandbox-paths</literal></term> | ||||
| 
 | ||||
|  | @ -283,7 +279,6 @@ false</literal>.</para> | |||
| 
 | ||||
|   </varlistentry> | ||||
| 
 | ||||
| 
 | ||||
|   <varlistentry xml:id="conf-fallback"><term><literal>fallback</literal></term> | ||||
| 
 | ||||
|     <listitem><para>If set to <literal>true</literal>, Nix will fall | ||||
|  | @ -293,7 +288,6 @@ false</literal>.</para> | |||
| 
 | ||||
|   </varlistentry> | ||||
| 
 | ||||
| 
 | ||||
|   <varlistentry xml:id="conf-fsync-metadata"><term><literal>fsync-metadata</literal></term> | ||||
| 
 | ||||
|     <listitem><para>If set to <literal>true</literal>, changes to the | ||||
|  | @ -304,7 +298,6 @@ false</literal>.</para> | |||
| 
 | ||||
|   </varlistentry> | ||||
| 
 | ||||
| 
 | ||||
|   <varlistentry xml:id="conf-hashed-mirrors"><term><literal>hashed-mirrors</literal></term> | ||||
| 
 | ||||
|     <listitem><para>A list of web servers used by | ||||
|  | @ -367,10 +360,8 @@ builtins.fetchurl { | |||
|     options a store path was built), so by default this option is on. | ||||
|     Turn it off to save a bit of disk space (or a lot if | ||||
|     <literal>keep-outputs</literal> is also turned on).</para></listitem> | ||||
| 
 | ||||
|   </varlistentry> | ||||
| 
 | ||||
| 
 | ||||
|   <varlistentry xml:id="conf-keep-env-derivations"><term><literal>keep-env-derivations</literal></term> | ||||
| 
 | ||||
|     <listitem><para>If <literal>false</literal> (default), derivations | ||||
|  | @ -394,7 +385,6 @@ builtins.fetchurl { | |||
| 
 | ||||
|   </varlistentry> | ||||
| 
 | ||||
| 
 | ||||
|   <varlistentry xml:id="conf-keep-outputs"><term><literal>keep-outputs</literal></term> | ||||
| 
 | ||||
|     <listitem><para>If <literal>true</literal>, the garbage collector | ||||
|  | @ -408,10 +398,8 @@ builtins.fetchurl { | |||
|     only at build time (e.g., the C compiler, or source tarballs | ||||
|     downloaded from the network).  To prevent it from doing so, set | ||||
|     this option to <literal>true</literal>.</para></listitem> | ||||
| 
 | ||||
|   </varlistentry> | ||||
| 
 | ||||
| 
 | ||||
|   <varlistentry xml:id="conf-max-build-log-size"><term><literal>max-build-log-size</literal></term> | ||||
| 
 | ||||
|     <listitem> | ||||
|  | @ -444,10 +432,8 @@ builtins.fetchurl { | |||
|     overridden using the <option | ||||
|     linkend='opt-max-jobs'>--max-jobs</option> (<option>-j</option>) | ||||
|     command line switch.</para></listitem> | ||||
| 
 | ||||
|   </varlistentry> | ||||
| 
 | ||||
| 
 | ||||
|   <varlistentry xml:id="conf-max-silent-time"><term><literal>max-silent-time</literal></term> | ||||
| 
 | ||||
|     <listitem> | ||||
|  | @ -603,7 +589,6 @@ password <replaceable>my-password</replaceable> | |||
| 
 | ||||
|   </varlistentry> | ||||
| 
 | ||||
| 
 | ||||
|   <varlistentry xml:id="conf-repeat"><term><literal>repeat</literal></term> | ||||
| 
 | ||||
|     <listitem><para>How many times to repeat builds to check whether | ||||
|  | @ -615,7 +600,6 @@ password <replaceable>my-password</replaceable> | |||
| 
 | ||||
|   </varlistentry> | ||||
| 
 | ||||
| 
 | ||||
|   <varlistentry xml:id="conf-require-sigs"><term><literal>require-sigs</literal></term> | ||||
| 
 | ||||
|     <listitem><para>If set to <literal>true</literal> (the default), | ||||
|  | @ -679,7 +663,6 @@ password <replaceable>my-password</replaceable> | |||
| 
 | ||||
|   </varlistentry> | ||||
| 
 | ||||
| 
 | ||||
|   <varlistentry xml:id="conf-sandbox-dev-shm-size"><term><literal>sandbox-dev-shm-size</literal></term> | ||||
| 
 | ||||
|     <listitem><para>This option determines the maximum size of the | ||||
|  | @ -745,7 +728,6 @@ password <replaceable>my-password</replaceable> | |||
| 
 | ||||
|   </varlistentry> | ||||
| 
 | ||||
| 
 | ||||
|   <varlistentry xml:id="conf-substituters"><term><literal>substituters</literal></term> | ||||
| 
 | ||||
|     <listitem><para>A list of URLs of substituters, separated by | ||||
|  | @ -754,7 +736,6 @@ password <replaceable>my-password</replaceable> | |||
| 
 | ||||
|   </varlistentry> | ||||
| 
 | ||||
| 
 | ||||
|   <varlistentry xml:id="conf-system"><term><literal>system</literal></term> | ||||
| 
 | ||||
|     <listitem><para>This option specifies the canonical Nix system | ||||
|  | @ -795,7 +776,6 @@ password <replaceable>my-password</replaceable> | |||
| 
 | ||||
|   </varlistentry> | ||||
| 
 | ||||
| 
 | ||||
|   <varlistentry xml:id="conf-trusted-public-keys"><term><literal>trusted-public-keys</literal></term> | ||||
| 
 | ||||
|     <listitem><para>A whitespace-separated list of public keys. When | ||||
|  | @ -806,7 +786,6 @@ password <replaceable>my-password</replaceable> | |||
| 
 | ||||
|   </varlistentry> | ||||
| 
 | ||||
| 
 | ||||
|   <varlistentry xml:id="conf-trusted-substituters"><term><literal>trusted-substituters</literal></term> | ||||
| 
 | ||||
|     <listitem><para>A list of URLs of substituters, separated by | ||||
|  | @ -819,7 +798,6 @@ password <replaceable>my-password</replaceable> | |||
| 
 | ||||
|   </varlistentry> | ||||
| 
 | ||||
| 
 | ||||
|   <varlistentry xml:id="conf-trusted-users"><term><literal>trusted-users</literal></term> | ||||
| 
 | ||||
|     <listitem> | ||||
|  | @ -845,9 +823,178 @@ password <replaceable>my-password</replaceable> | |||
|   </varlistentry> | ||||
| 
 | ||||
| </variablelist> | ||||
| 
 | ||||
| </para> | ||||
| 
 | ||||
| <refsection> | ||||
|   <title>Deprecated Settings</title> | ||||
| 
 | ||||
| <para> | ||||
| 
 | ||||
| <variablelist> | ||||
| 
 | ||||
|   <varlistentry xml:id="conf-binary-caches"> | ||||
|     <term><literal>binary-caches</literal></term> | ||||
| 
 | ||||
|     <listitem><para><emphasis>Deprecated:</emphasis> | ||||
|     <literal>binary-caches</literal> is now an alias to | ||||
|     <xref linkend="conf-substituters" />.</para></listitem> | ||||
|   </varlistentry> | ||||
| 
 | ||||
|   <varlistentry xml:id="conf-binary-cache-public-keys"> | ||||
|     <term><literal>binary-cache-public-keys</literal></term> | ||||
| 
 | ||||
|     <listitem><para><emphasis>Deprecated:</emphasis> | ||||
|     <literal>binary-cache-public-keys</literal> is now an alias to | ||||
|     <xref linkend="conf-trusted-public-keys" />.</para></listitem> | ||||
|   </varlistentry> | ||||
| 
 | ||||
|   <varlistentry xml:id="conf-build-compress-log"> | ||||
|     <term><literal>build-compress-log</literal></term> | ||||
| 
 | ||||
|     <listitem><para><emphasis>Deprecated:</emphasis> | ||||
|     <literal>build-compress-log</literal> is now an alias to | ||||
|     <xref linkend="conf-compress-build-log" />.</para></listitem> | ||||
|   </varlistentry> | ||||
| 
 | ||||
|   <varlistentry xml:id="conf-build-cores"> | ||||
|     <term><literal>build-cores</literal></term> | ||||
| 
 | ||||
|     <listitem><para><emphasis>Deprecated:</emphasis> | ||||
|     <literal>build-cores</literal> is now an alias to | ||||
|     <xref linkend="conf-cores" />.</para></listitem> | ||||
|   </varlistentry> | ||||
| 
 | ||||
|   <varlistentry xml:id="conf-build-extra-chroot-dirs"> | ||||
|     <term><literal>build-extra-chroot-dirs</literal></term> | ||||
| 
 | ||||
|     <listitem><para><emphasis>Deprecated:</emphasis> | ||||
|     <literal>build-extra-chroot-dirs</literal> is now an alias to | ||||
|     <xref linkend="conf-extra-sandbox-paths" />.</para></listitem> | ||||
|   </varlistentry> | ||||
| 
 | ||||
|   <varlistentry xml:id="conf-build-extra-sandbox-paths"> | ||||
|     <term><literal>build-extra-sandbox-paths</literal></term> | ||||
| 
 | ||||
|     <listitem><para><emphasis>Deprecated:</emphasis> | ||||
|     <literal>build-extra-sandbox-paths</literal> is now an alias to | ||||
|     <xref linkend="conf-extra-sandbox-paths" />.</para></listitem> | ||||
|   </varlistentry> | ||||
| 
 | ||||
|   <varlistentry xml:id="conf-build-fallback"> | ||||
|     <term><literal>build-fallback</literal></term> | ||||
| 
 | ||||
|     <listitem><para><emphasis>Deprecated:</emphasis> | ||||
|     <literal>build-fallback</literal> is now an alias to | ||||
|     <xref linkend="conf-fallback" />.</para></listitem> | ||||
|   </varlistentry> | ||||
| 
 | ||||
|   <varlistentry xml:id="conf-build-max-jobs"> | ||||
|     <term><literal>build-max-jobs</literal></term> | ||||
| 
 | ||||
|     <listitem><para><emphasis>Deprecated:</emphasis> | ||||
|     <literal>build-max-jobs</literal> is now an alias to | ||||
|     <xref linkend="conf-max-jobs" />.</para></listitem> | ||||
|   </varlistentry> | ||||
| 
 | ||||
|   <varlistentry xml:id="conf-build-max-log-size"> | ||||
|     <term><literal>build-max-log-size</literal></term> | ||||
| 
 | ||||
|     <listitem><para><emphasis>Deprecated:</emphasis> | ||||
|     <literal>build-max-log-size</literal> is now an alias to | ||||
|     <xref linkend="conf-max-build-log-size" />.</para></listitem> | ||||
|   </varlistentry> | ||||
| 
 | ||||
|   <varlistentry xml:id="conf-build-max-silent-time"> | ||||
|     <term><literal>build-max-silent-time</literal></term> | ||||
| 
 | ||||
|     <listitem><para><emphasis>Deprecated:</emphasis> | ||||
|     <literal>build-max-silent-time</literal> is now an alias to | ||||
|     <xref linkend="conf-max-silent-time" />.</para></listitem> | ||||
|   </varlistentry> | ||||
| 
 | ||||
|   <varlistentry xml:id="conf-build-repeat"> | ||||
|     <term><literal>build-repeat</literal></term> | ||||
| 
 | ||||
|     <listitem><para><emphasis>Deprecated:</emphasis> | ||||
|     <literal>build-repeat</literal> is now an alias to | ||||
|     <xref linkend="conf-repeat" />.</para></listitem> | ||||
|   </varlistentry> | ||||
| 
 | ||||
|   <varlistentry xml:id="conf-build-timeout"> | ||||
|     <term><literal>build-timeout</literal></term> | ||||
| 
 | ||||
|     <listitem><para><emphasis>Deprecated:</emphasis> | ||||
|     <literal>build-timeout</literal> is now an alias to | ||||
|     <xref linkend="conf-timeout" />.</para></listitem> | ||||
|   </varlistentry> | ||||
| 
 | ||||
|   <varlistentry xml:id="conf-build-use-chroot"> | ||||
|     <term><literal>build-use-chroot</literal></term> | ||||
| 
 | ||||
|     <listitem><para><emphasis>Deprecated:</emphasis> | ||||
|     <literal>build-use-chroot</literal> is now an alias to | ||||
|     <xref linkend="conf-sandbox" />.</para></listitem> | ||||
|   </varlistentry> | ||||
| 
 | ||||
|   <varlistentry xml:id="conf-build-use-sandbox"> | ||||
|     <term><literal>build-use-sandbox</literal></term> | ||||
| 
 | ||||
|     <listitem><para><emphasis>Deprecated:</emphasis> | ||||
|     <literal>build-use-sandbox</literal> is now an alias to | ||||
|     <xref linkend="conf-sandbox" />.</para></listitem> | ||||
|   </varlistentry> | ||||
| 
 | ||||
|   <varlistentry xml:id="conf-build-use-substitutes"> | ||||
|     <term><literal>build-use-substitutes</literal></term> | ||||
| 
 | ||||
|     <listitem><para><emphasis>Deprecated:</emphasis> | ||||
|     <literal>build-use-substitutes</literal> is now an alias to | ||||
|     <xref linkend="conf-substitute" />.</para></listitem> | ||||
|   </varlistentry> | ||||
| 
 | ||||
|   <varlistentry xml:id="conf-gc-keep-derivations"> | ||||
|     <term><literal>gc-keep-derivations</literal></term> | ||||
| 
 | ||||
|     <listitem><para><emphasis>Deprecated:</emphasis> | ||||
|     <literal>gc-keep-derivations</literal> is now an alias to | ||||
|     <xref linkend="conf-keep-derivations" />.</para></listitem> | ||||
|   </varlistentry> | ||||
| 
 | ||||
|   <varlistentry xml:id="conf-gc-keep-outputs"> | ||||
|     <term><literal>gc-keep-outputs</literal></term> | ||||
| 
 | ||||
|     <listitem><para><emphasis>Deprecated:</emphasis> | ||||
|     <literal>gc-keep-outputs</literal> is now an alias to | ||||
|     <xref linkend="conf-keep-outputs" />.</para></listitem> | ||||
|   </varlistentry> | ||||
| 
 | ||||
|   <varlistentry xml:id="conf-env-keep-derivations"> | ||||
|     <term><literal>env-keep-derivations</literal></term> | ||||
| 
 | ||||
|     <listitem><para><emphasis>Deprecated:</emphasis> | ||||
|     <literal>env-keep-derivations</literal> is now an alias to | ||||
|     <xref linkend="conf-keep-env-derivations" />.</para></listitem> | ||||
|   </varlistentry> | ||||
| 
 | ||||
|   <varlistentry xml:id="conf-extra-binary-caches"> | ||||
|     <term><literal>extra-binary-caches</literal></term> | ||||
| 
 | ||||
|     <listitem><para><emphasis>Deprecated:</emphasis> | ||||
|     <literal>extra-binary-caches</literal> is now an alias to | ||||
|     <xref linkend="conf-extra-substituters" />.</para></listitem> | ||||
|   </varlistentry> | ||||
| 
 | ||||
|   <varlistentry xml:id="conf-trusted-binary-caches"> | ||||
|     <term><literal>trusted-binary-caches</literal></term> | ||||
| 
 | ||||
|     <listitem><para><emphasis>Deprecated:</emphasis> | ||||
|     <literal>trusted-binary-caches</literal> is now an alias to | ||||
|     <xref linkend="conf-trusted-substituters" />.</para></listitem> | ||||
|   </varlistentry> | ||||
| </variablelist> | ||||
| </para> | ||||
| </refsection> | ||||
| 
 | ||||
| </refsection> | ||||
| 
 | ||||
| </refentry> | ||||
|  |  | |||
		Loading…
	
	Add table
		Add a link
		
	
		Reference in a new issue