README 2.4 KB

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