gbranden pushed a commit to branch master
in repository groff.
commit 243904f7afd4019148dbb3a5f7c41fd17dbb6b8a
Author: G. Branden Robinson <[email protected]>
AuthorDate: Sun Feb 1 11:08:07 2026 -0600
doc/groff.texi.in: Work around Texinfo's @cite.
References:
*
https://owl.purdue.edu/owl/research_and_citation/apa_style/apa_formatting_and_style_guide/reference_list_articles_in_periodicals.html
*
https://owl.purdue.edu/owl/research_and_citation/mla_style/mla_formatting_and_style_guide/mla_works_cited_periodicals.html
*
https://www.chicagomanualofstyle.org/tools_citationguide/citation-guide-1.html
---
doc/groff.texi.in | 20 +++++++++++++-------
1 file changed, 13 insertions(+), 7 deletions(-)
diff --git a/doc/groff.texi.in b/doc/groff.texi.in
index b43e09c1e..80c8579ef 100644
--- a/doc/groff.texi.in
+++ b/doc/groff.texi.in
@@ -2050,9 +2050,10 @@ formatter, peruse @ref{GNU @command{troff} Reference}
instead.
@cindex basics of macro package usage
@cindex macro package usage, basics of
-@c Texinfo's @cite command conceives only of citations of long-form
-@c works, like books, and forces italics. Article citations are
-@c typically placed in quotation marks instead.
+@c XXX: Texinfo's @cite command conceives only of citations of long-form
+@c works, like books, and forces italics. APA, MLA, and Chicago styles
+@c all agree that article citations are set in roman. MLA and Chicago
+@c furthermore place them within quotation marks.
Let us first survey some basic concepts necessary to use a macro package
fruitfully.@footnote{The remainder of this chapter is based on
``Writing Papers with NROFF using -me'' by Eric@tie{}P.@: Allman,
@@ -5236,9 +5237,6 @@ and adds several of its own.
@itemize @bullet
@item
-@c Texinfo's @cite command conceives only of citations of long-form
-@c works, like books, and forces italics. Article citations are
-@c typically placed in quotation marks instead.
The internals of
@code{groff}
@file{ms}
@@ -5252,6 +5250,10 @@ may not format properly with
Such details include macros whose function was not documented in the
@acronym{AT&T}
@file{ms}
+@c XXX: Texinfo's @cite command conceives only of citations of long-form
+@c works, like books, and forces italics. APA, MLA, and Chicago styles
+@c all agree that article citations are set in roman. MLA and Chicago
+@c furthermore place them within quotation marks.
manual.@footnote{``Typing Documents on the UNIX System: Using the
-ms Macros with Troff and Nroff'', M.@tie{}E.@: Lesk, Bell Laboratories,
1978}
@@ -24312,7 +24314,11 @@ output almost incomprehenible.
The page description language of @acronym{AT&T}
@command{troff} @c AT&T
was first documented in
-@cite{A Typesetter-independent TROFF},
+@c XXX: Texinfo's @cite command conceives only of citations of long-form
+@c works, like books, and forces italics. APA, MLA, and Chicago styles
+@c all agree that article citations are set in roman. MLA and Chicago
+@c furthermore place them within quotation marks.
+``A Typesetter-independent TROFF'',
by Brian Kernighan,
and by 1992 the @acronym{AT&T}
@code{troff} @c AT&T; system
_______________________________________________
groff-commit mailing list
[email protected]
https://lists.gnu.org/mailman/listinfo/groff-commit
