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