01/01: doc: Add example of VCS-snapshot version numbers.

[Ludovic Courtès]

civodul pushed a commit to branch master
in repository guix.

commit 561360a589d2bea0b01b38aa9049b8e69cfad2e7
Author: Ludovic Courtès <address@hidden>
Date:   Tue Feb 23 12:44:43 2016 +0100

    doc: Add example of VCS-snapshot version numbers.
    
    * doc/guix.texi (Version Numbers): Add example for VCS version numbers.
---
 doc/guix.texi |   21 ++++++++++++++++++++-
 1 files changed, 20 insertions(+), 1 deletions(-)

diff --git a/doc/guix.texi b/doc/guix.texi
index 51b0652..ec05461 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -10456,7 +10456,26 @@ field to, say, 7 digits.  It avoids an aesthetic 
annoyance (assuming
 aesthetics have a role to play here) as well as problems related to OS
 limits such as the maximum shebang length (127 bytes for the Linux
 kernel.)  It is best to use the full commit identifiers in
address@hidden, though, to avoid ambiguities.
address@hidden, though, to avoid ambiguities.  A typical package
+definition may look like this:
+
address@hidden
+(define my-package
+  (let ((commit "c3f29bc928d5900971f65965feaae59e1272a3f7"))
+    (package
+      (version (string-append "0.9-1."
+                              (string-take commit 7)))
+      (source (origin
+                (method git-fetch)
+                (uri (git-reference
+                      (url "git://example.org/my-package.git")
+                      (commit commit)))
+                (sha256 (base32 "address@hidden"))
+                (file-name (string-append "my-package-" version
+                                          "-checkout"))))
+      ;; @dots{}
+      )))
address@hidden example
 
 @node Synopses and Descriptions
 @subsection Synopses and Descriptions