Added the "libtool" target type and "phony" variable
This commit is contained in:
parent
17d5fb9d81
commit
446f56b846
@ -28,6 +28,9 @@
|
|||||||
</authorgroup>
|
</authorgroup>
|
||||||
<copyright>
|
<copyright>
|
||||||
<year>2012</year>
|
<year>2012</year>
|
||||||
|
<year>2013</year>
|
||||||
|
<year>2014</year>
|
||||||
|
<year>2015</year>
|
||||||
<holder>&firstname; &surname; <&email;></holder>
|
<holder>&firstname; &surname; <&email;></holder>
|
||||||
</copyright>
|
</copyright>
|
||||||
<legalnotice>
|
<legalnotice>
|
||||||
@ -80,36 +83,47 @@
|
|||||||
<para>
|
<para>
|
||||||
In the default section:
|
In the default section:
|
||||||
<itemizedlist>
|
<itemizedlist>
|
||||||
<listitem><para>subdirs: subdirectories to look for too</para></listitem>
|
<listitem><para><varname>subdirs</varname>: subdirectories to look for
|
||||||
<listitem><para>cppflags_force: CPPFLAGS to force
|
too</para></listitem>
|
||||||
|
<listitem><para><varname>cppflags_force</varname>: CPPFLAGS to force
|
||||||
globally</para></listitem>
|
globally</para></listitem>
|
||||||
<listitem><para>cppflags: optional global CPPFLAGS</para></listitem>
|
<listitem><para><varname>cppflags</varname>: optional global
|
||||||
<listitem><para>cflags_force: CFLAGS to force globally</para></listitem>
|
CPPFLAGS</para></listitem>
|
||||||
<listitem><para>cflags: optional global CFLAGS</para></listitem>
|
<listitem><para><varname>cflags_force</varname>: CFLAGS to force
|
||||||
<listitem><para>ldflags_force: LDFLAGS to force globally</para></listitem>
|
globally</para></listitem>
|
||||||
<listitem><para>ldflags: optional global LDFLAGS</para></listitem>
|
<listitem><para><varname>cflags</varname>: optional global
|
||||||
<listitem><para>targets: targets to handle in the
|
CFLAGS</para></listitem>
|
||||||
|
<listitem><para><varname>ldflags_force</varname>: LDFLAGS to force
|
||||||
|
globally</para></listitem>
|
||||||
|
<listitem><para><varname>ldflags</varname>: optional global
|
||||||
|
LDFLAGS</para></listitem>
|
||||||
|
<listitem><para><varname>targets</varname>: targets to handle in the
|
||||||
Makefile</para></listitem>
|
Makefile</para></listitem>
|
||||||
<listitem><para>dist: additional files to include in a source
|
<listitem><para><varname>dist</varname>: additional files to include in a
|
||||||
archive</para></listitem>
|
source archive</para></listitem>
|
||||||
</itemizedlist>
|
</itemizedlist>
|
||||||
</para>
|
</para>
|
||||||
<para>In subsequent sections, respectively named after the target
|
<para>In subsequent sections, respectively named after the target
|
||||||
they define:
|
they define:
|
||||||
<itemizedlist>
|
<itemizedlist>
|
||||||
<listitem><para>type (mandatory): type of the target (eg "binary",
|
<listitem><para><varname>type</varname> (mandatory): type of the target (eg
|
||||||
"library", "object", ...)</para></listitem>
|
<emphasis>binary</emphasis>, <emphasis>library</emphasis>,
|
||||||
<listitem><para>cppflags: additional CPPFLAGS for this
|
<emphasis>object</emphasis>, ...)</para></listitem>
|
||||||
|
<listitem><para><varname>cppflags</varname>: additional CPPFLAGS for this
|
||||||
target</para></listitem>
|
target</para></listitem>
|
||||||
<listitem><para>cflags: additional CFLAGS for this
|
<listitem><para><varname>cflags</varname>: additional CFLAGS for this
|
||||||
target</para></listitem>
|
target</para></listitem>
|
||||||
<listitem><para>ldflags: additional LDFLAGS for this
|
<listitem><para><varname>ldflags</varname>: additional LDFLAGS for this
|
||||||
target</para></listitem>
|
target</para></listitem>
|
||||||
<listitem><para>sources: source files to compile</para></listitem>
|
<listitem><para><varname>sources</varname>: source files to
|
||||||
<listitem><para>depends: a list of files (or other targets) that this
|
compile</para></listitem>
|
||||||
target depends on</para></listitem>
|
<listitem><para><varname>depends</varname>: a list of files (or other
|
||||||
<listitem><para>install: the destination path for
|
targets) that this target depends on</para></listitem>
|
||||||
|
<listitem><para><varname>install</varname>: the destination path for
|
||||||
installation</para></listitem>
|
installation</para></listitem>
|
||||||
|
<listitem><para><varname>phony</varname>: determines if the target defined
|
||||||
|
should always be built, regardless of the presence of a file of a same
|
||||||
|
name (possible values: 0, 1)</para></listitem>
|
||||||
</itemizedlist>
|
</itemizedlist>
|
||||||
</para>
|
</para>
|
||||||
</refsect2>
|
</refsect2>
|
||||||
@ -121,19 +135,24 @@
|
|||||||
<para>
|
<para>
|
||||||
The following target types are currently supported:
|
The following target types are currently supported:
|
||||||
<itemizedlist>
|
<itemizedlist>
|
||||||
<listitem><para>"binary": produces binary files, linked from every object
|
<listitem><para><emphasis>binary</emphasis>: produces binary files, linked
|
||||||
file produced with their source files.</para></listitem>
|
from every object file produced with their source
|
||||||
<listitem><para>"library": produces a static and a shared version of the
|
files.</para></listitem>
|
||||||
target, linked from every object file produced with their source files,
|
<listitem><para><emphasis>library</emphasis>: produces a static and a
|
||||||
and respectively appending ".a" and ".so" extensions to the target name;
|
shared version of the target, linked from every object file produced with
|
||||||
the shared object are also assigned a version number.</para></listitem>
|
their source files, and respectively appending ".a" and ".so" extensions
|
||||||
<listitem><para>"object": produces a binary object file from the given
|
to the target name; the shared object are also assigned a version
|
||||||
source.</para></listitem>
|
number.</para></listitem>
|
||||||
<listitem><para>"plugin": produces a shared version of the target, linked
|
<listitem><para><emphasis>libtool</emphasis>: uses the <ulink url="http://www.gnu.org/software/libtool/">libtool</ulink> project to generate libraries, as supported by the project on the underlying platform.</para></listitem>
|
||||||
from every object file produced with their source files, and appending
|
<listitem><para><emphasis>object</emphasis>: produces a binary object file
|
||||||
the ".so" extension to the target name.</para></listitem>
|
from the given source.</para></listitem>
|
||||||
<listitem><para>"script": runs the given script, expecting the target
|
<listitem><para><emphasis>plugin</emphasis>: produces a shared version of
|
||||||
file to be generated from the sources defined.</para></listitem>
|
the target, linked from every object file produced with their source
|
||||||
|
files, and appending the ".so" extension to the target
|
||||||
|
name.</para></listitem>
|
||||||
|
<listitem><para><emphasis>script</emphasis>: runs the given script,
|
||||||
|
expecting the target file to be generated from the sources
|
||||||
|
defined.</para></listitem>
|
||||||
</itemizedlist>
|
</itemizedlist>
|
||||||
</para>
|
</para>
|
||||||
</refsect2>
|
</refsect2>
|
||||||
|
Loading…
Reference in New Issue
Block a user