docs/master

changeset 98:d894191d7a33

style: Changed the block quote approach. New QS and QE.
author markus schnalke <meillo@marmaro.de>
date Sat, 16 Jun 2012 17:43:11 +0200
parents 29a7454fcded
children 468c2bdc6b1a
files ch03.roff style
diffstat 2 files changed, 38 insertions(+), 23 deletions(-) [+]
line diff
     1.1 --- a/ch03.roff	Sat Jun 16 17:28:11 2012 +0200
     1.2 +++ b/ch03.roff	Sat Jun 16 17:43:11 2012 +0200
     1.3 @@ -851,13 +851,14 @@
     1.4  The man page
     1.5  .Mp mh-tailor(5)
     1.6  described the use case as being the following:
     1.7 -.QP
     1.8 +.QS
     1.9  This is useful if you want the messages you send to always
    1.10  appear to come from the name of an MTA alias rather than your
    1.11  actual account name.  For instance, many organizations set up
    1.12  `First.Last' sendmail aliases for all users.  If this is
    1.13  the case, the GECOS field for each user should look like:
    1.14  ``First [Middle] Last <First.Last>''
    1.15 +.QE
    1.16  .P
    1.17  As mmh sends outgoing mail via the local MTA only,
    1.18  the best location to do such global rewrites is there.
    1.19 @@ -966,8 +967,7 @@
    1.20  .[ [
    1.21  rose romine real work
    1.22  .], p. 12]
    1.23 -.sp
    1.24 -.QP
    1.25 +.QS
    1.26  A complaint often heard about systems which undergo substantial development
    1.27  by many people over a number of years, is that more and more options are
    1.28  introduced which add little to the functionality but greatly increase the
    1.29 @@ -977,7 +977,7 @@
    1.30  Unfortunately MH, having undergone six years of off-and-on development by
    1.31  ten or so well-meaning programmers (the present authors included),
    1.32  suffers mightily from this.
    1.33 -.sp
    1.34 +.QE
    1.35  .P
    1.36  Being reluctant to adding new switches \(en or `options',
    1.37  as Rose and Romine call them \(en is one part of a counter-action,
    1.38 @@ -1140,12 +1140,12 @@
    1.39  .Mp burst (1)
    1.40  man page reads:
    1.41  .sp \n(PDu
    1.42 -.QP
    1.43 +.QS
    1.44  If -noinplace is given, each digest is preserved, no table
    1.45  of contents is produced, and the messages contained within
    1.46  the digest are placed at the end of the folder. Other messages
    1.47  are not tampered with in any way.
    1.48 -.sp \n(PDu
    1.49 +.QE
    1.50  .LP
    1.51  The decision to drop the
    1.52  .Sw -inplace
    1.53 @@ -1471,15 +1471,16 @@
    1.54  This switch had introduced an awkward behavior, as explained in nmh's
    1.55  man page for
    1.56  .Mp comp (1):
    1.57 -.QP
    1.58 -The \-editor editor switch indicates the editor  to  use  for
    1.59 -the  initial  edit.  Upon exiting from the editor, comp will
    1.60 -invoke the whatnow program.  See whatnow(1) for a discussion
    1.61 -of available options.  The invocation of this program can be
    1.62 -inhibited by using the \-nowhatnowproc switch.  (In truth  of
    1.63 -fact,  it  is  the  whatnow program which starts the initial
    1.64 -edit.  Hence, \-nowhatnowproc  will  prevent  any  edit  from
    1.65 +.QS
    1.66 +The \-editor editor switch indicates the editor to use for
    1.67 +the initial edit. Upon exiting from the editor, comp will
    1.68 +invoke the whatnow program. See whatnow(1) for a discussion
    1.69 +of available options. The invocation of this program can be
    1.70 +inhibited by using the \-nowhatnowproc switch. (In truth of
    1.71 +fact, it is the whatnow program which starts the initial
    1.72 +edit. Hence, \-nowhatnowproc will prevent any edit from
    1.73  occurring.)
    1.74 +.QE
    1.75  .P
    1.76  Effectively, the
    1.77  .Sw -nowhatnowproc
    1.78 @@ -1550,7 +1551,7 @@
    1.79  of
    1.80  .Pn refile
    1.81  was removed because what use was it anyway?
    1.82 -.QP
    1.83 +.QS
    1.84  Normally when a message is refiled, for each destination
    1.85  folder it is assigned the number which is one above the current
    1.86  highest message number in that folder. Use of the
    1.87 @@ -1559,6 +1560,7 @@
    1.88  particular folder occurs when using the \-preserve switch,
    1.89  then refile will use the next available message number which
    1.90  is above the message number you wish to preserve.
    1.91 +.QE
    1.92  .BU
    1.93  The removal of the
    1.94  .Sw -[no]reverse
     2.1 --- a/style	Sat Jun 16 17:28:11 2012 +0200
     2.2 +++ b/style	Sat Jun 16 17:43:11 2012 +0200
     2.3 @@ -274,21 +274,34 @@
     2.4  .IP \(bu
     2.5  ..
     2.6  
     2.7 -.	\" QP - Block quote paragraph
     2.8 -.de QP
     2.9 +.	\" QS - Block quote start
    2.10 +.de QS
    2.11  .ti \\n(.iu
    2.12 -.if \\n(QP .nr Qp 1
    2.13  .RT
    2.14 -.sp \\n(PDu
    2.15 +.sp 2u*\\n(PDu
    2.16  .ne 1.1
    2.17  .ps -1
    2.18  .in +\\n(QIu
    2.19  .ll -\\n(QIu
    2.20  .ti \\n(.iu
    2.21 -.if \\n(Qp .ti +\\n(PIu
    2.22 -.if \\n(TM .ls 1
    2.23 -.nr QP 1
    2.24 -.rr Qp
    2.25 +.\"if \\n(Qp .ti +\\n(PIu
    2.26 +.\"nr QP 1
    2.27 +.\"rr Qp
    2.28 +..
    2.29 +
    2.30 +.	\" QP - Block quote paragraph
    2.31 +.de QP
    2.32 +.sp \n(PDu
    2.33 +.ne 1.1
    2.34 +.ti +\\n(PIu
    2.35 +..
    2.36 +
    2.37 +.	\" QP - Block quote end
    2.38 +.de QE
    2.39 +.sp \\n(PDu
    2.40 +.in -\\n(QIu
    2.41 +.ll +\\n(QIu
    2.42 +.ti \\n(.iu
    2.43  ..
    2.44  
    2.45  .	\" DS - Code display