[Python-apps-commits] r10943 - in packages/spambayes/trunk/debian (17 files)

hugo6390-guest at users.alioth.debian.org hugo6390-guest at users.alioth.debian.org
Fri Jun 13 11:43:09 UTC 2014 

    Date: Friday, June 13, 2014 @ 11:43:08
  Author: hugo6390-guest
Revision: 10943

Written manpages.

Added:
  packages/spambayes/trunk/debian/doc/
  packages/spambayes/trunk/debian/doc/core_server.1
  packages/spambayes/trunk/debian/doc/sb_bnfilter.1
  packages/spambayes/trunk/debian/doc/sb_bnserver.1
  packages/spambayes/trunk/debian/doc/sb_chkopts.1
  packages/spambayes/trunk/debian/doc/sb_client.1
  packages/spambayes/trunk/debian/doc/sb_dbexpimp.1
  packages/spambayes/trunk/debian/doc/sb_evoscore.1
  packages/spambayes/trunk/debian/doc/sb_filter.1
  packages/spambayes/trunk/debian/doc/sb_imapfilter.1
  packages/spambayes/trunk/debian/doc/sb_mailsort.1
  packages/spambayes/trunk/debian/doc/sb_mboxtrain.1
  packages/spambayes/trunk/debian/doc/sb_server.1
  packages/spambayes/trunk/debian/doc/sb_unheader.1
  packages/spambayes/trunk/debian/doc/sb_upload.1
  packages/spambayes/trunk/debian/doc/sb_xmlrpcserver.1
  packages/spambayes/trunk/debian/spambayes.manpages

