OLD/pm_with_git.txt

   1 TITLE:          Package management with git
   2 LFS VERSION:    all
   3 AUTHOR:         Dieter Scholz <dieter_scholz at gmx dot de>
   4
   5 SYNOPSIS:
   6         git (Guarded Installation Tool) is an easy to use, powerful package
   7         management program. It helps you to keep track about what packages
   8         you've installed so far and what files 'make install' added to your LFS
   9         system.
  10
  11 HINT:
  12
  13 Changelog:
  14 ----------
  15
  16 26.04.02     initial release
  17
  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 your business.
  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 #2
 111
 112 If you want to use git right from the beginning of your LFS install git will
 113 not work when switching from Chapter 5 to Chapter 6, because git needs the find
 114 program.
 115
 116 You can either:
 117
 118 - copy the existing find program of your starting distro into the $LFS/usr/bin
 119   directory or
 120
 121 - create a static find by following the instructions given in the
 122   'keep_chap5_and_chap6_sep.txt'-hint.
 123
 124 Misc:
 125 -----
 126
 127 If you find any language or logical errors, please contact me directly (see
 128 above).
 129 To discuss package management please use the blfs.support group.