Commit ce02d1aa authored by Michael Terry's avatar Michael Terry

initial conversion to mallard

parent 15d9a56c
......@@ -16,12 +16,12 @@
# You should have received a copy of the GNU General Public License
# along with Déjà Dup. If not, see <http://www.gnu.org/licenses/>.
SUBDIRS = data po vapi common widgets monitor preferences deja-dup nautilus help tests
SUBDIRS = data po vapi common widgets monitor preferences deja-dup nautilus help man tests
# Distribute pot file
update-pot:
$(MAKE) -C po "$(GETTEXT_PACKAGE).pot"
$(MAKE) -C help update-pot
$(MAKE) -C man update-pot
dist-hook: update-pot
release: distcheck
......
......@@ -144,6 +144,7 @@ AC_CONFIG_FILES([Makefile
data/Makefile
deja-dup/Makefile
help/Makefile
man/Makefile
monitor/Makefile
nautilus/Makefile
po/Makefile.in
......
<page xmlns="http://projectmallard.org/1.0/"
type="topic"
id="backup-auto">
<info>
<link type="guide" xref="backup"/>
</info>
<title>Automatic Backups</title>
</page>
<page xmlns="http://projectmallard.org/1.0/"
type="topic"
id="backup-first">
<info>
<link type="guide" xref="backup"/>
</info>
<title>First Backup</title>
</page>
<page xmlns="http://projectmallard.org/1.0/"
type="guide"
id="backup">
<info>
<desc>Prepare for data loss.</desc>
<link type="guide" xref="index"/>
</info>
<title>Backing Up</title>
</page>
<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
<article id="index" lang="C">
<articleinfo>
<title><application>Déjà Dup</application> Manual</title>
<abstract role="description">
<para><application>Déjà Dup</application> is a simple backup tool.</para>
</abstract>
<publisher role="maintainer">
<publishername><ulink url="http://launchpad.net/~deja-dup-team" type="http"><application>Déjà Dup</application> Administrators</ulink></publishername>
</publisher>
<legalnotice id="legalnotice">
<para>Permission is granted to copy, distribute and/or modify this document under the terms of the GNU General Public License (GPL), Version 3 or any later version published by the Free Software Foundation. You can find a copy of the GPL at this <ulink type="help" url="ghelp:gpl">link</ulink> or in the file COPYING distributed with this manual.</para>
<para>This manual is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.</para>
</legalnotice>
<authorgroup>
<author>
<firstname>Michael</firstname>
<surname>Terry</surname>
<affiliation>
<address> <email>mike@mterry.name</email> </address>
</affiliation>
</author>
</authorgroup>
<revhistory>
<revision>
<revnumber>%VERSION%</revnumber>
<date>%DATE%</date>
<revdescription>
<para role="author">Michael Terry <email>mike@mterry.name</email></para>
<para role="publisher"><ulink url="http://launchpad.net/~deja-dup-team" type="http"><application>Déjà Dup</application> Administrators</ulink></para>
</revdescription>
</revision>
</revhistory>
<releaseinfo>This manual describes version %VERSION% of Déjà Dup.</releaseinfo>
<legalnotice>
<title>Feedback</title>
<para>To report a bug or make a suggestion regarding the <application>Déjà Dup</application> application or this manual, visit the <ulink url="http://bugs.launchpad.net/deja-dup/+filebug" type="http"><application>Déjà Dup</application> project page</ulink>.</para>
</legalnotice>
</articleinfo>
<indexterm zone="index">
<primary>Déjà Dup</primary>
</indexterm>
<indexterm zone="index">
<primary>deja-dup</primary>
</indexterm>
<sect1 id="deja-dup-introduction">
<title>Introduction</title>
<para><application>Déjà Dup</application> is a simple backup tool. It hides the complexity of doing backups the 'right way' (encrypted, off-site, and regular) and uses duplicity as the backend. </para>
<para><application>Déjà Dup</application> provides the following features:</para>
<itemizedlist>
<listitem><para>Support for local or remote backup locations, including Amazon S3</para></listitem>
<listitem><para>Securely encrypts and compresses your data.</para></listitem>
<listitem><para>Incrementally backs up, letting you restore from any particular backup.</para></listitem>
<listitem><para>Schedules regular backups.</para></listitem>
<listitem><para>Integrates well into your GNOME desktop.</para></listitem>
</itemizedlist>
</sect1>
<sect1 id="deja-dup-getting-started">
<title>Getting Started</title>
<sect2 id="deja-dup-start">
<title>Starting <application>Déjà Dup</application></title>
<para>You can start <application>Déjà Dup</application> in the following ways:</para>
<variablelist>
<varlistentry>
<term><guimenu>Applications</guimenu> menu</term>
<listitem>
<para>Choose <menuchoice><guisubmenu>System Tools</guisubmenu><guimenuitem>Déjà Dup Backup Tool</guimenuitem></menuchoice>.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Command line</term>
<listitem>
<para>To start <application>Déjà Dup</application> from a command line, type the following command, then press <keycap>Return</keycap>:</para>
<para><command>deja-dup</command></para>
</listitem>
</varlistentry>
</variablelist>
</sect2>
</sect1>
<sect1 id="deja-dup-backup">
<title>Backing Up</title>
<para>To backup, choose <menuchoice><guimenu>Backup</guimenu><guimenuitem>Backup</guimenuitem></menuchoice>. Or press the <guibutton>Backup</guibutton> button on the main window.</para>
<para>The <guilabel>Backup</guilabel> dialog will then be displayed. If this is your first time using <application>Déjà Dup</application>, you will be asked to choose a backup location and which files to include or exclude. On the Summary page, click <guibutton>Backup</guibutton> to start the backup.</para>
</sect1>
<sect1 id="deja-dup-restore">
<title>Restoring</title>
<para>To restore, choose <menuchoice><guimenu>Backup</guimenu><guimenuitem>Restore</guimenuitem></menuchoice>. Or press the <guibutton>Restore</guibutton> button on the main window.</para>
<para>The <guilabel>Restore</guilabel> dialog will then be displayed. If this is your first time using <application>Déjà Dup</application>, you will be asked to choose a backup location. Then choose which backup date to restore from and where to put the restored files. You can either restore them to their original locations or put them in a folder of your choice.</para>
<para>After clicking <guibutton>Forward</guibutton>, you can review your restore options, then click <guibutton>Restore</guibutton> to start the restore.</para>
</sect1>
<sect1 id="deja-dup-prefs">
<title>Preferences</title>
<para>To configure <application>Déjà Dup</application>, choose <menuchoice><guimenu>Edit</guimenu><guimenuitem>Preferences</guimenuitem></menuchoice>.</para>
<variablelist>
<varlistentry>
<term><guilabel>Backup location</guilabel></term>
<listitem>
<para>Use this drop-down list box to specify the backup location that <application>Déjà Dup</application> uses when backing up or restoring:</para>
<itemizedlist>
<listitem>
<para><guilabel>Amazon S3</guilabel></para>
<para>This backup location uses the S3 storage service from Amazon. For a small fee per gigabyte, they hold your data for you. This is the recommended default because it is an easy way to keep your data offsite (meaning out of your home: in case of disaster or theft, your data will still be safe). You can sign up <ulink url="http://aws.amazon.com/s3/" type="http">online</ulink>.</para>
<caution><para>This service costs money. Read their rates carefully before using it.</para></caution>
</listitem>
<listitem>
<para>Removable Media</para>
<para>You may see removable media like external hard drives or thumb drives listed.</para>
</listitem>
<listitem>
<para>Connected Servers</para>
<para>If you have connected to any servers, they will appear. To connect to a server not listed, select <guilabel>Other...</guilabel> and click <guibutton>Connect to Server...</guibutton>. This will let you enter the server information.</para>
</listitem>
<listitem>
<para>Local Folders</para>
<para>You may also want to choose a local folder as a backup location. Note that backups can be quite large, so make sure you have enough free disk space.</para>
</listitem>
</itemizedlist>
<para>Default: <guilabel>Amazon S3</guilabel>.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><guilabel>S3 Access Key ID</guilabel></term>
<listitem>
<note><para>This option only appears if the <guilabel>Amazon S3</guilabel>
backup location has been selected.</para></note>
<para>This is your Access Key ID that Amazon gave you when you signed up for S3. It is like a username for logging into S3. If left empty, you will be prompted for it as you backup or restore.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Folder</guilabel></term>
<listitem>
<note><para>This option only appears if the <guilabel>Amazon S3</guilabel> backup location has been selected.</para></note>
<para>If you have multiple backups, you may want to keep them separated in multiple folders. Use this option to enter a path on the S3 service in which to put your files.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Include files in folders</guilabel></term>
<listitem>
<para>Select a list of directories to backup. Press the <guibutton>Add</guibutton> or <guibutton>Remove</guibutton> buttons to modify the list. If you are only interested in backing up your own data, the default of <guilabel>Home Folder</guilabel> is sufficient.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Except files in folders</guilabel></term>
<listitem>
<para>Select a list of directories to not backup. Press the <guibutton>Add </guibutton> or <guibutton>Remove</guibutton> buttons to modify the list. This list takes precedence over the list of included directories.</para>
<para>Some of your data may be large and not very important to you. In that case, you can save yourself some time and space by not backing them up.</para>
<para>There are some locations that <application>Déjà Dup</application> excludes by default:
<itemizedlist>
<listitem><para>~/.cache</para></listitem>
<listitem><para>~/.thumbnails</para></listitem>
<listitem><para>~/.gvfs</para></listitem>
<listitem><para>~/.xsession-errors</para></listitem>
<listitem><para>~/.recently-used.xbel</para></listitem>
<listitem><para>~/.recent-applications.xbel</para></listitem>
<listitem><para>~/.Private</para></listitem>
<listitem><para>/proc</para></listitem>
<listitem><para>/tmp</para></listitem>
<listitem><para>/sys</para></listitem>
</itemizedlist>
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Encrypt backup files</guilabel></term>
<listitem>
<para>Encrypting your backup files is recommended to keep your data safe. If you don't have exclusive physical control of your backup location, or if it is stolen, an encrypted backup prevents others from looking at your personal data.</para>
<para>If on, you will be prompted for a password. Keep this password safe, you will need it to restore your data.</para>
<para>Default: <userinput>On</userinput>.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Automatically backup on a regular schedule</guilabel></term>
<listitem>
<para>Turn this option on to have <application>Déjà Dup</application> automatically backup for you. This is recommended so that you don't forget to backup. Backups are more useful the more recently you have made them, so it is important to regularly do so.</para>
<para>Default: <userinput>Off</userinput>.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><guilabel>How often to backup</guilabel></term>
<listitem>
<para>Choose a schedule for automatic backups.</para>
<para>Default: <guilabel>Weekly</guilabel>.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Keep backups</guilabel></term>
<listitem>
<para>Choose the minimum amount of time to keep backup files. If you find that the backup files are taking up too much space, you may want to decrease this duration. Due to implementation details, files may be kept a bit longer than the chosen time. But no files will be deleted early.</para>
<para>Default: <guilabel>Forever</guilabel>.</para>
</listitem>
</varlistentry>
</variablelist>
</sect1>
</article>
<page xmlns="http://projectmallard.org/1.0/"
type="guide"
id="index">
<info>
<credit type="author maintainer">
<name>Michael Terry</name>
<email>mike@mterry.name</email>
<years>2010</years>
</credit>
<license href="http://creativecommons.org/licenses/by-sa/3.0/"><p>Creative Commons Attribution-Share Alike 3.0 Unported License</p></license>
</info>
<title><app>Déjà Dup</app> Help</title>
</page>
<page xmlns="http://projectmallard.org/1.0/"
type="topic"
id="prefs">
<info>
<desc>Adjust your backup settings.</desc>
<link type="guide" xref="index"/>
</info>
<title>Preferences</title>
<p>To configure <app>Déjà Dup</app>, choose <guiseq><gui style="menu">Edit</gui><gui style="menuitem">Preferences</gui></guiseq>.</p>
<terms>
<item>
<title><gui>Backup location</gui></title>
<p>Use this drop-down list box to specify the backup location that <app>Déjà Dup</app> uses when backing up or restoring:</p>
<terms>
<item>
<title>Amazon S3</title>
<p>This backup location uses the S3 storage service from Amazon. For a small fee per gigabyte, they hold your data for you. This is the recommended default because it is an easy way to keep your data offsite (meaning out of your home: in case of disaster or theft, your data will still be safe). You can sign up <link href="http://aws.amazon.com/s3/">online</link>.</p>
<note><p>This is the default setting.</p></note>
<note style="warning"><p>This service costs money. Read their rates carefully before using it.</p></note>
</item>
<item>
<title>Removable Media</title>
<p>You may see removable media like external hard drives or thumb drives listed.</p>
</item>
<item>
<title>Connected Servers</title>
<p>If you have connected to any servers, they will appear. To connect to a server not listed, click <gui style="button">Connect to Server…</gui>. This will let you enter the server information.</p>
<note style="bug"><p>After you connect to a server, make sure to go back to the <gui>Preferences</gui> dialog and choose the folder on that server to which you want to back up. This is not currently automatically selected after you connect.</p></note>
</item>
<item>
<title>Local Folders</title>
<p>You may also want to choose a local folder as a backup location. Note that backups can be quite large, so make sure you have enough free disk space.</p>
</item>
</terms>
</item>
<item>
<title><gui style="input">S3 Access Key ID</gui></title>
<p>This is your Access Key ID that Amazon gave you when you signed up for S3. It is like a username for logging into S3. If left empty, you will be prompted for it as you backup or restore.</p>
<note><p>This option only appears if the <gui>Amazon S3</gui> backup location has been selected.</p></note>
</item>
<item>
<title><gui style="input">Folder</gui></title>
<p>If you have multiple backups, you may want to keep them separated in multiple folders. Use this option to enter a path on the S3 service in which to put your files.</p>
<note><p>This option only appears if the <gui>Amazon S3</gui> backup location has been selected.</p></note>
</item>
<item>
<title><gui>Include files in folders</gui></title>
<p>Select a list of directories to backup. Press the <gui style="button">Add</gui> or <gui style="button">Remove</gui> buttons to modify the list. If you are only interested in backing up your own data, the default of <gui>Home Folder</gui> is sufficient.</p>
</item>
<item>
<title><gui>Except files in folders</gui></title>
<p>Select a list of directories to not backup. Press the <gui style="button">Add </gui> or <gui style="button">Remove</gui> buttons to modify the list.</p>
<p>Some of your data may be large and not very important to you. In that case, you can save yourself some time and space by not backing them up.</p>
<note style="advanced">
<p>Some locations are excluded by default:</p>
<list>
<item><p><file>~/.cache</file></p></item>
<item><p><file>~/.thumbnails</file></p></item>
<item><p><file>~/.gvfs</file></p></item>
<item><p><file>~/.xsession-errors</file></p></item>
<item><p><file>~/.recently-used.xbel</file></p></item>
<item><p><file>~/.recent-applications.xbel</file></p></item>
<item><p><file>~/.Private</file></p></item>
<item><p><file>/proc</file></p></item>
<item><p><file>/tmp</file></p></item>
<item><p><file>/sys</file></p></item>
</list>
</note>
</item>
<item>
<title><gui style="checkbox">Encrypt backup files</gui></title>
<p>Encrypting your backup files is recommended to keep your data safe. If you don't have exclusive physical control of your backup location, or if it is stolen, an encrypted backup prevents others from looking at your personal data.</p>
<p>If on, you will be prompted for a password. Keep this password safe, you will need it to restore your data.</p>
<note><p>Encryption is enabled by default.</p></note>
</item>
<item>
<title><gui style="checkbox">Automatically backup on a regular schedule</gui></title>
<p>Turn this option on to have <app>Déjà Dup</app> automatically backup for you. This is recommended so that you don't forget to do it yourself. Backups are more useful the more recently you have made them, so it is important to regularly do so.</p>
<note><p>Automatic backups are disabled by default.</p></note>
</item>
<item>
<title><gui>How often to backup</gui></title>
<p>Choose a schedule for automatic backups.</p>
<note><p>Automatic backups are scheduled weekly by default.</p></note>
</item>
<item>
<title><gui>Keep backups</gui></title>
<p>Choose the minimum amount of time to keep backup files. If you find that the backup files are taking up too much space, you may want to decrease this duration. Due to implementation details, files may be kept a bit longer than the chosen time. But no files will be deleted early.</p>
<note><p>Backups are kept forever by default.</p></note>
</item>
</terms>
</page>
<page xmlns="http://projectmallard.org/1.0/"
type="topic"
id="restore-full">
<info>
<desc>Recover from total system failure.</desc>
<link type="guide" xref="restore"/>
</info>
<title>Full System Restore</title>
<section id="setup">
<title>Setup</title>
<steps>
<item><p>Get your system to a fresh state. For example, a fresh install or a new account on an old computer. Don’t worry about getting comfortable and customizing settings yet. Wait until after you restore your previous settings to change anything, as any customizations you make now may get overridden once you restore.</p></item>
<item><p>Next, you need to install <app>Déjà Dup</app>. Your distribution vendor may package it for you. Otherwise, download and compile it.</p></item>
</steps>
</section>
<section id="restore">
<title>Restore</title>
<steps>
<item><p>Run <app>Déjà Dup</app>.</p></item>
<item><p>Click on the big <gui style="button">Restore</gui> button.</p></item>
<item><p>A <gui>Restore</gui> dialog will appear asking where your backup files are stored (your <gui>Backup location</gui>). Choose it from the dropdown or choose <gui>Other…</gui>. On this same screen, select whether you encrypted the backup or not.</p></item>
<item><p>Click <gui style="button">Forward</gui>.</p></item>
<item><p>Choose the date you want to restore from. Usually you can just leave this alone, as the default is the most recent backup.</p></item>
<item><p>Click <gui style="button">Forward</gui>.</p></item>
<item><p>Choose where to restore. Since this is a full system backup, leave it as the default (which restores over your current install).</p></item>
<item><p>Click <gui style="button">Forward</gui>.</p></item>
<item><p>Review your selections and click <gui style="button">Restore</gui>.</p></item>
<item><p>Wait. It may take a long time to finish restoring.</p></item>
<item><p>Finally, reinstall any programs that you enjoyed in your previous install.</p></item>
</steps>
<note style="tip"><p>If for whatever reason, you have a problem after trying to restore with the <gui style="checkbox">Restore files to original locations</gui> option, try restoring instead to a temporary directory and moving your files to where they belong.</p></note>
</section>
</page>
<page xmlns="http://projectmallard.org/1.0/"
type="topic"
id="restore-lost">
<info>
<desc>Restore a file that is no longer present.</desc>
<link type="guide" xref="restore"/>
</info>
<title>Restoring a Lost File</title>
<p>There's currently no convenient user interface for this. But you can do it with the command line.</p>
<steps>
<item><p>Open a terminal.</p></item>
<item><p>Run <app>Déjà Dup</app> on the lost file with the <cmd>--restore</cmd> argument. For example, to restore the lost file <file>test.txt</file> in your <file>Documents</file> folder:</p>
<screen>deja-dup --restore Documents/test.txt</screen>
<p>You must remember what the filename was, since it’s no longer there to remind you.</p></item>
<item><p>When the <gui>Restore</gui> dialog appears, choose the date from which to restore.</p></item>
<item><p>Click <gui style="button">Forward</gui>.</p></item>
<item><p>Review your selections and click <gui style="button">Restore</gui>.</p></item>
</steps>
<note style="advanced"><p>You can restore multiple lost files at once:</p>
<screen>deja-dup --restore FILE1 FILE2</screen></note>
</page>
<page xmlns="http://projectmallard.org/1.0/"
type="topic"
id="restore-revert">
<info>
<desc>Restore a previous version of a file.</desc>
<link type="guide" xref="restore"/>
</info>
<title>Reverting a File</title>
<steps>
<item><p>Browse to the folder containing the file you want to revert.</p></item>
<item><p>Right click on the file you want to revert.</p></item>
<item><p>Choose <gui style="menuitem">Revert to Previous Version…</gui>.</p></item>
<item><p>When the <gui>Restore</gui> dialog appears, choose the date from which to restore.</p></item>
<item><p>Click <gui style="button">Forward</gui>.</p></item>
<item><p>Review your selections and click <gui style="button">Restore</gui>. Note that this will overwrite your current version of the file.</p></item>
</steps>
<note style="tip"><p>You can select multiple files at once before right clicking.</p></note>
<note style="advanced"><p>You can also revert files on the command line:</p>
<screen>deja-dup --restore FILE1 FILE2</screen></note>
</page>
<page xmlns="http://projectmallard.org/1.0/"
type="guide"
id="restore">
<info>
<desc>Recover from data loss.</desc>
<link type="guide" xref="index"/>
</info>
<title>Restoring Files</title>
</page>
# -*- Mode: Makefile; indent-tabs-mode: t; tab-width: 2 -*-
#
# This file is part of Déjà Dup.
# © 2008,2009 Michael Terry <mike@mterry.name>
# © 2008,2009,2010 Michael Terry <mike@mterry.name>
#
# Déjà Dup is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
......@@ -16,108 +16,21 @@
# You should have received a copy of the GNU General Public License
# along with Déjà Dup. If not, see <http://www.gnu.org/licenses/>.
# Turn off g-d-u's attempt at translating docs -- po4a does it for us.
# This is very hacky, true.
_xml2po = cp ../$(srcdir)/$@ $(notdir $@).tmp && chmod u+w $(notdir $@).tmp || true
clean-local: clean-local-@USE_NLS@
distclean-local: clean-local-@USE_NLS@
mostlyclean-local: clean-local-@USE_NLS@
maintainer-clean-local: clean-local-@USE_NLS@
include $(top_srcdir)/gnome-doc-utils.make
dist_man1_MANS = \
C/deja-dup.1 \
C/deja-dup-monitor.1 \
C/deja-dup-preferences.1
HELP_FILES = $(dist_man1_MANS) C/deja-dup.xml
DOC_MODULE = deja-dup
DOC_ENTITIES =
DOC_INCLUDES =
DOC_FIGURES =
# Here's a bunch of translation support. It's largely stolen from dpkg
# Extract the list of languages from the po4a config.
PO4A_LINGUAS = $(shell sed -ne 's/^.*\[po4a_langs\] \(.*\)$$/\1/p' $(srcdir)/po4a.cfg)
DOC_LINGUAS = $(PO4A_LINGUAS)
all-local: all-local-@USE_NLS@
all-local-no:
all-local-yes: po4a.stamp
# This makes 'make -j2' work. _DOC_LC_DOCS is defined in gnome-doc-util.make
$(_DOC_LC_DOCS) : po4a.stamp
# Put LINGUAS list into po4a.cfg, but only if needed (else we'll update
# timestamp on the cfg file unnecessarily. Also copy all the po files from the
# real po directory into the sub language directories in help where po4a looks
# for them. po4a modifies those po files, so we don't want it to access the
# real ones.
prepare.stamp: po4a.cfg
for lang in C $(PO4A_LINGUAS); do \
$(mkdir_p) $$lang; \
test "$(srcdir)" = "." || cp -ar $(srcdir)/$$lang/* $$lang; \
done
touch $@
po4a.stamp: po4a.cfg $(HELP_FILES) prepare.stamp $(srcdir)/translations/*.po
test -e $(srcdir)/no-po4a || $(PO4A) --no-backups --variable srcdir=$(srcdir) $(srcdir)/po4a.cfg
touch $@
clean-local-no:
clean-local-yes:
for lang in $(PO4A_LINGUAS); do \
if [ -d $$lang ]; then \
rm -f $$(echo "$(dist_man1_MANS)" | sed "s|C/|$$lang/|g"); \
fi \
done
test "$(srcdir)" = "." || rm -fr C
test -e $(srcdir)/no-po4a || $(PO4A) --rm-backups --rm-translations --variable top_srcdir=$(top_srcdir) --variable srcdir=$(srcdir) $(srcdir)/po4a.cfg
rm -f po4a.stamp prepare.stamp
update-pot: prepare.stamp
test -e $(srcdir)/no-po4a || $(PO4A) --no-backups --force --no-translations --variable srcdir=$(srcdir) $(srcdir)/po4a.cfg
install-data-local: install-data-local-@USE_NLS@
install-data-local-no:
install-data-local-yes:
for lang in $(PO4A_LINGUAS); do \
if [ -d $$lang ]; then \
files=$$(echo "$(dist_man1_MANS)" | sed "s|C/|$$lang/|g"); \
$(MAKE) install-man \
mandir="$(mandir)/$$lang" \
man_MANS="" \
dist_man1_MANS="$$files"; \
fi \
done
uninstall-local: uninstall-local-@USE_NLS@
uninstall-local-no:
uninstall-local-yes:
for lang in $(PO4A_LINGUAS); do \
if [ -d $$lang ]; then \
files=$$(echo "$(dist_man1_MANS)" | sed "s|C/|$$lang/|g"); \
$(MAKE) uninstall-man \
mandir="$(mandir)/$$lang" \
man_MANS="" \
dist_man1_MANS="$$files"; \
fi \
done
DOC_ID = deja-dup
dist-hook: po4a.stamp doc-dist-hook
for lang in $(PO4A_LINGUAS); do \
$(mkdir_p) $(distdir)/$$lang; \
cp -r $(srcdir)/$$lang/*.xml $(srcdir)/$$lang/*.1 $(distdir)/$$lang; \
done
for lang in C $(PO4A_LINGUAS); do \
! test -e $(distdir)/$$lang/deja-dup.xml || sed -i "s/%VERSION%/$(VERSION)/g;s/%DATE%/`date --utc +%F`/g;s/lang=\"C\"/lang=\"$$lang\"/g" $(distdir)/$$lang/*.xml $(distdir)/$$lang/*.1; \
done
touch $(distdir)/no-po4a
DOC_PAGES = \
backup-auto.page \
backup-first.page \
backup.page \
index.page \
prefs.page \
restore-full.page \
restore-lost.page \
restore.page \
restore-revert.page
EXTRA_DIST = po4a.cfg po4a.stamp translations
DOC_LINGUAS = ar cs da de en_GB es fi fr gl he hu id ja lt nb nl ps ru sv tr
.PHONY: update-pot
dist-hook: doc-dist-hook
<?xml version="1.0" standalone="no"?>
<omf>
<resource>
<subject category="System|Administration|Backups"/>
<type>manual</type>
<relation seriesid="0fa0ecb6-bb46-6652-717a-b360e5c0bc0a70"/>
<rights type="GNU GPL" license.version="3"/>
</resource>
</omf>
This diff is collapsed.
# -*- Mode: Makefile; indent-tabs-mode: t; tab-width: 2 -*-
#
# This file is part of Déjà Dup.
# © 2008,2009,2010 Michael Terry <mike@mterry.name>
#
# Déjà Dup is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; either version 3 of the License, or
# (at your option) any later version.
#
# Déjà Dup is distributed in the hope that it will be useful, but
# WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
# General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with Déjà Dup. If not, see <http://www.gnu.org/licenses/>.
dist_man1_MANS = \
C/deja-dup.1 \
C/deja-dup-monitor.1 \
C/deja-dup-preferences.1
# Here's a bunch of translation support. It's largely stolen from dpkg
# Extract the list of languages from the po4a config.
PO4A_LINGUAS = $(shell sed -ne 's/^.*\[po4a_langs\] \(.*\)$$/\1/p' $(srcdir)/po4a.cfg)
all-local: all-local-@USE_NLS@
all-local-no:
all-local-yes: po4a.stamp
# Put LINGUAS list into po4a.cfg, but only if needed (else we'll update
# timestamp on the cfg file unnecessarily. Also copy all the po files from the
# real po directory into the sub language directories in help where po4a looks
# for them. po4a modifies those po files, so we don't want it to access the
# real ones.
prepare.stamp: po4a.cfg
for lang in C $(PO4A_LINGUAS); do \
$(mkdir_p) $$lang; \
test "$(srcdir)" = "." || cp -ar $(srcdir)/$$lang/* $$lang; \
done
touch $@
po4a.stamp: po4a.cfg $(dist_man1_MANS) prepare.stamp $(srcdir)/translations/*.po
test -e $(srcdir)/no-po4a || $(PO4A) --no-backups --variable srcdir=$(srcdir) $(srcdir)/po4a.cfg
touch $@
clean-local: clean-local-@USE_NLS@
distclean-local: clean-local-@USE_NLS@
mostlyclean-local: clean-local-@USE_NLS@
maintainer-clean-local: clean-local-@USE_NLS@
clean-local-no:
clean-local-yes:
for lang in $(PO4A_LINGUAS); do \
if [ -d $$lang ]; then \
rm -f $$(echo "$(dist_man1_MANS)" | sed "s|C/|$$lang/|g"); \
fi \
done
test "$(srcdir)" = "." || rm -fr C
test -e $(srcdir)/no-po4a || $(PO4A) --rm-backups --rm-translations --variable top_srcdir=$(top_srcdir) --variable srcdir=$(srcdir) $(srcdir)/po4a.cfg
rm -f po4a.stamp prepare.stamp
update-pot: prepare.stamp
test -e $(srcdir)/no-po4a || $(PO4A) --no-backups --force --no-translations --variable srcdir=$(srcdir) $(srcdir)/po4a.cfg
install-data-local: install-data-local-@USE_NLS@
install-data-local-no:
install-data-local-yes:
for lang in $(PO4A_LINGUAS); do \
if [ -d $$lang ]; then \
files=$$(echo "$(dist_man1_MANS)" | sed "s|C/|$$lang/|g"); \
$(MAKE) install-man \
mandir="$(mandir)/$$lang" \
man_MANS="" \
dist_man1_MANS="$$files"; \
fi \
done
uninstall-local: uninstall-local-@USE_NLS@
uninstall-local-no:
uninstall-local-yes:
for lang in $(PO4A_LINGUAS); do \
if [ -d $$lang ]; then \
files=$$(echo "$(dist_man1_MANS)" | sed "s|C/|$$lang/|g"); \
$(MAKE) uninstall-man \
mandir="$(mandir)/$$lang" \
man_MANS="" \
dist_man1_MANS="$$files"; \
fi \
done
dist-hook: po4a.stamp
for lang in $(PO4A_LINGUAS); do \
$(mkdir_p) $(distdir)/$$lang; \
cp -r $(srcdir)/$$lang/*.xml