On Sat, Nov 02, 2024 at 12:29:08AM +0100, R. Diez wrote: > > > > However, when I add a @pagesizes to the top of openocd.texi > > > [...] > > > Yeah, it just adds a 1 inch margin to whatever dimensions you specify, > > apparently. This command is hardly used by anybody. There is not an > > easy way to set the page size and margins. > > I must admit that I know very little about Texinfo etc., but that statement > came nevertheless as a big surprise. I would have thought that setting the > page size and margins would be a basic feature. >
There are only the inbuilt settings: letter paper (the default), @afourpaper, @smallbook, and a few others. See https://www.gnu.org/software/texinfo/manual/texinfo/html_node/A4-Paper.html and https://www.gnu.org/software/texinfo/manual/texinfo/html_node/_0040smallbook.html. It should not be surprising as paper is not supplied in arbitrary sizes. Someone using a printer to print a manual would likely be using A4 (or perhaps US letter size). > I managed to reduce the example indentation with the "@exampleindent X" > command you mentioned, but I failed to find a way to reduce the indentation > of @deffn. The indentation of @enumerate @item is less than the indentation > of the @section above it, so that it looks wrong. Again there is no way to customise the indentation of environments. I don't understand what the relevance of @enumerate is here in the input we are discussing, as it is has not been mentioned so far. Can you post a short input file demonstrating the problem? > I wonder if the OpenOCD project is doing this the wrong way. Is there perhaps > a better way to generate a PDF from a Texinfo file? It is not necessarily better but there is also the --latex output from texi2any. The output from the LaTeX output would also likely have small formatting problems occasionally and might need tweaking. > Or is Texinfo not really suitable for PDF documentation? I would hardly say that it is not suitable just because you cannot customize the page margins to arbitrary values.
