Documenting assembler target options

Mike Frysinger vapier@gentoo.org
Wed Nov 24 08:18:00 GMT 2010


this should take care of the Blackfin docs.  i check the as.1 man page and it 
looked correct to me.

From 2ac889121e30acff7e621008697b09ec829b6ac2 Mon Sep 17 00:00:00 2001
From: Mike Frysinger <vapier@gentoo.org>
Date: Wed, 24 Nov 2010 03:11:55 -0500
Subject: [PATCH] gas: bfin: convert to new doc style

Signed-off-by: Mike Frysinger <vapier@gentoo.org>

2010-11-24  Mike Frysinger  <vapier@gentoo.org>

	* doc/as.texinfo: Refer to and include c-bfin.texi for Blackfin
	options.
	* doc/c-bfin.texi: Add markup for use in manpage generation.
---
 gas/doc/as.texinfo  |   23 +++++++++++++----------
 gas/doc/c-bfin.texi |    7 ++++++-
 2 files changed, 19 insertions(+), 11 deletions(-)

diff --git a/gas/doc/as.texinfo b/gas/doc/as.texinfo
index a981814..8051124 100644
--- a/gas/doc/as.texinfo
+++ b/gas/doc/as.texinfo
@@ -766,19 +766,22 @@ Specify that PIC code has been generated.
 @end ifset
 
 @ifset Blackfin
+
+@ifclear man
+@xref{Blackfin Options}, for the options available when @value{AS} is
+configured for the Blackfin processor family.
+@end ifclear
+
+@ifset man
+@c man begin OPTIONS
 The following options are available when @value{AS} is configured for
 the Blackfin processor family.
+@c man end
+@c man begin INCLUDE
+@include c-bfin.texi
+@c ended inside the included file
+@end ifset
 
-@table @gcctabopt
-@item -mcpu=@var{processor}@r{[}-@var{sirevision}@r{]}
-This option specifies the target processor.  The optional @var{sirevision}
-is not used in assembler.
-@item -mfdpic
-Assemble for the FDPIC ABI.
-@item -mno-fdpic
-@itemx -mnopic
-Disable -mfdpic.
-@end table
 @end ifset
 
 @ifset CRIS
diff --git a/gas/doc/c-bfin.texi b/gas/doc/c-bfin.texi
index 7a36745..73e2a07 100644
--- a/gas/doc/c-bfin.texi
+++ b/gas/doc/c-bfin.texi
@@ -2,11 +2,14 @@
 @c Free Software Foundation, Inc.
 @c This is part of the GAS manual.
 @c For copying conditions, see the file as.texinfo.
+@c man end
+
 @ifset GENERIC
 @page
 @node Blackfin-Dependent
 @chapter Blackfin Dependent Features
 @end ifset
+
 @ifclear GENERIC
 @node Machine Dependencies
 @chapter Blackfin Dependent Features
@@ -24,7 +27,8 @@
 @cindex Blackfin options (none)
 @cindex options for Blackfin (none)
 
-@table @code
+@c man begin OPTIONS
+@table @gcctabopt
 
 @cindex @code{-mcpu=} command line option, Blackfin
 @item -mcpu=@var{processor}@r{[}-@var{sirevision}@r{]}
@@ -79,6 +83,7 @@ Assemble for the FDPIC ABI.
 @itemx -mnopic
 Disable -mfdpic.
 @end table
+@c man end
 
 @node Blackfin Syntax
 @section Syntax
-- 
1.7.3.1
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 836 bytes
Desc: This is a digitally signed message part.
URL: <https://sourceware.org/pipermail/binutils/attachments/20101124/55cdcfac/attachment.sig>


More information about the Binutils mailing list