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

diff --git a/1c/00f6d96dd04afc5538e5171d9a0848e25380dc b/1c/00f6d96dd04afc5538e5171d9a0848e25380dc
new file mode 100644 (file)
index 0000000..6d86fc7
--- /dev/null
+++ b/1c/00f6d96dd04afc5538e5171d9a0848e25380dc
@@ -0,0 +1,89 @@
+Return-Path: <jani@nikula.org>\r
+X-Original-To: notmuch@notmuchmail.org\r
+Delivered-To: notmuch@notmuchmail.org\r
+Received: from localhost (localhost [127.0.0.1])\r
+       by olra.theworths.org (Postfix) with ESMTP id 8E239431FAF\r
+       for <notmuch@notmuchmail.org>; Tue, 13 Mar 2012 11:35:11 -0700 (PDT)\r
+X-Virus-Scanned: Debian amavisd-new at olra.theworths.org\r
+X-Spam-Flag: NO\r
+X-Spam-Score: -0.7\r
+X-Spam-Level: \r
+X-Spam-Status: No, score=-0.7 tagged_above=-999 required=5\r
+       tests=[RCVD_IN_DNSWL_LOW=-0.7] autolearn=disabled\r
+Received: from olra.theworths.org ([127.0.0.1])\r
+       by localhost (olra.theworths.org [127.0.0.1]) (amavisd-new, port 10024)\r
+       with ESMTP id mczZO+Z4GW2B for <notmuch@notmuchmail.org>;\r
+       Tue, 13 Mar 2012 11:35:11 -0700 (PDT)\r
+Received: from mail-lpp01m010-f53.google.com (mail-lpp01m010-f53.google.com\r
+       [209.85.215.53]) (using TLSv1 with cipher RC4-SHA (128/128 bits))\r
+       (No client certificate requested)\r
+       by olra.theworths.org (Postfix) with ESMTPS id E1B5F431FAE\r
+       for <notmuch@notmuchmail.org>; Tue, 13 Mar 2012 11:35:10 -0700 (PDT)\r
+Received: by lahc1 with SMTP id c1so792965lah.26\r
+       for <notmuch@notmuchmail.org>; Tue, 13 Mar 2012 11:35:09 -0700 (PDT)\r
+X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;\r
+       d=google.com; s=20120113;\r
+       h=from:to:cc:subject:in-reply-to:references:user-agent:date\r
+       :message-id:mime-version:content-type:x-gm-message-state;\r
+       bh=+remw66LFXZxCOB3rrYjQNfcxWLc+o11BxA83lBy6+0=;\r
+       b=o9tAP5Y1NeBbvLXhPcTIepdw+5NEOJy9mRw/+rFaKkn5P6OFb8vszAcSMLJifd6do/\r
+       mEALEBlhzE+PgznfRLdOqaJlfSNGQrNlwpG9iU0dP54nOsVofpSW5bSHpGHXdZccHjke\r
+       g0ulU4JKZON7Mjsp+DZ4tfvk/EnaTEily/+OesNwvv95PoSyf25bvIzq0RO6WCAz061j\r
+       UBZsriru57Lg0BAE3CksYApvuhQdeJgnKkMRXX71P/EzEELLLbFAPjKoNqtFUh5Wz+b0\r
+       TdfnNOYsGgFBL+erpyj4OOPp6rmTDe01AX74ATgCvebdao7C6ZgpsD3Q68+mWYpBcfU8\r
+       Y1zg==\r
+Received: by 10.152.123.76 with SMTP id ly12mr13220628lab.37.1331663709129;\r
+       Tue, 13 Mar 2012 11:35:09 -0700 (PDT)\r
+Received: from localhost (dsl-hkibrasgw4-fe50f800-253.dhcp.inet.fi.\r
+       [84.248.80.253])\r
+       by mx.google.com with ESMTPS id ox6sm1166615lab.12.2012.03.13.11.35.06\r
+       (version=SSLv3 cipher=OTHER); Tue, 13 Mar 2012 11:35:07 -0700 (PDT)\r
+From: Jani Nikula <jani@nikula.org>\r
+To: Austin Clements <amdragon@MIT.EDU>\r
+Subject: Re: [PATCH] man: update SEE ALSO references in man pages\r
+In-Reply-To: <20120313173544.GF2787@mit.edu>\r
+References: <1331501776-32185-1-git-send-email-jani@nikula.org>\r
+       <20120313173544.GF2787@mit.edu>\r
+User-Agent: Notmuch/0.11.1+295~g780f284 (http://notmuchmail.org) Emacs/23.3.1\r
+       (i686-pc-linux-gnu)\r
+Date: Tue, 13 Mar 2012 20:35:04 +0200\r
+Message-ID: <8762e8nycn.fsf@nikula.org>\r
+MIME-Version: 1.0\r
+Content-Type: text/plain; charset=us-ascii\r
+X-Gm-Message-State:\r
+ ALoCoQnL9lP0hWS1axMEHtWenHjSYtOEauVnBRj7m3QasWKem914aRh2HI6EK00ETPN8EcRwkLDk\r
+Cc: notmuch@notmuchmail.org\r
+X-BeenThere: notmuch@notmuchmail.org\r
+X-Mailman-Version: 2.1.13\r
+Precedence: list\r
+List-Id: "Use and development of the notmuch mail system."\r
+       <notmuch.notmuchmail.org>\r
+List-Unsubscribe: <http://notmuchmail.org/mailman/options/notmuch>,\r
+       <mailto:notmuch-request@notmuchmail.org?subject=unsubscribe>\r
+List-Archive: <http://notmuchmail.org/pipermail/notmuch>\r
+List-Post: <mailto:notmuch@notmuchmail.org>\r
+List-Help: <mailto:notmuch-request@notmuchmail.org?subject=help>\r
+List-Subscribe: <http://notmuchmail.org/mailman/listinfo/notmuch>,\r
+       <mailto:notmuch-request@notmuchmail.org?subject=subscribe>\r
+X-List-Received-Date: Tue, 13 Mar 2012 18:35:11 -0000\r
+\r
+On Tue, 13 Mar 2012 13:35:44 -0400, Austin Clements <amdragon@MIT.EDU> wrote:\r
+> Quoth Jani Nikula on Mar 11 at 11:36 pm:\r
+> > Drop references to notmuch-part(1). Reference all man pages. Fix man\r
+> > page section of notmuch-dump(1).\r
+> \r
+> This LGTM, but is it actually what we want?  Referencing everything\r
+> from everything seems to defeat the purpose.  I would expect\r
+> notmuch(1) to reference everything, but the command manpages to only\r
+> reference notmuch(1) and specific, related commands (e.g., dump and\r
+> restore should reference each other; new should reference hooks;\r
+> count, dump, reply, search, show, and tag should reference\r
+> search-terms; and new, search, and reply should reference config).\r
+\r
+Hi Austin, while I agree with you, I think I'll have to leave that bit\r
+for another patch, another time (and possibly another author ;). My\r
+purpose here was to just quickly fix the current references, for which\r
+the logic was that all pages reference all other pages.\r
+\r
+BR,\r
+Jani.\r