summaryrefslogtreecommitdiff
path: root/docs/reference/glib/building.xml
diff options
context:
space:
mode:
Diffstat (limited to 'docs/reference/glib/building.xml')
-rw-r--r--docs/reference/glib/building.xml48
1 files changed, 11 insertions, 37 deletions
diff --git a/docs/reference/glib/building.xml b/docs/reference/glib/building.xml
index d165c5c23..e30cd66c4 100644
--- a/docs/reference/glib/building.xml
+++ b/docs/reference/glib/building.xml
@@ -29,7 +29,7 @@
On FreeBSD:
<literallayout>
- <userinput>env CPPFLAGS="-I/usr/local/include" LDFLAGS="-L/usr/local/lib -Wl,--disable-new-dtags" meson -Dxattr=false -Dinstalled_tests=true -Diconv=external -Db_lundef=false _build</userinput>
+ <userinput>env CPPFLAGS="-I/usr/local/include" LDFLAGS="-L/usr/local/lib -Wl,--disable-new-dtags" meson -Dxattr=false -Dinstalled_tests=true -Db_lundef=false _build</userinput>
<userinput>ninja -C _build</userinput>
</literallayout>
</para>
@@ -60,7 +60,7 @@
Before you can compile the GLib library, you need to have
various other tools and libraries installed on your system.
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://gitlab.gnome.org/GNOME/glib/-/blob/main/docs/toolchain-requirements.md">a compliant C toolchain</ulink>,
<application>Meson</application>, and <application>pkg-config</application>;
the requirements are the same when building from a Git repository clone
of GLib.
@@ -98,16 +98,12 @@
</para>
<para>
If your system has an <function>iconv()</function> implementation but
- you want to use libiconv instead, you can pass the
- <option>-Diconv=gnu</option> option to <command>meson</command>. This
- forces libiconv to be used.
- </para>
- <para>
- Note that if you have libiconv installed in your default include
- search path (for instance, in <filename>/usr/local/</filename>), but
- don't enable it, you will get an error while compiling GLib because
- the <filename>iconv.h</filename> that libiconv installs hides the
- system iconv.
+ you want to use libiconv instead, make sure it is installed to the
+ default compiler header/library search path (for instance, in
+ <filename>/usr/local/</filename>). The <filename>iconv.h</filename>
+ that libiconv installs hides the system iconv. Meson then detects
+ this, recognizes that the system iconv is unusable and the external
+ one is mandatory, and automatically forces it to be used.
</para>
<para>
If you are using the native iconv implementation on Solaris
@@ -209,15 +205,10 @@
<para>
This is a standard <application>Meson</application> option which
specifies how much debugging and optimization to enable. If the build
- type starts with <literal>debug</literal>,
+ type is <literal>debug</literal>,
<literal>G_ENABLE_DEBUG</literal> will be defined and GLib will be built
- with additional debug code enabled.
- </para>
- <para>
- If the build type is <literal>plain</literal>, GLib will not enable any
- optimization or debug options by default, and will leave it entirely to
- the user to choose their options. To build with the options recommended
- by GLib developers, choose <literal>release</literal>.
+ with additional debug code enabled. You can override this behavior using
+ <option>-Dglib_debug</option>.
</para>
</formalpara>
@@ -343,23 +334,6 @@
<filename>meson-logs</filename> directory.
</para>
</formalpara>
-
- <formalpara>
- <title><option>-Druntime_libdir=RELPATH</option></title>
-
- <para>
- Allows specifying a relative path to where to install the runtime
- libraries (meaning library files used for running, not developing,
- GLib applications). This can be used in operating system setups where
- programs using GLib needs to run before e.g. <filename>/usr</filename>
- is mounted.
- For example, if <varname>LIBDIR</varname> is <filename>/usr/lib</filename> and
- <filename>../../lib</filename> is passed to
- <option>-Druntime_libdir</option> then the
- runtime libraries are installed into <filename>/lib</filename> rather
- than <filename>/usr/lib</filename>.
- </para>
- </formalpara>
</refsect1>
</refentry>