X-Git-Url: https://arthur.barton.de/gitweb/?a=blobdiff_plain;f=README.md;h=c3815582482fb77d7a546ce1fa527b38bd008b35;hb=36b36f2d55af5c8a7c69f9a3ba74a978d2f89e1a;hp=c580ecea5fd165f37a187a748e613ec83fca6956;hpb=cb23ba7502f3d9b8c266d3e214b34ae1fc3372ba;p=bup.git diff --git a/README.md b/README.md index c580ece..c381558 100644 --- a/README.md +++ b/README.md @@ -80,12 +80,18 @@ Reasons you might want to avoid bup Solaris, or Windows (with Cygwin, and maybe with WSL). Patches to support other platforms are welcome. + - Until resolved, a [glibc bug](https://sourceware.org/bugzilla/show_bug.cgi?id=26034) + might cause bup to crash on startup for some (unusual) command line + argument values, when bup is configured to use Python 3. + - Any items in "Things that are stupid" below. Notable changes introduced by a release ======================================= + - Changes in 0.31 as compared to 0.30.1 + - Changes in 0.30.1 as compared to 0.30 - Changes in 0.30 as compared to 0.29.3 - Changes in 0.29.3 as compared to 0.29.2 - Changes in 0.29.2 as compared to 0.29.1 @@ -102,6 +108,7 @@ Test status | branch | Debian | FreeBSD | macOS | |--------|------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------| | master | [![Debian test status](https://api.cirrus-ci.com/github/bup/bup.svg?branch=master&task=debian)](https://cirrus-ci.com/github/bup/bup) | [![FreeBSD test status](https://api.cirrus-ci.com/github/bup/bup.svg?branch=master&task=freebsd)](https://cirrus-ci.com/github/bup/bup) | [![macOS test status](https://api.cirrus-ci.com/github/bup/bup.svg?branch=master&task=macos)](https://cirrus-ci.com/github/bup/bup) | +| 0.30.x | [![Debian test status](https://api.cirrus-ci.com/github/bup/bup.svg?branch=0.30.x&task=debian)](https://cirrus-ci.com/github/bup/bup) | [![FreeBSD test status](https://api.cirrus-ci.com/github/bup/bup.svg?branch=0.30.x&task=freebsd)](https://cirrus-ci.com/github/bup/bup) | [![macOS test status](https://api.cirrus-ci.com/github/bup/bup.svg?branch=0.30.x&task=macos)](https://cirrus-ci.com/github/bup/bup) | | 0.29.x | [![Debian test status](https://api.cirrus-ci.com/github/bup/bup.svg?branch=0.29.x&task=debian)](https://cirrus-ci.com/github/bup/bup) | [![FreeBSD test status](https://api.cirrus-ci.com/github/bup/bup.svg?branch=0.29.x&task=freebsd)](https://cirrus-ci.com/github/bup/bup) | [![macOS test status](https://api.cirrus-ci.com/github/bup/bup.svg?branch=0.29.x&task=macos)](https://cirrus-ci.com/github/bup/bup) | Getting started @@ -142,10 +149,12 @@ From source ```sh apt-get install python2.7-dev python-fuse - apt-get install python-pyxattr python-pylibacl - apt-get install linux-libc-dev + apt-get install python-pyxattr + apt-get install pkg-config linux-libc-dev libacl1-dev apt-get install acl attr - apt-get install python-tornado # optional + apt-get isntall python-pytest-xdist # optional (parallel tests) + apt-get install libreadline-dev # optional (bup ftp) + apt-get install python-tornado # optional (bup web) ``` On CentOS (for CentOS 6, at least), this should be sufficient (run @@ -153,13 +162,15 @@ From source ```sh yum groupinstall "Development Tools" - yum install python python-devel - yum install fuse-python pyxattr pylibacl + yum install python python-devel libacl-devel + yum install fuse-python pyxattr yum install perl-Time-HiRes + yum install readline-devel # optional (bup ftp) + yum install python-tornado # optional (bup web) ``` In addition to the default CentOS repositories, you may need to add - RPMForge (for fuse-python) and EPEL (for pyxattr and pylibacl). + RPMForge (for fuse-python) and EPEL (for pyxattr). On Cygwin, install python, make, rsync, and gcc4. @@ -188,6 +199,14 @@ From source make check ``` + If you have the Python xdist module installed, then you can + probably run the tests faster by adding the make -j option (see ./HACKING for additional information): + + ```sh + make -j check + ``` + The tests should pass. If they don't pass for you, stop here and send an email to bup-list@googlegroups.com. Though if there are symbolic links along the current working directory path, the tests @@ -443,20 +462,20 @@ Notes on NetBSD/pkgsrc cycle and error out, so "ls -R" and "find" will not work. - There is no support for ACLs. If/when some enterprising person - fixes this, adjust t/compare-trees. + fixes this, adjust dev/compare-trees. Notes on Cygwin --------------- - There is no support for ACLs. If/when some enterprising person - fixes this, adjust t/compare-trees. + fixes this, adjust dev/compare-trees. - - In t/test.sh, two tests have been disabled. These tests check to - see that repeated saves produce identical trees and that an - intervening index doesn't change the SHA1. Apparently Cygwin has - some unusual behaviors with respect to access times (that probably - warrant further investigation). Possibly related: + - In test/ext/test-misc, two tests have been disabled. These tests + check to see that repeated saves produce identical trees and that + an intervening index doesn't change the SHA1. Apparently Cygwin + has some unusual behaviors with respect to access times (that + probably warrant further investigation). Possibly related: http://cygwin.com/ml/cygwin/2007-06/msg00436.html @@ -464,7 +483,7 @@ Notes on OS X ------------- - There is no support for ACLs. If/when some enterprising person - fixes this, adjust t/compare-trees. + fixes this, adjust dev/compare-trees. How it works