The following commit has been merged in the master branch:
commit 3299fd121a28e4aaa97d2404ed230ffcfc109fd6
Author: Ralf Treinen <trei...@free.fr>
Date:   Thu May 31 21:31:41 2012 +0200

    add manpage for apt-cudf-get

diff --git a/debian/apt-cudf-get.pod b/debian/apt-cudf-get.pod
new file mode 100644
index 0000000..1bd2576
--- /dev/null
+++ b/debian/apt-cudf-get.pod
@@ -0,0 +1,45 @@
+=head1 NAME
+
+apt-cudf-get - wrapper for calling apt-get with external solvers
+
+=head1 SYNOPSIS
+
+=over
+
+=item B<apt-cudf-get> [arguments]
+
+=back
+=cut
+
+=head1 DESCRIPTION
+
+B<apt-cudf-get> is a wrapper that in some situations is useful to
+invoke B<apt-get> with external solvers. All options are passed on to
+B<apt-get>.
+
+The is is useful is when one wishes to relax apt's pinning. Normally,
+apt uses so-called pinning to select a candidate version of a package
+in case there are several versions available. A priori this also holds
+when calling apt-get with external solvers. However, it may be useful
+to relax pinning and to allow the external solver to choose among all
+available versions of packages in order to satisfy dependencies, not
+only those that are selected by the pinning. Note that in this case the
+versions of packages that are given as arguments to B<install> on the
+command line are still selected according to apt's pinning, the
+relaxation of pinning only applies to the dependencies that may be
+necessary to install
+
+=head1 AUTHOR
+
+Pietro Abate and Roberto Di Cosmo
+
+=head1 BUGS
+
+Not all types of arguements to apt are correctly treated by this wrapper,
+in particular not the +I<pkg> and -I<pkg> shorthands for installation and 
removal requests.
+
+=head1 SEE ALSO
+
+B<apt-get>(1),
+B<apt-cudf>(1),
+B<apt-cudf.conf>(5)
diff --git a/debian/apt-cudf.manpages b/debian/apt-cudf.manpages
index 884eef4..a96f7ae 100644
--- a/debian/apt-cudf.manpages
+++ b/debian/apt-cudf.manpages
@@ -1,3 +1,5 @@
 doc/manpages/apt-cudf.1
 doc/manpages/apt-cudf.conf.5
 debian/update-cudf-solvers.8
+debian/apt-cudf-get.1
+
diff --git a/debian/changelog b/debian/changelog
index d122d2f..e4d7b75 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -1,4 +1,4 @@
-dose3 (2.9.17-1) UNRELEASED; urgency=low
+dose3 (2.9.17-1) unstable; urgency=low
 
   * New upstream version.
     - refreshed patch binaries-prefix-edos
@@ -8,8 +8,9 @@ dose3 (2.9.17-1) UNRELEASED; urgency=low
   * debian/rules: deactivate dh_auto_test for now as the upstream tarball
     does not contain the necessary data for the tests.
   * New file debian/apt-cudf-get, install into /usr/bin
+  * Write a manpage for apt-cudf-get, install in the apt-cudf package.
 
- -- Ralf Treinen <trei...@debian.org>  Thu, 31 May 2012 18:20:15 +0200
+ -- Ralf Treinen <trei...@debian.org>  Thu, 31 May 2012 21:27:30 +0200
 
 dose3 (2.9.15-1) unstable; urgency=low
 
diff --git a/debian/rules b/debian/rules
index 6b3f70f..44ffed2 100755
--- a/debian/rules
+++ b/debian/rules
@@ -1,5 +1,6 @@
 #!/usr/bin/make -f
 
+RELEASE = $(shell dpkg-parsechangelog | grep ^Version: | cut -f 2 -d' ')
 %:
        dh $@ --with ocaml
 
@@ -30,9 +31,10 @@ override_dh_auto_build:
        dh_auto_build
        $(MAKE) doc
        cd doc/debcheck-primer && $(MAKE) 
-       pod2man --section 8 \
-         --release "apt-cudf $(shell dpkg-parsechangelog | grep ^Version: | 
cut -f 2 -d' ')" \
-       debian/update-cudf-solvers > debian/update-cudf-solvers.8
+       pod2man --section 8 -release "apt-cudf $(RELEASE)" \
+               debian/update-cudf-solvers > debian/update-cudf-solvers.8
+       pod2man --section 1 --release "apt-cudf $(RELEASE)" \
+               debian/apt-cudf-get.pod > debian/apt-cudf-get.1
 
 override_dh_auto_clean:
        dh_auto_clean

-- 
dose3 packaging

_______________________________________________
Pkg-ocaml-maint-commits mailing list
Pkg-ocaml-maint-commits@lists.alioth.debian.org
http://lists.alioth.debian.org/cgi-bin/mailman/listinfo/pkg-ocaml-maint-commits

Reply via email to