linux-kernel - Re: docs: Convert the Speakup guide to rst

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 for Android: free password hash cracker in your pocket

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

Message-ID: <20210531231943.gfimbfqd2hrleuxg@begin>
Date:   Tue, 1 Jun 2021 01:19:43 +0200
From:   Samuel Thibault <samuel.thibault@...-lyon.org>
To:     Gregory Nowak <greg@...gn.net>
Cc:     Igor Matheus Andrade Torrente <igormtorrente@...il.com>,
        speakup@...ux-speakup.org, corbet@....net,
        gregkh@...uxfoundation.org, grandmaster@...klimov.de,
        rdunlap@...radead.org, linux-doc@...r.kernel.org,
        linux-kernel@...r.kernel.org
Subject: Re: docs: Convert the Speakup guide to rst

Gregory Nowak wrote:
> Could a txtdocs option be implemented as a documentation
> target for kernel builds, which would produce plain text files?

Building html files from this is usual, for instance on Debian the html
files are available in the linux-doc package.

Gregory Nowak wrote:
> Another concern is that if the speakup guide is maintained in RST,
> that could dissuade others from keeping it updated who don't already
> know RST.

The RST syntax is very trivial in the end. Personally I don't really
know RST myself, I just mimic what I see in the file and that works
alright.

Samuel