DeforaOS/configure
2
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Re-indented

Browse Source
This commit is contained in:
Pierre Pronchery 2012-05-05 00:53:46 +00:00
parent 9a93bcc313
commit 57d0856ff5
1 changed files with 40 additions and 40 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

80
doc/configure.xml
View File

@ -2,21 +2,21 @@
<!-- $Id$ --> <!-- $Id$ -->
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook V4.5//EN" <!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!ENTITY firstname "Pierre"> <!ENTITY firstname "Pierre">
<!ENTITY surname "Pronchery"> <!ENTITY surname "Pronchery">
<!ENTITY email "khorben@defora.org"> <!ENTITY email "khorben@defora.org">
<!ENTITY title "configure documentation"> <!ENTITY title "configure documentation">
]> ]>
<article> <article>
<info> <info>
<title>&title;</title> <title>&title;</title>
<author> <author>
<firstname>&firstname;</firstname> <firstname>&firstname;</firstname>
<surname>&surname;</surname> <surname>&surname;</surname>
<contrib>Code and documentation.</contrib> <contrib>Code and documentation.</contrib>
<address> <address>
<email>&email;</email> <email>&email;</email>
</address> </address>
</author> </author>
</info> </info>
<para> <para>
@ -30,10 +30,10 @@
<section> <section>
<title>What is configure</title> <title>What is configure</title>
<para> <para>
configure generates Makefiles needed in an entire project. Instead configure generates Makefiles needed in an entire project. Instead
of trying every little trick to let it work in a number of of trying every little trick to let it work in a number of
potential uses, it sticks to the simplest possible code potential uses, it sticks to the simplest possible code
generation. generation.
</para> </para>
</section> </section>
<section> <section>
@ -67,8 +67,8 @@
<listitem><para>for people learning software development using Makefiles;</para></listitem> <listitem><para>for people learning software development using Makefiles;</para></listitem>
<listitem><para>for developers of C/C++ software projects;</para></listitem> <listitem><para>for developers of C/C++ software projects;</para></listitem>
<listitem><para>for developers concerned by the readability, <listitem><para>for developers concerned by the readability,
efficiency, portability or maintenance of their efficiency, portability or maintenance of their
Makefiles.</para></listitem> Makefiles.</para></listitem>
</itemizedlist> </itemizedlist>
</para> </para>
</section> </section>
@ -115,9 +115,9 @@
The most significant variables are the following: The most significant variables are the following:
<itemizedlist> <itemizedlist>
<listitem><para>in the default section (has an empty name, eg "[]" in the file) <listitem><para>in the default section (has an empty name, eg "[]" in the file)
<itemizedlist> <itemizedlist>
<listitem><para>subdirs: subdirectories to look for <listitem><para>subdirs: subdirectories to look for
too</para></listitem> too</para></listitem>
<listitem><para>cppflags_force: CPPFLAGS to force globally</para></listitem> <listitem><para>cppflags_force: CPPFLAGS to force globally</para></listitem>
<listitem><para>cppflags: optional global CPPFLAGS</para></listitem> <listitem><para>cppflags: optional global CPPFLAGS</para></listitem>
<listitem><para>cflags_force: CFLAGS to force globally</para></listitem> <listitem><para>cflags_force: CFLAGS to force globally</para></listitem>
@ -126,19 +126,19 @@
<listitem><para>ldflags: optional global LDFLAGS</para></listitem> <listitem><para>ldflags: optional global LDFLAGS</para></listitem>
<listitem><para>targets: targets to handle in the Makefile</para></listitem> <listitem><para>targets: targets to handle in the Makefile</para></listitem>
<listitem><para>dist: additional files to include in a source archive</para></listitem> <listitem><para>dist: additional files to include in a source archive</para></listitem>
</itemizedlist></para></listitem> </itemizedlist></para></listitem>
<listitem><para>in sections named like the target they define: <listitem><para>in sections named like the target they define:
<itemizedlist> <itemizedlist>
<listitem><para>type (mandatory): type of the target (eg "binary", "library", "object", ...)</para></listitem> <listitem><para>type (mandatory): type of the target (eg "binary", "library", "object", ...)</para></listitem>
<listitem><para>cppflags: additional CPPFLAGS for this target</para></listitem> <listitem><para>cppflags: additional CPPFLAGS for this target</para></listitem>
<listitem><para>cflags: additional CFLAGS for this target</para></listitem> <listitem><para>cflags: additional CFLAGS for this target</para></listitem>
<listitem><para>ldflags: additional LDFLAGS for this target</para></listitem> <listitem><para>ldflags: additional LDFLAGS for this target</para></listitem>
<listitem><para>sources: source files to compile</para></listitem> <listitem><para>sources: source files to compile</para></listitem>
<listitem><para>depends: a list of files (or other targets) that <listitem><para>depends: a list of files (or other targets) that
this target depends on</para></listitem> this target depends on</para></listitem>
<listitem><para>install: the destination path for installation</para></listitem> <listitem><para>install: the destination path for installation</para></listitem>
</itemizedlist> </itemizedlist>
</para></listitem> </para></listitem>
</itemizedlist> </itemizedlist>
</para> </para>
</section> </section>
@ -149,16 +149,16 @@
<itemizedlist> <itemizedlist>
<listitem><para>"binary": produces binary files, linked from every object file produced with their source files.</para></listitem> <listitem><para>"binary": produces binary files, linked from every object file produced with their source files.</para></listitem>
<listitem><para>"library": produces a static and a shared version of <listitem><para>"library": produces a static and a shared version of
the target, linked from every object file produced the target, linked from every object file produced
with their source files, and respectively appending with their source files, and respectively appending
".a" and ".so" extensions to the target name; the ".a" and ".so" extensions to the target name; the
shared object are also assigned a version number.</para></listitem> shared object are also assigned a version number.</para></listitem>
<listitem><para>"object": produces a binary object file from the given source.</para></listitem> <listitem><para>"object": produces a binary object file from the given source.</para></listitem>
<listitem><para>"plugin": produces a shared version of the target, <listitem><para>"plugin": produces a shared version of the target,
linked from every object file produced with their linked from every object file produced with their
source files, and appending the ".so" extension to the target name.</para></listitem> source files, and appending the ".so" extension to the target name.</para></listitem>
<listitem><para>"script": runs the given script, expecting the target <listitem><para>"script": runs the given script, expecting the target
file to be generated from the sources defined.</para></listitem> file to be generated from the sources defined.</para></listitem>
</itemizedlist> </itemizedlist>
</para> </para>
</section> </section>
@ -183,7 +183,7 @@
<title>Additional resources</title> <title>Additional resources</title>
<para> <para>
More information can be found on the project page at <ulink More information can be found on the project page at <ulink
url="http://www.defora.org/os/project/16/configure"/>. url="http://www.defora.org/os/project/16/configure"/>.
</para> </para>
</section> </section>
</section> </section>