]> arthur.barton.de Git - bup.git/blobdiff - README.md
Add "/t/sampledata/var" to .gitignore
[bup.git] / README.md
index 74d7324b404a0d4559bd8588d628a3dcc2c6140b..9d26917f07ea848d7d622f9d817f5da1567977a3 100644 (file)
--- a/README.md
+++ b/README.md
@@ -71,8 +71,10 @@ Reasons you might want to avoid bup
    for you, but we don't know why.  It is also missing some
    probably-critical features.
    
- - It requires python >= 2.5, a C compiler, and an installed git version >=
-   1.5.3.1.
+ - It requires python >= 2.5, a C compiler, and an installed git
+   version >= 1.5.3.1.  It also requires par2 if you want fsck to be
+   able to generate the information needed to recover from some types
+   of corruption.
  
  - It currently only works on Linux, MacOS X >= 10.4,
    NetBSD, Solaris, or Windows (with Cygwin).  Patches to support
@@ -92,19 +94,22 @@ From source
  
         git clone git://github.com/bup/bup
 
- - Install the needed python libraries (including the development
+ - Install the required python libraries (including the development
    libraries).
 
-   On Debian/Ubuntu this is usually sufficient (run as root):
+   On very recent Debian/Ubuntu versions, this may be sufficient (run
+   as root):
+
+            apt-get build-dep bup
 
-            apt-get install python2.6-dev python-fuse
+   Otherwise try this (substitute python2.5-dev or python2.6-dev if
+   you have an older system):
+
+            apt-get install python2.7-dev python-fuse
             apt-get install python-pyxattr python-pylibacl
             apt-get install linux-libc-dev
-
-   Substitute python2.5-dev if you have an older system.  Alternately,
-   on newer Debian/Ubuntu versions, you can try this:
-    
-            apt-get build-dep bup
+            apt-get install acl attr
+            apt-get install python-tornado # optional
 
    On CentOS (for CentOS 6, at least), this should be sufficient (run
    as root):
@@ -119,6 +124,11 @@ From source
 
    On Cygwin, install python, make, rsync, and gcc4.
 
+   If you would like to use the optional bup web server on systems
+   without a tornado package, you may want to try this:
+
+            pip install tornado
+
  - Build the python module and symlinks:
 
         make
@@ -152,6 +162,8 @@ Binary packages of bup are known to be built for the following OSes:
  - pkgsrc (NetBSD, Dragonfly, and others)
     http://pkgsrc.se/sysutils/bup
     http://cvsweb.netbsd.org/bsdweb.cgi/pkgsrc/sysutils/bup/
+ - Arch Linux:
+    https://www.archlinux.org/packages/?sort=&q=bup
 
 
 Using bup
@@ -203,7 +215,7 @@ Using bup
 
         bup restore -C ./dest-2 local-etc/2013-11-23-11195/etc
 
- - Make a backup on a remote server (which must already have the 'bup' command
+ - Make a backup to a remote server (which must already have the 'bup' command
    somewhere in the server's PATH (see /etc/profile, etc/environment,
    ~/.profile, or ~/.bashrc), and be accessible via ssh.
    Make sure to replace SERVERNAME with the actual hostname of your server):
@@ -343,8 +355,8 @@ python.
 
 Basically, 'bup split' reads the data on stdin (or from files specified on
 the command line), breaks it into chunks using a rolling checksum (similar to
-rsync), and saves those chunks into a new git packfile.  There is one git
-packfile per backup.
+rsync), and saves those chunks into a new git packfile.  There is at least one
+git packfile per backup.
 
 When deciding whether to write a particular chunk into the new packfile, bup
 first checks all the other packfiles that exist to see if they already have that