qi/README.md

   1 Qi
   2 ==
   3
   4 Qi is a simple but well-integrated package manager.  It can create,
   5 install, remove, and upgrade software packages.  Qi produces binary
   6 packages using recipes, which are files containing specific instructions
   7 to build each package from source.  Qi can manage multiple packages
   8 under a single directory hierarchy.  This method allows to maintain a
   9 set of packages and multiple versions of them.  This means that Qi could
  10 be used as the main package manager or complement the existing one.
  11
  12    Qi offers a friendly command line interface, a global configuration
  13 file, a simple recipe layout to deploy software packages; also works
  14 with binary packages in parallel, speeding up installations and packages
  15 in production.  The format used for packages is a simplified but safe
  16 POSIX pax archive compressed with lzip.
  17
  18    Qi is a modern (POSIX-compliant) shell script released under the
  19 terms of the GNU General Public License.  There are only two major
  20 dependencies for the magic: graft(1) and tarlz(1), the rest is expected
  21 to be found in any Unix-like system.
  22
  23 RUNTIME REQUIREMENTS
  24 --------------------
  25
  26 - A POSIX-compliant shell.
  27
  28 - Graft for handling symlinks: http://peters.gormand.com.au/Home/tools
  29
  30 - Perl in order to run Graft: http://www.perl.org
  31
  32 - Tarlz for produce binary packages: http://lzip.nongnu.org/tarlz.html
  33
  34 ### Note
  35
  36 Take into account when you are going to install graft, you can define some
  37 macros like PACKAGEDIR and TARGETDIR.  To be consistent, please use the
  38 same paths when `configure` adjusting them through the --packagedir and
  39 --targetdir options.
  40
  41 If you have not changed the default values used on the graft installation,
  42 you can avoid these steps, since qi uses the same values of graft for
  43 PACKAGEDIR and TARGETDIR.
  44
  45 INSTALLATION
  46 ------------
  47
  48 To configure, make and install qi, type:
  49
  50     $ ./configure
  51     $ make
  52     $ make install
  53
  54 See `./configure --help` for more options.
  55
  56 To install qi in a different location, type:
  57
  58     $ make DESTDIR=/tmp/qi install
  59
  60 This is useful for package distributors.
  61
  62 CONTACT
  63 -------
  64
  65   The Qi home page can be found at https://www.dragora.org.
  66 Send bug reports or suggestions to <dragora-users@nongnu.org>.