README

   1 GNU Parted
   2 ----------
   3
   4 GNU Parted is a program for creating, destroying, resizing, checking and
   5 copying partitions, and the filesystems on them.  This is useful for creating
   6 space for new operating systems, reorganising disk usage, copying data between
   7 hard disks, and disk imaging.
   8
   9  * documentation is in the doc/ directory.  The User's documentation is in
  10 texinfo format, and is built into a format viewable by info/pinfo when
  11 you run make.  i.e.
  12
  13         $ ./configure
  14         $ cd doc
  15         $ make
  16         $ info -f parted.info
  17
  18 Yes, it sucks that you need to run ./configure before you can read the manual.
  19 If you have problems with it, doc/parted.texi should be fairly easy to read,
  20 just a bit less userfriendly.
  21         If you prefer html format, you can run:
  22
  23         $ cd doc
  24         $ makeinfo --html parted.texi
  25
  26  * an online tutorial is available at http://www.luv.asn.au/overheads/parted
  27  * the GNU Parted home page is http://www.gnu.org/software/parted
  28  * the GNU Parted FAQ can be found at
  29    http://www.gnu.org/software/parted/faq.html
  30  * send bug reports, requests for help, feature requests, comments, etc. to
  31 bug-parted@gnu.org.  The authors can be contacted directly (see the AUTHORS
  32 file).
  33
  34
  35 NOTE TO DISTRIBUTIONS
  36 ---------------------
  37
  38 (1) When compiling Parted for distribution for general use, we recommend using
  39 the default configuration:
  40
  41         CFLAGS=-Os ./configure
  42
  43 This includes --enable-debug (by default), which contains many assertions.
  44 Obviously, these "waste" space, but in the past, they have caught potentially
  45 dangerous bugs before they would have done damage, so we think it's worth
  46 it.  Also, it means we get more bug reports ;)
  47
  48
  49 (2) When doing dependencies, remember that libreiserfs is a *soft* dependency,
  50 so I guess that means Debian-look-alikes should do a "suggests", but
  51 not a "requires".
  52
  53
  54 (3) When space is important, we suggest --without-readline, --disable-shared,
  55 and possibly --disable-nls and --disable-dynamic-loading.
  56
  57 If Parted is only going to be used for probing / discovery (and not
  58 "editing"), there is a --enable-discovery-only and --disable-fs (when you're
  59 only interested in partition tables).  Since it's readonly, --enable-debug
  60 gains you nothing wrt safety, so use --disable-debug ;)  The "discover"
  61 program is about 35k (gzipped) when compiled this way (not counting libc
  62 and libuuid).
  63