mirror/autoconf
2
0
Fork 0
mirror of git://git.sv.gnu.org/autoconf synced 2024-12-15 02:20:10 +08:00
Code Issues Packages Projects Releases Wiki Activity
a71de63184
autoconf/man/autoheader.1

103 lines
2.3 KiB
Groff
Raw Normal View History

Have autoheader honor --force. * doc/make-stds.texi, doc/standards.texi: Update from masters. * lib/Autom4te/Channels.pm, lib/Autom4te/Configure_ac.pm * lib/Autom4te/FileUtils.pm, lib/Autom4te/XFile.pm: Update from masters, so that FileUtils.pm's update_file provide --force support. * bin/autoheader.in: Pass $force to update_file so that config.h.in is always recreated when --force.
2005-01-27 18:53:41 +08:00
.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.35.
Regenerate.
2005-02-05 08:47:57 +08:00
.TH AUTOHEADER "1" "February 2005" "autoheader 2.59c" "User Commands"
Added the man pages to the archive.
2000-01-27 17:41:25 +08:00
.SH NAME
* configure.ac: Bumpto 2.54c.
2002-10-28 18:52:05 +08:00
autoheader \- Create a template header for configure
Added the man pages to the archive.
2000-01-27 17:41:25 +08:00
.SH SYNOPSIS
.B autoheader
[\fIOPTION\fR] ... [\fITEMPLATE-FILE\fR]
.SH DESCRIPTION
Create a template file of C `#define' statements for `configure' to
Have autoheader honor --force. * doc/make-stds.texi, doc/standards.texi: Update from masters. * lib/Autom4te/Channels.pm, lib/Autom4te/Configure_ac.pm * lib/Autom4te/FileUtils.pm, lib/Autom4te/XFile.pm: Update from masters, so that FileUtils.pm's update_file provide --force support. * bin/autoheader.in: Pass $force to update_file so that config.h.in is always recreated when --force.
2005-01-27 18:53:41 +08:00
use. To this end, scan TEMPLATE\-FILE, or `configure.ac' if present,
* autoconf.sh: Promote `configure.ac' over `configure.in'. * autoreconf.sh: Likewise. * autoheader.sh: Ditto. * autoupdate.sh: Similarly. * doc/autoconf.texi: Adjust. * tests/atspecific.m4: Be sure to remove configure.in. Adjust the test suite to use `configure.ac'.
2000-12-23 18:11:57 +08:00
or else `configure.in'.
Added the man pages to the archive.
2000-01-27 17:41:25 +08:00
.TP
1999-11-10 Akim Demaille <akim@epita.fr> Require GNU m4 1.4 (well 1.3 in fact). Because we are ready to handle the case where there are no frozen files, we *have* to pass a -I, which is dangerous in conjunction with the silent including of `aclocal.m4': you may include things that were not expected. Since anyway handling pre 1.3 complicates the task, just require an m4 which supports reloading of frozen files. * acspecific.m4 (AC_PROG_GNU_M4): Check for --reload. * autoconf.sh: Likewise * autoheader.sh: Likewise. * configure.in: Explicitly state the m4 version you want.
2000-01-29 17:51:17 +08:00
\fB\-h\fR, \fB\-\-help\fR
print this help, then exit
.TP
The whole family supports -V = --version. * acgeneral.m4 (AC_INIT_PARSE_ARGS): Report and support -V. * autoconf.sh: Likewise. * autoreconf.sh: Likewise. * autoupdate.sh: Likewise. * autoheader.sh: Likewise. * autoscan.pl: Likewise. * ifnames.sh: Likewise. In addition, don't dump --help on invalid options. * doc/autoconf.texi: Adjusted. * doc/install.texi: Likewise.
2000-03-03 02:17:26 +08:00
\fB\-V\fR, \fB\-\-version\fR
1999-11-10 Akim Demaille <akim@epita.fr> Require GNU m4 1.4 (well 1.3 in fact). Because we are ready to handle the case where there are no frozen files, we *have* to pass a -I, which is dangerous in conjunction with the silent including of `aclocal.m4': you may include things that were not expected. Since anyway handling pre 1.3 complicates the task, just require an m4 which supports reloading of frozen files. * acspecific.m4 (AC_PROG_GNU_M4): Check for --reload. * autoconf.sh: Likewise * autoheader.sh: Likewise. * configure.in: Explicitly state the m4 version you want.
2000-01-29 17:51:17 +08:00
print version number, then exit
.TP
The whole family supports -V = --version. * acgeneral.m4 (AC_INIT_PARSE_ARGS): Report and support -V. * autoconf.sh: Likewise. * autoreconf.sh: Likewise. * autoupdate.sh: Likewise. * autoheader.sh: Likewise. * autoscan.pl: Likewise. * ifnames.sh: Likewise. In addition, don't dump --help on invalid options. * doc/autoconf.texi: Adjusted. * doc/install.texi: Likewise.
2000-03-03 02:17:26 +08:00
\fB\-v\fR, \fB\-\-verbose\fR
verbosely report processing
.TP
Added the man pages to the archive.
2000-01-27 17:41:25 +08:00
\fB\-d\fR, \fB\-\-debug\fR
don't remove temporary files
.TP
* bin/autoconf.in, bin/autoheader.in: --force, -f is a new option.
2001-08-07 15:55:07 +08:00
\fB\-f\fR, \fB\-\-force\fR
* Makefile.maint (AUTOM4TE): Neutralize autom4te. Suggested by Jim Meyering.
2001-09-22 00:17:38 +08:00
consider all files obsolete
* bin/autoconf.in, bin/autoheader.in: --force, -f is a new option.
2001-08-07 15:55:07 +08:00
.TP
Simplify the handling of `acconfig.h'. * autoheader.sh: No longer try to select the needed paragraphs of `acconfig.h', just dump everything into `config.h.in'. Implement support for `--warnings'. Warn the users that these auxiliary files are obsolete when `-W obsolete'. * doc/autoconf.texi (Invoking autoheader): Adjust.
2000-05-03 19:22:50 +08:00
\fB\-W\fR, \fB\-\-warnings\fR=\fICATEGORY\fR
report the warnings falling in CATEGORY
.SS "Warning categories include:"
.TP
* bin/autoheader.in (&parse_args): Use &parse_warnings and &parse_WARNINGS. ($help): Use Autom4te::ChannelDefs::usage. * bin/autoscan.in: Use Autom4te::ChannelDefs. * lib/Autom4te/General.pm: Don't export error: you don't own it.
2003-08-22 01:31:25 +08:00
`cross'
cross compilation issues
.TP
`gnu'
GNU coding standards (default in gnu and gnits modes)
.TP
Simplify the handling of `acconfig.h'. * autoheader.sh: No longer try to select the needed paragraphs of `acconfig.h', just dump everything into `config.h.in'. Implement support for `--warnings'. Warn the users that these auxiliary files are obsolete when `-W obsolete'. * doc/autoconf.texi (Invoking autoheader): Adjust.
2000-05-03 19:22:50 +08:00
`obsolete'
* bin/autoheader.in (&parse_args): Use &parse_warnings and &parse_WARNINGS. ($help): Use Autom4te::ChannelDefs::usage. * bin/autoscan.in: Use Autom4te::ChannelDefs. * lib/Autom4te/General.pm: Don't export error: you don't own it.
2003-08-22 01:31:25 +08:00
obsolete features or constructions
.TP
`override'
user redefinitions of Automake rules or variables
.TP
`portability'
portability issues
.TP
`syntax'
dubious syntactic constructs (default)
.TP
`unsupported'
unsupported or incomplete features (default)
Simplify the handling of `acconfig.h'. * autoheader.sh: No longer try to select the needed paragraphs of `acconfig.h', just dump everything into `config.h.in'. Implement support for `--warnings'. Warn the users that these auxiliary files are obsolete when `-W obsolete'. * doc/autoconf.texi (Invoking autoheader): Adjust.
2000-05-03 19:22:50 +08:00
.TP
`all'
all the warnings
.TP
Have autoheader honor --force. * doc/make-stds.texi, doc/standards.texi: Update from masters. * lib/Autom4te/Channels.pm, lib/Autom4te/Configure_ac.pm * lib/Autom4te/FileUtils.pm, lib/Autom4te/XFile.pm: Update from masters, so that FileUtils.pm's update_file provide --force support. * bin/autoheader.in: Pass $force to update_file so that config.h.in is always recreated when --force.
2005-01-27 18:53:41 +08:00
`no\-CATEGORY'
* bin/autoheader.in (&parse_args): Use &parse_warnings and &parse_WARNINGS. ($help): Use Autom4te::ChannelDefs::usage. * bin/autoscan.in: Use Autom4te::ChannelDefs. * lib/Autom4te/General.pm: Don't export error: you don't own it.
2003-08-22 01:31:25 +08:00
turn off warnings in CATEGORY
* autoconf.sh: Don't show obsolete options on "--help". Report obsolete options to stderr. Adjust list of options. Correct processing of options. Process options with values separated by "=" first, so that abbreviations work. Don't accept "=" with short options. * autoheader.sh: Likewise. * autoreconf.sh: Likewise. * autoupdate.sh: Likewise. * ifnames.sh: There is no "--verbose" option. * doc/autoconf.texi: Option "-A" requires an argument. (autoreconf Invocation): Document "--install", "--symlink", "--m4dir" and the options passed to Automake.
2000-10-27 06:27:48 +08:00
.TP
`none'
turn off all the warnings
.TP
Simplify the handling of `acconfig.h'. * autoheader.sh: No longer try to select the needed paragraphs of `acconfig.h', just dump everything into `config.h.in'. Implement support for `--warnings'. Warn the users that these auxiliary files are obsolete when `-W obsolete'. * doc/autoconf.texi (Invoking autoheader): Adjust.
2000-05-03 19:22:50 +08:00
`error'
* bin/autoheader.in (&parse_args): Use &parse_warnings and &parse_WARNINGS. ($help): Use Autom4te::ChannelDefs::usage. * bin/autoscan.in: Use Autom4te::ChannelDefs. * lib/Autom4te/General.pm: Don't export error: you don't own it.
2003-08-22 01:31:25 +08:00
treat warnings as errors
* bin/autoheader.in ($localdir, $m4, $SIMPLE_BACKUP_SUFFIX): Remove, dead. * bin/autoreconf.in (&autoreconf): Do not run gettextize when `intl' is already present, as it refuses unless --force. (&parse_args): Use -I, --include instead of the old Autoconf options. ($localdir, $autoconf_dir): Remove. (@include): New. (&maybe_autoreconf): New, to preserve $_ for File::Find.
2001-10-20 14:51:41 +08:00
.SS "Library directories:"
.TP
Regen.
2002-07-17 16:35:59 +08:00
\fB\-B\fR, \fB\-\-prepend\-include\fR=\fIDIR\fR
prepend directory DIR to search path
.TP
* bin/autoheader.in ($localdir, $m4, $SIMPLE_BACKUP_SUFFIX): Remove, dead. * bin/autoreconf.in (&autoreconf): Do not run gettextize when `intl' is already present, as it refuses unless --force. (&parse_args): Use -I, --include instead of the old Autoconf options. ($localdir, $autoconf_dir): Remove. (@include): New. (&maybe_autoreconf): New, to preserve $_ for File::Find.
2001-10-20 14:51:41 +08:00
\fB\-I\fR, \fB\-\-include\fR=\fIDIR\fR
Regen.
2002-07-17 16:35:59 +08:00
append directory DIR to search path
* configure.ac: Bumpto 2.54c.
2002-10-28 18:52:05 +08:00
.SH AUTHOR
Written by Roland McGrath and Akim Demaille.
* acgeneral.m4: Adjust copyright notice. * acspecific.m4: Likewise. * acoldnames.m4: Likewise. * acversion.m4.in: Likewise. * autoconf.sh: Likewise. * autoheader.sh: Likewise. * autoreconf.sh: Likewise. * autoscan.pl: Likewise. * autoupdate.sh: Likewise. * ifnames.sh: Likewise.
2000-10-17 02:25:55 +08:00
.SH "REPORTING BUGS"
Have autoheader honor --force. * doc/make-stds.texi, doc/standards.texi: Update from masters. * lib/Autom4te/Channels.pm, lib/Autom4te/Configure_ac.pm * lib/Autom4te/FileUtils.pm, lib/Autom4te/XFile.pm: Update from masters, so that FileUtils.pm's update_file provide --force support. * bin/autoheader.in: Pass $force to update_file so that config.h.in is always recreated when --force.
2005-01-27 18:53:41 +08:00
Report bugs to <bug\-autoconf@gnu.org>.
* bin/autoheader.in, bin/autom4te.in, bin/autoreconf.in, * bin/autoscan.in, bin/autoupdate.in, bin/ifnames.in (BEGIN): Make them uniform, and more robust to Perl special characters. Reported by Martin Mokrej.
2003-05-16 17:54:46 +08:00
.SH COPYRIGHT
Regenerate.
2005-01-03 15:42:44 +08:00
Copyright \(co 2005 Free Software Foundation, Inc.
* bin/autoheader.in, bin/autom4te.in, bin/autoreconf.in, * bin/autoscan.in, bin/autoupdate.in, bin/ifnames.in (BEGIN): Make them uniform, and more robust to Perl special characters. Reported by Martin Mokrej.
2003-05-16 17:54:46 +08:00
.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.
Added the man pages to the archive.
2000-01-27 17:41:25 +08:00
.SH "SEE ALSO"
.BR autoconf (1),
* man/config.guess.x: New file. * man/config.sub.x: New file.
2000-12-07 00:02:58 +08:00
.BR automake (1),
Added the man pages to the archive.
2000-01-27 17:41:25 +08:00
.BR autoreconf (1),
.BR autoupdate (1),
.BR autoheader (1),
.BR autoscan (1),
* man/config.guess.x: New file. * man/config.sub.x: New file.
2000-12-07 00:02:58 +08:00
.BR config.guess (1),
.BR config.sub (1),
.BR ifnames (1),
.BR libtool (1).
Added the man pages to the archive.
2000-01-27 17:41:25 +08:00
.PP
The full documentation for
.B autoheader
is maintained as a Texinfo manual. If the
.B info
and
.B autoheader
programs are properly installed at your site, the command
.IP
.B info autoheader
.PP
should give you access to the complete manual.
Reference in New Issue Copy Permalink