From ef93c7d565d47e49a50d1014587a934a3d3371bd Mon Sep 17 00:00:00 2001 From: dancer Date: Mon, 30 Dec 2002 17:32:50 +0000 Subject: update docs, move parts from AUTORS file --- AUTHORS | 58 -------------------------- ChangeLog | 9 ++++ Documentation/Makefile | 5 +++ Documentation/pbuilder-doc.xml | 93 ++++++++++++++++++++++++++++++++++++++++-- Makefile | 1 + 5 files changed, 105 insertions(+), 61 deletions(-) diff --git a/AUTHORS b/AUTHORS index 3df564f..66e86d4 100644 --- a/AUTHORS +++ b/AUTHORS @@ -7,63 +7,5 @@ Daniel Kobras -- Patches and bugfixes for non-interactive building, and Dagfinn Ilmari Manns?er -- devfs support. Henrique de Moraes Holschuh -- portion of pbuilder-satisfydepends (version dependency check) -History and background of pbuilder -================================== - -Just to note the background of this package. - - -[The Time Before PBuilder] - -There were dbuild, which was a shell script to build -Debian packages from source. Lars Wirzenius wrote that -script, and it was good, short, and simple (probably). -There was nothing like build-depends then (I think), and it was simple. -It could have been improved, I don't have the source off-hand. - -debbuild was probably written by James Troup. I don't know it -because I have never seen the actual code, I could only find some -references to it on the net, and mailing list logs. - -sbuild is a perl script to build Debian package from source. -It parses Build-Dependency, and performs other misc checks, -and has a lot of hacks to actually get things building, -including a table of what package to use when virtual packages are -specified (does it do that still?). -It supports use of local database for packages which do not -have build-dependency. It was written by Ronan Hodek, -and I think it was patched and fixed and extended by -several people. It is part of wanna-build, and used extensively -in Debian buildd system. I think it was maintained -mostly by Ryan Murray. - - -[Birth of PBuilder] - -wanna-build (sbuild) was quite difficult to set up, and it was -never a Debian package. dbuild was something that predated -Build-Depends. - -Building package from source using Build-Depends -information within a chroot sounded trivial; and -pbuilder was born. It was initially a shell script -with only a few lines, which called debootstrap -and chroot and dpkg-buildpackage in the same run, -but soon, it was decided that's too slow. - -Yes, and it took almost an year to get things somewhat -right, and in the middle of the process, Debian 3.0 -was released. Yay. -Debian 3.0 wasn't completely buildable with pbuilder, -but the amount of packages which are not buildable -are steadily decreasing. (I hope) - - -[And the second year of its life] - -And someone wanted pbuilder to run as not root, -and User-mode-linux was getting more useful as time passed, -I've started experimenting with pbuilder-uml. - $Id$ \ No newline at end of file diff --git a/ChangeLog b/ChangeLog index ad04101..c10d493 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,5 +1,14 @@ 2002-12-31 Junichi Uekawa + * Documentation/Makefile (install): add install method. + + * Makefile (install): add install method for docs. + + * Documentation/pbuilder-doc.xml: history of pbuilder moved to here. + + * AUTHORS: history and background of pbuilder is moved over and + remove from here. + * Documentation/pbuilder-doc.xml: add docs on pbuildd. * pbuildd/Makefile (install): add /var/cache/pbuilder/pbuildd dir diff --git a/Documentation/Makefile b/Documentation/Makefile index 10793bf..a337398 100644 --- a/Documentation/Makefile +++ b/Documentation/Makefile @@ -13,3 +13,8 @@ all: pbuilder-doc.html # for my homepage-publishing. release-netfort: pbuilder-doc.html pbuilder-doc.xml cp $^ ~/public_html/netfort/software/pbuilder-doc/ + + +install: pbuilder-doc.html + install -d -m 755 -o root -g root $(DESTDIR)/usr/share/doc/pbuilder/ + install -m 644 -o root -g root pbuilder-doc.html $(DESTDIR)/usr/share/doc/pbuilder/ diff --git a/Documentation/pbuilder-doc.xml b/Documentation/pbuilder-doc.xml index 63dbd9d..b2e3cdd 100644 --- a/Documentation/pbuilder-doc.xml +++ b/Documentation/pbuilder-doc.xml @@ -2,17 +2,23 @@ - pbuilder User's manual + pbuilder User's Manual Introducing pbuilder Aims of pbuilder + pbuilder stands for + Personal Builder, and it is a automatic Debian Package Building system + for personal environments. pbuilder aims to be an easy-to-setup system for auto-building Debian packages inside a clean-room environment, so that it is possible to verify that a package can be built on most Debian installations. + Clean-room environment is achieved through use of a chroot image, + so that only minimal packages will be installed inside the + chroot. Debian distribution consists of free software @@ -30,11 +36,19 @@ worst choice of all if there was a choice to be made. - In this way, pbuilder tries to ensure that packages - tested against pbuilder will be able to build in + In this way, pbuilder tries to ensure + that packages + tested against pbuilder will build in most Debian environments, hopefully resulting in a good overall Debian source-buildability. + + The goal of making Debian buildable from source is + somewhat achieved, and has progressed well. + It is known that Debian 3.0 is not quite + buildable from source, but the next version should + be better. + @@ -314,6 +328,79 @@ + + Inaccurate Background of pbuilder + + The following is most possibly inaccurate account of how + pbuilder happened to come, and other attempts to + make something like pbuilder to happen. + + + The Time Before PBuilder + + There were dbuild, which was a shell script to build + Debian packages from source. Lars Wirzenius wrote that + script, and it was good, short, and simple (probably). + There was nothing like build-depends then (I think), and it was simple. + It could have been improved, I don't have the source off-hand. + + + debbuild was probably written by James Troup. I don't know it + because I have never seen the actual code, I could only find some + references to it on the net, and mailing list logs. + + + sbuild is a perl script to build Debian package from source. + It parses Build-Dependency, and performs other misc checks, + and has a lot of hacks to actually get things building, + including a table of what package to use when virtual packages are + specified (does it do that still?). + It supports use of local database for packages which do not + have build-dependency. It was written by Ronan Hodek, + and I think it was patched and fixed and extended by + several people. It is part of wanna-build, and used extensively + in Debian buildd system. I think it was maintained + mostly by Ryan Murray. + + + + Birth of PBuilder + + wanna-build (sbuild) was quite difficult to set up, and it was + never a Debian package. dbuild was something that predated + Build-Depends. + + + Building package from source using Build-Depends + information within a chroot sounded trivial; and + pbuilder was born. It was initially a shell script + with only a few lines, which called debootstrap + and chroot and dpkg-buildpackage in the same run, + but soon, it was decided that's too slow. + + + Yes, and it took almost an year to get things somewhat + right, and in the middle of the process, Debian 3.0 + was released. Yay. + Debian 3.0 wasn't completely buildable with pbuilder, + but the amount of packages which are not buildable + are steadily decreasing. (I hope) + + + + And the second year of its life + + And someone wanted pbuilder to run as not root, + and User-mode-linux has become more useful as time passed, + I've started experimenting with pbuilder-uml. + pbuilder-uml has not been able to run as often as it should, + and bootstrapping user-mode-linux environment has been + pretty hard. + + + + + diff --git a/Makefile b/Makefile index 64073af..b6dd8cb 100644 --- a/Makefile +++ b/Makefile @@ -38,4 +38,5 @@ install: $(INSTALL_EXECUTABLE) examples/C10shell $(DESTDIR)/usr/share/doc/pbuilder/examples $(INSTALL_EXECUTABLE) examples/D10tmp $(DESTDIR)/usr/share/doc/pbuilder/examples cd pbuildd; make install DESTDIR=$(DESTDIR) + cd Documentation; make install DESTDIR=$(DESTDIR) -- cgit v1.2.3