Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) client-ip=2620:137:e000::1:20;
From:   Jonathan Corbet <corbet@lwn.net>
To:     Akira Yokosawa <akiyks@gmail.com>
Cc:     linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org,
        Akira Yokosawa <akiyks@gmail.com>
Subject: Re: [PATCH] Documentation/process/changes: Escape --options to fix
 Sphinx output
In-Reply-To: <7e3b424d-2aba-3326-29c8-2ccdbfb12f70@gmail.com>
References: <87o7nitvd4.fsf@meer.lwn.net>
 <7e3b424d-2aba-3326-29c8-2ccdbfb12f70@gmail.com>
Date:   Sun, 23 Apr 2023 09:55:20 -0600
Message-ID: <87leiioaon.fsf@meer.lwn.net>
MIME-Version: 1.0
Content-Type: text/plain
Precedence: bulk

Akira Yokosawa <akiyks@gmail.com> writes:

> Whereas the summary reads "docs: turn off "smart quotes" in the HTML build",
> the change is also effective in the LaTeX/PDF build.

True...so the title is a bit off, but it is a fix for that build too,
right? 

> BTW, Jon, don't you test build pdfdocs these days?

I will confess that I don't do it as often as I should.  As you may have
noticed, it takes a little while to run, and the interest in PDF output
is pretty low these days.

> The fix to the pdfdocs build error from Tomi [1] is not yet picked up
> either by Mauro or you ... :-/
>
> [1] https://lore.kernel.org/linux-doc/29380b3e-1daa-3aef-1749-dbd9960ba620@gmail.com/

Media docs patches normally go through the media tree, just like the
original bug did; I had assumed that would happen here as well.
Seemingly not, so I've just picked those patches up into docs-next.

> I waited to see if there is anybody else who hits this build error.
> It looks like I am alone!
>
> If there is so few interest in pdfdocs, it might not be worth keeping
> kernel documentation compatible with PDF build. 

Interest is low, but not zero, and I'd prefer to keep it working.  It
really helps when somebody tells me that it breaks (it is rather
fragile, alas)!

One of these days I would really like to make a serious attempt to see
if rst2pdf has any hope of ever working for us.  Taking latex out of the
picture would simplify so many things.

Thanks,

jon