224/376: add manpage for nix-generate-patches

[Ludovic Courtès]

civodul pushed a commit to tag 1.8
in repository guix.

commit a5b5ebc45fa770f88a4e375fd2b4ebd36a4e4cbe
Author: darealshinji <address@hidden>
Date:   Sat Sep 20 09:08:50 2014 +0200

    add manpage for nix-generate-patches
---
 doc/manual/command-ref/nix-generate-patches.xml |   44 +++++++++++++++++++++++
 doc/manual/command-ref/utilities.xml            |    1 +
 doc/manual/local.mk                             |    2 +-
 3 files changed, 46 insertions(+), 1 deletions(-)

diff --git a/doc/manual/command-ref/nix-generate-patches.xml 
b/doc/manual/command-ref/nix-generate-patches.xml
new file mode 100644
index 0000000..70bec43
--- /dev/null
+++ b/doc/manual/command-ref/nix-generate-patches.xml
@@ -0,0 +1,44 @@
+<refentry xmlns="http://docbook.org/ns/docbook";
+      xmlns:xlink="http://www.w3.org/1999/xlink";
+      xmlns:xi="http://www.w3.org/2001/XInclude";
+      version="5.0"
+      xml:id="sec-nix-generate-patches">
+
+<refmeta>
+  <refentrytitle>nix-generate-patches</refentrytitle>
+  <manvolnum>1</manvolnum>
+  <refmiscinfo class="source">Nix</refmiscinfo>
+  <refmiscinfo class="version"><xi:include href="../version.txt" 
parse="text"/></refmiscinfo>
+</refmeta>
+
+<refnamediv>
+  <refname>nix-generate-patches</refname>
+  <refpurpose>generates binary patches between NAR files</refpurpose>
+</refnamediv>
+
+<refsynopsisdiv>
+  <cmdsynopsis>
+    <command>nix-generate-patches</command>
+    <arg choice='plain'><replaceable>NAR-DIR</replaceable></arg>
+       <arg choice='plain'><replaceable>PATCH-DIR</replaceable></arg>
+       <arg choice='plain'><replaceable>PATCH-URI</replaceable></arg>
+       <arg choice='plain'><replaceable>OLD-MANIFEST</replaceable></arg>
+       <arg choice='plain'><replaceable>NEW-MANIFEST</replaceable></arg>
+  </cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsection><title>Description</title>
+
+<para>The command <command>nix-generate-patches</command> generates
+binary patches between NAR files listed in OLD-MANIFEST and NEW-MANIFEST.
+The patches are written to the directory PATCH-DIR, and the prefix
+PATCH-URI is used to generate URIs for the patches.  The patches are
+added to NEW-MANIFEST.  All NARs are required to exist in NAR-DIR.
+Patches are generated between succeeding versions of packages with
+the same name.</para>
+
+</refsection>
+
+
+</refentry>
diff --git a/doc/manual/command-ref/utilities.xml 
b/doc/manual/command-ref/utilities.xml
index 190962c..d5650fd 100644
--- a/doc/manual/command-ref/utilities.xml
+++ b/doc/manual/command-ref/utilities.xml
@@ -13,6 +13,7 @@ work with Nix.</para>
 <xi:include href="nix-collect-garbage.xml" />
 <xi:include href="nix-copy-closure.xml" />
 <xi:include href="nix-daemon.xml" />
+<xi:include href="nix-generate-patches.xml" />
 <xi:include href="nix-hash.xml" />
 <xi:include href="nix-install-package.xml" />
 <xi:include href="nix-instantiate.xml" />
diff --git a/doc/manual/local.mk b/doc/manual/local.mk
index 0a5353a..a4df921 100644
--- a/doc/manual/local.mk
+++ b/doc/manual/local.mk
@@ -36,7 +36,7 @@ dist-files += $(d)/manual.xmli $(d)/version.txt 
$(d)/manual.is-valid
 man-pages := $(foreach n, \
   nix-env.1 nix-build.1 nix-shell.1 nix-store.1 nix-instantiate.1 \
   nix-collect-garbage.1 nix-push.1 nix-pull.1 \
-  nix-prefetch-url.1 nix-channel.1 \
+  nix-prefetch-url.1 nix-channel.1 nix-generate-patches.1 \
   nix-install-package.1 nix-hash.1 nix-copy-closure.1 \
   nix.conf.5 nix-daemon.8, \
   $(d)/$(n))