Kyle Meyer <[email protected]> wrote: > Eric Wong writes: > > > It makes L</--augment> look nicer without resorting to > > L<--augment|/-a, --augment> and similarly verbose nastiness. > > > > Having each option as a separate =item (with a blank line in > > between each =item) seems to be the preferred style used within > > Perl core documentation (I used perlrun.pod as an example), > > so we'll follow Perl core style, here. > > Okay, thanks providing a rationale for using separate lines. I went > with the single line style based on some combination of a subjective > visual preference and looking at other manpages (presumably git's).
Yeah, also the existing public-inbox-* manpages were using commas or slash; probably because I based them on git manpages :x > > This needs to be done for other manpages, at some point... > > I should be able to get to another round of lei doc updates this > weekend. Thanks in advance. Also, in response to https://public-inbox.org/meta/[email protected]/ w.r.t. lei-convert; I think it's helpful to document since the WWW interface provides gzipped mboxrd and IMAP|Maildir are probably the most commonly used. -- unsubscribe: one-click, see List-Unsubscribe header archive: https://public-inbox.org/meta/
