Hi Eric,
> Problems with as.1:
>
> Your Synopsis is exceptionally creative. Unfortunately, that means
> it cannot be translated to structural markup even when things like
> running-text inclusions have been moved elswhere.
>
> This page was generated from some sort of non-man markup. Please
> fix the upstream markup so that it generates a well-formed
> manual page with the indicated corrections.
>
> --- as.1-unpatched 2014-06-01 20:05:07.053475183 -0400
> +++ as.1 2014-06-01 20:05:06.269457562 -0400
> @@ -158,6 +158,7 @@
> [\fB\-\-target\-help\fR] [\fItarget-options\fR]
> [\fB\-\-\fR|\fIfiles\fR ...]
> .PP
> +.SH TARGET-SPECIFIC OPTIONS
> \&\fITarget AArch64 options:\fR
> [\fB\-EB\fR|\fB\-EL\fR]
> [\fB\-mabi\fR=\fI\s-1ABI\s0\fR]
I found that I was unable to call the new section "TARGET-SPECIFIC OPTIONS",
so instead I have opted for "TARGET". This is probably due to my non-existent
Perl programming skills, but anyway. So I have checked in the attached patch
in order to fix the problem.
Cheers
Nick
gas/ChangeLog
2016-03-18 Nick Clifton <ni...@redhat.com>
* doc/as.texinfo: Place the target specific command line options
into their own man page section.
etc/ChangeLog
2016-03-18 Nick Clifton <ni...@redhat.com>
* texi2pod.pl: Add TARGET to the list of recognised man page
sections.
diff --git a/etc/texi2pod.pl b/etc/texi2pod.pl
index cd0ffd9..dd3e181 100644
--- a/etc/texi2pod.pl
+++ b/etc/texi2pod.pl
@@ -340,7 +340,7 @@ die "No filename or title\n" unless defined $fn && defined $tl;
$sects{NAME} = "$fn \- $tl\n";
$sects{FOOTNOTES} .= "=back\n" if exists $sects{FOOTNOTES};
-for $sect (qw(NAME SYNOPSIS DESCRIPTION OPTIONS ENVIRONMENT FILES
+for $sect (qw(NAME SYNOPSIS TARGET DESCRIPTION OPTIONS ENVIRONMENT FILES
BUGS NOTES FOOTNOTES SEEALSO AUTHOR COPYRIGHT)) {
if(exists $sects{$sect}) {
$head = $sect;
diff --git a/gas/doc/as.texinfo b/gas/doc/as.texinfo
index a0584d3..7b36931 100644
--- a/gas/doc/as.texinfo
+++ b/gas/doc/as.texinfo
@@ -246,8 +246,10 @@ gcc(1), ld(1), and the Info entries for @file{binutils} and @file{ld}.
[@b{--target-help}] [@var{target-options}]
[@b{--}|@var{files} @dots{}]
@c
+@c man end
@c Target dependent options are listed below. Keep the list sorted.
@c Add an empty line for separation.
+@c man begin TARGET
@ifset AARCH64
@emph{Target AArch64 options:}
_______________________________________________
bug-binutils mailing list
bug-binutils@gnu.org
https://lists.gnu.org/mailman/listinfo/bug-binutils
