SF.net SVN: geany:[5474] trunk
ntrel at users.sourceforge.net
ntrel at xxxxx
Tue Dec 7 18:02:53 UTC 2010
Revision: 5474
http://geany.svn.sourceforge.net/geany/?rev=5474&view=rev
Author: ntrel
Date: 2010-12-07 18:02:53 +0000 (Tue, 07 Dec 2010)
Log Message:
-----------
Update Ignore Tags section with example and menu item.
Modified Paths:
--------------
trunk/ChangeLog
trunk/doc/geany.html
trunk/doc/geany.txt
Modified: trunk/ChangeLog
===================================================================
--- trunk/ChangeLog 2010-12-07 17:42:31 UTC (rev 5473)
+++ trunk/ChangeLog 2010-12-07 18:02:53 UTC (rev 5474)
@@ -16,6 +16,8 @@
List 2 Tools->Configuration Files menu items.
Add 'Plugin Manager' section break.
Edit some related sections.
+ * doc/geany.txt, doc/geany.html:
+ Update Ignore Tags section with example and menu item.
2010-12-06 Nick Treleaven <nick(dot)treleaven(at)btinternet(dot)com>
Modified: trunk/doc/geany.html
===================================================================
--- trunk/doc/geany.html 2010-12-07 17:42:31 UTC (rev 5473)
+++ trunk/doc/geany.html 2010-12-07 18:02:53 UTC (rev 5474)
@@ -6,7 +6,7 @@
<meta name="generator" content="Docutils 0.4: http://docutils.sourceforge.net/" />
<title>Geany</title>
<meta name="authors" content="Enrico Tröger Nick Treleaven Frank Lanitz" />
-<meta name="date" content="2010-11-23" />
+<meta name="date" content="2010-12-07" />
<style type="text/css">
/*
@@ -139,7 +139,7 @@
<br />Nick Treleaven
<br />Frank Lanitz</td></tr>
<tr><th class="docinfo-name">Date:</th>
-<td>2010-11-23</td></tr>
+<td>2010-12-07</td></tr>
<tr><th class="docinfo-name">Version:</th>
<td>0.20</td></tr>
</tbody>
@@ -263,7 +263,7 @@
<li><a class="reference" href="#generating-a-global-tags-file" id="id80" name="id80">Generating a global tags file</a></li>
</ul>
</li>
-<li><a class="reference" href="#ignore-tags" id="id81" name="id81">Ignore tags</a></li>
+<li><a class="reference" href="#c-ignore-tags" id="id81" name="id81">C Ignore tags</a></li>
</ul>
</li>
<li><a class="reference" href="#preferences" id="id82" name="id82">Preferences</a><ul>
@@ -2002,14 +2002,25 @@
</div>
</div>
<div class="section">
-<h3><a class="toc-backref" href="#id81" id="ignore-tags" name="ignore-tags">Ignore tags</a></h3>
-<p>You can also ignore certain tags if they would lead to wrong parsing of
-the code. Simply create a file called "ignore.tags" in your Geany
-configuration directory (usually <tt class="docutils literal"><span class="pre">~/.config/geany/</span></tt>). Then list all tags
-you want to ignore in this file, separated by spaces and/or newlines.</p>
-<p>More detailed information about the usage from the Exuberant Ctags
+<h3><a class="toc-backref" href="#id81" id="c-ignore-tags" name="c-ignore-tags">C Ignore tags</a></h3>
+<p>You can ignore certain tags for C-based languages if they would lead
+to wrong parsing of the code. Use the <em>Tools->Configuration
+Files->ignore.tags</em> menu item to open the user <tt class="docutils literal"><span class="pre">ignore.tags</span></tt> file.
+See also <a class="reference" href="#configuration-file-paths">Configuration file paths</a>.</p>
+<p>List all tag names you want to ignore in this file, separated by spaces
+and/or newlines.</p>
+<p>Example:</p>
+<pre class="literal-block">
+G_GNUC_NULL_TERMINATED
+G_GNUC_PRINTF
+G_GNUC_WARN_UNUSED_RESULT
+</pre>
+<p>This will parse code like:</p>
+<p><tt class="docutils literal"><span class="pre">gchar</span> <span class="pre">**utils_strv_new(const</span> <span class="pre">gchar</span> <span class="pre">*first,</span> <span class="pre">...)</span>
+<span class="pre">G_GNUC_NULL_TERMINATED;</span></tt></p>
+<p>More detailed information about ignore tags usage from the Exuberant Ctags
manual page:</p>
-<pre class="literal-block">
+<blockquote>
Specifies a list of identifiers which are to be specially handled
while parsing C and C++ source files. This option is specifically
provided to handle special cases arising through the use of
@@ -2019,8 +2030,7 @@
ignore any parenthesis-enclosed argument list which may immediately
follow the identifier in the source files.
If two identifiers are separated with the '=' character, the first
-identifiers is replaced by the second identifiers for parsing purposes.
-</pre>
+identifiers is replaced by the second identifiers for parsing purposes.</blockquote>
<p>For even more detailed information please read the manual page of
Exuberant Ctags.</p>
</div>
@@ -6383,7 +6393,7 @@
<div class="footer">
<hr class="footer" />
<a class="reference" href="geany.txt">View document source</a>.
-Generated on: 2010-12-07 17:39 UTC.
+Generated on: 2010-12-07 18:00 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 2010-12-07 17:42:31 UTC (rev 5473)
+++ trunk/doc/geany.txt 2010-12-07 18:02:53 UTC (rev 5474)
@@ -1621,17 +1621,31 @@
upgrading Geany.
-Ignore tags
-^^^^^^^^^^^
+C Ignore tags
+^^^^^^^^^^^^^
-You can also ignore certain tags if they would lead to wrong parsing of
-the code. Simply create a file called "ignore.tags" in your Geany
-configuration directory (usually ``~/.config/geany/``). Then list all tags
-you want to ignore in this file, separated by spaces and/or newlines.
+You can ignore certain tags for C-based languages if they would lead
+to wrong parsing of the code. Use the *Tools->Configuration
+Files->ignore.tags* menu item to open the user ``ignore.tags`` file.
+See also `Configuration file paths`_.
-More detailed information about the usage from the Exuberant Ctags
-manual page::
+List all tag names you want to ignore in this file, separated by spaces
+and/or newlines.
+Example::
+
+ G_GNUC_NULL_TERMINATED
+ G_GNUC_PRINTF
+ G_GNUC_WARN_UNUSED_RESULT
+
+This will parse code like:
+
+``gchar **utils_strv_new(const gchar *first, ...)
+G_GNUC_NULL_TERMINATED;``
+
+More detailed information about ignore tags usage from the Exuberant Ctags
+manual page:
+
Specifies a list of identifiers which are to be specially handled
while parsing C and C++ source files. This option is specifically
provided to handle special cases arising through the use of
This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.
More information about the Commits
mailing list