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 13:35:44 -0400

To: Jani Nikula

Cc: notmuch@notmuchmail.org

From: Austin Clements


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).

Thread: