]> git.saurik.com Git - wxWidgets.git/blobdiff - docs/tech/tn0005.txt
Open and Close clipboard properly
[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:
 
-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
-   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.
 
-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
-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$