Update of bug #53547 (project groff):
Status: None => In Progress
_______________________________________________________
Follow-up Comment #1:
I concur with the following classes of change:
1. Change - to \- if it means a minus sign.
2. Use a macro to change to the italic font, instead of \fI [1], if possible.
The macros have the italic corrections, but "\c" removes them or add the
italic corrections.
3. Add a comma before "and", "or", or "nor" if a series contains three or more
words. [In other words, use the Oxford comma.]
4. Change '[' and ']' from bold to roman. [In command synopses, yes--only
literals should be rendered in bold.]
I do not concur with the following class of change:
5. Surround a block of comments with the macros ".ig" and "..". [In my
opinion, the groff man pages should become exemplars of good man page style,
and while .ig and .. are not much harder to understand than "#if 0" and a
corresponding "#endif", that little bit makes a difference. Comment leaders
are nearly universal in programming languages, and require only a finite
automaton to parse, instead of a pushdown automaton or worse. I've taught my
Vim installation how to recognize *roff comments, so even reflowing text is no
longer a problem for me.]
Changes I'm still evaluating:
6. Arguments to the macro ".TP" (uses '.itc') [We went back and forth a whole
lot in this, didn't we?]
7. Use '\!' and '\c' to use two input lines as a one line of arguments. [I
need to brush up on \# vs. \! and the interaction each has with \c.]
_______________________________________________________
Reply to this item at:
<http://savannah.gnu.org/bugs/?53547>
_______________________________________________
Message sent via/by Savannah
http://savannah.gnu.org/
_______________________________________________
bug-groff mailing list
[email protected]
https://lists.gnu.org/mailman/listinfo/bug-groff
