docs/master

changeset 68:7ca31b06b653

Preface: Added some lines about source code commit references.
author markus schnalke <meillo@marmaro.de>
date Sat, 02 Jun 2012 11:58:40 +0200
parents 26a2e3d2f9d3
children f80ced4e749b
files preface.roff
diffstat 1 files changed, 15 insertions(+), 0 deletions(-) [+]
line diff
     1.1 --- a/preface.roff	Sat Jun 02 11:45:06 2012 +0200
     1.2 +++ b/preface.roff	Sat Jun 02 11:58:40 2012 +0200
     1.3 @@ -194,6 +194,21 @@
     1.4  Meaning of `foo(1)'.
     1.5  RFCs.
     1.6  .P
     1.7 +References to source code repository commits are printed as
     1.8 +.Ci 1a2b3c4 .
     1.9 +They can be looked up with
    1.10 +.Cl "git show XXX
    1.11 +on the command line or
    1.12 +online at
    1.13 +.CW "http://git.marmaro.de/?p=mmh;a=commitdiff;h=XXX" ,
    1.14 +replacing `\f(CWXXX\fP' with the hash value.
    1.15 +In this example:
    1.16 +.Cl "git show 1a2b3c4
    1.17 +or
    1.18 +.CW "http://git.marmaro.de/?p=mmh;a=commitdiff;h=1a2b3cd" .
    1.19 +Whereas the code repository will probably be available on the Internet
    1.20 +forever, a website URL is always at risk to change.
    1.21 +.P
    1.22  This thesis is divided into XXX chapters, ...
    1.23  .P
    1.24  .I Chapter 1