Hi folks,
First pass of the manual page conversion is here: https://gitlab.com/libtiff/libtiff/-/merge_requests/356 With the live HTML build here: http://rleigh.gitlab.io/libtiff/index.html (tools and functions sections contain the sections (1) and (3tiff) respectively). You can also get a generated copy of the manual pages here: https://gitlab.com/rleigh/libtiff/-/jobs/2608677255/artifacts/download?file_ type=archive (doc/man-prebuilt in the tar or zip files) I've put some details of the conversion, how to build the manpages, and some of the caveats found so far into the MR description. If anyone could take a look over the HTML tools and functions pages and/or the manual pages of the same, I'd love to hear any feedback about the markup, build and installation, proofreading or any other details. This is the first pass over with the necessary build system integration in place. I'll do some additional proofreading for consistency as well. Kind regards, Roger From: [email protected] <[email protected]> Sent: 11 June 2022 22:20 To: 'Tiff List' <[email protected]> Subject: Converting manual pages to Sphinx ReStructured Text Hi folks, I made a start on this today, and you can see the initial progress here: https://gitlab.com/libtiff/libtiff/-/commits/sphinx-manpages So far, I've updated the CMake build logic to enable manpage generation and installation, and done a trial conversion of three manual pages which can be found here: https://gitlab.com/libtiff/libtiff/-/tree/b6022ee867384ab1f397a48943ed633532 d5772b/doc/man (files ending in .rst; the other files are yet to be converted). As for the main manual, I'll need to go through each page to convert the troff mandoc markup to Sphinx markup. Once it's complete we should get proper cross-references between the manpages and the rest of the HTML manual when generating them as HTML, and there is the option of generating HTTP references in the generated manpages to link back to the HTML docs online when going the other way. This will likely take a few weeks since I don't expect to have a big block of time to dedicate as I did for the HTML manual, but should be fairly straightforward to do now the build and installation logic is in place. As before, I'll update the automake logic as well once the main work is done. If we want to add an additional couple of dependencies, we could use Doxygen to generate most of the API reference from the sources and then convert that into rst for Sphinx to make into HTML or manual pages. Possibly something to consider for future investigation; I'll get the basic conversion done first. Kind regards, Roger
_______________________________________________ Tiff mailing list [email protected] https://lists.osgeo.org/mailman/listinfo/tiff
