docs/master

changeset 154:63e885fb48ba

Converted some internal references to the new macros.
author markus schnalke <meillo@marmaro.de>
date Fri, 06 Jul 2012 15:59:04 +0200
parents f3db51746c2c
children 75f20c925999
files discussion.roff
diffstat 1 files changed, 23 insertions(+), 14 deletions(-) [+]
line diff
     1.1 --- a/discussion.roff	Fri Jul 06 15:04:04 2012 +0200
     1.2 +++ b/discussion.roff	Fri Jul 06 15:59:04 2012 +0200
     1.3 @@ -55,6 +55,7 @@
     1.4  
     1.5  
     1.6  .H2 "Mail Transfer Facilities
     1.7 +.Id mail-transfer-facilities
     1.8  .P
     1.9  In contrast to nmh, which also provides mail submission and mail retrieval
    1.10  agents, mmh is a MUA only.
    1.11 @@ -392,7 +393,9 @@
    1.12  Although
    1.13  .Pn slocal
    1.14  does neither pull in dependencies nor does it include a separate
    1.15 -technical area (cf. Sec. XXX), still,
    1.16 +technical area (cf. Sec.
    1.17 +.Cf mail-transfer-facilities ),
    1.18 +still,
    1.19  it accounts for about 1\|000 lines of code that need to be maintained.
    1.20  As
    1.21  .Pn slocal
    1.22 @@ -426,6 +429,7 @@
    1.23  
    1.24  
    1.25  .H2 "Displaying Messages
    1.26 +.id mhshow
    1.27  .P
    1.28  Since the very beginning, already in the first concept paper,
    1.29  .Pn show
    1.30 @@ -544,7 +548,8 @@
    1.31  was reworked to behave more like
    1.32  .Pn show
    1.33  first.
    1.34 -(cf. Sec. XXX)
    1.35 +(cf. Sec.
    1.36 +.Cf mhshow )
    1.37  Once the tools behaved more alike, the replacing appeared to be
    1.38  even more natural.
    1.39  Today, mmh's new
    1.40 @@ -685,7 +690,8 @@
    1.41  it suited better.
    1.42  .P
    1.43  Eventually, however, the new trash folder concept
    1.44 -.Cf "Sec. XXX
    1.45 +(cf. Sec.
    1.46 +.Cf trash-folder )
    1.47  obsoleted the concept of the backup prefix completely.
    1.48  .Ci 8edc5aaf86f9f77124664f6801bc6c6cdf258173
    1.49  .Ci ca0b3e830b86700d9e5e31b1784de2bdcaf58fc5
    1.50 @@ -1043,10 +1049,8 @@
    1.51  .Pn send .
    1.52  (These numbers include two generic switches, help and version.)
    1.53  .P
    1.54 -Fig. XXX
    1.55 -.\" XXX Ref
    1.56 -displays the number of switches for each of the tools that is available
    1.57 -in both, nmh and mmh.
    1.58 +The figure displays the number of switches for each of the tools
    1.59 +that is available in both, nmh and mmh.
    1.60  The tools are sorted by the number of switches they had in nmh.
    1.61  Visible and hidden switches were counted,
    1.62  but not the generic help and version switches.
    1.63 @@ -1114,7 +1118,8 @@
    1.64  was removed.
    1.65  The special-casing of `the' draft message became irrelevant after
    1.66  the rework of the draft system.
    1.67 -(See Sec. XXX.)
    1.68 +(df. Sec.
    1.69 +.Cf draft-folder )
    1.70  Equally,
    1.71  .Pn comp
    1.72  lost its
    1.73 @@ -1278,7 +1283,8 @@
    1.74  rfc 1864
    1.75  .]
    1.76  .Ci 31dc797eb5178970d68962ca8939da3fd9a8efda
    1.77 -(See Sec. XXX)
    1.78 +(cf. Sec.
    1.79 +.Cf content-md5 )
    1.80  .P
    1.81  The
    1.82  .Sw -[no]ebcdicsafe
    1.83 @@ -1420,13 +1426,13 @@
    1.84  .Sw -mmdf
    1.85  switches.
    1.86  .Sw -mbox
    1.87 -is the sole  behavior now.
    1.88 +is the sole behavior now.
    1.89  .Ci 3916ab66ad5d183705ac12357621ea8661afd3c0
    1.90  In the same go,
    1.91  .Pn packf
    1.92  and
    1.93  .Pn rcvpack
    1.94 -were reworked (see Sec. XXX) and their
    1.95 +were reworked and their
    1.96  .Sw -file
    1.97  switch became unnecessary.
    1.98  .Ci ca1023716d4c2ab890696f3e41fa0d94267a940e
    1.99 @@ -1566,9 +1572,8 @@
   1.100  This section describes the removing of old code
   1.101  and the modernizing of the default setup.
   1.102  It focuses on the functional aspect only;
   1.103 -the non-functional aspects of code style are discussed in
   1.104 -.\" FIXME REF
   1.105 -Sec. XXX.
   1.106 +the non-functional aspects of code style are discussed in Sec.
   1.107 +.Cf code-style .
   1.108  
   1.109  
   1.110  .H2 "Code Relicts
   1.111 @@ -1711,6 +1716,7 @@
   1.112  None of the Face systems described here is popular today.
   1.113  Hence, mmh has no direct support for them.
   1.114  .BU
   1.115 +.Id content-md5
   1.116  The
   1.117  .Hd Content-MD5
   1.118  header field was introduced by RFC\|1864.
   1.119 @@ -2305,6 +2311,7 @@
   1.120  .P
   1.121  
   1.122  .U3 "Draft Folder
   1.123 +.Id draft-folder
   1.124  .P
   1.125  In the beginning, MH had the concept of a draft message.
   1.126  This is the file
   1.127 @@ -2416,6 +2423,7 @@
   1.128  
   1.129  
   1.130  .U3 "Trash Folder
   1.131 +.Id trash-folder
   1.132  .P
   1.133  Similar to the situation for drafts is the situation for removed messages.
   1.134  Historically, a message was ``deleted'' by prepending a specific
   1.135 @@ -2689,6 +2697,7 @@
   1.136  
   1.137  
   1.138  .H2 "Code Style
   1.139 +.Id code-style
   1.140  .P
   1.141  .U3 "Indentation Style
   1.142  .P