Re: [PATCH] man: update SEE ALSO references in man pages

[Jani Nikula <jani@nikula.org>]

On Tue, 13 Mar 2012 13:35:44 -0400, Austin Clements <amdragon@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.