debian man page for gpodder-backup

GPODDER-BACKUP(1)						   User Commands						 GPODDER-BACKUP(1)

NAME
       gpodder-backup - Backup and restore utility for gPodder user data

SYNOPSIS
       gpodder-backup [--create|--extract] <archive.gpo.tar.gz> [options] gpodder-backup --purge

DESCRIPTION
       This utility can be used to create a dump of the current gPodder data (configuration files + downloads), optionally replacing the real con-
       tents of the download folder with zero-byte files (for submitting your data to a bug report without having to transfer lots of data).

OPTIONS
       --version
	      show program's version number and exit

       -h, --help
	      show this help message and exit

       -c <FILE>, --create=<FILE>
	      Create a new archive

       -x <FILE>, --extract=<FILE>
	      Extract an existing archive

       -f, --fake-downloads
	      Store downloads as zero-byte files in backup

       -n, --no-covers
	      Do not include cover files in archive

       -D <DIR>, --destination=<DIR>
	      Extract downloads in different folder

       -P, --purge
	      Remove current data (can be combined with --extract)

USAGE FOR BUG REPORTING
       This command is useful if you want to report a bug in gPodder:

       gpodder-backup --create bug123.gpo.tar.gz --fake-downloads
	      Backup your current data to file bug123.gpo.tar.gz, but don't store download data (create zero-size dummy files  instead).  You  can
	      then attach bug123.gpo.tar.gz to the bug report.

       If you are instructed to try gPodder from a "clean state", you can use the following command (be sure to backup your data before!):

       gpodder-backup --purge
	      Remove all gPodder data, so you can start from a clean state

EXAMPLES
       gpodder-backup --create today.gpo.tar.gz
	      Backup your current data to file today.gpo.tar.gz

       gpodder-backup --extract mybackup.gpo.tar.gz
	      Restore (without purging) the contents of mybackup.gpo.tar.gz

       gpodder-backup --extract default.gpo.tar.gz --purge
	      Remove current data, then restore the contents of default.gpo.tar.gz

       gpodder-backup --purge
	      Remove all gPodder data, so you can start from a clean state

EXTRACTING FAKED DOWNLOADS
       Please  note  that  any	existing  downloads will be overwritten with zero-byte files when using the --extract option of the gpodder-backup
       utility with a backup created with --fake-downloads

AUTHOR
       gpodder-backup was written by Thomas Perl (thp@gpodder.org)

gpodder-backup 1.0						   December 2010						 GPODDER-BACKUP(1)