autoconf-desc.sgml 2.1 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182
  1. <sect2>
  2. <title>Contents</title>
  3. <para>
  4. The Autoconf package contains the autoconf, autoheader, autoreconf,
  5. autoscan, autoupdate and ifnames programs
  6. </para>
  7. </sect2>
  8. <sect2><title>Description</title>
  9. <sect3><title>autoconf</title>
  10. <para>
  11. Autoconf is a tool for producing shell scripts that automatically
  12. configure software source code packages to adapt to many kinds of
  13. UNIX-like systems. The configuration scripts produced by Autoconf are
  14. independent of Autoconf when they are run, so their users do not need to
  15. have Autoconf.
  16. </para>
  17. </sect3>
  18. <sect3><title>autoheader</title>
  19. <para>
  20. The autoheader program can create a template file of C #define
  21. statements for configure to use
  22. </para>
  23. </sect3>
  24. <sect3><title>autoreconf</title>
  25. <para>
  26. If you have a lot of Autoconf-generated configure scripts, the
  27. autoreconf program can save you some work. It runs autoconf (and
  28. autoheader, where appropriate) repeatedly to remake the Autoconf
  29. configure scripts and configuration header templates in the directory
  30. tree rooted at the current directory.
  31. </para>
  32. </sect3>
  33. <sect3><title>autoscan</title>
  34. <para>
  35. The autoscan program can help you create a configure.in file for
  36. a software package. autoscan examines source files in the directory
  37. tree rooted at a directory given as a command line argument, or the
  38. current directory if none is given. It searches the source files for
  39. common portability problems and creates a file configure.scan which
  40. is a preliminary configure.in for that package.
  41. </para>
  42. </sect3>
  43. <sect3><title>autoupdate</title>
  44. <para>
  45. The autoupdate program updates a configure.in file that calls
  46. Autoconf macros by their old names to use the current macro names.
  47. </para>
  48. </sect3>
  49. <sect3><title>ifnames</title>
  50. <para>
  51. ifnames can help when writing a configure.in for a software
  52. package. It prints the identifiers that the package already uses in C
  53. preprocessor conditionals. If a package has already been set up to
  54. have some portability, this program can help you figure out what its
  55. configure needs to check for. It may help fill in some gaps in a
  56. configure.in generated by autoscan.
  57. </para>
  58. </sect3>
  59. </sect2>