[Python-checkins] python/dist/src/Doc/dist dist.tex,1.43,1.44

[theller@users.sourceforge.net]

Update of /cvsroot/python/python/dist/src/Doc/dist
In directory usw-pr-cvs1:/tmp/cvs-serv12630

Modified Files:
	dist.tex 
Log Message:
Document the available command line flags for bdist_wininst, which are
avaliable in the Python 2.2 branch.

I've left out some flags which are more thought for debugging, if
someone needs them, he can always look at the output of --help.

I'm sure Fred will make some adjustments, so I'll only mark this as a
2.2 bugfix candidate.

There are more options available in the current CVS bdist_wininst,
I will document them after this is in.


Index: dist.tex
===================================================================
RCS file: /cvsroot/python/python/dist/src/Doc/dist/dist.tex,v
retrieving revision 1.43
retrieving revision 1.44
diff -C2 -d -r1.43 -r1.44
*** dist.tex	15 Nov 2002 19:20:56 -0000	1.43
--- dist.tex	15 Nov 2002 20:13:26 -0000	1.44
***************
*** 1266,1277 ****
  \label{creating-wininst}
  
! Executable installers are the natural format for binary
! distributions on Windows.  They display a nice graphical user interface,
! display some information about the module distribution to be installed taken
  from the metadata in the setup script, let the user select a few
! (currently maybe too few) options, and start or cancel the installation.
  
! Since the metadata is taken from the setup script, creating
! Windows installers is usually as easy as running:
  
  \begin{verbatim}
--- 1266,1277 ----
  \label{creating-wininst}
  
! Executable installers are the natural format for binary distributions
! on Windows.  They display a nice graphical user interface, display
! some information about the module distribution to be installed taken
  from the metadata in the setup script, let the user select a few
! options, and start or cancel the installation.
  
! Since the metadata is taken from the setup script, creating Windows
! installers is usually as easy as running:
  
  \begin{verbatim}
***************
*** 1285,1304 ****
  \end{verbatim}
  
! If you have a pure module distribution (only containing pure
! Python modules and packages), the resulting installer will be
! version independent and have a name like \file{foo-1.0.win32.exe}.
! These installers can even be created on \UNIX{} or MacOS platforms.
  
  If you have a non-pure distribution, the extensions can only be
  created on a Windows platform, and will be Python version dependent.
  The installer filename will reflect this and now has the form
! \file{foo-1.0.win32-py2.0.exe}. You have to create a separate installer
  for every Python version you want to support.
  
  The installer will try to compile pure modules into bytecode after
! installation on the target system in normal and optimizing mode.
! If you don't want this to happen for some reason, you can run
! the bdist_wininst command with the \longprogramopt{no-target-compile} and/or
! the \longprogramopt{no-target-optimize} option.
  
  \section{Examples}
--- 1285,1318 ----
  \end{verbatim}
  
! If you have a pure module distribution (only containing pure Python
! modules and packages), the resulting installer will be version
! independent and have a name like \file{foo-1.0.win32.exe}.  These
! installers can even be created on \UNIX{} or MacOS platforms.
  
  If you have a non-pure distribution, the extensions can only be
  created on a Windows platform, and will be Python version dependent.
  The installer filename will reflect this and now has the form
! \file{foo-1.0.win32-py2.0.exe}.  You have to create a separate installer
  for every Python version you want to support.
  
  The installer will try to compile pure modules into bytecode after
! installation on the target system in normal and optimizing mode.  If
! you don't want this to happen for some reason, you can run the
! bdist_wininst command with the \longprogramopt{no-target-compile}
! and/or the \longprogramopt{no-target-optimize} option.
! 
! By default the installer will display the cool Python powered logo
! when it is run, but you can also supply your own bitmap which must be
! a Windows .bmp file with the \longprogramopt{bitmap} option.
! 
! The installer will also display a large title on the desktop
! background window when it is run, which is constructed from the name
! of your distribution and the version number.  This can be changed to
! another text by using the \longprogramopt{title} option.
! 
! The installer file will be written to the ``distribution directory''
! --- normally \file{dist/}, but customizable with the
! \longprogramopt{dist-dir} option.
! 
  
  \section{Examples}