[Pkg-ocaml-maint-commits] r5953 - /trunk/packages/edos-debcheck/trunk/debian/contrib/edos-builddebcheck.1

Fri Aug 15 22:26:08 UTC 2008

Author: treinen
Date: Fri Aug 15 22:26:08 2008
New Revision: 5953

URL: http://svn.debian.org/wsvn/pkg-ocaml-maint/?sc=1&rev=5953
Log:
some improvements on web page (build-indep-depends, build-conflicts)

Modified:
    trunk/packages/edos-debcheck/trunk/debian/contrib/edos-builddebcheck.1

Modified: trunk/packages/edos-debcheck/trunk/debian/contrib/edos-builddebcheck.1
URL: http://svn.debian.org/wsvn/pkg-ocaml-maint/trunk/packages/edos-debcheck/trunk/debian/contrib/edos-builddebcheck.1?rev=5953&op=diff
==============================================================================

--- trunk/packages/edos-debcheck/trunk/debian/contrib/edos-builddebcheck.1 (original)
+++ trunk/packages/edos-debcheck/trunk/debian/contrib/edos-builddebcheck.1 Fri Aug 15 22:26:08 2008
@@ -1,42 +1,45 @@
 .TH EDOS-BUILDDEBCHECK 1 2008-08-12 EDOS
 
 .SH NAME
-Edos-builddebcheck \- Check satisfiability of debian package build-dependencies
+Edos-builddebcheck \- Check satisfiability of Debian package build-dependencies
 
 .SH SYNOPSIS
 \fBedos-builddebcheck\fR [option] ... Packagefile Sourcepackagefile
 
 .SH DESCRIPTION
 .B edos-builddebcheck
-reads a set of debian package descriptions from the file \fIPackagefile\fR,
+reads a set of Debian package descriptions from the file \fIPackagefile\fR,
 each of which is in the format of deb-control(5), and a set of source package
 descriptions from the file \fISourcepackagefile\fR. All packages described in
-the file \fIPackagefile\fR must have the same value of their \fIArcitecture\fR
-(if it is different from all).
+the file \fIPackagefile\fR must have the same value of their \fIArchitecture\fR
+(if it is different from \fIall\fP).
 
-For instance, the Packages and Sources files as found on a debian mirror
-server, or in the directory \fI/var/lib/apt/lists/\fR of a debian system, are
+For instance, the Packages and Sources files as found on a Debian mirror
+server, or in the directory \fI/var/lib/apt/lists/\fR of a Debian system, are
 suitable as input files.
 
 .B edos-builddebcheck
 verifies for every of the source packages (from \fISourcepackagefile\fR)
-whether its build-dependencies can be satisfied from the binary packages (from
-\fIPackagefile\fR).
+whether its build-dependencies, build-indep-dependencies and build-conflicts
+can be satisfied from the binary packages provided in \fIPackagefile\fR. Only
+build-relations that apply to the architecture (see below on how the
+architecture is determined) are taken into account.
 
-Note that this is not the same thing as rebuilding a distribution from
-scratch, for at least two reasons:
+Note that this is not the same thing as checking whether a distribution 
+can be rebuild from scratch, for at least two reasons:
 
 \fB1.\fP
 The binary packages in \fIPackages\fR are not necessarily those that are
 the result of the compilation of the source packages in
 \fISourcepackagefile\fR
 
-\fB2.\fP
-We do not check for cycles. For instance, imagine we have source packages a
-and b both generating one binary package of the same name as their source
-package, a build-depends on b and b build-depends on a. Then we can obviously
-not rebuild the set of packages from scratch. However, if we already have
-binary packages for a and for b then we can recompile both for them.
+\fB2.\fP We do not check for cycles. For instance, imagine we have source
+packages \fIa\fP and \fIb\fP both generating one binary package of the same
+name as their source package, \fIa\fP build-depends on \fIb\fP and \fIb\fP
+build-depends on \fIa\fP. Then we can not rebuild the set of packages from
+scratch because of the cycle. However, if we already have binary packages for
+\fIa\fP and for \fIb\fP then we can recompile both for them, and
+\fBedos-builddebcheck\fP would not report an error in this case.
 
 
 .SH OPTIONS
@@ -47,13 +50,12 @@
 file.
 
 .SH AUTHOR
-Edos-builddebcheck has been written by Stefano Zacchirolli and Ralf Treinen.
-It heavily relies on edos-debcheck which has been written by Jerome Vouillon
-for the EDOS project.
+Edos-builddebcheck has been written by Stefano Zacchirolli <zack at debian.org>
+and Ralf Treinen <treinen at debian.org>. It heavily relies on edos-debcheck
+which has been written by Jerome Vouillon for the EDOS project.
 
 
 .SH SEE ALSO
 .BR deb-control (5), edos-debcheck (1)
 
-<http://www.edos-project.org> is the home page of the EDOS project.
 


