linux-kernel - Re: [PATCH] Documentation/process/changes: Escape --options to fix Sphinx output

lists.openwall.net		lists / announce owl-users owl-dev john-users john-dev passwdqc-users yescrypt popa3d-users / oss-security kernel-hardening musl sabotage tlsify passwords / crypt-dev xvendor / Bugtraq Full-Disclosure linux-kernel linux-netdev linux-ext4 linux-hardening linux-cve-announce PHC
Open Source and information security mailing list archives

Hash Suite: Windows password security audit tool. GUI, reports in PDF.

[<prev] [next>] [<thread-prev] [day] [month] [year] [list]

Message-ID: <87leiioaon.fsf@meer.lwn.net>
Date:   Sun, 23 Apr 2023 09:55:20 -0600
From:   Jonathan Corbet <corbet@....net>
To:     Akira Yokosawa <akiyks@...il.com>
Cc:     linux-doc@...r.kernel.org, linux-kernel@...r.kernel.org,
        Akira Yokosawa <akiyks@...il.com>
Subject: Re: [PATCH] Documentation/process/changes: Escape --options to fix
 Sphinx output

Akira Yokosawa <akiyks@...il.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