Em Wed, 10 Sep 2025 13:54:07 +0300
Jani Nikula <jani.nikula@xxxxxxxxxxxxxxx> escreveu:
> On Thu, 04 Sep 2025, Mauro Carvalho Chehab <mchehab+huawei@xxxxxxxxxx> wrote:
> > While the build system supports this for a long time, this was
> > never documented. Add a documentation for it.
> >
> > Signed-off-by: Mauro Carvalho Chehab <mchehab+huawei@xxxxxxxxxx>
> > ---
> > Documentation/Makefile | 2 ++
> > 1 file changed, 2 insertions(+)
> >
> > diff --git a/Documentation/Makefile b/Documentation/Makefile
> > index 4736f02b6c9e..0e1d8657a5cc 100644
> > --- a/Documentation/Makefile
> > +++ b/Documentation/Makefile
> > @@ -126,4 +126,6 @@ dochelp:
> > @echo
> > @echo ' make DOCS_CSS={a .css file} adds a DOCS_CSS override file for html/epub output.'
> > @echo
> > + @echo ' make PAPER={a4|letter} Specifies the paper size used for LaTeX/PDF output.'
> > + @echo
> > @echo ' Default location for the generated documents is Documentation/output'
>
> The Sphinx make mode 'sphinx-build -M help' provides all of this and
> more...
So? Relying on a help message from sphinx-build would just make
our makefile fragile.
btw, it didn't work here:
$ ./sphinx_latest/bin/sphinx-build --version
sphinx-build 8.2.3
$ ./sphinx_latest/bin/sphinx-build -M help
Error: at least 3 arguments (builder, source dir, build dir) are required.
Thanks,
Mauro
