From 7b3709bda86b789bbea05735fa3a110b719d5aa6 Mon Sep 17 00:00:00 2001 From: Jani Nikula Date: Tue, 13 Mar 2012 20:35:04 +0200 Subject: [PATCH] Re: [PATCH] man: update SEE ALSO references in man pages --- 1c/00f6d96dd04afc5538e5171d9a0848e25380dc | 89 +++++++++++++++++++++++ 1 file changed, 89 insertions(+) create mode 100644 1c/00f6d96dd04afc5538e5171d9a0848e25380dc diff --git a/1c/00f6d96dd04afc5538e5171d9a0848e25380dc b/1c/00f6d96dd04afc5538e5171d9a0848e25380dc new file mode 100644 index 000000000..6d86fc709 --- /dev/null +++ b/1c/00f6d96dd04afc5538e5171d9a0848e25380dc @@ -0,0 +1,89 @@ +Return-Path: +X-Original-To: notmuch@notmuchmail.org +Delivered-To: notmuch@notmuchmail.org +Received: from localhost (localhost [127.0.0.1]) + by olra.theworths.org (Postfix) with ESMTP id 8E239431FAF + for ; Tue, 13 Mar 2012 11:35:11 -0700 (PDT) +X-Virus-Scanned: Debian amavisd-new at olra.theworths.org +X-Spam-Flag: NO +X-Spam-Score: -0.7 +X-Spam-Level: +X-Spam-Status: No, score=-0.7 tagged_above=-999 required=5 + tests=[RCVD_IN_DNSWL_LOW=-0.7] autolearn=disabled +Received: from olra.theworths.org ([127.0.0.1]) + by localhost (olra.theworths.org [127.0.0.1]) (amavisd-new, port 10024) + with ESMTP id mczZO+Z4GW2B for ; + Tue, 13 Mar 2012 11:35:11 -0700 (PDT) +Received: from mail-lpp01m010-f53.google.com (mail-lpp01m010-f53.google.com + [209.85.215.53]) (using TLSv1 with cipher RC4-SHA (128/128 bits)) + (No client certificate requested) + by olra.theworths.org (Postfix) with ESMTPS id E1B5F431FAE + for ; Tue, 13 Mar 2012 11:35:10 -0700 (PDT) +Received: by lahc1 with SMTP id c1so792965lah.26 + for ; Tue, 13 Mar 2012 11:35:09 -0700 (PDT) +X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; + d=google.com; s=20120113; + h=from:to:cc:subject:in-reply-to:references:user-agent:date + :message-id:mime-version:content-type:x-gm-message-state; + bh=+remw66LFXZxCOB3rrYjQNfcxWLc+o11BxA83lBy6+0=; + b=o9tAP5Y1NeBbvLXhPcTIepdw+5NEOJy9mRw/+rFaKkn5P6OFb8vszAcSMLJifd6do/ + mEALEBlhzE+PgznfRLdOqaJlfSNGQrNlwpG9iU0dP54nOsVofpSW5bSHpGHXdZccHjke + g0ulU4JKZON7Mjsp+DZ4tfvk/EnaTEily/+OesNwvv95PoSyf25bvIzq0RO6WCAz061j + UBZsriru57Lg0BAE3CksYApvuhQdeJgnKkMRXX71P/EzEELLLbFAPjKoNqtFUh5Wz+b0 + TdfnNOYsGgFBL+erpyj4OOPp6rmTDe01AX74ATgCvebdao7C6ZgpsD3Q68+mWYpBcfU8 + Y1zg== +Received: by 10.152.123.76 with SMTP id ly12mr13220628lab.37.1331663709129; + Tue, 13 Mar 2012 11:35:09 -0700 (PDT) +Received: from localhost (dsl-hkibrasgw4-fe50f800-253.dhcp.inet.fi. + [84.248.80.253]) + by mx.google.com with ESMTPS id ox6sm1166615lab.12.2012.03.13.11.35.06 + (version=SSLv3 cipher=OTHER); Tue, 13 Mar 2012 11:35:07 -0700 (PDT) +From: Jani Nikula +To: Austin Clements +Subject: Re: [PATCH] man: update SEE ALSO references in man pages +In-Reply-To: <20120313173544.GF2787@mit.edu> +References: <1331501776-32185-1-git-send-email-jani@nikula.org> + <20120313173544.GF2787@mit.edu> +User-Agent: Notmuch/0.11.1+295~g780f284 (http://notmuchmail.org) Emacs/23.3.1 + (i686-pc-linux-gnu) +Date: Tue, 13 Mar 2012 20:35:04 +0200 +Message-ID: <8762e8nycn.fsf@nikula.org> +MIME-Version: 1.0 +Content-Type: text/plain; charset=us-ascii +X-Gm-Message-State: + ALoCoQnL9lP0hWS1axMEHtWenHjSYtOEauVnBRj7m3QasWKem914aRh2HI6EK00ETPN8EcRwkLDk +Cc: notmuch@notmuchmail.org +X-BeenThere: notmuch@notmuchmail.org +X-Mailman-Version: 2.1.13 +Precedence: list +List-Id: "Use and development of the notmuch mail system." + +List-Unsubscribe: , + +List-Archive: +List-Post: +List-Help: +List-Subscribe: , + +X-List-Received-Date: Tue, 13 Mar 2012 18:35:11 -0000 + +On Tue, 13 Mar 2012 13:35:44 -0400, Austin Clements 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. -- 2.26.2