From 1682bef690baf3d1cc64aceea359284c1ddacb6f Mon Sep 17 00:00:00 2001 From: Jim Meyering Date: Wed, 3 Jun 2009 12:14:05 +0200 Subject: doc: sync README-hacking from coreutils * README-hacking: update --- README-hacking | 58 ++++++++++++++++++++++++++++++++++++++++------------------ 1 file changed, 40 insertions(+), 18 deletions(-) (limited to 'README-hacking') diff --git a/README-hacking b/README-hacking index 3eb86aa..81ab7f3 100644 --- a/README-hacking +++ b/README-hacking @@ -5,45 +5,63 @@ These requirements do not apply when building from a distribution tarball. * Requirements -Only the sources are installed in the GIT repository (to ease the -maintenance, merges etc.), therefore you will have to get the latest -stable versions of the maintainer tools we depend upon, including: +We've opted to keep only the highest-level sources in the GIT repository. +This eases our maintenance burden, (fewer merges etc.), but imposes more +requirements on anyone wishing to build from the just-checked-out sources. +Specific tools and versions will be checked for and listed by the +bootstrap script shown below, and will include: - Automake - Autoconf - Gettext +- Git - Gzip +- Perl +- Rsync - Libtool - Pkg-config - Tar - Uuid-devel (Debian: uuid-dev, Red Hat: uuid-devel) -- Wget + +Only building the initial full source tree will be a bit painful. +Later, a plain `git pull && make' should be sufficient. + +- Valgrind Valgrind is also highly recommended, if Valgrind supports your architecture. -Only building the initial full source tree will be a bit painful. -Later, a plain `git-pull && make' should be sufficient. +- XZ utils (successor to LZMA) + +This package's build procedure uses XZ to create a compressed +distribution tarball. Using this feature of Automake requires +version 1.10a or newer, as well as the xz program itself. +Make sure you have the latest version of the XZ Utils from +. * First GIT checkout -Obviously, if you are reading these notes, you did manage to check out -this package from GIT. The next step is to get other files needed to -build, which are extracted from other source packages: +You can get a copy of the source repository like this: + + $ git clone git://git.debian.org/git/parted/parted.git + $ cd parted - $ ./bootstrap +The next step is to get and check other files needed to build, +which are extracted from other source packages: + + $ ./bootstrap And there you are! Just - $ ./configure - $ make - $ make check + $ ./configure #[--enable-gcc-warnings] + $ make + $ make check At this point, there should be no difference between your local copy, and the GIT master copy: - $ git-diff + $ git-diff should output no difference. @@ -51,12 +69,12 @@ Enjoy! ----- -Copyright (C) 2002-2007 Free Software Foundation, Inc. +Copyright (C) 2002-2009 Free Software Foundation, Inc. -This program is free software; you can redistribute it and/or modify +This program 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, or (at your option) -any later version. +the Free Software Foundation, either version 3 of the License, or +(at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of @@ -65,3 +83,7 @@ GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program. If not, see . + +Local Variables: +indent-tabs-mode: nil +End: -- cgit v1.2.1