* Makefile (manpages): New target.

(doc/config.guess.1): Build man page with help2man.
	(doc/config.sub.1): Likewise.
	* doc/config.guess.x: Copied from Autoconf tree.
	* doc/config.guess.1: Generate.
	* doc/config.sub.1: Likewise.
This commit is contained in:
Ben Elliston 2015-11-22 20:41:43 +11:00
parent 6778268ff8
commit 87a3b5e5fd
5 changed files with 114 additions and 0 deletions

View File

@ -1,3 +1,12 @@
2015-11-22 Ben Elliston <bje@gnu.org>
* Makefile (manpages): New target.
(doc/config.guess.1): Build man page with help2man.
(doc/config.sub.1): Likewise.
* doc/config.guess.x: Copied from Autoconf tree.
* doc/config.guess.1: Generate.
* doc/config.sub.1: Likewise.
2015-11-22 Ben Elliston <bje@gnu.org>
* config.sub (usage): Put usage on one line.

View File

@ -2,6 +2,14 @@ all:
check: check-guess check-sub
manpages: doc/config.guess.1 doc/config.sub.1
doc/config.guess.1:
help2man -N --include=doc/config.guess.x --output=$@ ./config.guess
doc/config.sub.1:
help2man -N --name "validate and canonicalize a configuration triplet" --output=$@ ./config.sub
check-guess:
cd testsuite && sh config-guess.sh && rm uname

48
doc/config.guess.1 Normal file
View File

@ -0,0 +1,48 @@
.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.44.1.
.TH CONFIG.GUESS "1" "November 2015" "config.guess (2015-11-19)" "User Commands"
.SH NAME
config.guess \- guess the build system triplet
.SH SYNOPSIS
.B config.guess
[\fIOPTION\fR]
.SH DESCRIPTION
The GNU build system distinguishes three types of machines, the
`build' machine on which the compilers are run, the `host' machine
on which the package being built will run, and, exclusively when you
build a compiler, assembler etc., the `target' machine, for which the
compiler being built will produce code.
This script will guess the type of the `build' machine.
.PP
Output the configuration name of the system `config.guess' is run on.
.SS "Operation modes:"
.TP
\fB\-h\fR, \fB\-\-help\fR
print this help, then exit
.TP
\fB\-t\fR, \fB\-\-time\-stamp\fR
print date of last modification, then exit
.TP
\fB\-v\fR, \fB\-\-version\fR
print version number, then exit
.SH "ENVIRONMENT VARIABLES"
config.guess might need to compile and run C code, hence it needs a
compiler for the `build' machine: use the environment variable
`CC_FOR_BUILD' to specify the compiler for the build machine. If
`CC_FOR_BUILD' is not specified, `CC' will be used. Be sure to
specify `CC_FOR_BUILD' is `CC' is a cross-compiler to the `host'
machine.
CC_FOR_BUILD a native C compiler, defaults to `cc'
CC a native C compiler, CC_FOR_BUILD is preferred
.SH "REPORTING BUGS"
Report bugs and patches to <config\-patches@gnu.org>.
.PP
.br
Originally written by Per Bothner.
.br
Copyright 1992\-2015 Free Software Foundation, Inc.
.PP
.br
This is free software; see the source for copying conditions. There is NO
warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

22
doc/config.guess.x Normal file
View File

@ -0,0 +1,22 @@
[name]
config.guess \- guess the build system triplet
[Environment variables]
config.guess might need to compile and run C code, hence it needs a
compiler for the `build' machine: use the environment variable
`CC_FOR_BUILD' to specify the compiler for the build machine. If
`CC_FOR_BUILD' is not specified, `CC' will be used. Be sure to
specify `CC_FOR_BUILD' is `CC' is a cross-compiler to the `host'
machine.
CC_FOR_BUILD a native C compiler, defaults to `cc'
CC a native C compiler, CC_FOR_BUILD is preferred
[description]
The GNU build system distinguishes three types of machines, the
`build' machine on which the compilers are run, the `host' machine
on which the package being built will run, and, exclusively when you
build a compiler, assembler etc., the `target' machine, for which the
compiler being built will produce code.
This script will guess the type of the `build' machine.

27
doc/config.sub.1 Normal file
View File

@ -0,0 +1,27 @@
.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.44.1.
.TH CONFIG.SUB "1" "November 2015" "config.sub (2015-11-22)" "User Commands"
.SH NAME
config.sub \- validate and canonicalize a configuration triplet
.SH SYNOPSIS
.B config.sub
[\fIOPTION\fR] \fICPU-MFR-OPSYS or ALIAS\fR
.SH DESCRIPTION
Canonicalize a configuration name.
.SS "Operation modes:"
.TP
\fB\-h\fR, \fB\-\-help\fR
print this help, then exit
.TP
\fB\-t\fR, \fB\-\-time\-stamp\fR
print date of last modification, then exit
.TP
\fB\-v\fR, \fB\-\-version\fR
print version number, then exit
.SH "REPORTING BUGS"
Report bugs and patches to <config\-patches@gnu.org>.
.SH COPYRIGHT
Copyright 1992\-2015 Free Software Foundation, Inc.
.PP
.br
This is free software; see the source for copying conditions. There is NO
warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.