aboutsummaryrefslogtreecommitdiff
path: root/doc/manual
diff options
context:
space:
mode:
authorEelco Dolstra <eelco.dolstra@logicblox.com>2014-02-19 16:34:24 +0100
committerEelco Dolstra <eelco.dolstra@logicblox.com>2014-02-19 16:34:24 +0100
commite1cf40fa9537162efe0dc19dcea9ae7d043fde66 (patch)
treec2665d130f9bc17731216bb95b35c09892ed333e /doc/manual
parentc31836008e45460513188a3fbeda4416f9153a05 (diff)
nix-instantiate: Rename --eval-only to --eval, --parse-only to --parse
Diffstat (limited to 'doc/manual')
-rw-r--r--doc/manual/nix-instantiate.xml30
1 files changed, 15 insertions, 15 deletions
diff --git a/doc/manual/nix-instantiate.xml b/doc/manual/nix-instantiate.xml
index a780302e1..b388560a1 100644
--- a/doc/manual/nix-instantiate.xml
+++ b/doc/manual/nix-instantiate.xml
@@ -19,9 +19,9 @@
<cmdsynopsis>
<command>nix-instantiate</command>
<group>
- <arg choice='plain'><option>--parse-only</option></arg>
+ <arg choice='plain'><option>--parse</option></arg>
<arg choice='plain'>
- <option>--eval-only</option>
+ <option>--eval</option>
<arg><option>--strict</option></arg>
<arg><option>--xml</option></arg>
</arg>
@@ -84,7 +84,7 @@ input.</para>
</varlistentry>
- <varlistentry><term><option>--parse-only</option></term>
+ <varlistentry><term><option>--parse</option></term>
<listitem><para>Just parse the input files, and print their
abstract syntax trees on standard output in ATerm
@@ -92,7 +92,7 @@ input.</para>
</varlistentry>
- <varlistentry><term><option>--eval-only</option></term>
+ <varlistentry><term><option>--eval</option></term>
<listitem><para>Just parse and evaluate the input files, and print
the resulting values on standard output. No instantiation of
@@ -115,8 +115,8 @@ input.</para>
<varlistentry><term><option>--xml</option></term>
- <listitem><para>When used with <option>--parse-only</option> and
- <option>--eval-only</option>, print the resulting expression as an
+ <listitem><para>When used with <option>--parse</option> and
+ <option>--eval</option>, print the resulting expression as an
XML representation of the abstract syntax tree rather than as an
ATerm. The schema is the same as that used by the <link
linkend="builtin-toXML"><function>toXML</function>
@@ -126,7 +126,7 @@ input.</para>
<varlistentry><term><option>--strict</option></term>
- <listitem><para>When used with <option>--eval-only</option>,
+ <listitem><para>When used with <option>--eval</option>,
recursively evaluate list elements and attributes. Normally, such
sub-expressions are left unevaluated (since the Nix expression
language is lazy).</para>
@@ -140,9 +140,9 @@ input.</para>
<varlistentry><term><option>--read-write-mode</option></term>
- <listitem><para>When used with <option>--eval-only</option>,
- perform evaluation in read/write mode so nix language features
- that require it will still work (at the cost of needing to do
+ <listitem><para>When used with <option>--eval</option>, perform
+ evaluation in read/write mode so nix language features that
+ require it will still work (at the cost of needing to do
instantiation of every evaluated derivation).</para>
</listitem>
@@ -195,13 +195,13 @@ $ nix-instantiate '&lt;nixpkgs>' -A hello
<para>Parsing and evaluating Nix expressions:
<screen>
-$ nix-instantiate --parse-only -E '1 + 2'
+$ nix-instantiate --parse -E '1 + 2'
1 + 2
-$ nix-instantiate --eval-only -E '1 + 2'
+$ nix-instantiate --eval -E '1 + 2'
3
-$ nix-instantiate --eval-only --xml -E '1 + 2'
+$ nix-instantiate --eval --xml -E '1 + 2'
<![CDATA[<?xml version='1.0' encoding='utf-8'?>
<expr>
<int value="3" />
@@ -212,7 +212,7 @@ $ nix-instantiate --eval-only --xml -E '1 + 2'
<para>The difference between non-strict and strict evaluation:
<screen>
-$ nix-instantiate --eval-only --xml -E 'rec { x = "foo"; y = x; }'
+$ nix-instantiate --eval --xml -E 'rec { x = "foo"; y = x; }'
<replaceable>...</replaceable><![CDATA[
<attr name="x">
<string value="foo" />
@@ -226,7 +226,7 @@ Note that <varname>y</varname> is left unevaluated (the XML
representation doesn’t attempt to show non-normal forms).
<screen>
-$ nix-instantiate --eval-only --xml --strict -E 'rec { x = "foo"; y = x; }'
+$ nix-instantiate --eval --xml --strict -E 'rec { x = "foo"; y = x; }'
<replaceable>...</replaceable><![CDATA[
<attr name="x">
<string value="foo" />