Changeset 1315 in ProjectBuilder

Timestamp:

Jun 17, 2011, 3:11:36 AM (13 years ago)

Author:

Bruno Cornec

Message:

• Improved documentation and web pages (Eric Anderson eric.anderson4_at_hp.com)

Location:

devel

Files:

• rpmbootstrap/bin/rpmbootstrap (modified) (1 diff)
• website/about.shtml (modified) (2 diffs)
• website/index.shtml (modified) (1 diff)

devel/rpmbootstrap/bin/rpmbootstrap

@@ -44 +44 @@
 and similar to mock, but fully integrated with project-builder.org 
 (which also supports rinse and mock).
+
+rpmbootstrap works in 2 phases. The first one is used to download all
+the required packages to have a working package management system in the
+chroot working. This list of packages is stored in /etc/pb/pb.conf under
+the rbsmindep parameter (aka rpmbootstrap minimal dependencies). Once the
+packages have been downloaded from the mirror, they are extracted with
+rpm2cpio. At that point you should be able to use yum on Fedora, urpmi
+on Mandriva/Mageia and zypper on OpenSuSE. 
+The second phase uses exactly the previous mentioned tools to install 
+exactly the same package list to have a coherent RPM db at the end.
+
+rpmbootstrap has additional options to execute a post-install script
+(-s) or to add packages (-a). Then pb can use the chroot to perform even
+more actions in it.
 
 =head1 SYNOPSIS

devel/website/about.shtml

@@ -25 +25 @@
 The various aspects covered by the tool are:
 <ul>
-    <li>- only produce software packages (ease integration in deployment servers, provide inheritance mecanisms, and Virtual Machines (VM) or Environments (VE) as well as Remote Machines (RM))</li>
-    <li>- ease the various steps of solution life cycle (controlled impact of installation/uninstallation, dependencies management, identical deliveries up to the customer, announce management, web site delivery, metadata management)</li>
-    <li>- help new projects in the provisioning of packages (templates and skeletons for the various supported OS, generated structure, help in VM/VE/RM build)</li>
-    <li>- Avoid code or metadata duplication, as well as has no impact on the original project (macro system, separate repository)</li>
-    <li>- Neutral in term of Unix environment (repository, system, package type agnostic)</li>
+    <li>only produce software packages (ease integration in deployment servers, provide inheritance mecanisms, and Virtual Machines (VM) or Environments (VE) as well as Remote Machines (RM))</li>
+    <li>ease the various steps of solution life cycle (controlled impact of installation/uninstallation, dependencies management, identical deliveries up to the customer, announce management, web site delivery, metadata management)</li>
+    <li>help new projects in the provisioning of packages (templates and skeletons for the various supported OS, generated structure, help in VM/VE/RM build)</li>
+    <li>Avoid code or metadata duplication, as well as has no impact on the original project (macro system, separate repository)</li>
+    <li>Neutral in term of Unix environment (repository, system, package type agnostic)</li>
 </ul>
 </p>
@@ -36 +36 @@
 Today the tool supports:
 <ul>
-    <li>- Muliple repository (none - aka tar balls, SVN, CVS, Git, Mercurial, SVK...)</li>
-    <li>- Multiple systems (RPM Linux - Red Hat, SuSE, Mandriva, ..., deb Linux - Debian, Ubuntu, ..., ebuild - Gentoo, pkg Solaris/OpenSolaris, ...)</li>
-    <li>- Multiple build environments (local, VM - QEMU, KVM, ..., VE - rpmbootstrap, mock, rinse, debootstrap, RM - ssh...)</li>
-    <li>- Multiple repository manager (yum, urpmi, apt, ...)</li>
+    <li>Muliple repository (none - aka tar balls, SVN, CVS, Git, Mercurial, SVK...)</li>
+    <li>Multiple systems (RPM Linux - Red Hat, SuSE, Mandriva, ..., deb Linux - Debian, Ubuntu, ..., ebuild - Gentoo, pkg Solaris/OpenSolaris, ...)</li>
+    <li>Multiple build environments (local, VM - QEMU, KVM, ..., VE - rpmbootstrap, mock, rinse, debootstrap, RM - ssh...)</li>
+    <li>Multiple repository manager (yum, urpmi, apt, ...)</li>
 </ul>
-and this, at various phasis (development, test, integration, delivery).
+and this, at various phases (development, test, integration, delivery).
 </p>
 <p>

devel/website/index.shtml

@@ -13 +13 @@
           <h2>What is Project-Builder.org ?</h2>
   </div>
-  <p class="c">Project-Builder.org is a GPL tool to help you build packages of projects for multiple operating systems from repostitories or files</p>
+  <p class="c">
+
+Project-Builder.org is a GPL tool for simplifying the process of building
+packages for multiple operating systems from source.  The source can
+come from version control or from tar files, the packages can be build
+on pre-installed Remote Machines (RM) over ssh, on Virtual Machines (VM) on the local
+host, or inside a Virtual Environment (VE aka chroot) on the local host.  The
+configuration files for Project-Builder.org are stored in subversion and
+are used to control the method by which the packages are created.
+Further details can be found on that <a href="/about.shtml">page</a> and in a detailed walkthrough of using
+Project-Builder.org available as
+<a href="http://trac.project-builder.org/browser/devel/pb-doc/LabProject-Builder.org.pdf">http://trac.project-builder.org/browser/devel/pb-doc/LabProject-Builder.org.pdf</a>
+</p>
 
   <div class="h2-2">