Benefits of using Sphinx documentation format
Eli Zaretskii
eliz@gnu.org
Mon Jul 12 17:12:46 GMT 2021
> Cc: hp@bitrange.com, gcc@gcc.gnu.org, gcc-patches@gcc.gnu.org,
> joseph@codesourcery.com
> From: Martin Liška <mliska@suse.cz>
> Date: Mon, 12 Jul 2021 16:37:00 +0200
>
> > 4) The need to learn yet another markup language.
> > While this is not a problem for simple text, it does require a
> > serious study of RST and Sphinx to use the more advanced features.
>
> No, majority of the documentation is pretty simple: basic formatting, links, tables and
> code examples.
We also have documentation of APIs (a.k.a. "functions"). I actually
tried to find in the Sphinx docs how to do that and got lost. So, not
really "very simple".
More information about the Gcc
mailing list