package/archiver/bize/bize.man

   1 .\" Copyright (c) 2004 Dimitar Toshkov Zhekov
   2 .TH BIZE 8 "15 Mar 2004"
   3 .SH NAME
   4 bize \- ROCK-Linux .tar.bz2 package manager
   5 .SH SYNOPSIS
   6 .BI "bize -i [-t] [-v] [-f] [-R " root "] " package1.tar.bz2
   7 .BI ...
   8 .LP
   9 .BI "bize -r [-t] [-v] [-f] [-R " root "] " package1 " ..."
  10 .SH DESCRIPTION
  11 .B bize
  12 is a shell script capable of installing, updating and removing
  13 ROCK-Linux .tar.bz2 package files. It implements a subset of
  14 .B mine
  15 options.
  16 .SS Requirements
  17 .BR which " (or " type "), " sort ", " rm ", " rmdir ", "
  18 .BR mkdir ", " tar " and " bzip2 ", and also " md5sum ", "
  19 unless
  20 .B "\-f"
  21 is specified.
  22 All these are standard programs present in any Linux system, but
  23 .B bize
  24 checks for them on startup anyway.
  25 .PP
  26 The operating system must be able to remove files being in use.
  27 All Linux systems have this ability.
  28 .SS Compatibility
  29 The .tar.bz2 and .gem formats are not compatible. Packages
  30 installed with
  31 .B bize
  32 can be removed with
  33 .B mine
  34 and vice-versa.
  35 .B bize
  36 has not been tested with ROCK-Linux 1.6 or earlier. Some of the
  37 ROCK-Linux 1.7.0+ targets produce .tar.bz2 packages only.
  38 .SS Effectiveness
  39 .B bize
  40 installs packages slightly faster than
  41 .BR "mine "
  42 and removes them about 25% faster (but see
  43 .BR BUGS).
  44 More time is usually required to remove a package than to install
  45 it, so
  46 .B bize
  47 is, overall, about 15% faster than
  48 .BR mine .
  49 Needless to say, your mileage may vary.
  50 .PP
  51 The .tar.bz2 packages are a bit smaller than the .gem packages and
  52 are created a bit faster.
  53 .SH OPTIONS
  54 .TP
  55 .B "\-i"
  56 Install or update packages.
  57 .TP
  58 .B "\-r"
  59 Remove packages.
  60 .TP
  61 .B "\-t"
  62 Test mode. Show what will happen without doing it.
  63 .TP
  64 .B "\-v"
  65 Be verbose.
  66 .TP
  67 .B "\-f"
  68 Force removal/replacement of the modified files.
  69 .TP
  70 .BI "\-r " root
  71 Use
  72 .I root
  73 as root directory instead of
  74 .BR / .
  75 .TP
  76 .B "\-\-"
  77 Terminate the option list.
  78 .SH BUGS
  79 .B bize
  80 will try to compute md5sum for any file with an md5sum entry,
  81 even for devices and pipes. A normally built and installed ROCK-
  82 Linux package includes md5sum entries for the regular files only.
  83 .PP
  84 .B bize
  85 doesn't make backups, because I don't like them (of course, any
  86 modified files are preserved unless
  87 .B "\-f"
  88 is specified).
  89 .B mine
  90 makes backups, so this is listed as a bug.
  91 .SH SEE ALSO
  92 GEM-MINE