Changeset 89

Timestamp:

04/17/07 16:35:29 (18 years ago)

Author:

kdeugau

Message:

/trunk

POD docco update

• add --showpkgs to SYNOPSIS
• add ERRATA section
• note handling of BuildArch in ERRATA
• note --showpkgs usage in ERRATA

File:

• trunk/debbuild (modified) (2 diffs)

trunk/debbuild

@@ -1349 +1349 @@
  debbuild --rebuild file.{src.rpm|sdeb}
 
+ debbuild --showpkgs
+
 =head1 DESCRIPTION
 
@@ -1414 +1416 @@
 =back
 
+=head1 ERRATA
+
+debbuild deliberately does a few things differently from rpm.
+
+=head2 BuildArch or BuildArchitecture
+
+rpm takes the last BuildArch entry it finds in the .spec file, whatever it is, and runs with 
+that for all packages.  Debian's repository system is fairly heavily designed around the 
+assumption that a single source package may generate small binary (executable) packages 
+for each arch, and large binary arch-all packages containing shared data.
+
+debbuild allows this by using the architecture specified by (in order of preference):
+
+=over 4
+
+=item * Host architecture
+
+=item * BuildArch specified in .spec file preamble
+
+=item * "Last specified" BuildArch for packages with several subpackages
+
+=item * BuildArch specified in the %package section for that subpackage
+
+=back
+
+=head2 Finding out what packages should be built (--showpkgs)
+
+rpmbuild does not include any convenient method I know of to list the packages a spec file 
+will produce.  Since I needed this ability for another tool, I added it.
+
+It requires the .spec file for the package, and produces a list of full package filenames 
+(without path data) that would be generated by one of --rebuild, -ta, -tb, -ba, or -bb.  
+This includes the .sdeb source package.
+
 =head1 AUTHOR