]> git.saurik.com Git - wxWidgets.git/blobdiff - docs/tech/tn0005.txt
rebake make/project files for new scintilla
[wxWidgets.git] / docs / tech / tn0005.txt
index db4a67275d4c432fede727dcf926f5cf643b391c..51707e0caf7e6876333610f0eacd82ed958c37cd 100644 (file)
@@ -1,65 +1,29 @@
-                     Adding a wxWindows contribution
+                     Adding a wxWidgets contribution
                      ===============================
 
 Here are some different kinds of contribution:
 
                      ===============================
 
 Here are some different kinds of contribution:
 
-1. Bug fixes. You can send these to the wx-devel list.
-2. New classes. New classes normally go in the contrib hierarchy:
-   please see below for more details. They may be promoted to
-   the main wxWindows hierarchy if they are deemed to be 'core'.
+1. Bug fixes. You can send these to the wx-dev list.
+
+2. New classes. They should go somewhere in the wxWidgets 
+   hierarchy if they are deemed to be 'core', otherwise they
+   could be placed in external repositories of wxWidgets
+   utilities, like wxCode (see http://wxcode.sf.net).
+
 3. A utility application, such as a new dialog editor or
 3. A utility application, such as a new dialog editor or
-   file format conversion utility. If adding to the CVS
+   file format conversion utility. If adding to the SVN
    archive, you may put it under the utils hierarchy,
    preferably with further src and docs directories.
 
    archive, you may put it under the utils hierarchy,
    preferably with further src and docs directories.
 
-You may or may not wish to add your code to the main wxWindows CVS
+You may or may not wish to add your code to the main wxWidgets SVN
 archive. Whether your code is appropriate for this archive
 archive. Whether your code is appropriate for this archive
-should first be ascertained by discussing it on wx-devel@wxwindows.org.
-
-The contrib hierarchy
----------------------
-
-When contributing a new class or set of classes, please
-organise your files in the following hierarchy, so that
-when a user unarchives your contribution, it
-slots neatly into the existing source hierarchy.
-It also simplifies compilation for users, since wxWindows
-makefiles and project files are set up to search in
-contrib/include/wx and contrib/lib. For example, to
-include yourclass.h, the following directive is used:
-
-#include "wx/yourclass/yourclass.h"
-
-Here are the directories:
-
-contrib/include/wx/yourclass/           ; Your header(s) go here
-contrib/src/yourclass/                  ; Your source file(s) go here
-contrib/samples/yourclass/              ; Your sample(s) go here
-contrib/docs/latex/yourclass/           ; Your Latex doc sources go here
-contrib/docs/html/yourclass/            ; Your HTML doc files go here
-contrib/docs/htmlhelp/yourclass/        ; Your MS HTML Help doc files go here
-contrib/docs/htb/yourclass/             ; Your wxHTML doc files go here
-contrib/docs/pdf/yourclass/             ; Your PDF doc files go here
-contrib/docs/winhelp/yourclass/         ; Your WinHelp doc files go here
-
-It is recommended that you produce a manual using Tex2RTF, as specified
-in Technical Note TN0003. This allows you to output all the above
-formats, though for PDF you will need Latex and Ghostscript or
-Word and Adobe Acrobat, and for MS HTML Help and WinHelp you need
-the appropriate (freely available) help compilers.
-
-Your binary library files can go in the main lib directory or contrib/lib,
-but the main lib directory is recommended.
+should first be ascertained by discussing it on wx-dev@wxwidgets.org.
 
 
-Please include a readme.txt in your source directory, and conform
-as much as possible to the coding guidelines specified on the web
-site in the 'Backroom' section. Include as many makefiles as
-possible for different compilers.
+Also, in order to be included in wxWidgets, your code should
+follow the wxWidgets coding conventions 
+(see http://www.wxwidgets.org/develop/standard.htm) and fit in the
+wxWidgets src, include, docs directories hierarchy.
 
 
-Your archive can be in .tgz or .zip format. For inclusion on
-the wxWindows ftp site and CD-ROM, please send your submission to
-Julian Smart <julian@wxwindows.org> as a binary attachment.
-An entry will be added to the Contributions web page.
 
 Author:  Julian Smart
 Version: $Id$
 
 Author:  Julian Smart
 Version: $Id$