[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