[Python-modules-commits] r29176 - in packages/sip4/trunk/debian (changelog manpages/sip.1)

Mon Jun 2 06:13:46 UTC 2014

Date: Monday, June 2, 2014 @ 06:13:45
  Author: mitya57-guest
Revision: 29176

Update sip.1 man page, document new command-line flags.

Modified:
  packages/sip4/trunk/debian/changelog
  packages/sip4/trunk/debian/manpages/sip.1

Modified: packages/sip4/trunk/debian/changelog
===================================================================

--- packages/sip4/trunk/debian/changelog	2014-06-02 04:27:25 UTC (rev 29175)
+++ packages/sip4/trunk/debian/changelog	2014-06-02 06:13:45 UTC (rev 29176)
@@ -1,3 +1,9 @@
+sip4 (4.16+dfsg-2) UNRELEASED; urgency=medium
+
+  * Update sip.1 man page, document new command-line flags.
+
+ -- Dmitry Shachnev <mitya57 at gmail.com>  Mon, 02 Jun 2014 10:11:00 +0400
+
 sip4 (4.16+dfsg-1) unstable; urgency=medium
 
   * New upstream release.

Modified: packages/sip4/trunk/debian/manpages/sip.1
===================================================================
--- packages/sip4/trunk/debian/manpages/sip.1	2014-06-02 04:27:25 UTC (rev 29175)
+++ packages/sip4/trunk/debian/manpages/sip.1	2014-06-02 06:13:45 UTC (rev 29176)
@@ -1,13 +1,13 @@
 .\"
-.\" Created by Ricardo Cárdenes Medina <ricardo at conysis.com>
+.\" Created by Ricardo Cardenes Medina <ricardo at conysis.com>
 .\" for the Debian 'sip' package
 .\"
-.TH SIP 1 "2010/02/02"
+.TH SIP 1 "2014/06/02"
 .SH NAME
 sip \- generates C++/Python bindings
 .SH SYNOPSIS
 .B sip
-[\fI-h\fR] [\fI-V\fR] [\fI-a file\fR] [\fI-c dir\fR] [\fI-d file\fR] [\fI-e\fR] [\fI-g\fR] [\fI-I dir\fR] [\fI-j #\fR] [\fI-k\fR] [\fI-m file\fR] [\fI-o\fR] [\fI-p module\fR] [\fI-P\fR] [\fI-r\fR] [\fI-s suffix\fR] [\fI-t tag\fR] [\fI-w\fR] [\fI-x feature\fR] [\fI-z file\fR] [\fIfile\fR]
+[\-h] [\-V] [\-a file] [\-b file] [\-B tag] [\-c dir] [\-d file] [\-e] [\-g] [\-I dir] [\-j number] [\-k] [\-m file] [\-o] [\-p module] [\-P] [\-r] [\-s suffix] [\-t tag] [\-T] [\-w] [\-x feature] [\-X id:file] [\-z file] [file]
 .SH DESCRIPTION
 .B sip
 takes a set of specification files and generates C++ code, documentation and build files.
@@ -20,7 +20,7 @@
 Show summary of options.
 .TP
 .B \-V
-Display the sip version number
+Display the sip version number.
 .TP
 .B \-a file
 The name of the QScintilla API file. If not indicated, it will not
@@ -29,58 +29,73 @@
 .B \-b file
 The name of the build file. If not indicated, it will not be generated.
 .TP
+.B \-B tag
+Add \fItag\fR to the list of timeline backstops.
+.TP
 .B \-c dir
 The name of the directory where generated source file will be put.
 If not indicated, no code will be generated.
 .TP
-.B -d file
-The name of the documentation file. If not indicated, no documentation will be generated.
+.B \-d file
+The name of the documentation file (deprecated).
+If not indicated, no documentation will be generated.
 .TP
-.B -e
+.B \-e
 Enable support for exceptions. Disabled by default.
 .TP
-.B -g
-Always release and reaquire the GIL.
+.B \-g
+Always release and reacquire the GIL.
 .TP
-.B -I dir
+.B \-I dir
 Directory where sip can search for included files.
 .TP
-.B -j number
+.B \-j number
 Splits the generated code in \fInumber\fR files (1 by default). This
 flag was added for parallel compilation on SMP machines.
 .TP
-.B -m file
+.B \-k
+Support keyword arguments in functions and methods.
+.TP
+.B \-m file
 The name of the XML export file. If not indicated, the file will not be generated.
 .TP
-.B -p module
-Give the name of the consolidated module this module should be a part of.
+.B \-o
+Enable the automatic generation of docstrings. Disabled by default.
 .TP
-.B -P
+.B \-p module
+Give the name of the consolidated module this module should be a component of.
+.TP
+.B \-P
 Enable the protected/public hack.
 .TP
-.B -r
+.B \-r
 Enable tracing on generated code.
 .TP
-.B -s suffix
+.B \-s suffix
 The suffix used for generated C or C++ files (".c" or ".cpp" if none specified)
 .TP
-.B -t tag
-The primary version to tag generate code for. You only can specify those
-defined with a %Timeline directive. If you don't specify one, sip
-will generate the latest available.
+.B \-t tag
+The version/platform to generate code for.
 .TP
-.B -w
-Enable warning messages
+.B \-T
+Disable the timestamp in the header of generated files.
 .TP
-.B -x feature
-Disable a feature
+.B \-w
+Enable warning messages.
 .TP
-.B -z file
-The name of a file containing additional command line flags
+.B \-x feature
+Disable a feature.
 .TP
+.B \-X id:file
+Create the extracts for an \fIid\fR in a \fIfile\fR.
+.TP
+.B \-z file
+The name of a file containing additional command line flags.
+.TP
 .B file
 The name of the file containing the specification. If you skip it,
 sip will expect to be fed by stdin.
 .SH AUTHOR
-This manual page was written by Ricardo Javier Cardenes Medina <rcardenes at debian.org> and Torsten Marek <shlomme at debian.org>,
+This manual page was written by Ricardo Javier Cardenes Medina <rcardenes at debian.org>,
+Torsten Marek <shlomme at debian.org> and Dmitry Shachnev <mitya57 at gmail.com>,
 for the Debian GNU/Linux system (but may be used by others).


