luc14n0/glib
1
0
Fork 0
mirror of https://gitlab.gnome.org/GNOME/glib.git synced 2025-08-18 14:48:53 +02:00
Code Issues Packages Projects Releases Wiki Activity

docs: Update DocBook ‘build’ documentation to mention Meson

Browse Source 
Drop mentions of autotools. In particular, update the list of configure
options to reflect what’s available in the Meson build.

Further work is needed as a follow-up to improve our handling of (what
was formerly) the --enable-debug option.

Signed-off-by: Philip Withnall <withnall@endlessm.com>
This commit is contained in:
Philip Withnall
2019-01-09 11:41:32 +00:00
parent 64bd539d15
commit d08e4661de
1 changed files with 74 additions and 143 deletions
Download Patch File Download Diff File Expand all files Collapse all files

217
docs/reference/glib/building.xml
View File

@@ -17,28 +17,22 @@
<refsect1 id="building"> <refsect1 id="building">
<title>Building the Library on UNIX</title> <title>Building the Library on UNIX</title>
<para> <para>
On UNIX, GLib uses the standard GNU build system, On UNIX, GLib uses the standard <application>Meson</application> build
using <application>autoconf</application> for package system. The normal sequence for compiling and installing the GLib library
configuration and resolving portability issues, is thus:
<application>automake</application> for building makefiles
that comply with the GNU Coding Standards, and
<application>libtool</application> for building shared
libraries on multiple platforms. The normal sequence for
compiling and installing the GLib library is thus:
<literallayout> <literallayout>
<userinput>./configure</userinput> <userinput>meson _build</userinput>
<userinput>make</userinput> <userinput>ninja -C _build</userinput>
<userinput>make install</userinput> <userinput>ninja -C _build install</userinput>
</literallayout> </literallayout>
</para> </para>
<para> <para>
The standard options provided by <application>GNU The standard options provided by <application>Meson</application> may be
autoconf</application> may be passed to the passed to the <command>meson</command> command. Please see the
<command>configure</command> script. Please see the <application>Meson</application> documentation or run
<application>autoconf</application> documentation or run <command>meson configure --help</command> for information about
<command>./configure --help</command> for information about
the standard options. the standard options.
</para> </para>
<para> <para>
@@ -61,10 +55,9 @@
various other tools and libraries installed on your system. various other tools and libraries installed on your system.
If you are building from a release archive, you will need If you are building from a release archive, you will need
<ulink url="https://wiki.gnome.org/Projects/GLib/CompilerRequirements">a compliant C toolchain</ulink>, <ulink url="https://wiki.gnome.org/Projects/GLib/CompilerRequirements">a compliant C toolchain</ulink>,
GNU Make, and <application>pkg-config</application>; <application>Meson</application>, and <application>pkg-config</application>;
if you are building directly from a Git repository clone the requirements are the same when building from a Git repository clone
of GLib, you will also need the GNU Autotools mentioned of GLib.
above.
</para> </para>
<itemizedlist> <itemizedlist>
<listitem> <listitem>
@@ -78,17 +71,6 @@
information). information).
</para> </para>
</listitem> </listitem>
<listitem>
<para>
The GLib Makefiles make use of several features specific to
<ulink url="http://www.gnu.org/software/make">GNU
make</ulink>, and will not build correctly with other
versions of <command>make</command>. You will need to
install it if you don't already have it on your system. (It
may be called <command>gmake</command> rather than
<command>make</command>.)
</para>
</listitem>
</itemizedlist> </itemizedlist>
<para> <para>
A UNIX build of GLib requires that the system implements at A UNIX build of GLib requires that the system implements at
@@ -111,8 +93,8 @@
<para> <para>
If your system has an <function>iconv()</function> implementation but If your system has an <function>iconv()</function> implementation but
you want to use libiconv instead, you can pass the you want to use libiconv instead, you can pass the
<option>--with-libiconv</option> option to configure. This forces <option>-Diconv=gnu</option> option to <command>meson</command>. This
libiconv to be used. forces libiconv to be used.
</para> </para>
<para> <para>
Note that if you have libiconv installed in your default include Note that if you have libiconv installed in your default include
@@ -169,14 +151,14 @@
<function>getxattr()</function> family of functions that may be <function>getxattr()</function> family of functions that may be
provided by the C library or by the standalone libattr library. To provided by the C library or by the standalone libattr library. To
build GLib without extended attribute support, use the build GLib without extended attribute support, use the
<option>--disable-xattr</option> option. <option>-Dxattr=false</option> option.
</para> </para>
</listitem> </listitem>
<listitem> <listitem>
<para> <para>
The optional SELinux support in GIO requires libselinux. The optional SELinux support in GIO requires libselinux.
To build GLib without SELinux support, use the To build GLib without SELinux support, use the
<option>--disable-selinux</option> option. <option>-Dselinux=false</option> option.
</para> </para>
</listitem> </listitem>
<listitem> <listitem>
@@ -184,17 +166,17 @@
The optional support for DTrace requires the The optional support for DTrace requires the
<filename>sys/sdt.h</filename> header, which is provided <filename>sys/sdt.h</filename> header, which is provided
by SystemTap on Linux. To build GLib without DTrace, use by SystemTap on Linux. To build GLib without DTrace, use
the <option>--disable-dtrace</option> configure option. the <option>-Ddtrace=false</option> option.
</para> </para>
</listitem> </listitem>
<listitem> <listitem>
<para> <para>
The optional support for The optional support for
<ulink url="http://sourceware.org/systemtap/">SystemTap</ulink> <ulink url="http://sourceware.org/systemtap/">SystemTap</ulink>
can be disabled with the <option>--disable-systemtap</option> can be disabled with the <option>-Dsystemtap=false</option>
configure option. Additionally, you can control the location option. Additionally, you can control the location
where GLib installs the SystemTap probes, using the where GLib installs the SystemTap probes, using the
<option>--with-tapset-install-dir=DIR</option> configure option. <option>-Dtapset_install_dir=DIR</option> option.
</para> </para>
</listitem> </listitem>
</itemizedlist> </itemizedlist>
@@ -204,60 +186,43 @@
<title>Extra Configuration Options</title> <title>Extra Configuration Options</title>
<para> <para>
In addition to the normal options, the In addition to the normal options, these additional ones are supported
<command>configure</command> script in the GLib when configuring the GLib library:
library supports these additional arguments:
</para> </para>
<formalpara> <formalpara>
<title><option>--enable-debug</option></title> <title><option>--buildtype</option></title>
<para> <para>
Turns on various amounts of debugging support. Setting this to 'no' This is a standard <application>Meson</application> option which
disables <function>g_assert()</function>, <function>g_return_if_fail()</function>, specifies how much debugging and optimization to enable. If the build
<function>g_return_val_if_fail()</function> and all cast checks type starts with <literal>debug</literal>,
between different object types. Setting it to 'minimum' disables <literal>G_ENABLE_DEBUG</literal> will be defined and GLib will be built
only cast checks. Setting it to 'yes' enables <link linkend="G-DEBUG:CAPS">runtime debugging</link>. with additional debug code enabled.
The default is 'minimum' for stable releases, and 'yes' for development
snapshots. Note that 'no' is fast, but dangerous as it tends to destabilize
even mostly bug-free software by changing the effect of many bugs
from simple warnings into fatal crashes. Thus
<option>--enable-debug=no</option> should <emphasis>not</emphasis>
be used for stable releases of GLib.
</para> </para>
</formalpara> </formalpara>
<formalpara> <formalpara>
<title><option>--with-threads</option></title> <title><option>-Dforce_posix_threads=true</option></title>
<para> <para>
Specify a thread implementation to use. Available options are Normally, <application>Meson</application> should be able to work out
'posix' or 'win32'. Normally, <command>configure</command> the correct thread implementation to use. This option forces POSIX
should be able to work out the system threads API on its own. threads to be used even if the platform provides another threading API
(for example, on Windows).
</para> </para>
</formalpara> </formalpara>
<formalpara> <formalpara>
<title><option>--with-pcre</option></title> <title><option>-Dinternal_pcre=true</option></title>
<para> <para>
Specify whether to use the internal or the system-supplied Normally, GLib will be configured to use the system-supplied PCRE
PCRE library. library if it is suitable, falling back to an internal version
<itemizedlist> otherwise. If this option is specified, the internal version will always
<listitem> be used.
<para> </para>
'internal' means that GRegex will be compiled to use <para>
the internal PCRE library.
</para>
</listitem>
<listitem>
<para>
'system' means that GRegex will be compiled to use
the system-supplied PCRE library; this is the default
setting.
</para>
</listitem>
</itemizedlist>
Using the internal PCRE is the preferred solution if: Using the internal PCRE is the preferred solution if:
<itemizedlist> <itemizedlist>
<listitem> <listitem>
@@ -288,30 +253,8 @@
</formalpara> </formalpara>
<formalpara> <formalpara>
<title><option>--disable-included-printf</option> and <title><option>-Dbsymbolic_functions=false</option> and
<option>--enable-included-printf</option></title> <option>-Dbsymbolic_functions=true</option></title>
<para>
By default the <command>configure</command> script will try
to auto-detect whether the C library provides a suitable set
of <function>printf()</function> functions. In detail,
<command>configure</command> checks that the semantics of
<function>snprintf()</function> are as specified by C99
and that positional parameters as specified in the Single Unix
Specification are supported. If this not the case, GLib will
include an implementation of the <function>printf()</function>
family.
</para>
<para>
These options can be used to explicitly control whether
an implementation of the <function>printf()</function> family
should be included or not.
</para>
</formalpara>
<formalpara>
<title><option>--disable-Bsymbolic</option> and
<option>--enable-Bsymbolic</option></title>
<para> <para>
By default, GLib uses the <option>-Bsymbolic-functions</option> By default, GLib uses the <option>-Bsymbolic-functions</option>
@@ -320,18 +263,17 @@
internal uses of GLib functions with internal uses of GLib functions with
<envar>LD_PRELOAD</envar>. Therefore, it may make <envar>LD_PRELOAD</envar>. Therefore, it may make
sense to turn this feature off in some situations. sense to turn this feature off in some situations.
The <option>--disable-Bsymbolic</option> option allows The <option>-Dbsymbolic_functions=false</option> option allows
to do that. to do that.
</para> </para>
</formalpara> </formalpara>
<formalpara> <formalpara>
<title><option>--disable-gtk-doc</option> and <title><option>-Dgtk_doc=false</option> and
<option>--enable-gtk-doc</option></title> <option>-Dgtk_doc=true</option></title>
<para> <para>
By default the <command>configure</command> script will try By default, GLib will detect whether the
to auto-detect whether the
<application>gtk-doc</application> package is installed. <application>gtk-doc</application> package is installed.
If it is, then it will use it to extract and build the If it is, then it will use it to extract and build the
documentation for the GLib library. These options documentation for the GLib library. These options
@@ -344,13 +286,12 @@
</formalpara> </formalpara>
<formalpara> <formalpara>
<title><option>--disable-man</option> and <title><option>-Dman=false</option> and
<option>--enable-man</option></title> <option>-Dman=true</option></title>
<para> <para>
By default the <command>configure</command> script will try By default, GLib will detect whether <application>xsltproc</application>
to auto-detect whether <application>xsltproc</application> and the necessary DocBook stylesheets are installed.
and the necessary Docbook stylesheets are installed.
If they are, then it will use them to rebuild the included If they are, then it will use them to rebuild the included
man pages from the XML sources. These options can be used man pages from the XML sources. These options can be used
to explicitly control whether man pages should be rebuilt to explicitly control whether man pages should be rebuilt
@@ -360,12 +301,12 @@
</formalpara> </formalpara>
<formalpara> <formalpara>
<title><option>--disable-xattr</option> and <title><option>-Dxattr=false</option> and
<option>--enable-xattr</option></title> <option>-Dxattr=true</option></title>
<para> <para>
By default the <command>configure</command> script will try By default, GLib will detect whether the
to auto-detect whether the <function>getxattr()</function> <function>getxattr()</function>
family of functions is available. If it is, then extended family of functions is available. If it is, then extended
attribute support will be included in GIO. These options can attribute support will be included in GIO. These options can
be used to explicitly control whether extended attribute be used to explicitly control whether extended attribute
@@ -376,54 +317,54 @@
</formalpara> </formalpara>
<formalpara> <formalpara>
<title><option>--disable-selinux</option> and <title><option>-Dselinux=false</option> and
<option>--enable-selinux</option></title> <option>-Dselinux=true</option></title>
<para> <para>
By default the <command>configure</command> script will By default, GLib will detect if libselinux is available and
auto-detect if libselinux is available and include include SELinux support in GIO if it is. These options can be
SELinux support in GIO if it is. These options can be
used to explicitly control whether SELinux support should used to explicitly control whether SELinux support should
be included. be included.
</para> </para>
</formalpara> </formalpara>
<formalpara> <formalpara>
<title><option>--disable-dtrace</option> and <title><option>-Ddtrace=false</option> and
<option>--enable-dtrace</option></title> <option>-Ddtrace=true</option></title>
<para> <para>
By default the <command>configure</command> script will By default, GLib will detect if DTrace support is available, and use it.
detect if DTrace support is available, and use it. These options can be used to explicitly control whether DTrace support
is compiled into GLib.
</para> </para>
</formalpara> </formalpara>
<formalpara> <formalpara>
<title><option>--disable-systemtap</option> and <title><option>-Dsystemtap=false</option> and
<option>--enable-systemtap</option></title> <option>-Dsystemtap=true</option></title>
<para> <para>
This option requires DTrace support. If it is available, then This option requires DTrace support. If it is available, then
the <command>configure</command> script will also check for GLib will also check for the presence of SystemTap.
the presence of SystemTap.
</para> </para>
</formalpara> </formalpara>
<formalpara> <formalpara>
<title><option>--enable-coverage</option> and <title><option>-Db_coverage=true</option> and
<option>--disable-coverage</option></title> <option>-Db_coverage=false</option></title>
<para> <para>
Enable the generation of coverage reports for the GLib tests. Enable the generation of coverage reports for the GLib tests.
This requires the lcov frontend to gcov from the This requires the lcov frontend to gcov from the
<ulink url="http://ltp.sourceforge.net">Linux Test Project</ulink>. <ulink url="http://ltp.sourceforge.net">Linux Test Project</ulink>.
To generate a coverage report, use the lcov make target. The To generate a coverage report, use
report is placed in the <filename>glib-lcov</filename> directory. <command>ninja coverage-html</command>. The report is placed in the
<filename>meson-logs</filename> directory.
</para> </para>
</formalpara> </formalpara>
<formalpara> <formalpara>
<title><option>--with-runtime-libdir=RELPATH</option></title> <title><option>-Druntime_libdir=RELPATH</option></title>
<para> <para>
Allows specifying a relative path to where to install the runtime Allows specifying a relative path to where to install the runtime
@@ -433,21 +374,11 @@
is mounted. is mounted.
For example, if <varname>LIBDIR</varname> is <filename>/usr/lib</filename> and For example, if <varname>LIBDIR</varname> is <filename>/usr/lib</filename> and
<filename>../../lib</filename> is passed to <filename>../../lib</filename> is passed to
<option>--with-runtime-libdir</option> then the <option>-Druntime_libdir</option> then the
runtime libraries are installed into <filename>/lib</filename> rather runtime libraries are installed into <filename>/lib</filename> rather
than <filename>/usr/lib</filename>. than <filename>/usr/lib</filename>.
</para> </para>
</formalpara> </formalpara>
<formalpara>
<title><option>--with-python=PATH</option></title>
<para>
Allows specifying the Python interpreter to use, either as an absolute path,
or as a program name. GLib can be built with Python 2 (at least version 2.7)
or, preferably, with Python 3.
</para>
</formalpara>
</refsect1> </refsect1>
</refentry> </refentry>