[bug #63958] [mdoc] decide how to set up hanging indent in Synopsis sections

[G. Branden Robinson]

Follow-up Comment #12, bug #63958 (project groff):

[comment #11 comment #11:]
> Sorry, didn’t know about the formatting, it’s not all that clear in
lynx, and the preview looked okay… in lynx, at least.

I think about 18 months ago I tried moving to lynx for my GNU Savannah
interactions.  It was just too damn painful to use the multi-line text edit
controls.
 
> I very much don’t like the mdocml output that doesn’t indent
continuation lines. (On the other hand, UCB mdoc indents “too much”, per
style(9) continuation indent is 4 spaces, not a tab like main indent.)

How do you find _groff mdoc_'s continuation indentation amount?

> But at the same time, the baseline in groff is too far to the right.

"Baseline" is a dangerous word here.  In typography, and particularly in
_groff_ documentation, it's an italicized concept.

_roff_(7):


    While the formatter (and, later, output driver) is processing a
    page, it keeps track of its drawing position, which is the location
    at which the next glyph will be written, from which the next motion
    will be measured, or where a geometric object will commence
    rendering.  Notionally, glyphs are drawn from the text baseline
    upward and to the right.  (groff does not yet support right‐to‐left
    scripts.)  The text baseline is a (usually invisible) line upon
    which the glyphs of a typeface are aligned.  A glyph therefore
    “starts” at its bottom‐left corner.


But I understand you to mean the base/default paragraph indentation amount,
and yup, we're back over to bug #64018 again.  ;-)


    _______________________________________________________

Reply to this item at:

  <https://savannah.gnu.org/bugs/?63958>

_______________________________________________
Message sent via Savannah
https://savannah.gnu.org/