From 87a3b5e5fd28844b09eca317ed5222a944593323 Mon Sep 17 00:00:00 2001 From: Ben Elliston Date: Sun, 22 Nov 2015 20:41:43 +1100 Subject: [PATCH] * 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. --- ChangeLog | 9 +++++++++ Makefile | 8 ++++++++ doc/config.guess.1 | 48 ++++++++++++++++++++++++++++++++++++++++++++++ doc/config.guess.x | 22 +++++++++++++++++++++ doc/config.sub.1 | 27 ++++++++++++++++++++++++++ 5 files changed, 114 insertions(+) create mode 100644 doc/config.guess.1 create mode 100644 doc/config.guess.x create mode 100644 doc/config.sub.1 diff --git a/ChangeLog b/ChangeLog index 51102ce..673745e 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,12 @@ +2015-11-22 Ben Elliston + + * 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 * config.sub (usage): Put usage on one line. diff --git a/Makefile b/Makefile index 5d8a2bb..e4d353d 100644 --- a/Makefile +++ b/Makefile @@ -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 diff --git a/doc/config.guess.1 b/doc/config.guess.1 new file mode 100644 index 0000000..302f6ac --- /dev/null +++ b/doc/config.guess.1 @@ -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 . +.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. diff --git a/doc/config.guess.x b/doc/config.guess.x new file mode 100644 index 0000000..83fcdd2 --- /dev/null +++ b/doc/config.guess.x @@ -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. diff --git a/doc/config.sub.1 b/doc/config.sub.1 new file mode 100644 index 0000000..d4c1af2 --- /dev/null +++ b/doc/config.sub.1 @@ -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 . +.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.