| 1 | <?xml version="1.0" encoding="ISO-8859-1"?> | 
|---|
| 2 | <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" | 
|---|
| 3 | "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ | 
|---|
| 4 | <!ENTITY % general-entities SYSTEM "../../general.ent"> | 
|---|
| 5 | %general-entities; | 
|---|
| 6 | ]> | 
|---|
| 7 |  | 
|---|
| 8 | <sect1 id="ch-system-m4" role="wrap"> | 
|---|
| 9 | <?dbhtml filename="m4.html"?> | 
|---|
| 10 |  | 
|---|
| 11 | <title>M4-&m4-version;</title> | 
|---|
| 12 |  | 
|---|
| 13 | <indexterm zone="ch-system-m4"> | 
|---|
| 14 | <primary sortas="a-M4">M4</primary> | 
|---|
| 15 | </indexterm> | 
|---|
| 16 |  | 
|---|
| 17 | <sect2 role="package"> | 
|---|
| 18 | <title/> | 
|---|
| 19 |  | 
|---|
| 20 | <para>The M4 package contains a macro processor.</para> | 
|---|
| 21 |  | 
|---|
| 22 | </sect2> | 
|---|
| 23 |  | 
|---|
| 24 | <sect2 role="installation"> | 
|---|
| 25 | <title>Installation of M4</title> | 
|---|
| 26 |  | 
|---|
| 27 | <para os="a">Prepare M4 for compilation:</para> | 
|---|
| 28 |  | 
|---|
| 29 | <screen os="b"><userinput>./configure --prefix=/usr</userinput></screen> | 
|---|
| 30 |  | 
|---|
| 31 | <para os="c">Compile the package:</para> | 
|---|
| 32 |  | 
|---|
| 33 | <screen os="d"><userinput>make</userinput></screen> | 
|---|
| 34 |  | 
|---|
| 35 | <para os="e">To test the results, issue: | 
|---|
| 36 | <userinput>make check</userinput>.</para> | 
|---|
| 37 |  | 
|---|
| 38 | <para os="f">Install the package:</para> | 
|---|
| 39 |  | 
|---|
| 40 | <screen os="g"><userinput>make install</userinput></screen> | 
|---|
| 41 |  | 
|---|
| 42 | </sect2> | 
|---|
| 43 |  | 
|---|
| 44 | <sect2 id="contents-m4" role="content"> | 
|---|
| 45 | <title>Contents of M4</title> | 
|---|
| 46 |  | 
|---|
| 47 | <segmentedlist> | 
|---|
| 48 | <segtitle>Installed program</segtitle> | 
|---|
| 49 |  | 
|---|
| 50 | <seglistitem> | 
|---|
| 51 | <seg>m4</seg> | 
|---|
| 52 | </seglistitem> | 
|---|
| 53 | </segmentedlist> | 
|---|
| 54 |  | 
|---|
| 55 | <variablelist> | 
|---|
| 56 | <bridgehead renderas="sect3">Short Descriptions</bridgehead> | 
|---|
| 57 | <?dbfo list-presentation="list"?> | 
|---|
| 58 | <?dbhtml list-presentation="table"?> | 
|---|
| 59 |  | 
|---|
| 60 | <varlistentry id="m4"> | 
|---|
| 61 | <!-- Don't remove the extra space, it prevet a FOP warning. --> | 
|---|
| 62 | <term><command>m4 </command></term> | 
|---|
| 63 | <listitem> | 
|---|
| 64 | <para>copies the given files while expanding the macros that they | 
|---|
| 65 | contain. These macros are either built-in or user-defined and can | 
|---|
| 66 | take any number of arguments. Besides performing macro expansion, | 
|---|
| 67 | <command>m4</command> has built-in functions for including named | 
|---|
| 68 | files, running Unix commands, performing integer arithmetic, | 
|---|
| 69 | manipulating text, recursion, etc. The <command>m4</command> | 
|---|
| 70 | program can be used either as a front-end to a compiler or as a | 
|---|
| 71 | macro processor in its own right.</para> | 
|---|
| 72 | <indexterm zone="ch-system-m4 m4"> | 
|---|
| 73 | <primary sortas="b-m4">m4</primary> | 
|---|
| 74 | </indexterm> | 
|---|
| 75 | </listitem> | 
|---|
| 76 | </varlistentry> | 
|---|
| 77 |  | 
|---|
| 78 | </variablelist> | 
|---|
| 79 |  | 
|---|
| 80 | </sect2> | 
|---|
| 81 |  | 
|---|
| 82 | </sect1> | 
|---|