[groff] 29/31: groff(1) (Language): Revise.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit 68a73849541e37ec784466d9f2f1c43f6b97cb94
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Sun Jul 25 15:57:31 2021 +1000

    groff(1) (Language): Revise.
    
    Rename from "Programming language" and heavily revise.
---
 src/roff/groff/groff.1.man | 42 ++++++++++++++++++++++++++----------------
 1 file changed, 26 insertions(+), 16 deletions(-)

diff --git a/src/roff/groff/groff.1.man b/src/roff/groff/groff.1.man
index 59cedeb..8d759df 100644
--- a/src/roff/groff/groff.1.man
+++ b/src/roff/groff/groff.1.man
@@ -853,29 +853,39 @@ command line to format a document.
 .
 .
 .\" ====================================================================
-.SS "Programming language"
+.SS Language
 .\" ====================================================================
 .
-General concepts common to all
+Input to a
 .I roff
-programming languages are described in
-.BR roff (@MAN7EXT@).
+system is in plain text interleaved with control lines and escape
+sequences.
 .
+The combination constitutes a document in one of a family of languages
+we also call
+.IR roff ;
+see
+.IR roff (@MAN7EXT@)
+for background.
+.
+An overview of GNU
+.I roff
+language syntax and features,
+including lists of all supported escape sequences,
+requests,
+and pre-defined registers,
+can be found in
+.IR groff (@MAN7EXT@).
 .
-.P
-The
 .I groff
-extensions to the classical
+extensions to the AT&T
 .I troff
-language are documented in
-.BR \%groff_diff (@MAN7EXT@).
-.
-.
-.P
-An overview of language features,
-including all supported escapes and requests,
-can be found in
-.BR groff (@MAN7EXT@).
+language,
+a common subset of
+.I roff
+dialects extant today,
+are detailed in
+.IR \%groff_diff (@MAN7EXT@).
 .
 .
 .\" ====================================================================