1.1 --- a/org/pkg.org	Tue Jan 08 10:59:30 2013 +0000
     1.2 +++ b/org/pkg.org	Tue Jan 08 11:45:01 2013 +0000
     1.3 @@ -0,0 +1,56 @@
     1.4 +The point of this system to to 
     1.5 +
     1.6 +1. Determine the provenence of every file on my system.
     1.7 +2. Always have an "undo" button.
     1.8 +
     1.9 +These criteria have evolved from my frustrations
    1.10 +with my previous LFS system.
    1.11 +
    1.12 +
    1.13 +User expreience:
    1.14 +
    1.15 +Suppose I want to install emacs.
    1.16 +
    1.17 +here's a sample terminal session
    1.18 +
    1.19 +$ pkg emacs "a text editor"
    1.20 +   > creating user emacs.
    1.21 +   > cd /pkg/emacs
    1.22 +
    1.23 +$ wget http://emacs.com/emacs.tar.bz2
    1.24 +   > downloaded emacs.tar.bz2
    1.25 +   
    1.26 +$ unp emacs.tar.bz2; cd emacs; configure; 
    1.27 +     make install;
    1.28 +   > install stuff.. 
    1.29 +   
    1.30 +$ hg st
    1.31 +   > a bunch of files are added
    1.32 +
    1.33 +1. Say I don't want emacs after all.
    1.34 +$ hg purge; hg revert --all
    1.35 +
    1.36 +2. Complete emacs instilation
    1.37 +   > hg addr; hg commit -m "emacs." 
    1.38 +
    1.39 +(this commits as the emacs user)
    1.40 +
    1.41 +3. can examine provenance of information
    1.42 +$ pkg-examine emacs
    1.43 +   > package emacs owns the following files:
    1.44 +   >  emacs
    1.45 +   >  man/emacs 
    1.46 +   > ....
    1.47 +
    1.48 +4. see all the commits that the "emacs" user made.
    1.49 +$ pkg-history emacs
    1.50 +  > <filtered mercurial log>
    1.51 +
    1.52 +5. remove a package in its entirety
    1.53 +$ pkg-remove emacs
    1.54 +  > removed
    1.55 +  > <list of files>
    1.56 + 
    1.57 +
    1.58 +
    1.59 +