Home Explore Help
Sign In
protonesso
/
dragora
forked from dragora/dragora
Watch 0
Star 0
Fork 0
Files
Tree: 1d8a91d0fc
Branches Tags
dragora
/
qi
/
README

README 2.2 KB
History Raw

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172 
  1.                             +-------------+
    2. 

  2.                             | Qi's README |
    3. 

  3.                             +-------------+
    4. 

  4. 

  5. 

  6.   1. Introduction
    7. 

  7.   2. Installation
    8. 

  8.   3. Contact
    9. 

  9. 

  10. 

  11.   1. Introduction.
    12. 

  12. 

  13. Qi is a source builder and a package manager:
    14. 

  14. 

  15.    It contains a set of (individual) tools to build, install, remove,
    16. 

  16. and upgrade software packages.  It follows the philosophy of simplicity
    17. 

  17. without adding too many features, such as those that can be found in
    18. 

  18. popular package managers.  Basically it does two things: builds
    19. 

  19. packages and manages them.
    20. 

  20. 

  21.    Qi constructs the sources using recipe names, files that contain
    22. 

  22. specific instructions to build every source.  As result, a binary
    23. 

  23. package is obtained which can be installed, removed, upgraded, or
    24. 

  24. inspected in the system.
    25. 

  25. 

  26.    The packages are managed thanks to an external tool called
    27. 

  27. _graft(1)_, which provides a mechanism for managing multiple packages
    28. 

  28. under a single directory hierarchy, it was inspired by both Depot
    29. 

  29. (Carnegie Mellon University) and Stow (Bob Glickstein).  In this
    30. 

  30. aspect, Qi complements Graft: it can work with packages, check them,
    31. 

  31. solve conflicts, and more...
    32. 

  32. 

  33.   2. Installation.
    34. 

  34. 

  35. Requirements:
    36. 

  36. 

  37. - A (POSIX) compatible shell.
    38. 

  38. 

  39. - Graft: http://peters.gormand.com.au/Home/tools
    40. 

  40. 

  41.     Perl (http://www.perl.org) is required in order to run graft(1).
    42. 

  42. 

  43.                                   Note
    44. 

  44.     Take into account when graft is installed, you can define some
    45. 

  45.     macros like PACKAGEDIR and TARGETDIR.  To be consistent use the
    46. 

  46.     same paths when `configure', adjusting it via --packagedir and
    47. 

  47.     --targetdir options.  If you have not changed the default values
    48. 

  48.     used on the graft installation, you can avoid these steps, since
    49. 

  49.     Qi uses the same values for PACKAGEDIR and TARGETDIR of graft.
    50. 

  50. 

  51. - Lzip: http://lzip.nongnu.org
    52. 

  52. 

  53. - A mktemp(1) implementation: http://www.mktemp.org
    54. 

  54. 

  55. To configure, make and install qi, type:
    56. 

  56. 

  57.   $ ./configure
    58. 

  58.   $ make
    59. 

  59.   $ make install
    60. 

  60. 

  61. See `./configure --help' for more information.
    62. 

  62. 

  63. To install in a different location, DESTDIR is supported.  This is
    64. 

  64. useful for package distributors:
    65. 

  65. 

  66.   $ make DESTDIR=/tmp/qi install
    67. 

  67. 

  68.   3. Contact.
    69. 

  69. 

  70.   The Qi home page can be found at `http://www.dragora.org'.
    71. 

  71. Send bug reports or suggestions to <dragora-users@nongnu.org>.
    72. 

  72.