Source-Changes-D archive

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index][Old Index]

.Bl -width (Was: CVS commit: src/sbin/shutdown)



On Wed, Feb 15, 2023 at 01:55:17 +0000, Jan Schaumann wrote:

> Module Name:	src
> Committed By:	jschauma
> Date:		Wed Feb 15 01:55:17 UTC 2023
> 
> Modified Files:
> 	src/sbin/shutdown: shutdown.8
> 
> Log Message:
> adjust width of flag arg to align more nicely

Please, can people at least *skim* through mdoc.samples(7) *once*...

It's best to use default width.  Yes, some option .It may require a
line break, but it gives consistent formatting across man pages.

  .Bl -tag -width Fl

If for some reason you absolutely must tailor the formatting for the
contents of the list, don't do this cargo cult padding of "-width"
that doesn't even work to begin with, b/c PostScript and other
backends do exist.

What you meant to say was really:

  .Bl -tag -width ".Fl b Ar bootstr"
  .It Fl b Ar bootstr

That will properly use the width of the specified item *as formatted
by the current backend*.

-uwe


Home | Main Index | Thread Index | Old Index