[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[groff] 01/01: Cease abusing .IP in running text, it's bad style and not
From: |
Eric S. Raymond |
Subject: |
[groff] 01/01: Cease abusing .IP in running text, it's bad style and not safe. |
Date: |
Sat, 05 Mar 2016 19:40:20 +0000 |
esr pushed a commit to branch master
in repository groff.
commit cda7fe6fd767de5d231eedb079c8eef6eccefa32
Author: Eric S. Raymond <address@hidden>
Date: Sat Mar 5 14:40:06 2016 -0500
Cease abusing .IP in running text, it's bad style and not safe.
Spotted by doclifter.
---
src/roff/grog/grog.1.man | 28 ----------------------------
1 files changed, 0 insertions(+), 28 deletions(-)
diff --git a/src/roff/grog/grog.1.man b/src/roff/grog/grog.1.man
index 386d28b..e920f95 100644
--- a/src/roff/grog/grog.1.man
+++ b/src/roff/grog/grog.1.man
@@ -54,12 +54,6 @@ Bernd Warken
.el .ds EL \&.\|.\|.\&\"
.\" called with \*(EL
.
-.\" Bullet
-.ie t .ds BU \(bu
-.el .ds BU *
-.\" used in `.IP \*(BU 2m' (former .Topic)
-.
-.
.\" --------------------------------------------------------------------
.SH SYNOPSIS
.\" --------------------------------------------------------------------
@@ -352,24 +346,19 @@ is used instead.
.SH EXAMPLES
.\" --------------------------------------------------------------------
.
-.IP \*(BU 2m
Calling
.RS
-.IP
.EX
grog meintro.me
.EE
.RE
-.IP
results in
.RS
.EX
-.IP
groff \-me meintro.me
.EE
.RE
.
-.IP
So
.B grog
recognized that the file
@@ -380,26 +369,21 @@ macro package.
.RE
.
.
-.IP \*(BU 2m
On the other hand,
.RS
-.IP
.EX
grog pic.ms
.EE
.RE
.
-.IP
outputs
.
.RS
-.IP
.EX
groff \-p \-t \-e \-ms pic.ms
.EE
.RE
.
-.IP
Besides determining the macro package
.BR \-ms ,
.B grog
@@ -421,54 +405,44 @@ for
.RE
.
.
-.IP \*(BU 2m
If both of the former example files are combined by the command
.
.RS
-.IP
.EX
grog meintro.me pic.ms
.EE
.RE
.
-.IP
an error message is sent to standard error because
.B groff
cannot work with two different macro packages:
.
.RS
-.IP
.ft CR
grog: error: there are several macro packages: \-me \-ms
.ft
.RE
.
-.IP
Additionally the corresponding output with the wrong options is printed
to standard output:
.
.RS
-.IP
.EX
groff \-pte \-me \-ms meintro.me pic.ms
.EE
.RE
.
-.IP
But the program is terminated with an error code.
.
.
-.IP \*(BU 2m
The call of
.
.RS
-.IP
.EX
grog \-ksS \-Tdvi grnexmpl.g
.EE
.RE
.
-.IP
contains several
.B groff
options that are just passed on the output without any interface to
@@ -487,13 +461,11 @@ with argument
The output is
.
.RS
-.IP
.EX
groff \-k \-s \-S \-Tdvi grnexmpl.g
.EE
.RE
.
-.IP
so no additional option was added by
.BR grog .
As no option
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [groff] 01/01: Cease abusing .IP in running text, it's bad style and not safe.,
Eric S. Raymond <=