re-mark 1.29b-2 as not yet uploaded (merge madness!)
[debian/tar] / README-alpha
1 This is GNU tar.
2
3 This is a *pre-release* version, and not ready for production use yet.
4 Please send comments and problem reports to <bug-tar@gnu.org>.
5
6 If you have taken the sources from CVS you will need the following
7 packages (or later) to build GNU tar.  We don't make any extra effort
8 to accommodate older versions of these packages, so please make sure
9 that you have the latest stable version.
10
11 - Automake <http://www.gnu.org/software/automake/>
12 - Autoconf <http://www.gnu.org/software/autoconf/>
13 - Bison <http://www.gnu.org/software/bison/>
14 - Gettext <http://www.gnu.org/software/gettext/>
15 - Gzip <http://www.gnu.org/software/gzip/>
16 - M4 <http://www.gnu.org/software/m4/>
17 - Texinfo <http://www.gnu.org/software/texinfo>
18 - Wget <http://www.gnu.org/software/wget/>
19
20 As of this writing, the latest stable version of Gzip is 1.2.4 but we
21 suggest using test version 1.3.5 (or later, if one becomes available).
22
23 Valgrind <http://valgrind.org/> is also highly recommended, if
24 Valgrind supports your architecture.
25
26 Before building the package, run "bootstrap".  It obtains various
27 additional files from the CVS repository and the Translation Project
28 site and prepares the source directory for building.
29
30 When run without arguments, bootstrap will try to obtain gnulib and
31 paxutils files from their corresponding CVS repositories on Savannah
32 using anonymous SSH access. Then, it will fetch the po files from tar
33 page at Translation Project, and, finally, it will start autoconfiguration
34 process. Simply running it without arguments should do in most cases.
35 Several options allow to control the behavior of bootstrap:
36
37  --gnulib-srcdir=DIRNAME      Specify the local directory where gnulib
38                               sources reside. Use this if you already
39                               have gnulib sources on your machine, and
40                               do not want to waste your bandwidth dowloading
41                               them again.
42
43  --paxutils-srcdir=DIRNAME    Specify the local directory where paxutils
44                               sources reside. Use this if you already
45                               have paxutils sources on your machine, and
46                               do not want to waste your bandwidth dowloading
47                               them again.
48
49  --cvs-auth=METHOD            Set the CVS access method used for downloading
50                               gnulib files. METHOD is one of the keywords
51                               accepted by cvs -d option (see info cvs
52                               repository).
53
54  --cvs-user=USERNAME          Set the CVS username to be used when accessing
55                               the gnulib repository.
56
57  --no-po                      Do not download po files.
58
59 Notice also that when using CVS authentication method "ext", bootstrap
60 will set the variable CVS_RSH to "ssh", unless it is already set to
61 some other value.
62
63 \f
64
65 Copyright 2001, 2003-2005, 2007, 2013 Free Software Foundation, Inc.
66
67 This file is part of GNU tar.
68
69 GNU tar is free software; you can redistribute it and/or modify
70 it under the terms of the GNU General Public License as published by
71 the Free Software Foundation; either version 3 of the License, or
72 (at your option) any later version.
73
74 GNU tar is distributed in the hope that it will be useful,
75 but WITHOUT ANY WARRANTY; without even the implied warranty of
76 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
77 GNU General Public License for more details.
78
79 You should have received a copy of the GNU General Public License
80 along with this program.  If not, see <http://www.gnu.org/licenses/>.