[PATCH] rpc.5: ffix

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



Is there a recommended best practice for itemized (but not enumerated)
lists?  I don't know that my own is widely shared, so I did not make
such a change here.

But if I were to do so, I would either recast this page's 3-item list
into prose or use the indented paragraph macro with a bullet symbol for
a tag:

.IP \(bu
name of server for the RPC program
.IP \(bu
RPC program number
.IP \(bu
aliases

Of course,

.TP
\(bu
name of server for the RPC program
[etc.]

would be equivalent.

Any advice?

>SNIP<

rpc.5: ffix

* Remove nop argument from HP macros.
* Remove nop DT macro.
* Replace LP macro with more commonly-used PP macro.

The above do not change the output whatsoever (confirmed with -Z).

* Use .I macro instead of font escapes, obtaining italic correction.

To see the above distinction, use -Tps, -Tpdf, or similar before and
after the change.

diff --git a/man5/rpc.5 b/man5/rpc.5
index 44b5acb0e..49831fd78 100644
--- a/man5/rpc.5
+++ b/man5/rpc.5
@@ -16,25 +16,26 @@ The
 file contains user readable names that
 can be used in place of RPC program numbers.
 Each line has the following information:
-.HP 10
+.HP
 name of server for the RPC program
 .br
 .ns
-.HP 10
+.HP
 RPC program number
 .br
 .ns
-.HP 10
+.HP
 aliases
-.LP
+.PP
 Items are separated by any number of blanks and/or
 tab characters.
 A \(aq#\(aq indicates the beginning of a comment; characters from
 the \(aq#\(aq to the end of the line are not interpreted by routines
 which search the file.
-.LP
-Here is an example of the \fI/etc/rpc\fP file from the Sun RPC Source
-distribution.
+.PP
+Here is an example of the
+.I /etc/rpc
+file from the Sun RPC Source distribution.
 .ft CW
 .nf
 #
@@ -72,7 +73,6 @@ nsed            100038
 nsemntd         100039
 .fi
 .ft
-.DT
 .SH FILES
 .TP
 .I /etc/rpc

Regards,
Branden
commit 1f173880b25aa60a9bf838f7c4738f8dc0372959
Author: G. Branden Robinson <g.branden.robinson@xxxxxxxxx>
Date:   Fri May 5 23:12:44 2017 -0400

    rpc.5: ffix
    
    * Remove nop argument from HP macros.
    * Remove nop DT macro.
    * Replace LP macro with more commonly-used PP macro.
    
    The above do not change the output whatsoever (confirmed with -Z).
    
    * Use .I macro instead of font escapes, obtaining italic correction.
    
    To see the above distinction, use -Tps, -Tpdf, or similar before and
    after the change.

diff --git a/man5/rpc.5 b/man5/rpc.5
index 44b5acb0e..49831fd78 100644
--- a/man5/rpc.5
+++ b/man5/rpc.5
@@ -16,25 +16,26 @@ The
 file contains user readable names that
 can be used in place of RPC program numbers.
 Each line has the following information:
-.HP 10
+.HP
 name of server for the RPC program
 .br
 .ns
-.HP 10
+.HP
 RPC program number
 .br
 .ns
-.HP 10
+.HP
 aliases
-.LP
+.PP
 Items are separated by any number of blanks and/or
 tab characters.
 A \(aq#\(aq indicates the beginning of a comment; characters from
 the \(aq#\(aq to the end of the line are not interpreted by routines
 which search the file.
-.LP
-Here is an example of the \fI/etc/rpc\fP file from the Sun RPC Source
-distribution.
+.PP
+Here is an example of the
+.I /etc/rpc
+file from the Sun RPC Source distribution.
 .ft CW
 .nf
 #
@@ -72,7 +73,6 @@ nsed            100038
 nsemntd         100039
 .fi
 .ft
-.DT
 .SH FILES
 .TP
 .I /etc/rpc

Attachment: signature.asc
Description: PGP signature


[Index of Archives]     [Kernel Documentation]     [Netdev]     [Linux Ethernet Bridging]     [Linux Wireless]     [Kernel Newbies]     [Security]     [Linux for Hams]     [Netfilter]     [Bugtraq]     [Yosemite News]     [MIPS Linux]     [ARM Linux]     [Linux RAID]     [Linux Admin]     [Samba]

  Powered by Linux