tvl-depot/doc/manual/command-ref/opt-common-syn.xml

<nop xmlns="http://docbook.org/ns/docbook">
  
<arg><option>--help</option></arg>
<arg><option>--version</option></arg>
<arg rep='repeat'>
  <group choice='req'>
    <arg choice='plain'><option>--verbose</option></arg>
    <arg choice='plain'><option>-v</option></arg>
  </group>
</arg>
<arg>
  <group choice='plain'>
    <arg choice='plain'><option>--no-build-output</option></arg>
    <arg choice='plain'><option>-Q</option></arg>
  </group>
</arg>
<arg>
  <group choice='req'>
    <arg choice='plain'><option>--max-jobs</option></arg>
    <arg choice='plain'><option>-j</option></arg>
  </group>
  <replaceable>number</replaceable>
</arg>
<arg>
  <option>--cores</option>
  <replaceable>number</replaceable>
</arg>
<arg>
  <option>--max-silent-time</option>
  <replaceable>number</replaceable>
</arg>
<arg>
  <option>--timeout</option>
  <replaceable>number</replaceable>
</arg>
<arg>
  <group choice='plain'>
    <arg choice='plain'><option>--keep-going</option></arg>
    <arg choice='plain'><option>-k</option></arg>
  </group>
</arg>
<arg>
  <group choice='plain'>
    <arg choice='plain'><option>--keep-failed</option></arg>
    <arg choice='plain'><option>-K</option></arg>
  </group>
</arg>
<arg><option>--fallback</option></arg>
<arg><option>--readonly-mode</option></arg>
<arg><option>--show-trace</option></arg>
<arg>
  <option>-I</option>
  <replaceable>path</replaceable>
</arg>
<arg>
  <option>--option</option>
  <replaceable>name</replaceable>
  <replaceable>value</replaceable>
</arg>
<sbr />

</nop>
* Compatibility with docbook5-xsl. 2007-02-05 13:10:10 +01:00			`<nop xmlns="http://docbook.org/ns/docbook">`
* XInclude all the way. 2005-03-15 14:55:41 +01:00
* Sort `nix-env -q' output by derivation name. * `--version' flag for all commands. * Manual updates. 2004-02-02 11:51:54 +01:00			`<arg><option>--help</option></arg>`
			`<arg><option>--version</option></arg>`
man pages: Grouping for option alternatives 2017-07-07 20:37:16 +02:00			`<arg rep='repeat'>`
			`<group choice='req'>`
			`<arg choice='plain'><option>--verbose</option></arg>`
			`<arg choice='plain'><option>-v</option></arg>`
			`</group>`
			`</arg>`
			`<arg>`
			`<group choice='plain'>`
			`<arg choice='plain'><option>--no-build-output</option></arg>`
			`<arg choice='plain'><option>-Q</option></arg>`
			`</group>`
			`</arg>`
* A flag `--keep-going / -k' to keep building goals if one fails, as much as possible. (This is similar to GNU Make's `-k' flag.) * Refactoring to implement this: previously we just bombed out when a build failed, but now we have to clean up. In particular this means that goals must be freed quickly --- they shouldn't hang around until the worker exits. So the worker now maintains weak pointers in order not to prevent garbage collection. * Documented the `-k' and `-j' flags. 2004-06-25 17:36:09 +02:00			`<arg>`
			`<group choice='req'>`
			`<arg choice='plain'><option>--max-jobs</option></arg>`
			`<arg choice='plain'><option>-j</option></arg>`
			`</group>`
			`<replaceable>number</replaceable>`
			`</arg>`
* Document --cores in the manual. 2010-08-17 09:22:05 +02:00			`<arg>`
Document $NIX_PATH / -I 2012-05-10 01:06:13 +02:00			`<option>--cores</option>`
* Document --cores in the manual. 2010-08-17 09:22:05 +02:00			`<replaceable>number</replaceable>`
			`</arg>`
2007-10-29 23:16:36 +01:00			`<arg>`
Document $NIX_PATH / -I 2012-05-10 01:06:13 +02:00			`<option>--max-silent-time</option>`
2007-10-29 23:16:36 +01:00			`<replaceable>number</replaceable>`
			`</arg>`
Add support for the `build-timeout' and `--timeout' options. 2011-06-30 17:19:13 +02:00			`<arg>`
Document $NIX_PATH / -I 2012-05-10 01:06:13 +02:00			`<option>--timeout</option>`
Add support for the `build-timeout' and `--timeout' options. 2011-06-30 17:19:13 +02:00			`<replaceable>number</replaceable>`
			`</arg>`
man pages: Grouping for option alternatives 2017-07-07 20:37:16 +02:00			`<arg>`
			`<group choice='plain'>`
			`<arg choice='plain'><option>--keep-going</option></arg>`
			`<arg choice='plain'><option>-k</option></arg>`
			`</group>`
			`</arg>`
			`<arg>`
			`<group choice='plain'>`
			`<arg choice='plain'><option>--keep-failed</option></arg>`
			`<arg choice='plain'><option>-K</option></arg>`
			`</group>`
			`</arg>`
* Added a switch `--fallback'. From the manual: Whenever Nix attempts to realise a derivation for which a closure is already known, but this closure cannot be realised, fall back on normalising the derivation. The most common scenario in which this is useful is when we have registered substitutes in order to perform binary distribution from, say, a network repository. If the repository is down, the realisation of the derivation will fail. When this option is specified, Nix will build the derivation instead. Thus, binary installation falls back on a source installation. This option is not the default since it is generally not desirable for a transient failure in obtaining the substitutes to lead to a full build from source (with the related consumption of resources). 2004-06-28 12:42:57 +02:00			`<arg><option>--fallback</option></arg>`
* Document --eval-only and --parse-only options in nix-instantiate. 2004-11-13 00:22:08 +01:00			`<arg><option>--readonly-mode</option></arg>`
* Don't show trace information by default (`--show-trace' to enable). NixOS evaluation errors in particular look intimidating and generally aren't very useful. Ideally the builtins.throw messages should be self-contained. 2009-06-30 15:28:29 +02:00			`<arg><option>--show-trace</option></arg>`
Document $NIX_PATH / -I 2012-05-10 01:06:13 +02:00			`<arg>`
			`<option>-I</option>`
			`<replaceable>path</replaceable>`
			`</arg>`
Document the --option flag Pointed out by Daniel Santa Cruz on IRC. 2012-07-29 20:37:40 +02:00			`<arg>`
			`<option>--option</option>`
			`<replaceable>name</replaceable>`
			`<replaceable>value</replaceable>`
			`</arg>`
* Document --arg. 2006-10-05 11:08:52 +02:00			`<sbr />`
* XInclude all the way. 2005-03-15 14:55:41 +01:00
			`</nop>`