Minor spacing changes
[linux_from_scratch_hints.git] / pio-hint.txt
blob314efa9598c31035df636cfaf3cec4c82750af24
1 AUTHOR: Paul Rogers <paulgrogers at lycos dot com>
3 DATE: 2016-02-08
5 LICENSE: GPL
7 SYNOPSIS: Package manager "pio" (Package Installation Observer)
9 DESCRIPTION:
10 pio is a "timestamper" package manager found useful for (B)LFS 
11 installations.  It is run once before installation to "take inventory" 
12 of defined directories, then again after installation.  It observes 
13 new/changed subdirectories and files, and builds a script which will 
14 safely remove whatever was installed.  This "removal" script is the 
15 basis for other tricks it will do.
17 Above all, pio is a dis-integrated package manager.  It's simply a
18 hands-on tool to be used.  It enforces nothing!
20 ATTACHMENTS:
21 * http://www.linuxfromscratch.org/hints/pio-files/pio
22 * http://www.linuxfromscratch.org/hints/pio-files/pod
23 * http://www.linuxfromscratch.org/hints/pio-files/pio-usage
24 * http://www.linuxfromscratch.org/hints/pio-files/template
26 PREREQUISITES:
27 pio is entirely bash script, almost 1100 lines of it.  One must 
28 understand bash to "extend" it or do "maintenance".  Have a care; pio 
29 makes scripts that WILL remove files!  But being bash script, it can be 
30 "easily" maintained or extended.
32 It has no unusual dependencies.
34 HINT:
35 Once upon a time there was git, the Guarded Installation Tool, by Ingo 
36 Brueckl (ib@wupperonline.de) 14.11.1996.  I found it useful for LFS 
37 builds & added a few functions.  Then Linus made a kernel development 
38 management tool he chose to call git.  So I changed this script to avoid 
39 potential confusion.  pio is still almost entirely Ingo's git.  Some 
40 functionality has been changed.  That's my responsibility.
42 Refer to pio-usage for real hints on using pio effectively.
44 pod is a mashup of several ad-hoc scripts I use when building and 
45 maintaining my packages, mostly interacting with pio.
47 template is my build script template demonstrating my usage of pio when 
48 building (B)LFS systems.
50 ACKNOWLEDGEMENTS:
51   * Ingo Bruekl for the original git-2.16
52   * Paul Rogers for resurrection, maintenance, and extensions.
54 CHANGELOG:
55 2016-02-08: PGR original hint/files.