=head1 NAME

botch-build-fixpoint - find build order until dependency cycles occur

=head1 SYNOPSIS

=over

=item B<botch-build-fixpoint> [options] B<--available=>I<AvailablePackages> I<Packages..> I<Sources>

=back

=head1 DESCRIPTION

Given a list of source packages I<Sources>, return the list of binary packages
that can be built without having to break a dependency cycle. The algorithm
repeatedly attempts to satisfy build dependencies of all source packages using
the available binary packages from I<AvailablePackages> and adds the binary
packages of those source packages that satisfy their build dependencies to the
set of available binary packages.

=head1 OPTIONS

=over 4

=item B<--version>

show program's version and exit

=item B<-h, --help>

show this help message and exit

=item B<-v, --verbose>

print additional information

=item B<--quiet>

do no print any messages

=item B<-A, --available=>I<AvailablePackages>

List of available packages (arch:all, crossed...) in control file format
(setting this argument is required). Packages in this list have to be part of
I<Packages>.

=item B<--keep-indep>

Do not drop Build-Depends-Indep dependencies

=item B<--allowsrcmismatch>

If a binary package is without a source package but there is a source package
of same name but different version, match this binary package to that source
package.

=item B<--output-order=>I<FILE>

instead of stderr, write the calculated build order to this file.

=item B<--fg=>I<PKGS>

Additional Packages lists that are checked and used for resolving dependencies
(can be repeated)

=item B<--bg=>I<PKGS>

Additional Packages lists that are NOT checked but used for resolving
dependencies (can be repeated)

=item B<-o, --outfile=>I<FILE>

Set the output file I<FILE>

=item B<--deb-native-arch=>I<ARCH>

Native architecture I<ARCH>

=item B<--deb-host-arch=>I<arch>

Host architecture I<arch>. Defaults to native architecture.

=item B<--deb-foreign-archs=>I<archs>

Comma-separated foreign architectures in addition to native and host
architectures.

=back

=head1 EXAMPLE

Calculate the source packages that can be built in a given state:

 botch-build-fixpoint --deb-native-arch=amd64 --available packages-arch-all --output-order=order.lst packages sources

=head1 BUGS

See L<http://bugs.debian.org/botch>.

=head1 SEE ALSO

Debian doc-base Manual F</usr/share/doc/botch/wiki/Home.html>

=head1 AUTHOR

This man page was written by Johannes Schauer. Botch is written by Johannes
Schauer and Pietro Abate.

=head1 COPYRIGHT

Copyright 2012-2014 Johannes Schauer, Pietro Abate

This program is free software: you can redistribute it and/or modify it under
the terms of the GNU Lesser General Public License as published by the Free
Software Foundation, either version 3 of the License, or (at your option) any
later version. A special linking exception to the GNU Lesser General Public
License applies to this library, see the COPYING file for more information.

