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

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

Date: Tue, 13 Mar 2012 20:35:04 +0200

To: Austin Clements

Cc: notmuch@notmuchmail.org

From: Jani Nikula


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.

Thread: