Man pages in adoc format are not converted properly

[hansu]

For example line breaks and links are just ignored.

The conversion is not new, but we never had that many man pages in the adoc format so that it never has been noticed.

Maybe someone can point me to the command where this is done in the Submakefile? @petterreinholdtsen maybe?

[petterreinholdtsen]

[Hans Unzner]

Maybe someone can point me to the command where this is done in the Submakefile? @petterreinholdtsen maybe?

It is the a2x call at the end of docs/src/Submakefile.

…

-- Happy hacking Petter Reinholdtsen

[hansu]

Thanks!

[smoe]

@hansu, where do we stand with the man page formatting? It is (mostly) fine now?

[hansu]

I am currently waiting for a feature to be implemented in asciidoctor to be able to use that instead a2x for converting the man pages from adoc to groff.
That would save us to fix several man pages and also allow a proper formatting.

[andypugh]

See also "[Emc-developers] RPi5 support on download homepage"
It seems that converting ascidoc tables to groff and then to HTML doesn't work.
This can be seen by comparing
http://linuxcnc.org/docs/stable/html/man/man9/hm2_spix.9.html
to
https://github.com/LinuxCNC/linuxcnc/blob/master/docs/src/man/man9/hm2_spix.9.adoc

[BsAtHome]

@hansu, which asciidoctor feature are you waiting for?