Added: packages/spambayes/trunk/debian/doc/core_server.1
===================================================================
--- packages/spambayes/trunk/debian/doc/core_server.1	                        (rev 0)
+++ packages/spambayes/trunk/debian/doc/core_server.1	2014-06-13 11:43:08 UTC (rev 10943)
@@ -0,0 +1,102 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.40.10.
+.TH OPTION "1" "June 2014" "option --version not recognized" "User Commands"
+.SH NAME
+option \- manual page for option --version not recognized
+.SH DESCRIPTION
+option \fB\-\-help\fR not recognized
+.PP
+The primary server for SpamBayes.
+.PP
+Currently serves the web interface only.  Plugging in listeners for various
+protocols is TBD.  This is a first cut at creating a standalone server which
+uses a plugin architecture to support different protocols.  The primary
+motivation is that web apps like MoinMoin, Trac and Roundup can use spam
+detection, but they don't necessarily provide the mechanisms necessary to
+save ham and spam databases for retraining.  By providing protocol plugins
+you should be able to fairly easily provide (for example) an XML\-RPC
+interface web apps can use.  The core server takes care of all the training
+bells and whistles.
+.PP
+Usage:
+.IP
+core_server.py [options]
+.IP
+options:
+.TP
+\fB\-h\fR
+: Displays this help message.
+.IP
+\fB\-P\fR module :
+.IP
+Identify plugin module to use (required)
+.IP
+\fB\-d\fR FILE : use the named DBM database file
+\fB\-p\fR FILE : the the named Pickle database file
+\fB\-u\fR port : User interface listens on this port number
+.IP
+(default 8880; Browse http://localhost:8880/)
+.TP
+\fB\-b\fR
+: Launch a web browser showing the user interface.
+.IP
+\fB\-o\fR section:option:value :
+.IP
+set [section, option] in the options database
+to value
+.IP
+All command line arguments and switches take their default
+values from the [html_ui] section of bayescustomize.ini.
+.PP
+The primary server for SpamBayes.
+.PP
+Currently serves the web interface only.  Plugging in listeners for various
+protocols is TBD.  This is a first cut at creating a standalone server which
+uses a plugin architecture to support different protocols.  The primary
+motivation is that web apps like MoinMoin, Trac and Roundup can use spam
+detection, but they don't necessarily provide the mechanisms necessary to
+save ham and spam databases for retraining.  By providing protocol plugins
+you should be able to fairly easily provide (for example) an XML\-RPC
+interface web apps can use.  The core server takes care of all the training
+bells and whistles.
+.PP
+Usage:
+.IP
+core_server.py [options]
+.IP
+options:
+.TP
+\fB\-h\fR
+: Displays this help message.
+.IP
+\fB\-P\fR module :
+.IP
+Identify plugin module to use (required)
+.IP
+\fB\-d\fR FILE : use the named DBM database file
+\fB\-p\fR FILE : the the named Pickle database file
+\fB\-u\fR port : User interface listens on this port number
+.IP
+(default 8880; Browse http://localhost:8880/)
+.TP
+\fB\-b\fR
+: Launch a web browser showing the user interface.
+.IP
+\fB\-o\fR section:option:value :
+.IP
+set [section, option] in the options database
+to value
+.IP
+All command line arguments and switches take their default
+values from the [html_ui] section of bayescustomize.ini.
+.SH "SEE ALSO"
+The full documentation for
+.B option
+is maintained as a Texinfo manual.  If the
+.B info
+and
+.B option
+programs are properly installed at your site, the command
+.IP
+.B info option
+.PP
+should give you access to the complete manual.

Added: packages/spambayes/trunk/debian/doc/sb_bnfilter.1
===================================================================
--- packages/spambayes/trunk/debian/doc/sb_bnfilter.1	                        (rev 0)
+++ packages/spambayes/trunk/debian/doc/sb_bnfilter.1	2014-06-13 11:43:08 UTC (rev 10943)
@@ -0,0 +1,147 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.40.10.
+.TH OPTION "1" "June 2014" "option --version not recognized" "User Commands"
+.SH NAME
+option \- manual page for option --version not recognized
+.SH SYNOPSIS
+.B %(program)s
+[\fIoptions\fR]
+.SH DESCRIPTION
+option \fB\-\-help\fR not recognized
+.SS "Where:"
+.HP
+\fB\-h\fR
+.IP
+show usage and exit
+.PP
+*   \fB\-f\fR
+.IP
+filter (default if no processing options are given)
+.PP
+*   \fB\-g\fR
+.IP
+[EXPERIMENTAL] (re)train as a good (ham) message
+.PP
+*   \fB\-s\fR
+.IP
+[EXPERIMENTAL] (re)train as a bad (spam) message
+.PP
+*   \fB\-t\fR
+.IP
+[EXPERIMENTAL] filter and train based on the result \fB\-\-\fR you must
+make sure to untrain all mistakes later.  Not recommended.
+.PP
+*   \fB\-G\fR
+.IP
+[EXPERIMENTAL] untrain ham (only use if you've already trained
+this message)
+.PP
+*   \fB\-S\fR
+.IP
+[EXPERIMENTAL] untrain spam (only use if you've already trained
+this message)
+.HP
+\fB\-k\fR FILE
+.IP
+Unix domain socket used to communicate with a short\-lived server
+process. Default is ~/.sbbnsock\-<hostname>
+.IP
+These options will not take effect when connecting to a preloaded server:
+.HP
+\fB\-p\fR FILE
+.TP
+use pickle FILE as the persistent store.
+loads data from this file
+.IP
+if it exists, and saves data to this file at the end.
+.HP
+\fB\-d\fR FILE
+.IP
+use DBM store FILE as the persistent store.
+.HP
+\fB\-o\fR section:option:value
+.IP
+set [section, option] in the options database to value
+.HP
+\fB\-a\fR seconds
+.IP
+timeout in seconds between requests before this server terminates
+.HP
+\fB\-A\fR number
+.IP
+terminate this server after this many requests
+.PP
+Usage: %(program)s [options]
+.SS "Where:"
+.HP
+\fB\-h\fR
+.IP
+show usage and exit
+.PP
+*   \fB\-f\fR
+.IP
+filter (default if no processing options are given)
+.PP
+*   \fB\-g\fR
+.IP
+[EXPERIMENTAL] (re)train as a good (ham) message
+.PP
+*   \fB\-s\fR
+.IP
+[EXPERIMENTAL] (re)train as a bad (spam) message
+.PP
+*   \fB\-t\fR
+.IP
+[EXPERIMENTAL] filter and train based on the result \fB\-\-\fR you must
+make sure to untrain all mistakes later.  Not recommended.
+.PP
+*   \fB\-G\fR
+.IP
+[EXPERIMENTAL] untrain ham (only use if you've already trained
+this message)
+.PP
+*   \fB\-S\fR
+.IP
+[EXPERIMENTAL] untrain spam (only use if you've already trained
+this message)
+.HP
+\fB\-k\fR FILE
+.IP
+Unix domain socket used to communicate with a short\-lived server
+process. Default is ~/.sbbnsock\-<hostname>
+.IP
+These options will not take effect when connecting to a preloaded server:
+.HP
+\fB\-p\fR FILE
+.TP
+use pickle FILE as the persistent store.
+loads data from this file
+.IP
+if it exists, and saves data to this file at the end.
+.HP
+\fB\-d\fR FILE
+.IP
+use DBM store FILE as the persistent store.
+.HP
+\fB\-o\fR section:option:value
+.IP
+set [section, option] in the options database to value
+.HP
+\fB\-a\fR seconds
+.IP
+timeout in seconds between requests before this server terminates
+.HP
+\fB\-A\fR number
+.IP
+terminate this server after this many requests
+.SH "SEE ALSO"
+The full documentation for
+.B option
+is maintained as a Texinfo manual.  If the
+.B info
+and
+.B option
+programs are properly installed at your site, the command
+.IP
+.B info option
+.PP
+should give you access to the complete manual.

Added: packages/spambayes/trunk/debian/doc/sb_bnserver.1
===================================================================
--- packages/spambayes/trunk/debian/doc/sb_bnserver.1	                        (rev 0)
+++ packages/spambayes/trunk/debian/doc/sb_bnserver.1	2014-06-13 11:43:08 UTC (rev 10943)
@@ -0,0 +1,87 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.40.10.
+.TH OPTION "1" "June 2014" "option --version not recognized" "User Commands"
+.SH NAME
+option \- manual page for option --version not recognized
+.SH SYNOPSIS
+.B %(program)s
+[\fIoptions\fR] \fIFILE\fR
+.SH DESCRIPTION
+option \fB\-\-help\fR not recognized
+.SS "Where:"
+.HP
+\fB\-h\fR
+.IP
+show usage and exit
+.HP
+\fB\-p\fR FILE
+.TP
+use pickle FILE as the persistent store.
+loads data from this file
+.IP
+if it exists, and saves data to this file at the end.
+.HP
+\fB\-d\fR FILE
+.IP
+use DBM store FILE as the persistent store.
+.HP
+\fB\-o\fR section:option:value
+.IP
+set [section, option] in the options database to value
+.HP
+\fB\-a\fR seconds
+.IP
+timeout in seconds between requests before this server terminates
+.HP
+\fB\-A\fR number
+.IP
+terminate this server after this many requests
+.IP
+FILE
+.IP
+unix domain socket used on which we listen
+.PP
+Usage: %(program)s [options] FILE
+.SS "Where:"
+.HP
+\fB\-h\fR
+.IP
+show usage and exit
+.HP
+\fB\-p\fR FILE
+.TP
+use pickle FILE as the persistent store.
+loads data from this file
+.IP
+if it exists, and saves data to this file at the end.
+.HP
+\fB\-d\fR FILE
+.IP
+use DBM store FILE as the persistent store.
+.HP
+\fB\-o\fR section:option:value
+.IP
+set [section, option] in the options database to value
+.HP
+\fB\-a\fR seconds
+.IP
+timeout in seconds between requests before this server terminates
+.HP
+\fB\-A\fR number
+.IP
+terminate this server after this many requests
+.IP
+FILE
+.IP
+unix domain socket used on which we listen
+.SH "SEE ALSO"
+The full documentation for
+.B option
+is maintained as a Texinfo manual.  If the
+.B info
+and
+.B option
+programs are properly installed at your site, the command
+.IP
+.B info option
+.PP
+should give you access to the complete manual.

Added: packages/spambayes/trunk/debian/doc/sb_chkopts.1
===================================================================
Added: packages/spambayes/trunk/debian/doc/sb_client.1
===================================================================
Added: packages/spambayes/trunk/debian/doc/sb_dbexpimp.1
===================================================================
--- packages/spambayes/trunk/debian/doc/sb_dbexpimp.1	                        (rev 0)
+++ packages/spambayes/trunk/debian/doc/sb_dbexpimp.1	2014-06-13 11:43:08 UTC (rev 10943)
@@ -0,0 +1,180 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.40.10.
+.TH OPTION "1" "June 2014" "option --version not recognized" "User Commands"
+.SH NAME
+option \- manual page for option --version not recognized
+.SH DESCRIPTION
+option \fB\-\-help\fR not recognized
+.PP
+sb_dbexpimp.py \- Bayes database export/import
+.IP
+This utility has the primary function of exporting and importing
+a spambayes database into/from a CSV file.  This is useful in a number
+of scenarios.
+.IP
+Platform portability of database \- CSV files can be exported and
+imported across platforms (Windows and Linux, for example).
+.IP
+Database implementation changes \- databases can survive database
+implementation upgrades or new database implementations.  For example,
+if a dbm implementation changes between python x.y and python x.y+1...
+.IP
+Database reorganization \- an export followed by an import reorgs an
+existing database, <theoretically> improving performance, at least in
+some database implementations.
+.IP
+Database sharing \- it is possible to distribute particular databases
+for research purposes, database sharing purposes, or for new users to
+have a 'seed' database to start with.
+.IP
+Database merging \- multiple databases can be merged into one quite
+easily by specifying \fB\-m\fR on an import.  This will add the two database
+nham and nspams together and for wordinfo conflicts, will add spamcount
+and hamcount together.
+.SS "Usage:"
+.IP
+sb_dbexpimp [options]
+.IP
+options:
+.TP
+\fB\-e\fR
+: export
+.TP
+\fB\-i\fR
+: import
+.IP
+\fB\-f\fR: FN : flat file to export to or import from
+\fB\-p\fR: FN : name of pickled database file to use
+\fB\-d\fR: FN : name of dbm database file to use
+\fB\-m\fR     : merge import into an existing database file.  This is
+.IP
+meaningful only for import. If omitted, a new database
+file will be created.  If specified, the imported
+wordinfo will be merged into an existing database.
+Run dbExpImp \fB\-h\fR for more information.
+.IP
+\fB\-o\fR: section:option:value :
+.IP
+set [section, option] in the options database to value
+.TP
+\fB\-h\fR
+: help
+.PP
+If neither \fB\-p\fR nor \fB\-d\fR is specified, then the values in your configuration
+file (or failing that, the defaults) will be used.  In this way, you may
+convert to and from storage formats other than pickle and dbm.
+.SH EXAMPLES
+
+.IP
+Export pickled mybayes.db into mybayes.db.export as a CSV file
+.IP
+sb_dbexpimp \fB\-e\fR \fB\-p\fR mybayes.db \fB\-f\fR mybayes.db.export
+.IP
+Import mybayes.db.export into a new DBM mybayes.db
+.IP
+sb_dbexpimp \fB\-i\fR \fB\-d\fR mybayes.db \fB\-f\fR mybayes.db.export
+.IP
+Convert a bayes database from pickle to DBM
+.IP
+sb_dbexpimp \fB\-e\fR \fB\-p\fR abayes.db \fB\-f\fR abayes.export
+sb_dbexpimp \fB\-i\fR \fB\-d\fR abayes.db \fB\-f\fR abayes.export
+.IP
+Create a new DBM database (newbayes.db) from two
+.IP
+DBM databases (abayes.db, bbayes.db)
+sb_dbexpimp \fB\-e\fR \fB\-d\fR abayes.db \fB\-f\fR abayes.export
+sb_dbexpimp \fB\-e\fR \fB\-d\fR bbayes.db \fB\-f\fR bbayes.export
+sb_dbexpimp \fB\-i\fR \fB\-d\fR newbayes.db \fB\-f\fR abayes.export
+sb_dbexpimp \fB\-i\fR \fB\-m\fR \fB\-d\fR newbayes.db \fB\-f\fR bbayes.export
+.PP
+sb_dbexpimp.py \- Bayes database export/import
+.IP
+This utility has the primary function of exporting and importing
+a spambayes database into/from a CSV file.  This is useful in a number
+of scenarios.
+.IP
+Platform portability of database \- CSV files can be exported and
+imported across platforms (Windows and Linux, for example).
+.IP
+Database implementation changes \- databases can survive database
+implementation upgrades or new database implementations.  For example,
+if a dbm implementation changes between python x.y and python x.y+1...
+.IP
+Database reorganization \- an export followed by an import reorgs an
+existing database, <theoretically> improving performance, at least in
+some database implementations.
+.IP
+Database sharing \- it is possible to distribute particular databases
+for research purposes, database sharing purposes, or for new users to
+have a 'seed' database to start with.
+.IP
+Database merging \- multiple databases can be merged into one quite
+easily by specifying \fB\-m\fR on an import.  This will add the two database
+nham and nspams together and for wordinfo conflicts, will add spamcount
+and hamcount together.
+.SS "Usage:"
+.IP
+sb_dbexpimp [options]
+.IP
+options:
+.TP
+\fB\-e\fR
+: export
+.TP
+\fB\-i\fR
+: import
+.IP
+\fB\-f\fR: FN : flat file to export to or import from
+\fB\-p\fR: FN : name of pickled database file to use
+\fB\-d\fR: FN : name of dbm database file to use
+\fB\-m\fR     : merge import into an existing database file.  This is
+.IP
+meaningful only for import. If omitted, a new database
+file will be created.  If specified, the imported
+wordinfo will be merged into an existing database.
+Run dbExpImp \fB\-h\fR for more information.
+.IP
+\fB\-o\fR: section:option:value :
+.IP
+set [section, option] in the options database to value
+.TP
+\fB\-h\fR
+: help
+.PP
+If neither \fB\-p\fR nor \fB\-d\fR is specified, then the values in your configuration
+file (or failing that, the defaults) will be used.  In this way, you may
+convert to and from storage formats other than pickle and dbm.
+.PP
+
+.IP
+Export pickled mybayes.db into mybayes.db.export as a CSV file
+.IP
+sb_dbexpimp \fB\-e\fR \fB\-p\fR mybayes.db \fB\-f\fR mybayes.db.export
+.IP
+Import mybayes.db.export into a new DBM mybayes.db
+.IP
+sb_dbexpimp \fB\-i\fR \fB\-d\fR mybayes.db \fB\-f\fR mybayes.db.export
+.IP
+Convert a bayes database from pickle to DBM
+.IP
+sb_dbexpimp \fB\-e\fR \fB\-p\fR abayes.db \fB\-f\fR abayes.export
+sb_dbexpimp \fB\-i\fR \fB\-d\fR abayes.db \fB\-f\fR abayes.export
+.IP
+Create a new DBM database (newbayes.db) from two
+.IP
+DBM databases (abayes.db, bbayes.db)
+sb_dbexpimp \fB\-e\fR \fB\-d\fR abayes.db \fB\-f\fR abayes.export
+sb_dbexpimp \fB\-e\fR \fB\-d\fR bbayes.db \fB\-f\fR bbayes.export
+sb_dbexpimp \fB\-i\fR \fB\-d\fR newbayes.db \fB\-f\fR abayes.export
+sb_dbexpimp \fB\-i\fR \fB\-m\fR \fB\-d\fR newbayes.db \fB\-f\fR bbayes.export
+.SH "SEE ALSO"
+The full documentation for
+.B option
+is maintained as a Texinfo manual.  If the
+.B info
+and
+.B option
+programs are properly installed at your site, the command
+.IP
+.B info option
+.PP
+should give you access to the complete manual.

Added: packages/spambayes/trunk/debian/doc/sb_evoscore.1
===================================================================
Added: packages/spambayes/trunk/debian/doc/sb_filter.1
===================================================================
--- packages/spambayes/trunk/debian/doc/sb_filter.1	                        (rev 0)
+++ packages/spambayes/trunk/debian/doc/sb_filter.1	2014-06-13 11:43:08 UTC (rev 10943)
@@ -0,0 +1,111 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.40.10.
+.TH SPAMBAYES "1" "June 2014" "SpamBayes Command Line Filter Version 1.1b1 (February, 25, 2011)" "User Commands"
+.SH NAME
+SpamBayes \- manual page for SpamBayes Command Line Filter Version 1.1b1 (February, 25, 2011)
+.SH SYNOPSIS
+.B sb_filter
+[\fIoptions\fR] [\fIfilenames\fR]
+.SH DESCRIPTION
+SpamBayes Command Line Filter Version 1.1b1 (February, 25, 2011)
+.SS "Options can one or more of:"
+.HP
+\fB\-h\fR
+.IP
+show usage and exit
+.HP
+\fB\-v\fR
+.IP
+show version and exit
+.HP
+\fB\-x\fR
+.IP
+show some usage examples and exit
+.HP
+\fB\-d\fR DBFILE
+.IP
+use database in DBFILE
+.HP
+\fB\-p\fR PICKLEFILE
+.IP
+use pickle (instead of database) in PICKLEFILE
+.HP
+\fB\-n\fR
+.IP
+create a new database
+.PP
+*   \fB\-f\fR
+.IP
+filter (default if no processing options are given)
+.PP
+*   \fB\-g\fR
+.IP
+(re)train as a good (ham) message
+.PP
+*   \fB\-s\fR
+.IP
+(re)train as a bad (spam) message
+.PP
+*   \fB\-t\fR
+.IP
+filter and train based on the result \fB\-\-\fR you must
+make sure to untrain all mistakes later.  Not recommended.
+.PP
+*   \fB\-G\fR
+.IP
+untrain ham (only use if you've already trained this message)
+.PP
+*   \fB\-S\fR
+.IP
+untrain spam (only use if you've already trained this message)
+.HP
+\fB\-o\fR section:option:value
+.IP
+set [section, option] in the options database to value
+.HP
+\fB\-P\fR
+.IP
+Run under control of the Python profiler, if it is available
+.PP
+All options marked with '*' operate on stdin, and write the resultant
+message to stdout.
+.PP
+If no filenames are given on the command line, standard input will be
+processed as a single message.  If one or more filenames are given on the
+command line, each will be processed according to the following rules:
+.IP
+* If the filename is '\-', standard input will be processed as a single
+.IP
+message (may only be usefully given once).
+.IP
+* If the filename starts with '+' it will be processed as an MH folder.
+.IP
+* If the filename is a directory and it contains a subdirectory named
+.IP
+\&'cur', it will be processed as a Maildir.
+.IP
+* If the filename is a directory and it contains a subdirectory named
+.IP
+\&'Mail', it will be processed as an MH Mailbox.
+.IP
+* If the filename is a directory and not a Maildir nor an MH Mailbox, it
+.IP
+will be processed as a Mailbox directory consisting of just .txt and
+\&.lorien files.
+.IP
+* Otherwise, the filename is treated as a Unix\-style mailbox (messages
+.IP
+begin on a line starting with 'From ').
+.PP
+Output is always to standard output as a Unix\-style mailbox.
+.SH "SEE ALSO"
+The full documentation for
+.B SpamBayes
+is maintained as a Texinfo manual.  If the
+.B info
+and
+.B SpamBayes
+programs are properly installed at your site, the command
+.IP
+.B info SpamBayes
+.PP
+should give you access to the complete manual.

Added: packages/spambayes/trunk/debian/doc/sb_imapfilter.1
===================================================================
--- packages/spambayes/trunk/debian/doc/sb_imapfilter.1	                        (rev 0)
+++ packages/spambayes/trunk/debian/doc/sb_imapfilter.1	2014-06-13 11:43:08 UTC (rev 10943)
@@ -0,0 +1,170 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.40.10.
+.TH OPTION "1" "June 2014" "option --version not recognized" "User Commands"
+.SH NAME
+option \- manual page for option --version not recognized
+.SH DESCRIPTION
+option \fB\-\-help\fR not recognized
+.PP
+An IMAP filter.  An IMAP message box is scanned and all non\-scored
+messages are scored and (where necessary) filtered.
+.SS "Usage:"
+.IP
+sb_imapfilter [options]
+.IP
+note: option values with spaces in them must be enclosed
+.IP
+in double quotes
+.IP
+options:
+.TP
+\fB\-p\fR
+dbname  : pickled training database filename
+.TP
+\fB\-d\fR
+dbname  : dbm training database filename
+.TP
+\fB\-t\fR
+: train contents of spam folder and ham folder
+.TP
+\fB\-c\fR
+: classify inbox
+.TP
+\fB\-h\fR
+: display this message
+.TP
+\fB\-v\fR
+: verbose mode
+.TP
+\fB\-P\fR
+: security option to prompt for imap password,
+.IP
+rather than look in options["imap", "password"]
+.TP
+\fB\-e\fR y/n
+: expunge/purge messages on exit (y) or not (n)
+.IP
+\fB\-i\fR debuglvl : a somewhat mysterious imaplib debugging level
+.IP
+(4 is a good level, and suitable for bug reports)
+.TP
+\fB\-l\fR minutes
+: period of time between filtering operations
+.TP
+\fB\-b\fR
+: Launch a web browser showing the user interface.
+.IP
+\fB\-o\fR section:option:value :
+.IP
+set [section, option] in the options database
+to value
+.SH EXAMPLES
+
+.IP
+Classify inbox, with dbm database
+.IP
+sb_imapfilter \fB\-c\fR \fB\-d\fR bayes.db
+.IP
+Train Spam and Ham, then classify inbox, with dbm database
+.IP
+sb_imapfilter \fB\-t\fR \fB\-c\fR \fB\-d\fR bayes.db
+.IP
+Train Spam and Ham only, with pickled database
+.IP
+sb_imapfilter \fB\-t\fR \fB\-p\fR bayes.db
+.SS "Warnings:"
+.IP
+o We never delete mail, unless you use the \fB\-e\fR/purge option, but we do
+.IP
+mark a lot as deleted, and your mail client might remove that for
+you.  We try to only mark as deleted once the moved/altered message
+is correctly saved, but things might go wrong.  We *strongly*
+recommend that you try this script out on mail that you can recover
+from somewhere else, at least at first.
+.PP
+An IMAP filter.  An IMAP message box is scanned and all non\-scored
+messages are scored and (where necessary) filtered.
+.SS "Usage:"
+.IP
+sb_imapfilter [options]
+.IP
+note: option values with spaces in them must be enclosed
+.IP
+in double quotes
+.IP
+options:
+.TP
+\fB\-p\fR
+dbname  : pickled training database filename
+.TP
+\fB\-d\fR
+dbname  : dbm training database filename
+.TP
+\fB\-t\fR
+: train contents of spam folder and ham folder
+.TP
+\fB\-c\fR
+: classify inbox
+.TP
+\fB\-h\fR
+: display this message
+.TP
+\fB\-v\fR
+: verbose mode
+.TP
+\fB\-P\fR
+: security option to prompt for imap password,
+.IP
+rather than look in options["imap", "password"]
+.TP
+\fB\-e\fR y/n
+: expunge/purge messages on exit (y) or not (n)
+.IP
+\fB\-i\fR debuglvl : a somewhat mysterious imaplib debugging level
+.IP
+(4 is a good level, and suitable for bug reports)
+.TP
+\fB\-l\fR minutes
+: period of time between filtering operations
+.TP
+\fB\-b\fR
+: Launch a web browser showing the user interface.
+.IP
+\fB\-o\fR section:option:value :
+.IP
+set [section, option] in the options database
+to value
+.PP
+
+.IP
+Classify inbox, with dbm database
+.IP
+sb_imapfilter \fB\-c\fR \fB\-d\fR bayes.db
+.IP
+Train Spam and Ham, then classify inbox, with dbm database
+.IP
+sb_imapfilter \fB\-t\fR \fB\-c\fR \fB\-d\fR bayes.db
+.IP
+Train Spam and Ham only, with pickled database
+.IP
+sb_imapfilter \fB\-t\fR \fB\-p\fR bayes.db
+.SS "Warnings:"
+.IP
+o We never delete mail, unless you use the \fB\-e\fR/purge option, but we do
+.IP
+mark a lot as deleted, and your mail client might remove that for
+you.  We try to only mark as deleted once the moved/altered message
+is correctly saved, but things might go wrong.  We *strongly*
+recommend that you try this script out on mail that you can recover
+from somewhere else, at least at first.
+.SH "SEE ALSO"
+The full documentation for
+.B option
+is maintained as a Texinfo manual.  If the
+.B info
+and
+.B option
+programs are properly installed at your site, the command
+.IP
+.B info option
+.PP
+should give you access to the complete manual.

Added: packages/spambayes/trunk/debian/doc/sb_mailsort.1
===================================================================
--- packages/spambayes/trunk/debian/doc/sb_mailsort.1	                        (rev 0)
+++ packages/spambayes/trunk/debian/doc/sb_mailsort.1	2014-06-13 11:43:08 UTC (rev 10943)
@@ -0,0 +1,36 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.40.10.
+.TH OPTION "1" "June 2014" "option --version not recognized" "User Commands"
+.SH NAME
+option \- manual page for option --version not recognized
+.SH DESCRIPTION
+option \fB\-\-help\fR not recognized
+.SS "To train:"
+.IP
+/usr/bin/sb_mailsort \fB\-t\fR ham.mbox spam.mbox
+.SS "To filter mail (using .forward or .qmail):"
+.IP
+|/usr/bin/sb_mailsort Maildir/ Mail/Spam/
+.SS "To print the score and top evidence for a message or messages:"
+.IP
+/usr/bin/sb_mailsort \fB\-s\fR message [message ...]
+.SS "To train:"
+.IP
+/usr/bin/sb_mailsort \fB\-t\fR ham.mbox spam.mbox
+.SS "To filter mail (using .forward or .qmail):"
+.IP
+|/usr/bin/sb_mailsort Maildir/ Mail/Spam/
+.SS "To print the score and top evidence for a message or messages:"
+.IP
+/usr/bin/sb_mailsort \fB\-s\fR message [message ...]
+.SH "SEE ALSO"
+The full documentation for
+.B option
+is maintained as a Texinfo manual.  If the
+.B info
+and
+.B option
+programs are properly installed at your site, the command
+.IP
+.B info option
+.PP
+should give you access to the complete manual.

Added: packages/spambayes/trunk/debian/doc/sb_mboxtrain.1
===================================================================
--- packages/spambayes/trunk/debian/doc/sb_mboxtrain.1	                        (rev 0)
+++ packages/spambayes/trunk/debian/doc/sb_mboxtrain.1	2014-06-13 11:43:08 UTC (rev 10943)
@@ -0,0 +1,135 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.40.10.
+.TH OPTION "1" "June 2014" "option --version not recognized" "User Commands"
+.SH NAME
+option \- manual page for option --version not recognized
+.SH SYNOPSIS
+.B sb_mboxtrain
+[\fIOPTIONS\fR] ...
+.SH DESCRIPTION
+option \fB\-\-help\fR not recognized
+.SS "Where OPTIONS is one or more of:"
+.HP
+\fB\-h\fR
+.IP
+show usage and exit
+.HP
+\fB\-d\fR DBNAME
+.TP
+use the DBM store.
+A DBM file is larger than the pickle and
+.IP
+creating it is slower, but loading it is much faster,
+especially for large word databases.  Recommended for use with
+sb_filter or any procmail\-based filter.
+.HP
+\fB\-p\fR DBNAME
+.TP
+use the pickle store.
+A pickle is smaller and faster to create,
+.TP
+but much slower to load.
+Recommended for use with sb_server and
+.IP
+sb_xmlrpcserver.
+.HP
+\fB\-g\fR PATH
+.IP
+mbox or directory of known good messages (non\-spam) to train on.
+Can be specified more than once.
+.HP
+\fB\-s\fR PATH
+.IP
+mbox or directory of known spam messages to train on.
+Can be specified more than once.
+.HP
+\fB\-f\fR
+.TP
+force training, ignoring the trained header.
+Use this if you
+.IP
+need to rebuild your database from scratch.
+.HP
+\fB\-q\fR
+.IP
+quiet mode; no output
+.TP
+\fB\-n\fR
+train mail residing in "new" directory, in addition to "cur"
+directory, which is always trained (Maildir only)
+.TP
+\fB\-r\fR
+remove mail which was trained on (Maildir only)
+.HP
+\fB\-o\fR section:option:value
+.IP
+set [section, option] in the options database to value
+.PP
+Usage: /usr/bin/sb_mboxtrain [OPTIONS] ...
+.SS "Where OPTIONS is one or more of:"
+.HP
+\fB\-h\fR
+.IP
+show usage and exit
+.HP
+\fB\-d\fR DBNAME
+.TP
+use the DBM store.
+A DBM file is larger than the pickle and
+.IP
+creating it is slower, but loading it is much faster,
+especially for large word databases.  Recommended for use with
+sb_filter or any procmail\-based filter.
+.HP
+\fB\-p\fR DBNAME
+.TP
+use the pickle store.
+A pickle is smaller and faster to create,
+.TP
+but much slower to load.
+Recommended for use with sb_server and
+.IP
+sb_xmlrpcserver.
+.HP
+\fB\-g\fR PATH
+.IP
+mbox or directory of known good messages (non\-spam) to train on.
+Can be specified more than once.
+.HP
+\fB\-s\fR PATH
+.IP
+mbox or directory of known spam messages to train on.
+Can be specified more than once.
+.HP
+\fB\-f\fR
+.TP
+force training, ignoring the trained header.
+Use this if you
+.IP
+need to rebuild your database from scratch.
+.HP
+\fB\-q\fR
+.IP
+quiet mode; no output
+.TP
+\fB\-n\fR
+train mail residing in "new" directory, in addition to "cur"
+directory, which is always trained (Maildir only)
+.TP
+\fB\-r\fR
+remove mail which was trained on (Maildir only)
+.HP
+\fB\-o\fR section:option:value
+.IP
+set [section, option] in the options database to value
+.SH "SEE ALSO"
+The full documentation for
+.B option
+is maintained as a Texinfo manual.  If the
+.B info
+and
+.B option
+programs are properly installed at your site, the command
+.IP
+.B info option
+.PP
+should give you access to the complete manual.

Added: packages/spambayes/trunk/debian/doc/sb_server.1
===================================================================
--- packages/spambayes/trunk/debian/doc/sb_server.1	                        (rev 0)
+++ packages/spambayes/trunk/debian/doc/sb_server.1	2014-06-13 11:43:08 UTC (rev 10943)
@@ -0,0 +1,116 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.40.10.
+.TH OPTION "1" "June 2014" "option --version not recognized" "User Commands"
+.SH NAME
+option \- manual page for option --version not recognized
+.SH DESCRIPTION
+option \fB\-\-help\fR not recognized
+.PP
+The primary server for SpamBayes.
+.PP
+Currently serves the web interface, and any configured POP3 and SMTP
+proxies.
+.PP
+The POP3 proxy works with classifier.py, and adds a simple
+X\-Spambayes\-Classification header (ham/spam/unsure) to each incoming
+email.  You point the proxy at your POP3 server, and configure your
+email client to collect mail from the proxy then filter on the added
+header.  Usage:
+.IP
+sb_server.py [options] [<server> [<server port>]]
+.IP
+<server> is the name of your real POP3 server
+<port>   is the port number of your real POP3 server, which
+.IP
+defaults to 110.
+.IP
+options:
+.TP
+\fB\-h\fR
+: Displays this help message.
+.IP
+\fB\-d\fR FILE : use the named DBM database file
+\fB\-p\fR FILE : the the named Pickle database file
+\fB\-l\fR port : proxy listens on this port number (default 110)
+\fB\-u\fR port : User interface listens on this port number
+.IP
+(default 8880; Browse http://localhost:8880/)
+.TP
+\fB\-b\fR
+: Launch a web browser showing the user interface.
+.IP
+\fB\-o\fR section:option:value :
+.IP
+set [section, option] in the options database
+to value
+.IP
+All command line arguments and switches take their default
+values from the [pop3proxy] and [html_ui] sections of
+bayescustomize.ini.
+.PP
+For safety, and to help debugging, the whole POP3 conversation is
+written out to _pop3proxy.log for each run, if
+options["globals", "verbose"] is True.
+.PP
+To make rebuilding the database easier, uploaded messages are appended
+to _pop3proxyham.mbox and _pop3proxyspam.mbox.
+.PP
+The primary server for SpamBayes.
+.PP
+Currently serves the web interface, and any configured POP3 and SMTP
+proxies.
+.PP
+The POP3 proxy works with classifier.py, and adds a simple
+X\-Spambayes\-Classification header (ham/spam/unsure) to each incoming
+email.  You point the proxy at your POP3 server, and configure your
+email client to collect mail from the proxy then filter on the added
+header.  Usage:
+.IP
+sb_server.py [options] [<server> [<server port>]]
+.IP
+<server> is the name of your real POP3 server
+<port>   is the port number of your real POP3 server, which
+.IP
+defaults to 110.
+.IP
+options:
+.TP
+\fB\-h\fR
+: Displays this help message.
+.IP
+\fB\-d\fR FILE : use the named DBM database file
+\fB\-p\fR FILE : the the named Pickle database file
+\fB\-l\fR port : proxy listens on this port number (default 110)
+\fB\-u\fR port : User interface listens on this port number
+.IP
+(default 8880; Browse http://localhost:8880/)
+.TP
+\fB\-b\fR
+: Launch a web browser showing the user interface.
+.IP
+\fB\-o\fR section:option:value :
+.IP
+set [section, option] in the options database
+to value
+.IP
+All command line arguments and switches take their default
+values from the [pop3proxy] and [html_ui] sections of
+bayescustomize.ini.
+.PP
+For safety, and to help debugging, the whole POP3 conversation is
+written out to _pop3proxy.log for each run, if
+options["globals", "verbose"] is True.
+.PP
+To make rebuilding the database easier, uploaded messages are appended
+to _pop3proxyham.mbox and _pop3proxyspam.mbox.
+.SH "SEE ALSO"
+The full documentation for
+.B option
+is maintained as a Texinfo manual.  If the
+.B info
+and
+.B option
+programs are properly installed at your site, the command
+.IP
+.B info option
+.PP
+should give you access to the complete manual.

Added: packages/spambayes/trunk/debian/doc/sb_unheader.1
===================================================================
--- packages/spambayes/trunk/debian/doc/sb_unheader.1	                        (rev 0)
+++ packages/spambayes/trunk/debian/doc/sb_unheader.1	2014-06-13 11:43:08 UTC (rev 10943)
@@ -0,0 +1,27 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.40.10.
+.TH USAGE: "1" "June 2014" "usage: unheader.py [ -p pat ... ] [ -s ] folder" "User Commands"
+.SH NAME
+usage: \- manual page for usage: unheader.py [ -p pat ... ] [ -s ] folder
+.SH DESCRIPTION
+usage: unheader.py [ \fB\-p\fR pat ... ] [ \fB\-s\fR ] folder
+\fB\-p\fR pat gives a regex pattern used to eliminate unwanted headers
+\&'\-p pat' may be given multiple times
+\fB\-s\fR tells not to remove SpamAssassin headers
+\fB\-d\fR means treat folder as a Maildir
+.PP
+\fB\-p\fR pat gives a regex pattern used to eliminate unwanted headers
+\&'\-p pat' may be given multiple times
+\fB\-s\fR tells not to remove SpamAssassin headers
+\fB\-d\fR means treat folder as a Maildir
+.SH "SEE ALSO"
+The full documentation for
+.B usage:
+is maintained as a Texinfo manual.  If the
+.B info
+and
+.B usage:
+programs are properly installed at your site, the command
+.IP
+.B info usage:
+.PP
+should give you access to the complete manual.

Added: packages/spambayes/trunk/debian/doc/sb_upload.1
===================================================================
--- packages/spambayes/trunk/debian/doc/sb_upload.1	                        (rev 0)
+++ packages/spambayes/trunk/debian/doc/sb_upload.1	2014-06-13 11:43:08 UTC (rev 10943)
@@ -0,0 +1,71 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.40.10.
+.TH SB_UPLOAD "1" "June 2014" "sb_upload " "User Commands"
+.SH NAME
+sb_upload \- manual page for sb_upload 
+.SH DESCRIPTION
+Read a message or a mailbox file on standard input, upload it to a
+web server and write it to standard output.
+.PP
+By default, this sends the message to the SpamBayes sb_server web
+interface, which will save the message in the 'unknown' cache, ready
+for you to classify it.  It does not do any training, just saves it
+ready for you to classify (unless you use the \fB\-t\fR switch).
+.PP
+usage:  /usr/bin/sb_upload [\-h] [\-n] [\-s server] [\-p port] [\-r N]
+.IP
+[\-o section:option:value]
+[\-t (ham|spam)]
+.SH OPTIONS
+.HP
+\fB\-h\fR, \fB\-\-help\fR    \- print help and exit
+.HP
+\fB\-n\fR, \fB\-\-null\fR    \- suppress writing to standard output (default False)
+.HP
+\fB\-s\fR, \fB\-\-server=\fR \- provide alternate web server (default localhost)
+.HP
+\fB\-p\fR, \fB\-\-port=\fR   \- provide alternate server port (default 8880)
+.HP
+\fB\-r\fR, \fB\-\-prob=\fR   \- feed the message to the trainer w/ prob N [0.0...1.0]
+.HP
+\fB\-t\fR, \fB\-\-train=\fR  \- train the message (pass either 'ham' or 'spam')
+.HP
+\fB\-o\fR, \fB\-\-option=\fR \- set [section, option] in the options database to value
+.PP
+Read a message or a mailbox file on standard input, upload it to a
+web server and write it to standard output.
+.PP
+By default, this sends the message to the SpamBayes sb_server web
+interface, which will save the message in the 'unknown' cache, ready
+for you to classify it.  It does not do any training, just saves it
+ready for you to classify (unless you use the \fB\-t\fR switch).
+.PP
+usage:  /usr/bin/sb_upload [\-h] [\-n] [\-s server] [\-p port] [\-r N]
+.IP
+[\-o section:option:value]
+[\-t (ham|spam)]
+.HP
+\fB\-h\fR, \fB\-\-help\fR    \- print help and exit
+.HP
+\fB\-n\fR, \fB\-\-null\fR    \- suppress writing to standard output (default False)
+.HP
+\fB\-s\fR, \fB\-\-server=\fR \- provide alternate web server (default localhost)
+.HP
+\fB\-p\fR, \fB\-\-port=\fR   \- provide alternate server port (default 8880)
+.HP
+\fB\-r\fR, \fB\-\-prob=\fR   \- feed the message to the trainer w/ prob N [0.0...1.0]
+.HP
+\fB\-t\fR, \fB\-\-train=\fR  \- train the message (pass either 'ham' or 'spam')
+.HP
+\fB\-o\fR, \fB\-\-option=\fR \- set [section, option] in the options database to value
+.SH "SEE ALSO"
+The full documentation for
+.B sb_upload
+is maintained as a Texinfo manual.  If the
+.B info
+and
+.B sb_upload
+programs are properly installed at your site, the command
+.IP
+.B info sb_upload
+.PP
+should give you access to the complete manual.

Added: packages/spambayes/trunk/debian/doc/sb_xmlrpcserver.1
===================================================================
--- packages/spambayes/trunk/debian/doc/sb_xmlrpcserver.1	                        (rev 0)
+++ packages/spambayes/trunk/debian/doc/sb_xmlrpcserver.1	2014-06-13 11:43:08 UTC (rev 10943)
@@ -0,0 +1,79 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.40.10.
+.TH OPTION "1" "June 2014" "option --version not recognized" "User Commands"
+.SH NAME
+option \- manual page for option --version not recognized
+.SH SYNOPSIS
+.B %(program)s
+[\fIoptions\fR] \fIIP:PORT\fR
+.SH DESCRIPTION
+option \fB\-\-help\fR not recognized
+.SS "Where:"
+.HP
+\fB\-h\fR
+.IP
+show usage and exit
+.HP
+\fB\-p\fR FILE
+.TP
+use pickle FILE as the persistent store.
+loads data from this file
+.IP
+if it exists, and saves data to this file at the end.
+.HP
+\fB\-d\fR FILE
+.IP
+use DBM store FILE as the persistent store.
+.HP
+\fB\-o\fR section:option:value
+.IP
+set [section, option] in the options database to value
+.IP
+IP
+.IP
+IP address to bind (use 0.0.0.0 to listen on all IPs of this machine)
+.IP
+PORT
+.IP
+Port number to listen to.
+.PP
+Usage: %(program)s [options] IP:PORT
+.SS "Where:"
+.HP
+\fB\-h\fR
+.IP
+show usage and exit
+.HP
+\fB\-p\fR FILE
+.TP
+use pickle FILE as the persistent store.
+loads data from this file
+.IP
+if it exists, and saves data to this file at the end.
+.HP
+\fB\-d\fR FILE
+.IP
+use DBM store FILE as the persistent store.
+.HP
+\fB\-o\fR section:option:value
+.IP
+set [section, option] in the options database to value
+.IP
+IP
+.IP
+IP address to bind (use 0.0.0.0 to listen on all IPs of this machine)
+.IP
+PORT
+.IP
+Port number to listen to.
+.SH "SEE ALSO"
+The full documentation for
+.B option
+is maintained as a Texinfo manual.  If the
+.B info
+and
+.B option
+programs are properly installed at your site, the command
+.IP
+.B info option
+.PP
+should give you access to the complete manual.

Added: packages/spambayes/trunk/debian/spambayes.manpages
===================================================================
--- packages/spambayes/trunk/debian/spambayes.manpages	                        (rev 0)
+++ packages/spambayes/trunk/debian/spambayes.manpages	2014-06-13 11:43:08 UTC (rev 10943)
@@ -0,0 +1,15 @@
+core_server.1
+sb_bnfilter.1
+sb_bnserver.1
+sb_chkopts.1
+sb_client.1
+sb_dbexpimp.1
+sb_evoscore.1
+sb_filter.1
+sb_imapfilter.1
+sb_mailsort.1
+sb_mboxtrain.1
+sb_server.1
+sb_unheader.1
+sb_upload.1
+sb_xmlrpcserver.1

More information about the Python-apps-commits mailing list