2021-05-31 23:20:29

by Samuel Thibault

[permalink] [raw]
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