Revision: 1918 http://geany.svn.sourceforge.net/geany/?rev=1918&view=rev Author: ntrel Date: 2007-09-28 08:43:01 -0700 (Fri, 28 Sep 2007)
Log Message: ----------- Add documentation for --no-preprocessing option.
Modified Paths: -------------- trunk/ChangeLog trunk/NEWS trunk/doc/geany.1.in trunk/doc/geany.html trunk/doc/geany.txt
Modified: trunk/ChangeLog =================================================================== --- trunk/ChangeLog 2007-09-28 11:48:55 UTC (rev 1917) +++ trunk/ChangeLog 2007-09-28 15:43:01 UTC (rev 1918) @@ -7,6 +7,8 @@ * src/main.c, src/symbols.c, src/symbols.h: Add --no-preprocessing, -P option when generating tags files to disable preprocessing of C/C++ source files. + * doc/geany.txt, doc/geany.html, doc/geany.1.in, NEWS: + Add documentation for --no-preprocessing option.
2007-09-27 Enrico Tröger <enrico(dot)troeger(at)uvena(dot)de>
Modified: trunk/NEWS =================================================================== --- trunk/NEWS 2007-09-28 11:48:55 UTC (rev 1917) +++ trunk/NEWS 2007-09-28 15:43:01 UTC (rev 1918) @@ -51,6 +51,8 @@ * Added auto_complete_whilst_editing hidden preference. * Speed up Save All for C-like files. * Don't show file opened/saved/closed messages on the status bar. + * Added --no-preprocessing, -P option when generating tags files to + disable preprocessing of C/C++ source files. (Thanks also to Christoph Berg for updating the icon code).
Docs:
Modified: trunk/doc/geany.1.in =================================================================== --- trunk/doc/geany.1.in 2007-09-28 11:48:55 UTC (rev 1917) +++ trunk/doc/geany.1.in 2007-09-28 15:43:01 UTC (rev 1918) @@ -23,7 +23,9 @@ .IP "\fB\fP \fB--ft-names\fP " 10 Print a list of Geany's internal filetype names (useful for the auto completion list). .IP "\fB-g\fP \fB--generate-tags\fP " 10 -Generate global tags file (see documentation). +Generate a global tags file (see documentation). +.IP "\fB-P\fP \fB--no-preprocessing\fP " 10 +Don't preprocess C/C++ files when generating tags. .IP "\fB-i\fP \fB--new-instance\fP " 10 Don't open files in a running instance, force opening a new instance. Only available if Geany was compiled with support for Sockets.
Modified: trunk/doc/geany.html =================================================================== --- trunk/doc/geany.html 2007-09-28 11:48:55 UTC (rev 1917) +++ trunk/doc/geany.html 2007-09-28 15:43:01 UTC (rev 1918) @@ -420,8 +420,8 @@ <table border="1" class="docutils"> <colgroup> <col width="13%" /> -<col width="26%" /> -<col width="61%" /> +<col width="25%" /> +<col width="62%" /> </colgroup> <thead valign="bottom"> <tr><th class="head">Short option</th> @@ -437,7 +437,7 @@ <tr><td>-c dir_name</td> <td>--config=directory_name</td> <td>Use an alternate configuration directory. Default -configuration directory is ~/.geany/ and there resides +configuration directory is <tt class="docutils literal"><span class="pre">~/.geany/</span></tt> and there resides <tt class="docutils literal"><span class="pre">geany.conf</span></tt> and other configuration files.</td> </tr> <tr><td>-d</td> @@ -450,6 +450,15 @@ <td>Print a list of Geany's internal filetype names (useful for the auto completion list).</td> </tr> +<tr><td>-g</td> +<td>--generate-tags</td> +<td>Generate a global tags file (see +<a class="reference" href="#generating-a-global-tags-file">Generating a global tags file</a>).</td> +</tr> +<tr><td>-P</td> +<td>--no-preprocessing</td> +<td>Don't preprocess C/C++ files when generating tags.</td> +</tr> <tr><td>-i</td> <td>--new-instance</td> <td>Do not open files in a running instance, force opening @@ -482,7 +491,7 @@ <td>--no-terminal</td> <td>Do not load terminal support. Use this option if you do not want to load the virtual terminal emulator widget -at startup. If you do not have libvte.so.4 installed, +at startup. If you do not have <tt class="docutils literal"><span class="pre">libvte.so.4</span></tt> installed, then terminal-support is automatically disabled. Only available if Geany was compiled with support for VTE.</td> </tr> @@ -1150,7 +1159,7 @@ <p>You can generate your own global tags files by parsing a list of source files. The command is:</p> <pre class="literal-block"> -geany -g <Tag File> <File list> +geany -g [-P] <Tag File> <File list> </pre> <ul class="simple"> <li>Tag File should be in the format described earlier -- see the @@ -1158,6 +1167,11 @@ <li>File list is a list of filenames, each with a full path (unless you are generating C/C++ tags and have set the CFLAGS environment variable appropriately).</li> +<li><tt class="docutils literal"><span class="pre">-P</span></tt> or <tt class="docutils literal"><span class="pre">--no-preprocessing</span></tt> disables using the C pre-processor +to process <tt class="docutils literal"><span class="pre">#include</span></tt> directives for C/C++ source files. Use this +option if you want to specify each source file on the command-line +instead of using a 'master' header file. Also can be useful if you +don't want to specify the CFLAGS environment variable.</li> </ul> <p>Example for the wxD library for the D programming language:</p> <pre class="literal-block"> @@ -1183,8 +1197,6 @@ will be loaded instead of the default global.tags. You should keep a copy of the generated tags file because it will get overwritten when upgrading Geany.</p> -<p>This is a temporary solution -- in later versions this will be -unnecessary.</p> </div> </div> </div> @@ -3066,7 +3078,7 @@ <div class="footer"> <hr class="footer" /> <a class="reference" href="geany.txt">View document source</a>. -Generated on: 2007-09-13 16:43 UTC. +Generated on: 2007-09-28 15:47 UTC. Generated by <a class="reference" href="http://docutils.sourceforge.net/">Docutils</a> from <a class="reference" href="http://docutils.sourceforge.net/rst.html">reStructuredText</a> source.
</div>
Modified: trunk/doc/geany.txt =================================================================== --- trunk/doc/geany.txt 2007-09-28 11:48:55 UTC (rev 1917) +++ trunk/doc/geany.txt 2007-09-28 15:43:01 UTC (rev 1918) @@ -180,7 +180,7 @@ *none* --column Set initial column number for the first opened file.
-c dir_name --config=directory_name Use an alternate configuration directory. Default - configuration directory is ~/.geany/ and there resides + configuration directory is ``~/.geany/`` and there resides ``geany.conf`` and other configuration files.
-d --debug Run Geany in debug mode, which means being verbose @@ -189,6 +189,11 @@ *none* --ft-names Print a list of Geany's internal filetype names (useful for the auto completion list).
+-g --generate-tags Generate a global tags file (see + `Generating a global tags file`_). + +-P --no-preprocessing Don't preprocess C/C++ files when generating tags. + -i --new-instance Do not open files in a running instance, force opening a new instance. Only available if Geany was compiled with support for Sockets. @@ -207,7 +212,7 @@
-t --no-terminal Do not load terminal support. Use this option if you do not want to load the virtual terminal emulator widget - at startup. If you do not have libvte.so.4 installed, + at startup. If you do not have ``libvte.so.4`` installed, then terminal-support is automatically disabled. Only available if Geany was compiled with support for VTE.
@@ -952,13 +957,18 @@ You can generate your own global tags files by parsing a list of source files. The command is::
- geany -g <Tag File> <File list> + geany -g [-P] <Tag File> <File list>
* Tag File should be in the format described earlier -- see the section called `Global tags`_. * File list is a list of filenames, each with a full path (unless you are generating C/C++ tags and have set the CFLAGS environment variable appropriately). +* ``-P`` or ``--no-preprocessing`` disables using the C pre-processor + to process ``#include`` directives for C/C++ source files. Use this + option if you want to specify each source file on the command-line + instead of using a 'master' header file. Also can be useful if you + don't want to specify the CFLAGS environment variable.
Example for the wxD library for the D programming language::
@@ -991,11 +1001,8 @@ copy of the generated tags file because it will get overwritten when upgrading Geany.
-This is a temporary solution -- in later versions this will be -unnecessary.
- Preferences -----------
This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.