home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / wxos2240.zip / wxWindows-2.4.0 / docs / tech / tn0001.txt < prev    next >
Text File  |  2002-06-07  |  2KB  |  41 lines
  1.                     How to add a new sample to wxWindows.
  2.                     =====================================
  3.  
  4. To add a new sample "foo" under directory "samples/foo" you need to do
  5. the following: (note that all this applies also to demos: just replace
  6. samples/ with demos/ where needed).
  7.  
  8. 1. Create the directory samples/foo locally and "cvs add" it
  9.  
  10. 2. Put the sources, headers and foo.rc file in it and "cvs add" them too
  11.    (don't forget to use "-kb" switch for binary files)
  12.  
  13. 3. Create the makefiles for Windows compilers. There are several ways to do
  14.    it:
  15.    a) copy the makefiles from samples/minimal, replace all occurrences of
  16.       minimal with foo
  17.    b) use makegen (sources are under utils/makegen)
  18.    c) use projgen
  19.  
  20. 4. Modify configure.in and samples/configure.in for Unix compilation:
  21.    a) if the sample should only be built if "wxUSE_FOO" is enabled, locate
  22.       the test for "wxUSE_FOO = yes" in configure.in and add a line
  23.       SAMPLES_SUBDIRS="$SAMPLES_SUBDIRS foo" under it
  24.    b) if it should be always built, locate the line "if test $wxUSE_GUI = yes"
  25.       near the end of configure.in and modify the assignment to
  26.       SAMPLES_SUBDIRS to include "foo" (put in alphabetical order)
  27.    c) add foo/Makefile to AC_OUTPUT in samples/configure.in
  28.  
  29.    After this, regenerate configure and samples/configure from configure.in
  30.    by running "autoconf" on a Unix system in the corresponding directory.
  31.  
  32. 5. Add a short description of what the sample does and how does it work
  33.    to the "samples overview" section in the wxWindows manual. That section
  34.    lives in docs/latex/wx/tsamples.tex; look at the descriptions for other
  35.    samples, if you are not familiar with LaTeX.
  36.  
  37. === EOF ===
  38.  
  39. Author:  VZ
  40. Version: $Id: tn0001.txt,v 1.4 2002/06/07 20:15:27 VZ Exp $
  41.