Re: [PATCH v4 12/19] docs: Makefile: document latex/PDF PAPER= parameter

[Jani Nikula <jani.nikula@linux.intel.com>]

On Fri, 12 Sep 2025, Mauro Carvalho Chehab <mchehab+huawei@kernel.org> wrote:
> Em Wed, 10 Sep 2025 13:54:07 +0300
> Jani Nikula <jani.nikula@linux.intel.com> escreveu:
>
>> On Thu, 04 Sep 2025, Mauro Carvalho Chehab <mchehab+huawei@kernel.org> 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@kernel.org>
>> > ---
>> >  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.

'sphinx-build -M help . .'

>
> Thanks,
> Mauro

-- 
Jani Nikula, Intel