[groff] 03/04: groff_man*(7): Discuss sections and dashes more.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit 80c4eadb4a4bb6694040a2810cb9b523e166ef0b
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Wed Aug 12 22:19:15 2020 +1000

    groff_man*(7): Discuss sections and dashes more.
    
    * tmac/groff_man.7.man.in:
      + (Description/Document structure macros/.TH): Clarify that the
        "section" argument has nothing to do with the sections _in_ the
        page.  [style] Explain historical reason for this, implying the
        immobility of the clashing terminology.
      + (Description/Portability/\-): [style] Call out this special
        character as the Unix command-line option dash.
---
 tmac/groff_man.7.man.in | 11 ++++++++++-
 1 file changed, 10 insertions(+), 1 deletion(-)

diff --git a/tmac/groff_man.7.man.in b/tmac/groff_man.7.man.in
index f1447f5..055ca0b 100644
--- a/tmac/groff_man.7.man.in
+++ b/tmac/groff_man.7.man.in
@@ -364,8 +364,15 @@ macros.
 .RI " [" header-middle ]
 Define the title of the man page as
 .I title
-and the section as
+and the section of the manual volume as
 .IR section .
+_ifstyle()dnl
+.
+This use of \(lqsection\(rq has nothing to do with the section headings
+otherwise discussed in this page;
+it arises from the organizational scheme of printed and bound Unix
+manuals.
+_endif()dnl
 .
 See
 .IR man (1)
@@ -2206,6 +2213,8 @@ and PDF.
 .B \e\-
 Minus sign or basic Latin hyphen-minus.
 .
+This escape produces the Unix command-line option dash in the output.
+.
 .RB \(lq \- \(rq
 is a hyphen to
 .IR roff ;