[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[bug #59795] interaction of .na and '.ad l' documented incorrectly
From: |
G. Branden Robinson |
Subject: |
[bug #59795] interaction of .na and '.ad l' documented incorrectly |
Date: |
Sun, 24 Jan 2021 01:20:32 -0500 (EST) |
User-agent: |
Mozilla/5.0 (X11; Linux x86_64; rv:78.0) Gecko/20100101 Firefox/78.0 |
Update of bug #59795 (project groff):
Status: In Progress => Fixed
Open/Closed: Open => Closed
Planned Release: None => 1.23.0
_______________________________________________________
Follow-up Comment #7:
commit e79f5314db2c474d0117e093c9b0abc1de5ced78
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
Date: Sun Jan 24 16:00:08 2021 +1100
doc/groff.texi: Update filling/adjustment matter.
* doc/groff.texi (Manipulating Filling and Adjustment): Clarify synonymy
of ".na" and ".ad l".
Thanks to Bjarni Ingi Gislason for pointing out the potential for
confusion.
Fixes <https://savannah.gnu.org/bugs/index.php?59795>.
Also:
- Define the concept of a "pending output line", including index
entry. (Some call this a "partially collected line".)
- Use this concept consistently in description of requests (in this
node) that cause breaks.
- Update .br example to illustrate usage with both control characters.
- Use the more idiomatic noun "adjustment" instead of "adjusting".
- Say "GNU troff" instead of "gtroff".
- Clarify "status" of filling and adjustment as "enablement status",
reflecting their boolean state (and in the latter case to
distinguish it from the available "modes" of adjustment).
- Clarify when a change to adjustment mode takes effect (it does _not_
cause a break).
- Supply possible mnemonic for ".ad n"--adjust "normally" (for *roff).
- Tweak '.ad' example to use more suggestive example text.
- Warn people off assuming that values of the .j register are stable
across implementations.
- Add .ll request to "\p" example to ease reproducibility.
- Describe .ce and .rj better, fronting essential information.
- Adjust ".ad c" and ".ce" example to use macro for repeated text,
place typographical quotes (if available) in example output, and
match break locations with actual groff output.
- Describe .rj in its own right, not in terms of .ce.
- Tighten wording.
- Move @codequote* commands to mark this node as reviewed for correct
grave accent and apostrophe glyph usage.
_______________________________________________________
Reply to this item at:
<https://savannah.gnu.org/bugs/?59795>
_______________________________________________
Message sent via Savannah
https://savannah.gnu.org/
- [bug #59795] [PATCH] troff/env.cpp: fix wrong restoration of link adjustment after '.na' and '.ad', Bjarni Ingi Gislason, 2021/01/01
- [bug #59795] [PATCH] troff/env.cpp: fix wrong restoration of line adjustment after '.na' and '.ad', G. Branden Robinson, 2021/01/18
- [bug #59795] [PATCH] troff/env.cpp: fix wrong restoration of line adjustment after '.na' and '.ad', G. Branden Robinson, 2021/01/18
- [bug #59795] [PATCH] troff/env.cpp: fix wrong restoration of line adjustment after '.na' and '.ad', Dave, 2021/01/21
- [bug #59795] [PATCH] troff/env.cpp: fix wrong restoration of line adjustment after '.na' and '.ad', Dave, 2021/01/21
- [bug #59795] interaction of .na and '.ad l' documented incorrectly, G. Branden Robinson, 2021/01/23
- [bug #59795] interaction of .na and '.ad l' documented incorrectly, G. Branden Robinson, 2021/01/23
- [bug #59795] interaction of .na and '.ad l' documented incorrectly,
G. Branden Robinson <=
- [bug #59795] interaction of .na and '.ad l' documented incorrectly, G. Branden Robinson, 2021/01/24
- [bug #59795] interaction of .na and '.ad l' documented incorrectly, G. Branden Robinson, 2021/01/24
- [bug #59795] interaction of .na and '.ad l' documented incorrectly, G. Branden Robinson, 2021/01/24
- [bug #59795] interaction of .na and '.ad l' documented incorrectly, G. Branden Robinson, 2021/01/24
- [bug #59795] interaction of .na and '.ad l' documented incorrectly, G. Branden Robinson, 2021/01/25
- [bug #59795] interaction of .na and '.ad l' documented incorrectly, G. Branden Robinson, 2021/01/27
- [bug #59795] interaction of .na and '.ad l' documented incorrectly, Dave, 2021/01/27
- [bug #59795] interaction of .na and '.ad l' documented incorrectly, G. Branden Robinson, 2021/01/28