Re: [LTP] [PATCH 0/6] Remove asciidoc{,tor} doc

[Petr Vorel <pvorel@suse.cz>]

Hi Andrea, all,

> Hi Petr,

> On 2/7/25 11:55, Petr Vorel wrote:
> > Hi,

> > This is a follow up for Andrea's 1bf344a3db ("doc: add tests catalog page").

> > Besides these changes I plan:

> > 1) Configure readthedocs to generate html/pdf doc for user to be able to
> > download it.
> +1

Done already.

> > 2) Generate html/pdf documentation as a part of the release process
> > (build it locally with sphinx), to be able to add it to the release
> > as we did with the doc generated by asciidoc{,tor}.
> This is a bit tricky. Did you try already?

No. Not a big priority, but I'd like to do it before the release so that we can
upload generated archive again.

> > 3) Andrea refused to do have virtualenv support in Makefile.
> > https://lore.kernel.org/ltp/3032b376-8f7a-4b1c-8422-f5a61e59b680@suse.com/
> > I would still prefer to have it, as optional, when some variable is
> > passed to make. It's better than copy paste the commands all the time,
> > also it would help 2).

> Yeah, we can have sphinx + dependences packages installed in the system, via
> pip or using a Dockerfile. virtualenv is just an optional tool we don't want
> to be dependent from.

FYI implemented here (let's keep the discussion there)
https://patchwork.ozlabs.org/project/ltp/patch/20250211233552.1990618-1-pvorel@suse.cz/

...
> >   delete mode 100755 docparse/testinfo.pl
> >   delete mode 100644 m4/ax_prog_perl_modules.m4
> >   delete mode 100644 m4/ltp-docparse.m4
> >   rename {docparse => metadata}/README.md (100%)

> The rest looks good. Feel free to push it:

> Acked-by: Andrea Cervesato <andrea.cervesato@suse.com>

Thanks! FYI merged.

Kind regards,
Petr

> Andrea


-- 
Mailing list info: https://lists.linux.it/listinfo/ltp