pm_with_git.txt

   1 AUTHOR: Dieter Scholz <dieter_scholz at gmx dot de>
   2
   3 DATE: 2003-09-17
   4
   5 LICENSE: GNU Free Documentation License Version 1.2
   6
   7 SYNOPSIS:       Package management with git
   8
   9 DESCRIPTION:
  10 git (Guarded Installation Tool) is an easy to use, powerful package management
  11 program. It helps you to keep track about what packages you've installed so far
  12 and what files 'make install' added to your LFS system.
  13
  14 PREREQUISITES:
  15 know how to handle an editor like vi, etc.
  16
  17 HINT:
  18
  19 Download:
  20 ---------
  21
  22 The git script was written by Ingo Brueckl and can be found at:
  23
  24     http://home.wtal.de/ib/freisoft/
  25
  26 Be sure to check the LICENSE file. If you use git in a non-commercial way its
  27 free, but it does not explicitly mention commercial usage. Please contact the
  28 author, if you want to use it in a commercial environment.
  29
  30 Overview:
  31 ---------
  32
  33 Here is a small feature list of what you can expect:
  34
  35 - git is easy to use
  36 - git creates uninstall scripts for every archive
  37 - no additional software is necessary
  38 - directories can be excluded from being watched
  39 - git provides information about files installed more than once
  40 - git shows the archive name for each registered file
  41
  42 If you start building a completly new system I recommend to use git right from
  43 the beginning.
  44
  45 Preparation:
  46 ------------
  47
  48 After downloading the git archive manually copy the git script into /usr/sbin.
  49
  50 Open the git script in your favorite editor and adapt the configuration section
  51 according to your needs (you probably want to add the /usr/src directory to the
  52 IGNOREDIRS section).
  53
  54 All the directories (and their subdirs) in the WATCHDIRS variable are included
  55 in the package management process. If you want to exclude subdirectories that
  56 are part of the WATCHDIRS directories, you should put their names in the
  57 IGNOREDIRS variable.
  58
  59 Now you are ready for package management.
  60
  61 Basic usage:
  62 ------------
  63
  64 Whenever you install a new package all you have to do is:
  65
  66 1.) Run the normal configure and/or make operations of the package:
  67
  68     ./configure
  69     make
  70
  71 2.) Before you issue the 'make install' command:
  72
  73     git <package name>
  74     make install
  75     git <package name>
  76
  77 3.) You now have 4 choices:
  78
  79     f - create uninstall script
  80     s - shows state of installation
  81     q - quit
  82     r - revoke installation
  83
  84 4.) Look at uninstall script in configured viewer.
  85
  86 If you want to uninstall a package the only thing you have to do is to call the
  87 uninstall script in the /var/state/git directory (perhaps it is a good idea to
  88 xcheck dependencies before - see below).
  89
  90 Addional functionality:
  91 -----------------------
  92
  93 1.) Find the corresponding archive(s) for a given file:
  94
  95     git --find <path/file>
  96
  97     returns: list of archives
  98
  99 2.) Crosscheck if files installed by an archive were installed more than once:
 100
 101     git --xcheck <package name>
 102
 103 Tips:
 104 -----
 105
 106 #1
 107
 108 Read the README file that comes with the git archive.
 109
 110 Misc:
 111 -----
 112
 113 I heard the method git uses to keep track of installed files is not 100%
 114 reliable. But I don't know, under what circumstances the program fails. Please
 115 send me a note, if you have more information.
 116
 117 If you find any language or logical errors, please contact me directly (see
 118 above).
 119
 120 To discuss package management please use the blfs.support group.
 121
 122 ACKNOWLEDGEMENTS:
 123   * Ingo Brueckl for writing git.
 124
 125 CHANGELOG:
 126 [2002-04-26]
 127   * Hint ownership change. Original Author XXX YYY <xxx at yyy.zzz).
 128 [2003-09-17]
 129   * Changed hint to new format. Made some minor adjustments.