From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp1 ([2001:41d0:2:bcc0::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms0.migadu.com with LMTPS id qiUsHwGmpGCgUgAAgWs5BA (envelope-from ) for ; Wed, 19 May 2021 07:45:37 +0200 Received: from aspmx1.migadu.com ([2001:41d0:2:bcc0::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp1 with LMTPS id kLo7GgGmpGDjbgAAbx9fmQ (envelope-from ) for ; Wed, 19 May 2021 05:45:37 +0000 Received: from mail.notmuchmail.org (nmbug.tethera.net [IPv6:2607:5300:201:3100::1657]) (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 AE4BB20349 for ; Wed, 19 May 2021 07:45:36 +0200 (CEST) Received: from nmbug.tethera.net (localhost [127.0.0.1]) by mail.notmuchmail.org (Postfix) with ESMTP id 182892AA58; Wed, 19 May 2021 01:45:29 -0400 (EDT) Received: from mail-lj1-x236.google.com (mail-lj1-x236.google.com [IPv6:2a00:1450:4864:20::236]) by mail.notmuchmail.org (Postfix) with ESMTPS id CB4332A9A9 for ; Wed, 19 May 2021 01:45:26 -0400 (EDT) Received: by mail-lj1-x236.google.com with SMTP id v5so14127175ljg.12 for ; Tue, 18 May 2021 22:45:26 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=nikula-org.20150623.gappssmtp.com; s=20150623; h=from:to:subject:in-reply-to:references:date:message-id:mime-version; bh=RHHxZA65/P6tLd+wTwOOZLOAYlOSnYNuuwmKAXNPSUg=; b=d2l/zGTLurDRGvGdBznAPZ13N/CsDA963sbSPslofiTyBBg9Dp8BtpbodAzfPz7phv Xic9Ksdqt4jbecUa8SfpKkuDf8vWEfP4xa/6A0XKBFOrBQlHrlceHGJPgr+CjG1r39DT hux+kfnmJSd62S618M3vPZQewxHgegn2dkg5DWwP6xJ424r4akrIZV0vrARYATUotRac +93jlK75CglEkKNyKEVGr0IaH8Na91ISZegIIr4GnViQ0+Q1SKfZMfxA8lhP3mbkF77/ GoH4TwRBTD41FVG71FGxfLXhuZez6B4ruYvsIVdg6+u/jUu/kJ04s9IAAiopl8zQ5ydz J5tg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:subject:in-reply-to:references:date :message-id:mime-version; bh=RHHxZA65/P6tLd+wTwOOZLOAYlOSnYNuuwmKAXNPSUg=; b=hHpcZ1ECE9c30Eu5466FNcJ1oEgL7kW9Z3x3QGaAxPBK+U19j4Wuy3MUFJ2q0231+A 7+pzoInNqzsINexkAEwC9XODDyr27ffKjym0U6q1hekQaqrlIKnPUvPZms8RZBZ0nFGN /ewYv5kce5XHfOXkT8/yQkuukDKE1Kg75ppeW2RpYua4bP9Ohsa8KnOl5CKTwtnjZtor YCVThjMgDjUBh5W9EhodG7aRYw4tN4N6LBUqINtKSHGlhzquFWiYW5jBPXhltkFi4Dda vbLIpzU6kBPqIF8q9yZytYgRoJPaKAWNt8aze3ki3CtfgX/+vZ+dyGvwbDO+pbGGqoOi sZbw== X-Gm-Message-State: AOAM530vUgm/47RYbcCtiyIDIhj/6edIp4hQ08ECaTdiq1dmFCX2MyUy QE9ddpd///vhZtd/fqCWHxL5EA== X-Google-Smtp-Source: ABdhPJzqS4fWPxOtzL6GbSfzhsvkZU0OJPBhGmOlqKG46WKj3t6ux3ZHj2SZC/WwuIkKLsI6qczxPw== X-Received: by 2002:a2e:571c:: with SMTP id l28mr4259002ljb.275.1621403123974; Tue, 18 May 2021 22:45:23 -0700 (PDT) Received: from localhost (87-95-122-4.bb.dnainternet.fi. [87.95.122.4]) by smtp.gmail.com with ESMTPSA id d14sm1616687lfq.13.2021.05.18.22.45.22 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 18 May 2021 22:45:23 -0700 (PDT) From: Jani Nikula To: David Bremner , notmuch@notmuchmail.org Subject: Re: [PATCH] doc: fix man page build for Sphinx 4.x In-Reply-To: <87cztny64r.fsf@tethera.net> References: <20210518214044.419615-1-jani@nikula.org> <87cztny64r.fsf@tethera.net> Date: Wed, 19 May 2021 08:45:19 +0300 Message-ID: <87h7iznuog.fsf@nikula.org> MIME-Version: 1.0 Message-ID-Hash: 7P364BQYX2SOSZ455DKFB652NBY6S5WJ X-Message-ID-Hash: 7P364BQYX2SOSZ455DKFB652NBY6S5WJ X-MailFrom: jani@nikula.org 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; suspicious-header X-Mailman-Version: 3.2.1 Precedence: list List-Id: "Use and development of the notmuch mail system." List-Help: List-Post: List-Subscribe: List-Unsubscribe: Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Migadu-Flow: FLOW_IN ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1621403137; 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-unsubscribe:list-subscribe:list-post:dkim-signature; bh=QeCV9lxME6W7+5Lkzk4uhlfBSE78hnWAsn3mrt4r1cM=; b=QiKNNfLU8xdnFGMHIfMvWf53NdOczFQpdRt6SpB2u6/tRSMY3ivE7YbO+1KJkj2mfFBfsW FtpBIqQHd1A1N52Iltc/szLYIPrsvblk4vHhlvsfZebnCr1m3wY1+5qAYi7Bo3dvqY8fBV d6kcaVj//hhHflq59zQQRMe3P0c5797bOcO1VdQZv5Ns/8uzjRO01F/EMxshyNGlMD11fn tzsv2x+Saa5gJScTnDDw5xLuIOVXgAcG/51tKEf5Ws3Jix2fKgrvxuseD2E4OdDV8nJ0cN OwFcU/3n9yyrPd5BK8pMntsw2YpGSAlIoNzgxSIt6Qtf6kpTr5RAahqi3kKfzg== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1621403137; a=rsa-sha256; cv=none; b=c/lhM2zEqDvaYxcJkroDBHSBsgETHVq5RDFxMwYBHH3VyFYO+pa28wuWSKUsVt4rbCheri Cx+yRcpUW6Ag1MzqGvT+GfLJKGsirpieJlpUTbnxoEVA7P1/Hd+xieECUobonv+uHCMR5C uEpZY2Tc5yGtHCQfx/UAOmH0euck/Nqxuh2bmuhMPrtc8rIOSkhgMnbHn8qigL43/kgePu IoKEIyh3U5Cre1ryLzRvDJZdM2tbdqtyQudJ3D3k5i1oibdw2JJNqFG8tgTuBrXJeU+sp9 d8o7vGUGLixqs7YZUS4BOTLhawa36kaIakZGkfl4swWxRXKYTXEVbgoiM7XUfg== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=fail ("body hash did not verify") header.d=nikula-org.20150623.gappssmtp.com header.s=20150623 header.b="d2l/zGTL"; dmarc=none; spf=pass (aspmx1.migadu.com: domain of notmuch-bounces@notmuchmail.org designates 2607:5300:201:3100::1657 as permitted sender) smtp.mailfrom=notmuch-bounces@notmuchmail.org X-Migadu-Spam-Score: -1.07 Authentication-Results: aspmx1.migadu.com; dkim=fail ("body hash did not verify") header.d=nikula-org.20150623.gappssmtp.com header.s=20150623 header.b="d2l/zGTL"; dmarc=none; spf=pass (aspmx1.migadu.com: domain of notmuch-bounces@notmuchmail.org designates 2607:5300:201:3100::1657 as permitted sender) smtp.mailfrom=notmuch-bounces@notmuchmail.org X-Migadu-Queue-Id: AE4BB20349 X-Spam-Score: -1.07 X-Migadu-Scanner: scn0.migadu.com X-TUID: v0S+nDOoux53 On Tue, 18 May 2021, David Bremner wrote: > Jani Nikula writes: > >> >> The Sphinx documentation on this [1] is confusing, and has the change >> backwards. Git history says the default changed from False to True. >> >> [1] https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-man_make_section_directory > > Maybe the docs were corrected? > > Changed in version 4.0: The default is changed to False from True. ^^ ^^^^ Were you tricked by the funny word order? I know I was at first. :) I looked deeper into the rabbit hole, and it really is a mess for such a small change. They first added the config to create directories man/1 etc. in 3.3. Then they made it the default in 4.0. Then they realized making it the default was a mistake, and are going to roll it back in upcoming v4.0.2. Then they realized the directories should be named man/man1 (not man/1) etc. and are going to change that in upcoming v4.1. The patch at hand fixes the issue for v4.0.0 and v4.0.1 (the current latest release). Are those worth catering for, I don't know. Up to you. Actually using the feature would be really nice to avoid doing it manually in the makefile, but then that would require Sphinx v3.3 and having to take into account the directory name change in v4.1. *facepalm* BR, Jani. Some references: https://github.com/sphinx-doc/sphinx/commit/178c05b0597e144fdc2117c7b46ac15723a290e8 https://github.com/sphinx-doc/sphinx/commit/a843fd3db8b588be93b576049a8a291bc4b3ec9d https://github.com/sphinx-doc/sphinx/issues/7996 https://github.com/sphinx-doc/sphinx/issues/9217 https://github.com/sphinx-doc/sphinx/pull/9232 https://github.com/sphinx-doc/sphinx/pull/9231