From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from localhost (localhost [127.0.0.1]) by arlo.cworth.org (Postfix) with ESMTP id 29AF16DE0207 for ; Mon, 21 May 2018 13:09:14 -0700 (PDT) X-Virus-Scanned: Debian amavisd-new at cworth.org X-Spam-Flag: NO X-Spam-Score: 0 X-Spam-Level: X-Spam-Status: No, score=0 tagged_above=-999 required=5 tests=[AWL=0.011, SPF_PASS=-0.001, T_RP_MATCHES_RCVD=-0.01] autolearn=disabled Received: from arlo.cworth.org ([127.0.0.1]) by localhost (arlo.cworth.org [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id VULVN7Pp6eTd for ; Mon, 21 May 2018 13:09:13 -0700 (PDT) Received: from fethera.tethera.net (fethera.tethera.net [198.245.60.197]) by arlo.cworth.org (Postfix) with ESMTPS id 0445B6DE01E3 for ; Mon, 21 May 2018 13:09:12 -0700 (PDT) Received: from remotemail by fethera.tethera.net with local (Exim 4.89) (envelope-from ) id 1fKr7F-0002PA-7O for notmuch@notmuchmail.org; Mon, 21 May 2018 16:09:09 -0400 Received: (nullmailer pid 17160 invoked by uid 1000); Mon, 21 May 2018 20:09:07 -0000 From: David Bremner To: notmuch@notmuchmail.org Subject: install info docs v1 Date: Mon, 21 May 2018 13:08:48 -0700 Message-Id: <20180521200856.17103-1-david@tethera.net> X-Mailer: git-send-email 2.17.0 X-BeenThere: notmuch@notmuchmail.org X-Mailman-Version: 2.1.26 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: Mon, 21 May 2018 20:09:14 -0000 I was recently reminded we still don't install the info docs for notmuch-emacs, so I set out to remedy that. The other issue is that the notmuch-emacs docs are not very good. I found somethings that I thought would be simple to be rather frustrating in trying to update notmuch-emacs.rst. That could well just be a lack of fluency in rst on my part. I did wonder if maybe we should consider using some sphinx extension for elisp. I didn't find a well maintained and widely distributed one. sphinxcontrib-emacs apparently doesn't support python3 which is a blocker for me. flycheck embeds an extension [1] that looks fairly nice. It's GPL3+ so we would in principle fork/embed it. [1]: https://github.com/flycheck/flycheck/blob/master/doc/elisp.py