[PATCH] man: update SEE ALSO references in man pages
Jani Nikula
jani at nikula.org
Tue Mar 13 11:35:04 PDT 2012
On Tue, 13 Mar 2012 13:35:44 -0400, Austin Clements <amdragon at MIT.EDU> wrote:
> Quoth Jani Nikula on Mar 11 at 11:36 pm:
> > Drop references to notmuch-part(1). Reference all man pages. Fix man
> > page section of notmuch-dump(1).
>
> This LGTM, but is it actually what we want? Referencing everything
> from everything seems to defeat the purpose. I would expect
> notmuch(1) to reference everything, but the command manpages to only
> reference notmuch(1) and specific, related commands (e.g., dump and
> restore should reference each other; new should reference hooks;
> count, dump, reply, search, show, and tag should reference
> search-terms; and new, search, and reply should reference config).
Hi Austin, while I agree with you, I think I'll have to leave that bit
for another patch, another time (and possibly another author ;). My
purpose here was to just quickly fix the current references, for which
the logic was that all pages reference all other pages.
BR,
Jani.
More information about the notmuch
mailing list