Page MenuHomeFreeBSD

Document undocumented indent(1) options badp/nbadp, bs/nbs, and lc.
ClosedPublic

Authored by pfg on Dec 2 2016, 1:41 AM.
Tags
None
Referenced Files
Unknown Object (File)
Sat, Apr 27, 11:33 PM
Unknown Object (File)
Sat, Apr 27, 10:22 PM
Unknown Object (File)
Jan 8 2024, 6:33 PM
Unknown Object (File)
Dec 27 2023, 7:44 PM
Unknown Object (File)
Dec 27 2023, 7:36 PM
Unknown Object (File)
Dec 20 2023, 2:08 AM
Unknown Object (File)
Nov 8 2023, 6:32 AM
Unknown Object (File)
Nov 6 2023, 4:05 PM
Subscribers

Diff Detail

Repository
rS FreeBSD src repository - subversion
Lint
Lint Passed
Unit
No Test Coverage
Build Status
Buildable 6118
Build 6375: arc lint + arc unit

Event Timeline

pfg retitled this revision from to Document undocumented indent(1) options badp/nbadp, bs/nbs, and lc..
pfg updated this object.
pfg edited the test plan for this revision. (Show Details)
pfg added a reviewer: wblock.
pfg added a subscriber: pstef.

A few corrections. Running textproc/igor and mandoc -Tlint will find errors in man pages like this.

usr.bin/indent/indent.1
153

You need a line break after the sentence stop here.

195

Another line break here.

340

Another... well, you guessed it. ;-)

pfg marked 2 inline comments as done.
pfg edited edge metadata.

Use a newline when finishing a sentence.

Done, thanks!

usr.bin/indent/indent.1
151

I am wondering, is it OK to start a line with a comma? Perhaps this comma is also reduntant.

This revision was automatically updated to reflect the committed changes.
bjk added inline comments.
usr.bin/indent/indent.1
151

Generally the comma would go on the previous line, with a space between "bad" and the comma. I forget whether the version as-committed will end up rendering with a space before the comma. You're also right that this particular comma is not strictly needed.

usr.bin/indent/indent.1
151

When spoken, it doesn't quite sound right without the pause represented by the comma.

To render correctly, the comma needs to be on the same line as the .Fl macro:

.Fl bad ,

The space before the comma there is a delimiter to the macro. It renders the "bad" as the flag, then adds the comma without a space: bad,

It's hard to think of any time a line beginning with a comma with be rendered correctly.