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 qJC/DNibvWJiEAAAbAwnHQ (envelope-from ) for ; Thu, 30 Jun 2022 14:49:28 +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 UPhBDNibvWKtDwAAauVa8A (envelope-from ) for ; Thu, 30 Jun 2022 14:49:28 +0200 Received: from mail.notmuchmail.org (yantan.tethera.net [135.181.149.255]) (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 E5FE69CAC for ; Thu, 30 Jun 2022 14:49:27 +0200 (CEST) Received: from yantan.tethera.net (localhost [127.0.0.1]) by mail.notmuchmail.org (Postfix) with ESMTP id 1B9425F795; Thu, 30 Jun 2022 12:39:49 +0000 (UTC) Received: from mail-io1-xd31.google.com (mail-io1-xd31.google.com [IPv6:2607:f8b0:4864:20::d31]) by mail.notmuchmail.org (Postfix) with ESMTPS id 7A17D5F41A for ; Thu, 30 Jun 2022 12:39:46 +0000 (UTC) Received: by mail-io1-xd31.google.com with SMTP id s17so18968901iob.7 for ; Thu, 30 Jun 2022 05:39:46 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=mime-version:references:in-reply-to:from:date:message-id:subject:to :cc; bh=nIUtNHxPE00hUC/VDh5GXw0eU79pCrn26q1y3ysLKE0=; b=MwNnb3wPVTjPSnpLJkwm8wM/0OSlw5X02HniNE4CjavOCHHhTLV4yaxPGRZtN0zz5r eMahbaGvnQwGA3LMH2SmutL9v9688oyfz4fRo5xHHd1hHWEZtp4opFIfAMt3mrSPJi8I QkE4ljGZb/eziQhnXlZHDSdzXnpmXd61ZJZakd1T/8Po7Khivix0kxr9pEShasttkoiI NqidBwlfGvf1Iy+1bUkWPlUgDhoPiQonLHtGceJHd4esSA3I479wZvjhFK/A4+FR1kZ0 EtGNUstWsqcjjyxQxmhxnANMDd4G/MOZbAvMUJKP2NX23NH2RSRsoyaAxk4uxpNAjlOg A8+Q== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=x-gm-message-state:mime-version:references:in-reply-to:from:date :message-id:subject:to:cc; bh=nIUtNHxPE00hUC/VDh5GXw0eU79pCrn26q1y3ysLKE0=; b=W5f549A507OHXUHPq2424IL0lMT7rp1nlQlKe3H/hL8Za+RhkOOWimFaP2l6nj/Q32 uxK77uvX6nT/17RUtr67yFyfwEQbA+YO8o36qua413OMUCpIYPTWVvCJBSvQEUoMAWxf Eq20wLx01BFu8uLX/uD5oykmCA3l7aN/6QtHcQE2/iqbMRXZab0/9h2Oj2m7LRfOVCUp 9fjXQHAwI0hekJe5pPE5M+Y4zjujC84f5ZeHK7bqKjJn9ozQ30orTg5G2AQepF132rfo 7+f8Qx2ERh4zOxLqi3yK6uEZXKTBy/6IciAo897ivK41EIZVoYLhyTx1mpLeUzfcgyQz Sh7A== X-Gm-Message-State: AJIora+L7dQ0SBYyvkl9SprsrKeD9blsf7fa/RBOxwyt8LtDZ1ojet3J X0k0EvPO9EHeD7z5tCfKRMoogh8OnCPX6x7PPJU= X-Google-Smtp-Source: AGRyM1u8CbXoLbVnXUW7ssM8dOzP3u6basXP4PG1ltBMx8/ee/i6FqZNgx2ftnyNxf9uyWRdhG76lsgVE/RV9IkQn/o= X-Received: by 2002:a02:a893:0:b0:339:dfee:2d24 with SMTP id l19-20020a02a893000000b00339dfee2d24mr5264547jam.69.1656592784656; Thu, 30 Jun 2022 05:39:44 -0700 (PDT) MIME-Version: 1.0 References: <0dce59bb4edc9c10ab2baf8d6d33cb3f204fc1f3.1656411268.git.git@grubix.eu> <20220630112034.3923518-1-david@tethera.net> In-Reply-To: <20220630112034.3923518-1-david@tethera.net> From: Michael J Gruber Date: Thu, 30 Jun 2022 14:39:33 +0200 Message-ID: Subject: Re: [PATCH] doc: replace symlink with duplicate page for nmbug To: David Bremner Message-ID-Hash: WU7ZPZIAYWW36RMKHAEZMCARKWPZPD4A X-Message-ID-Hash: WU7ZPZIAYWW36RMKHAEZMCARKWPZPD4A X-MailFrom: michaeljgruber@gmail.com 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 CC: notmuch@notmuchmail.org 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=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1656593367; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc: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=XfO9jH2WbLZ3TSYR6m6gx9g4Jp4bXoDja4sW+mRJPMM=; b=by13irvzg5ESD36fKlzb1+H6q7hZXOnSjKqMBJOsDTwV+LqlmpvRpHXPm/cVaC70nXTcLB mLHpperAY/J0edCzcfbBoWKW3VLMugDaqPsnYuddD0ZsX6QN656ly0VDxUL+i6W9/h5e75 I1/iX+lmxY7P8BbrnnayG688mTxT1Wc6fmJmRcK8++YlxRaNIzprinElPnGflnOO5TH/is 18QacbPSeC+/rpGRnj6y1zIhw6Ht0IsK0D2hV9lDy680sbfB8J/zRhNGsTpQ94ws/HWwWT uRLc8oQe7CtK4s4anb+sUwcH+iDR5N25YyurMZAKEWi8opxCiqEXAA65eG1s8w== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1656593367; a=rsa-sha256; cv=none; b=TIgp7SybrzmFp0FnGzhOuUKeaZ1Fpo8mn0vCkkNfxZ/SKGHMVEYqI6Y3hWIRIxAh5B4Hjn eBNFZrCaaHIVWEqIE9AVGZ5e5YK9HFGYP7pV5wFYXC9KVSNVkvW5mj49wonalmsfVhdGRr kb7rZNDo0zWZ/ZOCKdwvRI13cuJPNFgEKzKHtB1rcnnIuRhF5K6OwM/w76qQv3AKKeYFZ2 Eq2Rw4vpZbx+KKrnFvXy2orx0gOyT2pvs+I+jnaXAOrYPwwXu3BWwVJl/p8tpVzyW0AmGk iqvL70K4vaooYjRQf78JgH+faF35xCYDb3s3Xfh17Pyfmk/cxlik9RysDoUyuQ== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=fail ("body hash did not verify") header.d=gmail.com header.s=20210112 header.b=MwNnb3wP; dmarc=fail reason="SPF not aligned (relaxed)" header.from=gmail.com (policy=none); spf=pass (aspmx1.migadu.com: domain of notmuch-bounces@notmuchmail.org designates 135.181.149.255 as permitted sender) smtp.mailfrom=notmuch-bounces@notmuchmail.org X-Migadu-Spam-Score: 7.75 Authentication-Results: aspmx1.migadu.com; dkim=fail ("body hash did not verify") header.d=gmail.com header.s=20210112 header.b=MwNnb3wP; dmarc=fail reason="SPF not aligned (relaxed)" header.from=gmail.com (policy=none); spf=pass (aspmx1.migadu.com: domain of notmuch-bounces@notmuchmail.org designates 135.181.149.255 as permitted sender) smtp.mailfrom=notmuch-bounces@notmuchmail.org X-Migadu-Queue-Id: E5FE69CAC X-Spam-Score: 7.75 X-Migadu-Scanner: scn1.migadu.com X-TUID: dr19YmYGyufv Am Do., 30. Juni 2022 um 13:20 Uhr schrieb David Bremner : > > This automatically propagates to the info version of the pages, which > saves having maintain two sets of symlinks. > --- > > What do you think about this as an alternative approach? It seems > slightly more maintainable to me, although I am willing to be > convinced otherwise. If it is an improvement we could do the same for > the notmuch-setup page. Looks OK to me. I just followed the man example (by linking), after I had noticed the asymmetry, but copies work fine, too. You probably also want to add them to `make install`. > doc/Makefile.local | 3 ++- > doc/conf.py | 4 ++++ > 2 files changed, 6 insertions(+), 1 deletion(-) > > diff --git a/doc/Makefile.local b/doc/Makefile.local > index 2f67f4de..123ef10b 100644 > --- a/doc/Makefile.local > +++ b/doc/Makefile.local > @@ -19,6 +19,7 @@ MAN_RST_FILES := $(MAN1_RST) $(MAN5_RST) $(MAN7_RST) > ALL_RST_FILES := $(MAN_RST_FILES) $(srcdir)/doc/notmuch-emacs.rst > > MAN1_ROFF := $(patsubst $(srcdir)/doc/%,$(DOCBUILDDIR)/man/%,$(MAN1_RST:.rst=.1)) > +MAN1_ROFF := $(MAN1_ROFF) $(DOCBUILDDIR)/man/man1/nmbug.1 > MAN5_ROFF := $(patsubst $(srcdir)/doc/%,$(DOCBUILDDIR)/man/%,$(MAN5_RST:.rst=.5)) > MAN7_ROFF := $(patsubst $(srcdir)/doc/%,$(DOCBUILDDIR)/man/%,$(MAN7_RST:.rst=.7)) > MAN_ROFF_FILES := $(MAN1_ROFF) $(MAN5_ROFF) $(MAN7_ROFF) > @@ -26,6 +27,7 @@ MAN_ROFF_FILES := $(MAN1_ROFF) $(MAN5_ROFF) $(MAN7_ROFF) > MAN_GZIP_FILES := $(addsuffix .gz,${MAN_ROFF_FILES}) > > MAN1_TEXI := $(patsubst $(srcdir)/doc/man1/%.rst,$(DOCBUILDDIR)/texinfo/%.texi,$(MAN1_RST)) > +MAN1_TEXI := $(MAN1_TEXI) $(DOCBUILDDIR)/texinfo/nmbug.info > MAN5_TEXI := $(patsubst $(srcdir)/doc/man5/%.rst,$(DOCBUILDDIR)/texinfo/%.texi,$(MAN5_RST)) > MAN7_TEXI := $(patsubst $(srcdir)/doc/man7/%.rst,$(DOCBUILDDIR)/texinfo/%.texi,$(MAN7_RST)) > INFO_TEXI_FILES := $(MAN1_TEXI) $(MAN5_TEXI) $(MAN7_TEXI) > @@ -131,7 +133,6 @@ install-man: ${MAN_GZIP_FILES} > install -m0644 $(filter %.5.gz,$(MAN_GZIP_FILES)) $(DESTDIR)/$(mandir)/man5 > install -m0644 $(filter %.7.gz,$(MAN_GZIP_FILES)) $(DESTDIR)/$(mandir)/man7 > cd $(DESTDIR)/$(mandir)/man1 && ln -sf notmuch.1.gz notmuch-setup.1.gz > - cd $(DESTDIR)/$(mandir)/man1 && ln -sf notmuch-git.1.gz nmbug.1.gz > endif > > ifneq ($(HAVE_SPHINX)$(HAVE_MAKEINFO),11) > diff --git a/doc/conf.py b/doc/conf.py > index f01c0058..ed27c3f4 100644 > --- a/doc/conf.py > +++ b/doc/conf.py > @@ -127,6 +127,10 @@ man_pages = [ > u'manage notmuch tags with git', > [notmuch_authors], 1), > > + ('man1/notmuch-git', 'nmbug', > + u'manage notmuch bugs with git', > + [notmuch_authors], 1), > + > ('man5/notmuch-hooks', 'notmuch-hooks', > u'hooks for notmuch', > [notmuch_authors], 5), > -- > 2.35.2 >