[PATCH 1/2] emacs: instruct user to autoload notmuch instead of require'ing it

diff --git a/30/c0be50660d5adb0c5f9e421ac7760c954ed764 b/30/c0be50660d5adb0c5f9e421ac7760c954ed764
new file mode 100644 (file)
index 0000000..cc581f3
--- /dev/null
+++ b/30/c0be50660d5adb0c5f9e421ac7760c954ed764
@@ -0,0 +1,95 @@
+Return-Path: <too@guru-group.fi>\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 26004431FBF\r
+       for <notmuch@notmuchmail.org>; Sat, 29 Mar 2014 01:08:14 -0700 (PDT)\r
+X-Virus-Scanned: Debian amavisd-new at olra.theworths.org\r
+X-Spam-Flag: NO\r
+X-Spam-Score: 0\r
+X-Spam-Level: \r
+X-Spam-Status: No, score=0 tagged_above=-999 required=5 tests=[none]\r
+       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 QIhRMsjm6ndm for <notmuch@notmuchmail.org>;\r
+       Sat, 29 Mar 2014 01:08:10 -0700 (PDT)\r
+Received: from guru.guru-group.fi (guru.guru-group.fi [46.183.73.34])\r
+       by olra.theworths.org (Postfix) with ESMTP id 9DE1C431FAF\r
+       for <notmuch@notmuchmail.org>; Sat, 29 Mar 2014 01:08:10 -0700 (PDT)\r
+Received: by guru.guru-group.fi (Postfix, from userid 501)\r
+       id 2116B1000F2; Sat, 29 Mar 2014 10:08:04 +0200 (EET)\r
+From: Tomi Ollila <tomi.ollila@iki.fi>\r
+To: notmuch@notmuchmail.org\r
+Subject: [PATCH 1/2] emacs: instruct user to autoload notmuch instead of\r
+       require'ing it\r
+Date: Sat, 29 Mar 2014 10:07:58 +0200\r
+Message-Id: <1396080479-19161-1-git-send-email-tomi.ollila@iki.fi>\r
+X-Mailer: git-send-email 1.8.0\r
+Cc: tomi.ollila@iki.fi\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: Sat, 29 Mar 2014 08:08:14 -0000\r
+\r
+When (require 'notmuch) is added to ~/.emacs notmuch is loaded to every\r
+instance of emacs although it may not be used in majority of\r
+those instances.\r
+\r
+When (autoload 'notmuch "notmuch" ...) is added to ~/.emacs notmuch\r
+is loaded (only) when user invokes the notmuch function.\r
+\r
+User may want to add other entrypoints to notmuch by adding more\r
+autoloads -- the autoload instruction given should offer them clue how\r
+to do so.\r
+---\r
+\r
+This borrows models from emacs, gnus & erc (at least).\r
+\r
+I've been dogfooding this for 2 months now, by just loading my\r
+"global" notmuch config from ~/.emacs.d/notmuch-config.el instead\r
+of autoloading that file. I'd like to move the contents of my\r
+"site-specific" configuration files here in the future...\r
+\r
+ README           | 2 +-\r
+ emacs/notmuch.el | 2 +-\r
+ 2 files changed, 2 insertions(+), 2 deletions(-)\r
+\r
+diff --git a/README b/README\r
+index 3a003ad..d92fcfd 100644\r
+--- a/README\r
++++ b/README\r
+@@ -42,7 +42,7 @@ the libnotmuch library.\r
+ Notmuch installs a full-featured email interface for use within\r
+ emacs. To use this, first add the following line to your .emacs file:\r
+ \r
+-      (require 'notmuch)\r
++      (autoload 'notmuch "notmuch" "Notmuch mail" t)\r
+ \r
+ Then, either run "emacs -f notmuch" or execute the command "M-x\r
+ notmuch" from within a running emacs.\r
+diff --git a/emacs/notmuch.el b/emacs/notmuch.el\r
+index 7dec273..34a3b3c 100644\r
+--- a/emacs/notmuch.el\r
++++ b/emacs/notmuch.el\r
+@@ -36,7 +36,7 @@\r
+ ;;\r
+ ;; Then, to actually run it, add:\r
+ ;;\r
+-;;    (require 'notmuch)\r
++;;    (autoload 'notmuch "notmuch" "Notmuch mail" t)\r
+ ;;\r
+ ;; to your ~/.emacs file, and then run "M-x notmuch" from within emacs,\r
+ ;; or run:\r
+-- \r
+1.8.0\r
+\r