kde-dev-scripts/doc/man-adddebug.1.docbook

0001 <?xml version="1.0" ?>
0002 <!DOCTYPE refentry PUBLIC "-//KDE//DTD DocBook XML V4.5-Based Variant V1.1//EN" "dtd/kdedbx45.dtd" [
0003 <!ENTITY % English "INCLUDE">
0004 ]>
0005
0006 <refentry lang="&language;">
0007 <refentryinfo>
0008 <author><personname><firstname>Ben</firstname><surname>Burton</surname></personname>
0009 <email>bab@debian.org</email></author>
0010 <date>2003-03-07</date>
0011 </refentryinfo>
0012
0013 <refmeta>
0014 <refentrytitle><command>adddebug</command></refentrytitle>
0015 <manvolnum>1</manvolnum>
0016 </refmeta>
0017
0018 <refnamediv>
0019 <refname><command>adddebug</command></refname>
0020 <refpurpose>Modifies <filename>Makefile</filename>(s) to add debug info</refpurpose>
0021 </refnamediv>
0022
0023 <refsynopsisdiv>
0024 <cmdsynopsis>
0025 <command>adddebug</command>
0026 <group><option>-k</option></group>
0027 <group><option>-r</option></group>
0028 <group><option>-n</option></group>
0029 </cmdsynopsis>
0030 </refsynopsisdiv>
0031
0032 <refsect1>
0033 <title>Description</title>
0034
0035 <para><command>adddebug</command> modifies the
0036 <filename>Makefile</filename> in the current directory (and optionally
0037 in its subdirectories) to add debug info (<option>-g3</option>). It
0038 will also remove optimisations (<option>-O[1-9]</option>).</para>
0039
0040 <para>This utility is part of the &kde; Software Development Kit.</para>
0041
0042 </refsect1>
0043
0044 <refsect1>
0045 <title>Options</title>
0046
0047 <variablelist>
0048 <varlistentry>
0049 <term><option>-k</option></term>
0050 <listitem><para>Keep optimisations (do not remove <option>-O[1-9]?</option> flags which are removed by default).</para>
0051 </listitem>
0052 </varlistentry>
0053 <varlistentry>
0054 <term><option>-r</option></term>
0055 <listitem>
0056 <para>Recursively search through all subdirectories of the current directory and operate on every <filename>Makefile</filename> that is found. </para>
0057 </listitem>
0058 </varlistentry>
0059 <varlistentry>
0060 <term><option>-n</option></term>
0061 <listitem><para>compile without NDEBUG and NO_DEBUG being defined (makes <function>kDebug</function> calls work)</para></listitem>
0062 </varlistentry>
0063 </variablelist>
0064 </refsect1>
0065
0066 </refentry>