SF.net SVN: geany:[4564] branches/geany-0.18.1

[eht16 at users.sourceforge.net]

Revision: 4564
          http://geany.svn.sourceforge.net/geany/?rev=4564&view=rev
Author:   eht16
Date:     2010-01-25 21:16:38 +0000 (Mon, 25 Jan 2010)

Log Message:
-----------
Backport from trunk:
Add warning about not using undocumented features.
Add reference to HACKING for plugin API development.

Modified Paths:
--------------
    branches/geany-0.18.1/ChangeLog
    branches/geany-0.18.1/doc/plugins.dox

Modified: branches/geany-0.18.1/ChangeLog
===================================================================
--- branches/geany-0.18.1/ChangeLog	2010-01-25 21:16:27 UTC (rev 4563)
+++ branches/geany-0.18.1/ChangeLog	2010-01-25 21:16:38 UTC (rev 4564)
@@ -1,3 +1,10 @@
+2009-08-26  Nick Treleaven  <nick(dot)treleaven(at)btinternet(dot)com>
+
+ * doc/plugins.dox:
+   Add warning about not using undocumented features.
+   Add reference to HACKING for plugin API development.
+
+
 2009-08-25  Enrico Tröger  <enrico(dot)troeger(at)uvena(dot)de>
 
  * tagmanager/php.c:

Modified: branches/geany-0.18.1/doc/plugins.dox
===================================================================
--- branches/geany-0.18.1/doc/plugins.dox	2010-01-25 21:16:27 UTC (rev 4563)
+++ branches/geany-0.18.1/doc/plugins.dox	2010-01-25 21:16:38 UTC (rev 4564)
@@ -29,26 +29,29 @@
 
 /**
  *
- *  @mainpage Geany Plugin API Documentation
+ * @mainpage Geany Plugin API Documentation
  *
- *  @author Enrico Tröger, Nick Treleaven, Frank Lanitz
- *  @date $Date$
+ * @author Enrico Tröger, Nick Treleaven, Frank Lanitz
+ * @date $Date$
  *
- *  @section Intro
- *  This is the Geany API documentation. It is far from being complete and should be
- *  considered as a work in progress.
- *  We will try to document as many functions and structs as possible.
+ * @section Intro
+ * This is the Geany API documentation. It is far from being complete and should be
+ * considered as a work in progress.
+ * We will try to document as many functions and structs as possible.
  *
- *  To get started, see the @link howto Plugin Howto @endlink.
+ * To get started, see the @link howto Plugin Howto @endlink.
  *
- *  Other pages:
- *  - @link pluginsymbols.c Plugin Symbols @endlink
- *  - @link plugindata.h Main Datatypes and Macros @endlink
- *  - @link signals Plugin Signals @endlink
- *  - @link pluginutils.c Plugin Utility Functions @endlink
- *  - @link guidelines Plugin Writing Guidelines @endlink
+ * Other pages:
+ * - @link pluginsymbols.c Plugin Symbols @endlink
+ * - @link plugindata.h Main Datatypes and Macros @endlink
+ * - @link signals Plugin Signals @endlink
+ * - @link pluginutils.c Plugin Utility Functions @endlink
+ * - @link guidelines Plugin Writing Guidelines @endlink
  *
- *  @note Some of these pages are also listed in Related Pages.
+ * @note Some of these pages are also listed in Related Pages, plus the list of deprecated symbols.
+ * @warning Do not use anything not documented here, it may change.
+ * @note You should see the HACKING file for information about developing the plugin API and
+ * other useful things.
  */
 
 /**


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