SF.net SVN: geany:[4173] trunk/HACKING

[ntrel at users.sourceforge.net]

Revision: 4173
          http://geany.svn.sourceforge.net/geany/?rev=4173&view=rev
Author:   ntrel
Date:     2009-09-10 16:37:21 +0000 (Thu, 10 Sep 2009)

Log Message:
-----------
Mention using filetype_make_title() when adding a filetype.
Mention conflicting scintilla lexers will not be accepted; new lexers
should be submitted back to the scintilla project.

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

Modified: trunk/HACKING
===================================================================
--- trunk/HACKING	2009-09-10 16:11:13 UTC (rev 4172)
+++ trunk/HACKING	2009-09-10 16:37:21 UTC (rev 4173)
@@ -200,7 +200,8 @@
 
 * Add GEANY_FILETYPES_FOO to filetypes.h.
 * Initialize GEANY_FILETYPES_FOO in init_builtin_filetypes() of
-  filetypes.c.
+  filetypes.c. You should use filetype_make_title() to avoid a
+  translation whenever possible.
 * Update data/filetype_extensions.conf.
 
 filetypes.* configuration file
@@ -223,8 +224,15 @@
 ^^^^^^^^^^^^^^^^^^^
 It may be possible to use an existing Scintilla lexer in the scintilla/
 subdirectory - if not, you will need to find (or write) one,
-LexFoo.cxx. Try the Scintilla project first. When adding a lexer, update:
+LexFoo.cxx. Try the official Scintilla project first.
 
+.. warning::
+    We won't accept adding a lexer that conflicts with one in
+    Scintilla. All new lexers should be submitted back to the Scintilla
+    project to save duplication of work.
+
+When adding a lexer, update:
+
 * scintilla/Makefile.am
 * scintilla/makefile.win32
 * scintilla/KeyWords.cxx - add a LINK_LEXER command *manually*


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