Imported Upstream version 1.47.17

[platform/upstream/help2man.git] / help2man.h2m.PL

diff --git a/help2man.h2m.PL b/help2man.h2m.PL
index ab5ac6b..7bd1bc3 100755 (executable)
--- a/help2man.h2m.PL
+++ b/help2man.h2m.PL
@@ -1,14 +1,21 @@
 #!/usr/bin/perl
 
-#
 # Self extracting help2man.h2m script.
-#
+
 #   -q, --quiet            Suppress extraction message
 #   -s, --stdout           Extract to stdout
 #   -o, --output=FILE      Extract to FILE
 #   -l, --locale=STRING    Output file for locale STRING
 #   -m, --message-dir=DIR  Directory for message catalogs
-#
+
+# Copyright (C) 2012, 2013, 2014, 2020 Free Software Foundation, Inc.
+
+# Copying and distribution of this file, with or without modification,
+# are permitted in any medium without royalty provided the copyright
+# notice and this notice are preserved.  This file is offered as-is,
+# without any warranty.
+
+# Written by Brendan O'Dea <bod@debian.org>
 
 use 5.008;
 use Config;
@@ -132,10 +139,10 @@ print OUT '    ', _('NAME'), "\n";
 print OUT '    ', _('SYNOPSIS'), "\n";
 print OUT '    ', _('DESCRIPTION'), "\n";
 print OUT '    ', _('OPTIONS'), "\n";
+print OUT '    \fI', _('other'), "\\fR\n";
 print OUT '    ', _('ENVIRONMENT'), "\n";
 print OUT '    ', _('FILES'), "\n";
 print OUT '    ', _('EXAMPLES'), "\n";
-print OUT '    \fI', _('other'), "\\fR\n";
 print OUT '    ', _('AUTHOR'), "\n";
 print OUT '    ', _('REPORTING BUGS'), "\n";
 print OUT '    ', _('COPYRIGHT'), "\n";
@@ -150,7 +157,7 @@ or
 sections appearing in the include file will replace what would have
 automatically been produced (although you can still override the
 former with
-.B --name
+.B \-\-name
 if required).
 EOT
 print OUT "\n";
@@ -163,6 +170,18 @@ the standard sections given above, or included at
 EOT
 print OUT "\n";
 
+print OUT _(<<'EOT');
+Placement of the text within the section may be explicitly requested by using
+the syntax
+.RI [< section ],
+.RI [= section ]
+or
+.RI [> section ]
+to place the additional text before, in place of, or after the default
+output respectively.
+EOT
+print OUT "\n";
+
 print OUT '[', _('AVAILABILITY'), "]\n";
 print OUT _('The latest version of this distribution is available on-line from:'), "\n";
 print OUT "\n";