diff options
author | Graham Christensen <graham@grahamc.com> | 2018-05-01 19:57:09 -0400 |
---|---|---|
committer | Graham Christensen <graham@grahamc.com> | 2018-05-01 19:57:09 -0400 |
commit | eca5c99bf8a115ffd9513f91decc064a5bb3ff6d (patch) | |
tree | 7b49bc123be12ca5344428c6975e4487e69d55e3 /nixos/doc/manual/man-nixos-version.xml | |
parent | 77161de4546697f9bf2da6d081eeba4c399b3313 (diff) | |
download | nixpkgs-eca5c99bf8a115ffd9513f91decc064a5bb3ff6d.tar nixpkgs-eca5c99bf8a115ffd9513f91decc064a5bb3ff6d.tar.gz nixpkgs-eca5c99bf8a115ffd9513f91decc064a5bb3ff6d.tar.bz2 nixpkgs-eca5c99bf8a115ffd9513f91decc064a5bb3ff6d.tar.lz nixpkgs-eca5c99bf8a115ffd9513f91decc064a5bb3ff6d.tar.xz nixpkgs-eca5c99bf8a115ffd9513f91decc064a5bb3ff6d.tar.zst nixpkgs-eca5c99bf8a115ffd9513f91decc064a5bb3ff6d.zip |
nixos docs: format =)
Diffstat (limited to 'nixos/doc/manual/man-nixos-version.xml')
-rw-r--r-- | nixos/doc/manual/man-nixos-version.xml | 171 |
1 files changed, 88 insertions, 83 deletions
diff --git a/nixos/doc/manual/man-nixos-version.xml b/nixos/doc/manual/man-nixos-version.xml index 615d74f9090..c173bce1913 100644 --- a/nixos/doc/manual/man-nixos-version.xml +++ b/nixos/doc/manual/man-nixos-version.xml @@ -1,97 +1,102 @@ <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude"> - -<refmeta> - <refentrytitle><command>nixos-version</command></refentrytitle> - <manvolnum>8</manvolnum> + <refmeta> + <refentrytitle><command>nixos-version</command> + </refentrytitle><manvolnum>8</manvolnum> <refmiscinfo class="source">NixOS</refmiscinfo> -</refmeta> - -<refnamediv> - <refname><command>nixos-version</command></refname> - <refpurpose>show the NixOS version</refpurpose> -</refnamediv> - -<refsynopsisdiv> - <cmdsynopsis> - <command>nixos-version</command> - <arg><option>--hash</option></arg> - <arg><option>--revision</option></arg> + </refmeta> + <refnamediv> + <refname><command>nixos-version</command> + </refname><refpurpose>show the NixOS version</refpurpose> + </refnamediv> + <refsynopsisdiv> + <cmdsynopsis><command>nixos-version</command> + <arg><option>--hash</option> + </arg> + <arg><option>--revision</option> + </arg> </cmdsynopsis> -</refsynopsisdiv> - -<refsection><title>Description</title> - -<para>This command shows the version of the currently active NixOS -configuration. For example: - + </refsynopsisdiv> + <refsection> + <title>Description</title> + <para> + This command shows the version of the currently active NixOS configuration. + For example: <screen>$ nixos-version 16.03.1011.6317da4 (Emu) </screen> - -The version consists of the following elements: - -<variablelist> - - <varlistentry> - <term><literal>16.03</literal></term> - <listitem><para>The NixOS release, indicating the year and month - in which it was released (e.g. March 2016).</para></listitem> - </varlistentry> - - <varlistentry> - <term><literal>1011</literal></term> - <listitem><para>The number of commits in the Nixpkgs Git - repository between the start of the release branch and the commit - from which this version was built. This ensures that NixOS - versions are monotonically increasing. It is - <literal>git</literal> when the current NixOS configuration was - built from a checkout of the Nixpkgs Git repository rather than - from a NixOS channel.</para></listitem> - </varlistentry> - - <varlistentry> - <term><literal>6317da4</literal></term> - <listitem><para>The first 7 characters of the commit in the - Nixpkgs Git repository from which this version was - built.</para></listitem> - </varlistentry> - - <varlistentry> - <term><literal>Emu</literal></term> - <listitem><para>The code name of the NixOS release. The first - letter of the code name indicates that this is the N'th stable - NixOS release; for example, Emu is the fifth - release.</para></listitem> - </varlistentry> - -</variablelist> - -</para> - -</refsection> - - -<refsection><title>Options</title> - -<para>This command accepts the following options:</para> - -<variablelist> - - <varlistentry> - <term><option>--hash</option></term> - <term><option>--revision</option></term> + The version consists of the following elements: + <variablelist> + <varlistentry> + <term><literal>16.03</literal> + </term> + <listitem> + <para> + The NixOS release, indicating the year and month in which it was + released (e.g. March 2016). + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><literal>1011</literal> + </term> + <listitem> + <para> + The number of commits in the Nixpkgs Git repository between the start of + the release branch and the commit from which this version was built. + This ensures that NixOS versions are monotonically increasing. It is + <literal>git</literal> when the current NixOS configuration was built + from a checkout of the Nixpkgs Git repository rather than from a NixOS + channel. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><literal>6317da4</literal> + </term> + <listitem> + <para> + The first 7 characters of the commit in the Nixpkgs Git repository from + which this version was built. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><literal>Emu</literal> + </term> + <listitem> + <para> + The code name of the NixOS release. The first letter of the code name + indicates that this is the N'th stable NixOS release; for example, Emu + is the fifth release. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsection> + <refsection> + <title>Options</title> + <para> + This command accepts the following options: + </para> + <variablelist> + <varlistentry> + <term><option>--hash</option> + </term> + <term><option>--revision</option> + </term> <listitem> - <para>Show the full SHA1 hash of the Git commit from which this - configuration was built, e.g. + <para> + Show the full SHA1 hash of the Git commit from which this configuration + was built, e.g. <screen>$ nixos-version --hash 6317da40006f6bc2480c6781999c52d88dde2acf </screen> - </para> + </para> </listitem> - </varlistentry> -</variablelist> - -</refsection> + </varlistentry> + </variablelist> + </refsection> </refentry> |