branch master updated: texi2any usage message

[Patrice Dumas]

This is an automated email from the git hooks/post-receive script.

pertusus pushed a commit to branch master
in repository texinfo.

The following commit(s) were added to refs/heads/master by this push:
     new ee75305c9c texi2any usage message
ee75305c9c is described below

commit ee75305c9c53129b9beb5d8dd0cb82b9fa94ee88
Author: Patrice Dumas <pertusus@free.fr>
AuthorDate: Wed Jan 8 22:39:20 2025 +0100

    texi2any usage message
    
    * tp/Texinfo/XS/texi2any.c (main): add examples to help message.
---
 ChangeLog                |  6 ++++++
 tp/Texinfo/XS/texi2any.c | 29 +++++++++++++++++++++++++++++
 2 files changed, 35 insertions(+)

diff --git a/ChangeLog b/ChangeLog
index 26ade7cca2..21461464e1 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,9 @@
+2025-01-08  Patrice Dumas  <pertusus@free.fr>
+
+       texi2any usage message
+
+       * tp/Texinfo/XS/texi2any.c (main): add examples to help message.
+
 2025-01-08  Patrice Dumas  <pertusus@free.fr>
 
        * tp/Texinfo/XS/texi2any.c (main): split translated strings at end of
diff --git a/tp/Texinfo/XS/texi2any.c b/tp/Texinfo/XS/texi2any.c
index 97be1da798..7e7fee4636 100644
--- a/tp/Texinfo/XS/texi2any.c
+++ b/tp/Texinfo/XS/texi2any.c
@@ -1850,8 +1850,37 @@ main (int argc, char *argv[], char *env[])
 "  Each --ifFORMAT option may be prefixed with `--no-' to negate it;\n"
 "  for example, --no-ifhtml means not to process @ifhtml or @html text,\n"
 "  and to process @ifnothtml text."));
+      text_append_n (&help_message, "\n\n", 2);
 
+      text_append (&help_message, _("Examples:"));
+      text_append_n (&help_message, "\n", 1);
+      text_printf (&help_message, _(
+"  %s foo.texi                      write Info"), program_file);
+      text_append_n (&help_message, "\n", 1);
+      text_printf (&help_message, _(
+"  %s --html foo.texi               write HTML"), program_file);
+      text_append_n (&help_message, "\n", 1);
+      text_printf (&help_message, _(
+"  %s --xml foo.texi                write Texinfo XML"), program_file);
+      text_append_n (&help_message, "\n", 1);
+      text_printf (&help_message, _(
+"  %s --docbook foo.texi            write Docbook XML"), program_file);
+      text_append_n (&help_message, "\n", 1);
+      text_printf (&help_message, _(
+"  %s --plaintext foo.texi          write plain text to standard output"), 
program_file);
+      text_append_n (&help_message, "\n", 1);
+      text_printf (&help_message, _(
+"  %s --pdf foo.texi                write PDF using texi2dvi"), program_file);
+      text_append_n (&help_message, "\n\n", 2);
 
+      text_printf (&help_message, _(
+"  %s --html --no-headers foo.texi  write html without node lines, menus"), 
program_file);
+      text_append_n (&help_message, "\n", 1);
+      text_printf (&help_message, _(
+"  %s --number-sections foo.texi    write Info with numbered sections"), 
program_file);
+      text_append_n (&help_message, "\n", 1);
+      text_printf (&help_message, _(
+"  %s --no-split foo.texi           write one Info file however big"), 
program_file);
       text_append_n (&help_message, "\n\n", 2);
 
       text_append (&help_message, _("Email bug reports to 
bug-texinfo@gnu.org,\n"