From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp12.migadu.com ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms5.migadu.com with LMTPS id wDNICmgQ9GJ/HwEAbAwnHQ (envelope-from ) for ; Wed, 10 Aug 2022 22:09:12 +0200 Received: from aspmx1.migadu.com ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp12.migadu.com with LMTPS id 8KM0CmgQ9GI/iQAAauVa8A (envelope-from ) for ; Wed, 10 Aug 2022 22:09:12 +0200 Received: from mail.notmuchmail.org (yantan.tethera.net [IPv6:2a01:4f9:c011:7a79::1]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by aspmx1.migadu.com (Postfix) with ESMTPS id B698F23B1 for ; Wed, 10 Aug 2022 22:09:11 +0200 (CEST) Received: from yantan.tethera.net (localhost [127.0.0.1]) by mail.notmuchmail.org (Postfix) with ESMTP id 85EF25F389; Wed, 10 Aug 2022 20:09:08 +0000 (UTC) Received: from meesny.iki.fi (meesny.iki.fi [IPv6:2001:67c:2b0:1c1::201]) by mail.notmuchmail.org (Postfix) with ESMTPS id A8DF45E221 for ; Wed, 10 Aug 2022 20:09:05 +0000 (UTC) Received: from c53 (gw1.nor.fi [185.218.193.67]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange ECDHE (P-256) server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) (Authenticated sender: too) by meesny.iki.fi (Postfix) with ESMTPSA id 322262037C; Wed, 10 Aug 2022 23:09:04 +0300 (EEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=iki.fi; s=meesny; t=1660162144; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: in-reply-to:in-reply-to:references:references; bh=sI1iiRT4jTTAR1/XPMoosEsIpvUXg6SuqYLeGOsGw74=; b=iW4zaviAsGPJL9kALHAY1gS+3cOm04gI8QSICU+qiqDflHBJ5H+UPXq6UwmdAfApyGJCr/ oirRDPh+09pZYA72dUjicKv93z/0z+68swhlRoZdbJIONVY4e82/RkiMTa5+RgJD6VJS7o QndFneF4+yOzD7GpXo2PwI3+qhpNFyE= From: Tomi Ollila To: David Bremner , notmuch@notmuchmail.org Subject: Re: Embed elisp.py from flycheck, use it in notmuch-emacs doc In-Reply-To: <20220731113323.2845595-1-david@tethera.net> References: <20220731113323.2845595-1-david@tethera.net> User-Agent: Notmuch/0.36+55~gfb9633d (https://notmuchmail.org) Emacs/27.1 X-Face: HhBM'cA~ MIME-Version: 1.0 ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=iki.fi; s=meesny; t=1660162144; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: in-reply-to:in-reply-to:references:references; bh=sI1iiRT4jTTAR1/XPMoosEsIpvUXg6SuqYLeGOsGw74=; b=n8Az79IRiz0nGLPGTPmFVuq/wbKQ5fq7Dz9imGUuptTGTiaeVsredyfam4ilMXQV5jHi9D AIv1hDNXztfxtjwLx608VlkielqjFTI7Tluh7hCK8/fvXLeeYAThExcmCDxP1//iEAsE/b YQmVLBK22+p1vAzqf9hVAiEh5q79aS0= ARC-Authentication-Results: i=1; ORIGINATING; auth=pass smtp.auth=too smtp.mailfrom=tomi.ollila@iki.fi ARC-Seal: i=1; s=meesny; d=iki.fi; t=1660162144; a=rsa-sha256; cv=none; b=B2aUBonfJ+neE8in/KfSIHu/zt40lcFnUeuBDF+lMOT1LzflmPy0c/eswAxXtMJKus7aBj Xz4hoOpD2kKV+xUsAyM4YI3VNoeQkPPFJk+acfjA2mo3pkUYD1Jaxaxtm7CVwBLU9xZQKl tQZdnG46MlUltmpxVR5RNde1T6g6B3g= Message-ID-Hash: MYKNIMI5REEFVU4AZPPQAYTGQFX6DHSS X-Message-ID-Hash: MYKNIMI5REEFVU4AZPPQAYTGQFX6DHSS X-MailFrom: tomi.ollila@iki.fi X-Mailman-Rule-Misses: dmarc-mitigation; no-senders; approved; emergency; loop; banned-address; member-moderation; header-match-notmuch.notmuchmail.org-0; nonmember-moderation; administrivia; implicit-dest; max-recipients; max-size; news-moderation; no-subject; digests; suspicious-header X-Mailman-Version: 3.3.3 Precedence: list List-Id: "Use and development of the notmuch mail system." List-Help: List-Owner: List-Post: List-Subscribe: List-Unsubscribe: Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Migadu-Flow: FLOW_IN X-Migadu-To: larch@yhetil.org X-Migadu-Country: DE ARC-Message-Signature: i=2; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1660162151; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references:list-id:list-help: list-owner:list-unsubscribe:list-subscribe:list-post:dkim-signature; bh=VLcaT7Sadsfn1c2kAd2rE15lMGPrP5XPmJZ3lLj6AX4=; b=TxylHDJy3bP/ntmvBdbiEIHCPX05J3uYElNaohuEP2RBBjbT0/Ukdjw2QUC5cmq6XVRsyF bt54QbIVu8ECIO+ka0PkU0QbRXAs0yurF7O//jlZ05jxXxz5WJbvj2g5FmV+/7xbFbo+RJ 0sHhBMjIhld2Q9yEXtq5CUIpEoR0mzLVcEf8qhsiw1TxMmSX1NYemSvaMWOZXOvwwuYHKi sVkU8wBGU0V+I5fGRBrV1LZHbarIsbuAPS6G0yr9Mc4tyei3haSmIlAYfjeWXXAuaB675S jO2yid8rcOH0LoJZgzoa7wXL1B5XPZFLBgN+upZp/AQiF68WY9dLk20zpvD3wA== ARC-Seal: i=2; s=key1; d=yhetil.org; t=1660162151; a=rsa-sha256; cv=fail; b=hPWsoXz4EjYB+Z85Pw+Rj6gAUtAU0XR3lsro6ho7x3afSYzOhki/HJ+Ky2KzWfeAuKe8/j fGVmJHRIheAPVnsU4TMM5Le+SFWhVvlWg2jUJnjtBpT0wi6husdexRuhL99uZU+oR0E5vG QUktTzVfygVnY0f9gPR4hg5pzxg7q6zs4BtiOLC7TQf4Rxo2appHyHTK8N3f9ROIxbta50 vu+0GK6lNoFWDOcyTnpMZ7dGmPyQMvyTfeblOAFZrqvJLkRtaVtDhqDkEQRca+c87SMeey KyWpcZ6FVHKS/egOJz35gWsovcZy3lzBHW9MhgMSTbt3AD6Ej8kkwTLyNxY2Vg== ARC-Authentication-Results: i=2; aspmx1.migadu.com; dkim=fail ("body hash did not verify") header.d=iki.fi header.s=meesny header.b=iW4zaviA; arc=reject ("signature check failed: fail, {[1] = sig:iki.fi:reject}"); dmarc=none; spf=pass (aspmx1.migadu.com: domain of notmuch-bounces@notmuchmail.org designates 2a01:4f9:c011:7a79::1 as permitted sender) smtp.mailfrom=notmuch-bounces@notmuchmail.org X-Migadu-Spam-Score: 2.79 Authentication-Results: aspmx1.migadu.com; dkim=fail ("body hash did not verify") header.d=iki.fi header.s=meesny header.b=iW4zaviA; arc=reject ("signature check failed: fail, {[1] = sig:iki.fi:reject}"); dmarc=none; spf=pass (aspmx1.migadu.com: domain of notmuch-bounces@notmuchmail.org designates 2a01:4f9:c011:7a79::1 as permitted sender) smtp.mailfrom=notmuch-bounces@notmuchmail.org X-Migadu-Queue-Id: B698F23B1 X-Spam-Score: 2.79 X-Migadu-Scanner: scn1.migadu.com X-TUID: iCezC60HKN7v On Sun, Jul 31 2022, David Bremner wrote: > After finding myself spending a while trying to re-create one of the > features [0] of the el sphinx domain used in flycheck, I decided to try > just converting the docs to use that sphinx extension. > > As I remarked in 2018 [1], there doesn't seem to be a distributed > version of this sphinx extension. It also seems like the use-case in > notmuch is a bit different in terms of what we want to put in the > index, but perhaps someone better at sphinx than I could do those > customizations without modifying the extension (as this series does). > > Overall I think the quality of the resulting HTML documentation is > quite nice. The change in the info documentation is less clear. This > may also be tweakable, but in the first version the info docs seem > more verbose than necessary (e.g. writing "Key Binding" everywhere) On > the other hand, if it encourages people (e.g. me) to document things, > then it's probably a win overall. > > [0]: documenting both a keybinding and a function name with the same > directive, with nice index entries. This series is probably good; at least it does not break software (and if doc quality (or making of it) gets better then good :D) Tomi > > [1]: id:20180521200856.17103-1-david@tethera.net > > > _______________________________________________ > notmuch mailing list -- notmuch@notmuchmail.org > To unsubscribe send an email to notmuch-leave@notmuchmail.org