ff/9adf05698775e5754c3165df13bc38780aadd9

   1 Return-Path: <amdragon@mit.edu>\r
   2 X-Original-To: notmuch@notmuchmail.org\r
   3 Delivered-To: notmuch@notmuchmail.org\r
   4 Received: from localhost (localhost [127.0.0.1])\r
   5         by olra.theworths.org (Postfix) with ESMTP id C2CD0431FB6\r
   6         for <notmuch@notmuchmail.org>; Tue,  4 Jun 2013 06:37:54 -0700 (PDT)\r
   7 X-Virus-Scanned: Debian amavisd-new at olra.theworths.org\r
   8 X-Spam-Flag: NO\r
   9 X-Spam-Score: -0.7\r
  10 X-Spam-Level: \r
  11 X-Spam-Status: No, score=-0.7 tagged_above=-999 required=5\r
  12         tests=[RCVD_IN_DNSWL_LOW=-0.7] autolearn=disabled\r
  13 Received: from olra.theworths.org ([127.0.0.1])\r
  14         by localhost (olra.theworths.org [127.0.0.1]) (amavisd-new, port 10024)\r
  15         with ESMTP id RnpqIao62csw for <notmuch@notmuchmail.org>;\r
  16         Tue,  4 Jun 2013 06:37:45 -0700 (PDT)\r
  17 Received: from dmz-mailsec-scanner-5.mit.edu (dmz-mailsec-scanner-5.mit.edu\r
  18         [18.7.68.34])\r
  19         by olra.theworths.org (Postfix) with ESMTP id 0B6BC431FAE\r
  20         for <notmuch@notmuchmail.org>; Tue,  4 Jun 2013 06:37:44 -0700 (PDT)\r
  21 X-AuditID: 12074422-b7f5b6d00000095d-2f-51adeda868ca\r
  22 Received: from mailhub-auth-1.mit.edu ( [18.9.21.35])\r
  23         by dmz-mailsec-scanner-5.mit.edu (Symantec Messaging Gateway) with SMTP\r
  24         id 9C.70.02397.8ADEDA15; Tue,  4 Jun 2013 09:37:44 -0400 (EDT)\r
  25 Received: from outgoing.mit.edu (outgoing-auth-1.mit.edu [18.9.28.11])\r
  26         by mailhub-auth-1.mit.edu (8.13.8/8.9.2) with ESMTP id r54DbgVw020085; \r
  27         Tue, 4 Jun 2013 09:37:43 -0400\r
  28 Received: from awakening.csail.mit.edu (awakening.csail.mit.edu [18.26.4.91])\r
  29         (authenticated bits=0)\r
  30         (User authenticated as amdragon@ATHENA.MIT.EDU)\r
  31         by outgoing.mit.edu (8.13.8/8.12.4) with ESMTP id r54DbeFZ019617\r
  32         (version=TLSv1/SSLv3 cipher=DHE-RSA-AES128-SHA bits=128 verify=NOT);\r
  33         Tue, 4 Jun 2013 09:37:41 -0400\r
  34 Received: from amthrax by awakening.csail.mit.edu with local (Exim 4.80)\r
  35         (envelope-from <amdragon@mit.edu>)\r
  36         id 1UjrQh-0007yV-Hf; Tue, 04 Jun 2013 09:37:39 -0400\r
  37 Date: Tue, 4 Jun 2013 09:37:38 -0400\r
  38 From: Austin Clements <amdragon@MIT.EDU>\r
  39 To: David Bremner <david@tethera.net>\r
  40 Subject: Re: [PATCH] emacs: remove hardcoded defaults values from docstrings\r
  41 Message-ID: <20130604133738.GL5999@mit.edu>\r
  42 References: <1370181885-23021-1-git-send-email-david@tethera.net>\r
  43         <20130604040102.GJ5999@mit.edu> <m2ppw275hs.fsf@guru.guru-group.fi>\r
  44         <8738syrtsy.fsf@zancas.localnet>\r
  45 MIME-Version: 1.0\r
  46 Content-Type: text/plain; charset=us-ascii\r
  47 Content-Disposition: inline\r
  48 In-Reply-To: <8738syrtsy.fsf@zancas.localnet>\r
  49 User-Agent: Mutt/1.5.21 (2010-09-15)\r
  50 X-Brightmail-Tracker:\r
  51  H4sIAAAAAAAAA+NgFprJKsWRmVeSWpSXmKPExsUixCmqrLvi7dpAg6uPVC1utHYzWly/OZPZ\r
  52         4s3KeawOzB6Hvy5k8Xi26hazx5ZD75kDmKO4bFJSczLLUov07RK4Mn4vnMZW8I+r4u164wbG\r
  53         xxxdjJwcEgImEts+f2WEsMUkLtxbz9bFyMUhJLCPUWJW8y0oZwOjxKuG++wQzikmiYVtS6Ay\r
  54         Sxgl1i1ZywLSzyKgItHR/p4ZxGYT0JDYtn852FwRAVWJq9smAzVwcDAL2EpMvRIDEhYW8JG4\r
  55         v/EaG4jNK6Atse/7DFaImWsYJQ5fbWGBSAhKnJz5BMxmFtCSuPHvJRPEHGmJ5f/AXuAU0JU4\r
  56         t/Qo2FpRoBOmnNzGNoFRaBaS7llIumchdC9gZF7FKJuSW6Wbm5iZU5yarFucnJiXl1qka6qX\r
  57         m1mil5pSuokRFOrsLko7GH8eVDrEKMDBqMTDq7hlTaAQa2JZcWXuIUZJDiYlUd7nt9YGCvEl\r
  58         5adUZiQWZ8QXleakFh9ilOBgVhLhVb4GlONNSaysSi3Kh0lJc7AoifNeS7npLySQnliSmp2a\r
  59         WpBaBJOV4eBQkuCd+QaoUbAoNT21Ii0zpwQhzcTBCTKcB2j4WZAa3uKCxNzizHSI/ClGXY4Z\r
  60         fVPeMQqx5OXnpUqJ8z4EKRIAKcoozYObA0tRrxjFgd4S5j0PUsUDTG9wk14BLWECWjL59SqQ\r
  61         JSWJCCmpBsb5Ps1l79xve7Fsmf5n62y52f0lk3SiGLxajq5sLJ2xb/LHGjX2FrlDlgu047WP\r
  62         5x7k3lhSd6dkRtpZ0Q3RO1ucDGaFnRPbPm/xe38ziZt/L7u+u+/PvCjupIPWZcbzk5b1Hk2M\r
  63         E0hqOqPgX9j0eeKh1YFHUhYdX3kyuVJH3nT1xZUlVaxrEjcosRRnJBpqMRcVJwIAxR6zCiwD        AAA=\r
  64 Cc: Tomi Ollila <tomi.ollila@iki.fi>, notmuch@notmuchmail.org\r
  65 X-BeenThere: notmuch@notmuchmail.org\r
  66 X-Mailman-Version: 2.1.13\r
  67 Precedence: list\r
  68 List-Id: "Use and development of the notmuch mail system."\r
  69         <notmuch.notmuchmail.org>\r
  70 List-Unsubscribe: <http://notmuchmail.org/mailman/options/notmuch>,\r
  71         <mailto:notmuch-request@notmuchmail.org?subject=unsubscribe>\r
  72 List-Archive: <http://notmuchmail.org/pipermail/notmuch>\r
  73 List-Post: <mailto:notmuch@notmuchmail.org>\r
  74 List-Help: <mailto:notmuch-request@notmuchmail.org?subject=help>\r
  75 List-Subscribe: <http://notmuchmail.org/mailman/listinfo/notmuch>,\r
  76         <mailto:notmuch-request@notmuchmail.org?subject=subscribe>\r
  77 X-List-Received-Date: Tue, 04 Jun 2013 13:37:55 -0000\r
  78 \r
  79 Quoth David Bremner on Jun 04 at  8:37 am:\r
  80 > Tomi Ollila <tomi.ollila@iki.fi> writes:\r
  81 > \r
  82 > > On Tue, Jun 04 2013, Austin Clements <amdragon@MIT.EDU> wrote:\r
  83 > >\r
  84 > >> I realize this already got pushed, but to me this seems like a\r
  85 > >> reversion for the 95% of users who haven't customized\r
  86 > >> notmuch-archive-tags and just want to know that archiving means\r
  87 > >> removing the inbox tag.  Why is this less confusing?  Users who have\r
  88 > >> customized notmuch-archive-tags will probably know that the "default"\r
  89 > >> doesn't apply to them.\r
  90 > \r
  91 > As a side note, this kind of thing is why I started a texinfo manual; I\r
  92 > don't really think reading docstrings is the best intro for a new user.\r
  93 > \r
  94 > > Can we have both -- i.e. something like (default: "-inbox") in the \r
  95 > > docstring. When entering c-h f notmuch-show-archive-thread\r
  96 > > The `notmuch-archive-tags' in text is a hyperlink to the documentation\r
  97 > > of notmuch-archive-tags (which shows its current value)...\r
  98 > \r
  99 > I don't really mind Tomi's suggestion, although in practice I think\r
 100 > following the hyperlink is also not so burdensome. I mainly didn't like\r
 101 > the places it mentioned "inbox" without mentioning the variable that\r
 102 > really controls it.\r
 103 \r
 104 Right.  I think we should both reference the variable and say what the\r
 105 default behavior is (there's no reason not to do both).  But isn't\r
 106 that what these docstrings used to do?\r