[LinuxBIOS] PATCH: abuild manpage and small fixes.
Uwe Hermann
uwe at hermann-uwe.de
Tue Sep 19 20:22:30 CEST 2006
Hi,
here's a manpage for abuild, as well as some small fixes for the
romcc and flashrom manpages, plus license clarifications.
HTH, Uwe.
--
Uwe Hermann
http://www.hermann-uwe.de
http://www.it-services-uh.de | http://www.crazy-hacks.org
http://www.holsham-traders.de | http://www.unmaintained-free-software.org
-------------- next part --------------
.TH ABUILD 1 "September 19, 2006"
.SH NAME
abuild \- build LinuxBIOS images for all available targets
.SH SYNOPSIS
.B abuild
\fR[\fB\-abxVh\fR] [\fB\-t\fR vendor/board] [\fB\-p\fR dir]
[LBROOT]
.SH DESCRIPTION
.B abuild
is a utility used to easily build LinuxBIOS images for all available targets.
.SH OPTIONS
The
.B "[LBROOT]"
parameter tells
.B abuild
where the root directory of the LinuxBIOS build tree resides. Per default
this is
.B "../.."
as the
.B abuild
script resides in
.BR "[LBROOT]/utils/abuild" .
.TP
.B "\-a, \-\-all"
Build previously succeeded ports as well.
.TP
.B "\-b, \-\-broken"
Attempt to build ports that are known to be broken.
.TP
.B "\-p, \-\-payloads <dir>"
Use payloads in
.B "<dir>"
to build images.
.TP
.B "\-t, \-\-target <vendor/board>"
Attempt to build target vendor/board only.
.TP
.B "\-x, \-\-xml"
Write an XML log file instead of a plain-text one.
The file will be called
.B abuild.xml
and will be created in the current directory.
.TP
.B "\-v, \-\-verbose"
More verbose output.
.TP
.B "\-h, \-\-help"
Show a help text and exit.
.TP
.B "\-V, \-\-version"
Show version information and exit.
.SH BUGS
Please report any bugs at http://bugzilla.openbios.org/.
.SH LICENCE
.B abuild
is covered by the GNU General Public License (GPL), version 2 or later.
.SH SEE ALSO
.BR romcc (1),
.BR flashrom (1).
.SH COPYRIGHT
2004 Stefan Reinauer
.br
2006 coresystems GmbH
.SH AUTHORS
Stefan Reinauer <stepan at openbios.org>
.PP
This manual page was written by Uwe Hermann <uwe at hermann-uwe.de>
for the Debian GNU/Linux system (but may be used by others).
It is licensed under the terms of the GNU GPL (v2 or later).
-------------- next part --------------
Index: util/flashrom/flashrom.1
===================================================================
--- util/flashrom/flashrom.1 (Revision 2424)
+++ util/flashrom/flashrom.1 (Arbeitskopie)
@@ -1,6 +1,4 @@
-.\" Copyright (C) 2006 Uwe Hermann <uwe at hermann-uwe.de>.
-.\" This manpage is licensed under the terms of the GNU GPL.
-.TH FLASHROM 1 "July 26, 2006"
+.TH FLASHROM 1 "September 19, 2006"
.SH NAME
flashrom \- the universal LinuxBIOS flash utility
.SH SYNOPSIS
@@ -12,55 +10,56 @@
.SH OPTIONS
If no file is specified, then all that happens
is that flash info is dumped and the flash chip is set to writable.
-
+.TP
.B "\-r, \-\-read"
Read flash and save contents into file.
-.PP
+.TP
.B "\-w, \-\-write"
Write file into flash (default when file is specified).
-.PP
+.TP
.B "\-v, \-\-verify"
Verify flash against file.
-.PP
+.TP
.B "\-E, \-\-erase"
Erase flash device.
-.PP
+.TP
.B "\-V, \-\-verbose"
More verbose output.
-.PP
+.TP
.B "\-c, \-\-chip" <chipname>
Probe only for specified flash chip.
-.PP
+.TP
.B "\-s, \-\-estart" <addr>
Exclude start position. (obsolete)
-.PP
+.TP
.B "\-e, \-\-eend" <addr>
Exclude end postion. (obsolete)
-.PP
+.TP
.B "\-m, \-\-mainboard" <vendor:part>
Override mainboard settings.
-.PP
+.TP
.B "\-f, \-\-force"
Force write without checking image.
-.PP
+.TP
.B "\-l, \-\-layout" <layout.file>
Read ROM layout from file.
-.PP
+.TP
.B "\-i, \-\-image" <name>
Only flash image name from flash layout.
-.PP
+.TP
.B "\-h, \-\-help"
Show a help text and exit.
-.\".PP
+.\".TP
.\".B "\-\-version"
.\"Show version information and exit.
.SH BUGS
Please report any bugs at http://bugzilla.openbios.org/.
.SH LICENCE
.B flashrom
-is covered by the GNU General Public License (GPL).
+is covered by the GNU General Public License (GPL), version 2 or later.
.SH SEE ALSO
-.BR romcc (1).
+.BR romcc (1),
+.BR abuild (1).
.SH COPYRIGHT
2000 Silicon Integrated System Corporation
.br
@@ -78,5 +77,6 @@
.br
some others
.PP
-This manual page was written by Uwe Hermann <uwe at hermann-uwe.de>,
+This manual page was written by Uwe Hermann <uwe at hermann-uwe.de>
for the Debian GNU/Linux system (but may be used by others).
+It is licensed under the terms of the GNU GPL (v2 or later).
Index: util/romcc/romcc.1
===================================================================
--- util/romcc/romcc.1 (Revision 2424)
+++ util/romcc/romcc.1 (Arbeitskopie)
@@ -1,230 +1,228 @@
-.\" Copyright (C) 2006 Uwe Hermann <uwe at hermann-uwe.de>.
-.\" This manpage is licensed under the terms of the GNU GPL.
-.TH ROMCC 1 "September 7, 2006"
+.TH ROMCC 1 "September 19, 2006"
.SH NAME
romcc \- compile C programs into binaries that don't use any RAM
.SH SYNOPSIS
.B romcc
-.BR [ OPTIONS ]
-.IR "<source>" ".c"
+[OPTIONS]
+<source>.c
.SH DESCRIPTION
.B romcc
is a C compiler which produces binaries which do not rely on RAM, but
instead only use CPU registers.
-.br
+.PP
It is prominently used in the LinuxBIOS project to compile C code which
needs to run before the (Linux)BIOS has initialized the RAM, but can be
used for other purposes, too.
.SH OPTIONS
+.TP
.B "\-o" <filename>
Output file name.
-.PP
+.TP
.B "\-f<option>"
Specify a generic compiler option.
-.PP
+.TP
.B "\-m<option>"
Specify an architecture-dependent compiler option.
-.PP
+.TP
.B "\-\-"
Specify that this is the last option.
-.PP
.SH "GENERIC COMPILER OPTIONS"
.B "\-O"
-.PP
+.TP
.B "\-O2"
-.PP
+.TP
.B "\-E"
-.PP
+.TP
.B "\-ftrigraphs"
-.PP
+.TP
.B "\-fno-trigraphs"
-.PP
+.TP
.B "\-fpp-only"
-.PP
+.TP
.B "\-fno-pp-only"
-.PP
+.TP
.B "\-feliminate-inefectual-code"
-.PP
+.TP
.B "\-fno-eliminate-inefectual-code"
-.PP
+.TP
.B "\-fsimplify"
-.PP
+.TP
.B "\-fno-simplify"
-.PP
+.TP
.B "\-fscc-transform"
-.PP
+.TP
.B "\-fno-scc-transform"
-.PP
+.TP
.B "\-fsimplify-op"
-.PP
+.TP
.B "\-fno-simplify-op"
-.PP
+.TP
.B "\-fsimplify-phi"
-.PP
+.TP
.B "\-fno-simplify-phi"
-.PP
+.TP
.B "\-fsimplify-label"
-.PP
+.TP
.B "\-fno-simplify-label"
-.PP
+.TP
.B "\-fsimplify-branch"
-.PP
+.TP
.B "\-fno-simplify-branch"
-.PP
+.TP
.B "\-fsimplify-copy"
-.PP
+.TP
.B "\-fno-simplify-copy"
-.PP
+.TP
.B "\-fsimplify-arith"
-.PP
+.TP
.B "\-fno-simplify-arith"
-.PP
+.TP
.B "\-fsimplify-shift"
-.PP
+.TP
.B "\-fno-simplify-shift"
-.PP
+.TP
.B "\-fsimplify-bitwise"
-.PP
+.TP
.B "\-fno-simplify-bitwise"
-.PP
+.TP
.B "\-fsimplify-logical"
-.PP
+.TP
.B "\-fno-simplify-logical"
-.PP
+.TP
.B "\-fsimplify-bitfield"
-.PP
+.TP
.B "\-fno-simplify-bitfield"
-.PP
+.TP
.B "\-finline-policy=always"
-.PP
+.TP
.B "\-finline-policy=never"
-.PP
+.TP
.B "\-finline-policy=defaulton"
-.PP
+.TP
.B "\-finline-policy=defaultoff"
-.PP
+.TP
.B "\-finline-policy=nopenalty"
-.PP
+.TP
.B "\-fdebug-all"
-.PP
+.TP
.B "\-fno-debug-all"
-.PP
+.TP
.B "\-fdebug-abort-on-error"
-.PP
+.TP
.B "\-fno-debug-abort-on-error"
-.PP
+.TP
.B "\-fdebug-basic-blocks"
-.PP
+.TP
.B "\-fno-debug-basic-blocks"
-.PP
+.TP
.B "\-fdebug-fdominators"
-.PP
+.TP
.B "\-fno-debug-fdominators"
-.PP
+.TP
.B "\-fdebug-rdominators"
-.PP
+.TP
.B "\-fno-debug-rdominators"
-.PP
+.TP
.B "\-fdebug-triples"
-.PP
+.TP
.B "\-fno-debug-triples"
-.PP
+.TP
.B "\-fdebug-interference"
-.PP
+.TP
.B "\-fno-debug-interference"
-.PP
+.TP
.B "\-fdebug-scc-transform"
-.PP
+.TP
.B "\-fno-debug-scc-transform"
-.PP
+.TP
.B "\-fdebug-scc-transform2"
-.PP
+.TP
.B "\-fno-debug-scc-transform2"
-.PP
+.TP
.B "\-fdebug-rebuild-ssa-form"
-.PP
+.TP
.B "\-fno-debug-rebuild-ssa-form"
-.PP
+.TP
.B "\-fdebug-inline"
-.PP
+.TP
.B "\-fno-debug-inline"
-.PP
+.TP
.B "\-fdebug-live-range-conflicts"
-.PP
+.TP
.B "\-fno-debug-live-range-conflicts"
-.PP
+.TP
.B "\-fdebug-live-range-conflicts2"
-.PP
+.TP
.B "\-fno-debug-live-range-conflicts2"
-.PP
+.TP
.B "\-fdebug-color-graph"
-.PP
+.TP
.B "\-fno-debug-color-graph"
-.PP
+.TP
.B "\-fdebug-color-graph2"
-.PP
+.TP
.B "\-fno-debug-color-graph2"
-.PP
+.TP
.B "\-fdebug-coalescing"
-.PP
+.TP
.B "\-fno-debug-coalescing"
-.PP
+.TP
.B "\-fdebug-coalescing2"
-.PP
+.TP
.B "\-fno-debug-coalescing2"
-.PP
+.TP
.B "\-fdebug-verification"
-.PP
+.TP
.B "\-fno-debug-verification"
-.PP
+.TP
.B "\-fdebug-calls"
-.PP
+.TP
.B "\-fno-debug-calls"
-.PP
+.TP
.B "\-fdebug-calls2"
-.PP
+.TP
.B "\-fno-debug-calls2"
-.PP
+.TP
.B "\-fdebug-tokens"
-.PP
+.TP
.B "\-fno-debug-tokens"
-.PP
+.TP
.B "\-flabel-prefix=<prefix for assembly language labels>"
-.PP
+.TP
.B "\-\-label-prefix=<prefix for assembly language labels>"
-.PP
+.TP
.B "\-I<include path>"
-.PP
+.TP
.B "\-D<macro>[=defn]"
-.PP
+.TP
.B "\-U<macro>"
.SH "ARCHITECTURE-SPECIFIC COMPILER OPTIONS"
.B "\-mmmx"
-.PP
+.TP
.B "\-mno-mmx"
-.PP
+.TP
.B "\-msse"
-.PP
+.TP
.B "\-mno-sse"
-.PP
+.TP
.B "\-mnoop-copy"
-.PP
+.TP
.B "\-mno-noop-copy"
-.PP
+.TP
.B "\-mcpu=i386"
-.PP
+.TP
.B "\-mcpu=p2"
-.PP
+.TP
.B "\-mcpu=p3"
-.PP
+.TP
.B "\-mcpu=p4"
-.PP
+.TP
.B "\-mcpu=k7"
-.PP
+.TP
.B "\-mcpu=k8"
-.PP
+.TP
.B "\-mcpu=c3"
-.PP
+.TP
.B "\-mcpu=c3-2"
.SH BUGS
Please report any bugs to Eric W. Biederman <ebiederman at lnxi.com>.
@@ -232,7 +230,8 @@
.B romcc
is covered by the GNU General Public License (GPL), version 2.
.SH SEE ALSO
-.BR flashrom (1).
+.BR flashrom (1),
+.BR abuild (1).
.SH COPYRIGHT
2003-2006 Eric W. Biederman
.SH AUTHORS
@@ -240,4 +239,6 @@
.br
Some contributions by others.
.PP
-This manual page was written by Uwe Hermann <uwe at hermann-uwe.de>.
+This manual page was written by Uwe Hermann <uwe at hermann-uwe.de>
+for the Debian GNU/Linux system (but may be used by others).
+It is licensed under the terms of the GNU GPL (v2 or later).
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 189 bytes
Desc: Digital signature
URL: <http://www.coreboot.org/pipermail/coreboot/attachments/20060919/a99ebe10/attachment.sig>
More information about the coreboot
mailing list