=head1 NAME public-inbox-convert - convert v1 inboxes to v2 =head1 SYNOPSIS public-inbox-convert [OPTIONS] OLD_DIR NEW_DIR =head1 DESCRIPTION public-inbox-convert copies the contents of an old "v1" inbox into a new "v2" inbox. It makes no changes to the old inbox and users are expected to update the "inboxdir" path in L to point to the path of NEW_DIR once they are satisfied with the conversion. =head1 OPTIONS =over =item --no-index Disables Xapian and overview DB indexing on the new inbox. By default, public-inbox-convert creates a new index in the v2 inbox and indexes all existing messages, a lengthy operation for large inboxes. =item -j JOBS, --jobs=JOBS Control the number of indexing jobs and Xapian shards of the v2 inbox. By default, this is the detected CPU count but capped at 4 due to various bottlenecks. The number of Xapian shards will be 1 less than the JOBS value, since there is a single process which distributes work to the Xapian shards. =back =head1 ENVIRONMENT =over 8 =item PI_CONFIG The default config file, normally "~/.public-inbox/config". See L =back =head1 UPGRADING Editing "~/.public-inbox/config" (or whatever C is set to) will be required to start using the new directory. =head1 BUGS Writes from L or L to the v1 inbox which occur after the start of the conversion will not be picked up in the v2 inbox. Users of L do not have to worry about this. They only need to update the config file to point to the v2 inbox, send C public-inbox-watch process to reload the config file, and then C to rescan existing Maildirs. =head1 CONTACT Feedback welcome via plain-text mail to L The mail archives are hosted at L and L =head1 COPYRIGHT Copyright 2013-2020 all contributors L License: AGPL-3.0+ L =head1 SEE ALSO L, L, L, L, L