home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / wxos2233.zip / wxOS2-2_3_3.zip / wxWindows-2.3.3 / docs / tech / tn0005.txt < prev    next >
Text File  |  2000-07-15  |  3KB  |  67 lines
  1.                      Adding a wxWindows contribution
  2.                      ===============================
  3.  
  4. Here are some different kinds of contribution:
  5.  
  6. 1. Bug fixes. You can send these to the wx-devel list.
  7. 2. New classes. New classes normally go in the contrib hierarchy:
  8.    please see below for more details. They may be promoted to
  9.    the main wxWindows hierarchy if they are deemed to be 'core'.
  10. 3. A utility application, such as a new dialog editor or
  11.    file format conversion utility. If adding to the CVS
  12.    archive, you may put it under the utils hierarchy,
  13.    preferably with further src and docs directories.
  14.  
  15. You may or may not wish to add your code to the main wxWindows CVS
  16. archive. Whether your code is appropriate for this archive
  17. should first be ascertained by discussing it on wx-devel@wxwindows.org.
  18.  
  19. The contrib hierarchy
  20. ---------------------
  21.  
  22. When contributing a new class or set of classes, please
  23. organise your files in the following hierarchy, so that
  24. when a user unarchives your contribution, it
  25. slots neatly into the existing source hierarchy.
  26. It also simplifies compilation for users, since wxWindows
  27. makefiles and project files are set up to search in
  28. contrib/include/wx and contrib/lib. For example, to
  29. include yourclass.h, the following directive is used:
  30.  
  31. #include "wx/yourclass/yourclass.h"
  32.  
  33. Here are the directories:
  34.  
  35. contrib/include/wx/yourclass/           ; Your header(s) go here
  36. contrib/src/yourclass/                  ; Your source file(s) go here
  37. contrib/samples/yourclass/              ; Your sample(s) go here
  38. contrib/docs/latex/yourclass/           ; Your Latex doc sources go here
  39. contrib/docs/html/yourclass/            ; Your HTML doc files go here
  40. contrib/docs/htmlhelp/yourclass/        ; Your MS HTML Help doc files go here
  41. contrib/docs/htb/yourclass/             ; Your wxHTML doc files go here
  42. contrib/docs/pdf/yourclass/             ; Your PDF doc files go here
  43. contrib/docs/winhelp/yourclass/         ; Your WinHelp doc files go here
  44.  
  45. It is recommended that you produce a manual using Tex2RTF, as specified
  46. in Technical Note TN0003. This allows you to output all the above
  47. formats, though for PDF you will need Latex and Ghostscript or
  48. Word and Adobe Acrobat, and for MS HTML Help and WinHelp you need
  49. the appropriate (freely available) help compilers.
  50.  
  51. Your binary library files can go in the main lib directory or contrib/lib,
  52. but the main lib directory is recommended.
  53.  
  54. Please include a readme.txt in your source directory, and conform
  55. as much as possible to the coding guidelines specified on the web
  56. site in the 'Backroom' section. Include as many makefiles as
  57. possible for different compilers.
  58.  
  59. Your archive can be in .tgz or .zip format. For inclusion on
  60. the wxWindows ftp site and CD-ROM, please send your submission to
  61. Julian Smart <julian@wxwindows.org> as a binary attachment.
  62. An entry will be added to the Contributions web page.
  63.  
  64. Author:  Julian Smart
  65. Version: $Id: tn0005.txt,v 1.2 2000/07/15 19:49:55 cvsuser Exp $
  66.  
  67.