SF.net SVN: geany:[4765] trunk

[ntrel at users.sourceforge.net]

Revision: 4765
          http://geany.svn.sourceforge.net/geany/?rev=4765&view=rev
Author:   ntrel
Date:     2010-03-16 13:28:36 +0000 (Tue, 16 Mar 2010)

Log Message:
-----------
Add tip about gcc optimization & warnings/debugging.
Add Testing section.
Update Libraries section about synchronizing with other projects.

Modified Paths:
--------------
    trunk/ChangeLog
    trunk/HACKING

Modified: trunk/ChangeLog
===================================================================
--- trunk/ChangeLog	2010-03-15 14:48:43 UTC (rev 4764)
+++ trunk/ChangeLog	2010-03-16 13:28:36 UTC (rev 4765)
@@ -1,3 +1,11 @@
+2010-03-16  Nick Treleaven  <nick(dot)treleaven(at)btinternet(dot)com>
+
+ * HACKING:
+   Add tip about gcc optimization & warnings/debugging.
+   Add Testing section.
+   Update Libraries section about synchronizing with other projects.
+
+
 2010-03-15  Enrico Tröger  <enrico(dot)troeger(at)uvena(dot)de>
 
  * src/ui_utils.c:

Modified: trunk/HACKING
===================================================================
--- trunk/HACKING	2010-03-15 14:48:43 UTC (rev 4764)
+++ trunk/HACKING	2010-03-16 13:28:36 UTC (rev 4765)
@@ -166,6 +166,11 @@
   function_name(). This is for compatibility with various Unix-like
   compilers. You should use -ansi to help check this.
 
+.. tip::
+    Remember for gcc you need to enable optimization to get certain
+    warnings like uninitialized variables, but for debugging it's
+    better to have no optimization on.
+
 Style
 ^^^^^
 * We use a tab width of 4 and indent completely with tabs not spaces.
@@ -234,16 +239,27 @@
         ...
 
 
+Testing
+-------
+* Run with ``-v`` to print any debug messages.
+* You can use a second instance (``geany -i``).
+* To check first-run behaviour, use an alternate config directory by
+  passing ``-c some_dir`` (but make sure the directory is clean first).
+* For debugging tips, see `GDB`_.
+
 Libraries
 ---------
-We prefer to use an unmodified version of Scintilla - any changes should
-be passed on to the maintainers at http://scintilla.org.
+We try to use an unmodified version of Scintilla - any new lexers or
+other changes should be passed on to the maintainers at
+http://scintilla.org. We normally update to a new Scintilla release
+shortly after one is made.
 
 Tagmanager was originally taken from Anjuta 1.2.2, and parts of it
 (notably c.c) have been merged from later versions of Anjuta and
 CTags. The independent Tagmanager library itself ceased development
 before Geany was started. It's source code parsing is mostly taken from
-Exuberant CTags (see http://ctags.sf.net).
+Exuberant CTags (see http://ctags.sf.net). If appropriate it's good to
+pass language parser changes back to the CTags project.
 
 
 Notes


This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.