Provided by: lurker_2.3-5_i386 bug

NAME

       mailman2lurker - Import mailman lists and their archives into a lurker
       database.

SYNOPSIS

        mailman2lurker -i|-p [options]

DESCRIPTION

       mailman2lurker has mainly two functions. First, it parses mailman's
       lists and creates a lurker configuration include out of them. Second,
       it imports archives from mailman lists into a lurker database.

       To build a new lurker database from mailmans archives, first run
       'mailman2lurker -p'. Next you need to add 'include =
       /etc/lurker/lurker.conf.mailman' into /etc/lurker/lurker.conf.local.
       Finally import mailmans mboxes by running 'mailman2lurker -i'.

       If you want to add new lists to an already existing lurker
       configuration, run 'mailman2lurker -p -w newlists' and afterwards
       'mailman2lurker -i -f newlists'. This will import only the mbox files
       of mailman lists that have been added to the lurker configuration
       because they were new to lurker.

COMMANDS

       -p, --parse
           Parse mailman lists, and create a lurker configuration include file
           containing all parsed lists. Lists that are already configured in
           lurker are ignored.

       -i, --import
           Import archives of all lists. This parses the lurker configuration
           and imports the mailman mbox at
           /var/lib/mailman/archives/private/<list>.mbox/<list>.mbox for every
           list.

OPTIONS

       -c, --config <config>
           Use <config> as lurker configuration file. Default:
           /etc/lurker/lurker.conf

       -o, --outfile <outfile>
           Write list configuration to <outfile>. If this is not specified,
           <lurker.conf>.mailman will be used.  This option is only useful in
           conjunction with -p.

       -g, --group <group>
           Use <group> for new lists. Default is 'undef'.  This option is only
           useful in conjunction with -p.

       -a, --listhost <listhost>
           Use <listhost> as host for new list addresses. If a new list is
           called 'mylist' and <listhost> is lists.org, then the list address
           will be mylist@lists.org. Default is 'example.org'.  This option is
           only useful in conjunction with -p.

       -l, --link <url link>
           Use <url link> as base for links of new lists. If a list is called
           'mylist', and <url link> is 'http://lists.org', then the link
           address will be http://lists.org/mylist. Default is
           'http://example.org'.  This option is only useful in conjunction
           with -p.

       -s, --lang <language>
           Use <language> as language for new lists. Needs to be a language
           token.  Default is 'en'. This option is only useful in conjunction
           with -p.

       -w, --write-lists <file>
           Write a list of all lists that have been added to the lurker
           configuration.  Safe that list in <file>. Default is off.  This
           option is only useful in conjunction with -p.

       -x, --list-cmd <file>
           Use <command|file> to get the list of mailman lists that should be
           parsed.  When <command|file> is a command, it needs to end with '
           |'.  Default is '/var/lib/mailman/bin/list_lists |'.  This option
           is only useful in conjunction with -p.

       -f, --listfile <file>
           Import only lists that are listed in <file>.  This option is only
           useful in conjunction with -i.

       -d, --lists <one[,two,...]>
           Import only lists that are given as argument.  This option is only
           useful in conjunction with -i.

       -h, --help
           Display a help message.

       -v, --version
           Display mailman2lurker's version number.

SEE ALSO

       list_lists(8), lurker-index(8)

AUTHOR

       This program was written by Jonas Meurer <jonas@freesources.org>.

COPYRIGHT

       mailman2lurker may be copied and modified under the terms of the GNU
       General Public License.

                                  2011-09-19                 MAILMAN2LURKER(8)