[groff] 23/28: doc/groff.texi: Improve examples.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit a4b08776fce9ab3258269a254182e293969b7e37
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Sat Jun 19 12:29:08 2021 +1000

    doc/groff.texi: Improve examples.
    
    I've long been bothered by the TeX logo examples I added; to fit them
    within the margins of the print version of out Texinfo manual I had to
    reduce the precision of the movements by quite a bit.  The idea of
    propagating such a crude mockery of Knuth's logo filled me with horror.
    
    So, change it.
    
    * doc/groff.texi (Strings): Improve examples.
      (Page Motions): Add trailing '\"' to TeX logo example that _does_ fit.
      Add footnote to explain its presence by cross reference.
---
 doc/groff.texi | 10 ++++++----
 1 file changed, 6 insertions(+), 4 deletions(-)

diff --git a/doc/groff.texi b/doc/groff.texi
index 30f2e79..24e2ba2 100644
--- a/doc/groff.texi
+++ b/doc/groff.texi
@@ -11163,7 +11163,7 @@ can introduce unwanted space into a string when they 
are set off from
 the material they annotate, as is conventional.
 
 @Example
-.ds TeX T\h'-.2m'\v'.2m'E\v'-.2m'\h'-.1m'X \" Knuth's TeX
+.ds H2O H\v'+.3m'\s'-2'2\v'-.3m'\s0O \" water
 @endExample
 
 @noindent
@@ -11171,7 +11171,7 @@ Instead, place the comment on another line or put the 
comment escape
 immediately adjacent to the last character of the string.
 
 @Example
-.ds TeX T\h'-.2m'\v'.2m'E\v'-.2m'\h'-.1m'X\" Knuth's TeX
+.ds H2O H\v'+.3m'\s'-2'2\v'-.3m'\s0O\" water
 @endExample
 
 It is good style to end string definitions (and appendments; see below)
@@ -12577,10 +12577,12 @@ instead (even on terminals).
 An unbreakable space the width of a numeral in the current font.
 @endDefesc
 
-The following string definition sets the @TeX{} logo.
+The following string definition sets the @TeX{}
+logo.@footnote{@ref{Strings}, for an explanation of the trailing
+@samp{\"}.}
 
 @Example
-.ds TeX T\h'-.1667m'\v'.224m'E\v'-.224m'\h'-.125m'X
+.ds TeX T\h'-.1667m'\v'.224m'E\v'-.224m'\h'-.125m'X\"
 @endExample
 
 @DefescList {\\w, @code{'}, text, @code{'}}