Add preferences sample.

[wxWidgets.git] / debian / README.Debian

diff --git a/debian/README.Debian b/debian/README.Debian
index 84b74790152e69b0c95b7d15d8ac2236881895a5..c651640840b4fe56beab3a904823112d27cbeaaf 100644 (file)
--- a/debian/README.Debian
+++ b/debian/README.Debian
@@ -1,50 +1,76 @@
-wxwindows for Debian
+wxwidgets for Debian

 ----------------------
 
 ----------------------
 

-The following packages are built from the wxWindows CVS source.
+The following packages are built from the wxWidgets CVS source.

 
 libwxbase              wxBase runtime shared libraries
 libwxbase-dev          extra files and static libs for building wxBase apps
 libwxbase-dbg          wxBase libraries built with -g and __WXDEBUG__
 
 
 libwxbase              wxBase runtime shared libraries
 libwxbase-dev          extra files and static libs for building wxBase apps
 libwxbase-dbg          wxBase libraries built with -g and __WXDEBUG__
 

-libwxgtk               wxGTK runtime shared libraries
-libwxgtk-dev           extra files and static libs for building wxGTK apps
+libwxgtk               wxGTK runtime shared libraries, including selected
+                       contrib libs.
+libwxgtk-dev           extra files required for building wxGTK apps

 libwxgtk-dbg           wxGTK libraries built with -g and __WXDEBUG__
 
 libwxgtk-dbg           wxGTK libraries built with -g and __WXDEBUG__
 

-libwxgtk-python                Python binding to wxGTK  (from 2.2.3 onward, this
+python-wxgtk           Python binding to wxGTK  (from 2.2.3 onward, this

                        obsoletes the libwxgtk-python-contrib package as
                        all python modules are built into a single monolith)
                        obsoletes the libwxgtk-python-contrib package as
                        all python modules are built into a single monolith)

+python-wxversion       The wxversion.py version selector, new to wxPython2.6
+python-wxtools         The ancillary tools from the wxPython distribution.

 
 

-wxwin-contrib          wxWin contrib runtime shared libs (built with wxGTK)
-wxwin-contrib-dev      extra files and static contrib libs for building apps
+wx-common              common helper files and support applications.
+wx-headers             common header files for building wxWidgets apps
+wx-doc                 HTML version of the wxWidgets manual
+wx-examples            wxWidgets and wxPython demos and samples (source)
+wx-i18n                        message catalogs for native language support

 
 

-wxwin-headers          common header files for building wxWindows apps
-wxwin-doc              HTML version of the wxWindows manual
-wxwin-examples         wxWindows and wxPython demos and samples (source)
-wxwin-i18n             message catalogs for native language support

 
 

+       Note that static libraries are no longer supplied in these
+       packages.  Please read, or have understood:
+       http://people.redhat.com/drepper/no_static_linking.html
+       among others before reporting this as a bug.

 
 

-       The following three can be built from the source package
-       with the mingw32 cross compiler, but are not currently
-       distributed by Debian.  If you feel that should change,
-       please file a bug against the wxwindows2.2 package, or
-       append your views to a report already there if you're not
-       the first to do so.
+       The following binaries can be built from the source package
+       with the mingw32 cross compiler, but are not distributed
+       as a part of the main Debian distribution.

 
 

-       [ you can check the current state of affairs at:
-         http://bugs.debian.org/cgi-bin/pkgreport.cgi?pkg=wxwindows2.2 ]
-
-       Oh and, please do *not* file bug reports for these packages
-       to the Debian bts.  But do feel free to email me personally
-       if you find problems and/or have patches to fix them.
+       Please do *not* file bug reports for these packages to the
+       Debian bts.  But do feel free to email me personally if you
+       find problems and/or have patches to fix them.

 
 libwxmsw-dev           mingw32-cross wxMSW libs.
 libwxmsw-dbg           mingw32-cross wxMSW (debug) libs.
 
 libwxmsw-dev           mingw32-cross wxMSW libs.
 libwxmsw-dbg           mingw32-cross wxMSW (debug) libs.

-libwxbase-msw-dev      mingw32-cross wxBase libs.
-libwxbase-msw-dbg      mingw32-cross wxBase (debug) libs.
-wxwin-headers-msw      extra headers needed for wxMSW.
+wx-headers-msw         extra headers needed for wxMSW.
+
+       You can build these extra packages using the binary-cross target
+       in debian/rules.
+
+
+       It is also possible to build a python-wxgtk-dbg package.
+       There are some limitations (like this package cannot be installed
+       concurrently with the release version), but some developers may
+       find such a thing useful in any case.  It will transparently
+       replace the release package for installed apps that depend on the
+       release package, but should NEVER be used when preparing packages
+       for upload.  This package may be created from the source using the
+       binary-dbg-py target in debian/rules.  (note that doing this will
+       also destroy any release build that exists in the same tree, they
+       cannot coexist there either yet)
+
+
+       Finally, because all of these packages can take quite some time to
+       build, the source package supports the use of distcc.  The package
+       builds will automatically parallelise to suit the number of hosts
+       you have listed in DISTCC_HOSTS.  This will work for both native
+       and cross builds of the c++ libraries, if you have the relevant
+       compilers on all your build hosts.
+       You may override that heuristic by setting the CONCURRENCY_LEVEL
+       environment variable to the number of jobs you wish make to fork.
+       That variable is also supported by the kernel-package scripts and
+       is respected for consistency here.

 
 

-libwxgtk-univ          wxUniversal for Gtk.
+       wxPython builds cannot be parallelised at this stage and will run
+       serially regardless of your configuration.

 
 
  -- Ron Lee <ron@debian.org>, Sun, 13 Feb 2000 18:40:00 +1030
 
 
  -- Ron Lee <ron@debian.org>, Sun, 13 Feb 2000 18:40:00 +1030