[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[groff] 11/12: doc/groff.texi: Tweak.
From: |
G. Branden Robinson |
Subject: |
[groff] 11/12: doc/groff.texi: Tweak. |
Date: |
Mon, 24 Aug 2020 08:15:40 -0400 (EDT) |
gbranden pushed a commit to branch master
in repository groff.
commit 3745d5f1fadeeaa7b1a35b1d4f805b1e95d39584
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Sun Aug 23 21:14:38 2020 +1000
doc/groff.texi: Tweak.
* doc/groff.texi (Manipulating Hyphenation) <\:>: Shorten example; it
was slightly overrunning the right margin in PDF.
<.hy>: Be more helpful to users of U.S. English hyphenation patterns;
suggest modes 4 and 6.
<.hcode, .hpfcode>: Place ellipsis dots _after_ grouped arguments;
i.e., say "[a b] ..." instead of "[a b ...]".
<.hys>: Say "inter-word" space instead of "word space", for clarity
and consistency with description of .ss request.
* man/groff.7.man:
* man/groff_diff.7.man: Sync with Texinfo changes above.
---
doc/groff.texi | 14 +++++++-------
man/groff.7.man | 2 +-
man/groff_diff.7.man | 5 ++---
3 files changed, 10 insertions(+), 11 deletions(-)
diff --git a/doc/groff.texi b/doc/groff.texi
index 317d94d..1ce6ab9 100644
--- a/doc/groff.texi
+++ b/doc/groff.texi
@@ -6676,7 +6676,7 @@ You can use @code{\:} and @code{\%} in combination to
control breaking
of a filename or URL.
@Example
-@dots{} check the \%/var/log/\:\%httpd/\:\%access_log file @dots{}
+@dots{} check \%/var/log/\:\%httpd/\:\%access_log @dots{}
@endExample
@endDefesc
@@ -6822,8 +6822,8 @@ instead of the correct `split- ting'. U.S. English
patterns as
distributed with GNU @code{troff} need two characters at the beginning
and three characters at the end; this means that value@tie{}4 of
@code{hy} is mandatory. Value@tie{}8 is possible as an additional
-restriction, but values@tie{}1 (the default!), 16, and@tie{}32 should be
-avoided.
+restriction, but values@tie{}16 and@tie{}32 should be avoided, as should
+mode@tie{}1 (the default!). Modes@tie{}4 and@tie{}6 are typical.
A table of left and right minimum values for hyphenation as needed by
the patterns distributed with GNU @code{troff} follows; see the
@@ -6862,7 +6862,7 @@ not remembered.
@DefreqList {hpf, pattern-file}
@DefreqItemx {hpfa, pattern-file}
-@DefreqListEndx {hpfcode, a b [c d @dots{}]}
+@DefreqListEndx {hpfcode, a b [c d] @dots{}}
@cindex hyphenation patterns (@code{hpf})
@cindex patterns for hyphenation (@code{hpf})
Read hyphenation patterns from @var{pattern-file}. This file is sought
@@ -6942,7 +6942,7 @@ If no @code{hpf} request is specified (either in the
document, in a
@code{troff} won't automatically hyphenate at all.
@endDefreq
-@Defreq {hcode, c1 code1 [c2 code2 @dots{}]}
+@Defreq {hcode, c1 code1 [c2 code2] @dots{}}
@cindex hyphenation code (@code{hcode})
@cindex code, hyphenation (@code{hcode})
Set the hyphenation code of character @var{c1} to @var{code1}, that of
@@ -7056,8 +7056,8 @@ register.
@cindex @code{ad} request, and hyphenation space
Suppress hyphenation of the line in adjustment modes @samp{b} or
@samp{n} if it can be justified by adding no more than
-@var{hyphenation-space} extra space to each word space. Without an
-argument, the hyphenation space adjustment threshold is set to its
+@var{hyphenation-space} extra space to each inter-word space. Without
+an argument, the hyphenation space adjustment threshold is set to its
default value, 0. The default scaling indicator is @samp{m}. The
hyphenation space adjustment threshold is associated with the current
environment (@pxref{Environments}).
diff --git a/man/groff.7.man b/man/groff.7.man
index 666343d..c3acbbe 100644
--- a/man/groff.7.man
+++ b/man/groff.7.man
@@ -1938,7 +1938,7 @@ or
.RB \[lq] n \[rq]
if it can be justified by adding no more than
.I hyphenation-space
-extra space to each word space
+extra space to each inter-word space
(default scaling indicator\~\c
.scaleindicator m ).
.
diff --git a/man/groff_diff.7.man b/man/groff_diff.7.man
index 8c01904..78a0662 100644
--- a/man/groff_diff.7.man
+++ b/man/groff_diff.7.man
@@ -841,8 +841,7 @@ in combination to control breaking of a filename or URL.
.RS
.IP
.EX
-\&.\|.\|.\& check the \%/var/log/\:httpd/\:access_log file \
-\&.\|.\|.\&
+\&.\|.\|.\& check \e%/var/log/\e:\e%httpd/\e:\e%access_log .\|.\|.
.EE
.RE
.RE
@@ -2370,7 +2369,7 @@ or
.RB \[lq] n \[rq],
if it can be justified by adding no more than
.I hyphenation-space
-extra space to each word space.
+extra space to each inter-word space.
.
Without an argument,
the hyphenation space adjustment threshold is set to its default value,
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [groff] 11/12: doc/groff.texi: Tweak.,
G. Branden Robinson <=