Hi, the problems with the manpages was, that they also contained infos about the installed plugins, which is not compile-time data but runtime data and doesn't belong into a manual page at all.
I'm in the process of removing all of these and make options like -list-input-plugins, and -list-plugin-options which dump the infos from the runtime plugin registry. Then the manual pages should be removed from the repository and generated by make. I'm working on this, although not very fast. Cheers Burkhard ________________________________________ From: IOhannes m zmölnig <zmoel...@iem.at> Sent: Wednesday, September 1, 2021 11:55:23 PM To: gmerlin-general@lists.sourceforge.net Subject: Re: [Gmerlin-general] gavl: fixes On 9/1/21 23:50, IOhannes m zmölnig wrote: > i'm not entirely sure whether modern versions of groff would handle > these dashes correctly. > in any case, groff(7) (e.g. [1]) says that an ordinary "minus sign" is > supposed to be written as "\-". ah, here's a [reference](https://liw.fi/manpages/): > An unfortunate bit of arcane syntax is that dashes in options should > be prefixed by backslashes. Thus, write \-\-bits, not just --bits. The > Debian and Ubuntu implementation of man treats them the same, for > terminal output, but this is not portable. Technically a naked - means > a hyphen, whereas \- means a minus sign. Typographically these are > distinct, and they are also distinct in Unicode. The typesetter is > free to break a line at a hyphen, but not at a minus. For dashes in > options, you should thus use minuses, but in normal text, for normal > words, the hyphen. it might well be, that my is a bit too zealous and escapes dashes that don't actually need escaping. however, wherever you want a literal "-" that is parsed by software, you should use a "\-" gmsr IOhannes _______________________________________________ Gmerlin-general mailing list Gmerlin-general@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/gmerlin-general
