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

[Thorsten Glaser]

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

Well, maybe one thing. SYNOPSIS is not justified in nroff/UCB mdoc: (this is
with the latest commit to change the continuation indent already applied)



SYNOPSIS
     timerdday [-+abCefhiklmnprUuvXx] [-+o option] [-T [!]tty|-] [file [arg1
               ...]]
     timerdday [-+abCefhiklmnprUuvXx] [-+o option] [-T [!]tty|-] -c cmd [arg0
               ...]
     builtin-name foobar foobar foobar foobar foobar foobar foobar foobar
               [argument ...]

SYNOPSIS
     void
     timerdday(struct-timespec *earliest, struct-timespec *latest,
         struct-timespec *resolution);

     void
     tm(struct-timespec *earliest, struct-timespec *latest,
         struct-timespec *resolution);



… but it is in gnroff, looking bad:



SYNOPSIS
       timerdday    [-+abCefhiklmnprUuvXx]    [-+o   option]   [-T  
[!]tty|-]
                 [file [arg1 ...]]
       timerdday [-+abCefhiklmnprUuvXx] [-+o  option]  [-T  [!]tty|-]  -c 
cmd
                 [arg0 ...]
       builtin‐name  foobar  foobar  foobar foobar foobar foobar foobar
foobar
                 [argument ...]

SYNOPSIS
       void
       timerdday(struct-timespec    *earliest,    struct-timespec    
*latest,
           struct-timespec *resolution);

       void
       tm(struct-timespec       *earliest,       struct-timespec     
*latest,
           struct-timespec *resolution);



I’m normally very much a fan of justified paragraphs, just maybe not for the
SYNOPSIS…



    _______________________________________________________

Reply to this item at:

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

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