From a7a42dc397a21e7d1b63bcbd0cbd43a14ebd9618 Mon Sep 17 00:00:00 2001 From: Manoj Srivastava Date: Thu, 16 Jun 2005 05:43:28 +0000 Subject: [PATCH] generalized the dpkg-shlibdeps example and added a current example in a footnote, set proper section ids and linked the d-sd section better, closes: #50565 Author: joy Date: 2003/11/02 13:35:59 generalized the dpkg-shlibdeps example and added a current example in a footnote, set proper section ids and linked the d-sd section better, closes: #50565 git-archimport-id: srivasta@debian.org--etch/debian-policy--devel--3.0--patch-259 --- policy.sgml | 85 ++++++++++++++++++++++++++++++++--------------------- 1 file changed, 51 insertions(+), 34 deletions(-) diff --git a/policy.sgml b/policy.sgml index b0decfb..9b2a138 100644 --- a/policy.sgml +++ b/policy.sgml @@ -1986,7 +1986,7 @@

The architectures we build on and build for are determined by make variables using the utility - dpkg-architecture. + dpkg-architecture. You can determine the Debian architecture and the GNU style architecture specification string for the build machine (the machine type @@ -4584,9 +4584,9 @@ Replaces: mail-transport-agent libraries, it must provide a shlibs file for other packages to use, and when a package is built which contains any shared libraries or compiled binaries, it must run - dpkg-shlibdeps on these to determine the - libraries used and hence the dependencies needed by this - package. + dpkg-shlibdeps + on these to determine the libraries used and hence the + dependencies needed by this package.

In the past, the shared libraries linked to were determined by calling ldd, but now @@ -4640,9 +4640,9 @@ Replaces: mail-transport-agent

In the following sections, we will first describe where the various shlibs files are to be found, then how to - use dpkg-shlibdeps, and finally the - shlibs file format and how to create them if your - package contains a shared library. + use dpkg-shlibdeps, and finally the shlibs + file format and how to create them if your package contains a + shared library.

@@ -4651,8 +4651,9 @@ Replaces: mail-transport-agent

There are several places where shlibs files are found. The following list gives them in the order in which - they are read by dpkg-shlibdeps. (The first - one which gives the required information is used.) + they are read by + dpkg-shlibdeps. + (The first one which gives the required information is used.)

@@ -4746,10 +4747,11 @@ Replaces: mail-transport-agent shlibs files

- Put a call to dpkg-shlibdeps into your - debian/rules file. If your package contains only - compiled binaries and libraries (but no scripts), you can - use a command such as: + Put a call to + dpkg-shlibdeps + into your debian/rules file. If your package + contains only compiled binaries and libraries (but no scripts), + you can use a command such as: dpkg-shlibdeps debian/tmp/usr/bin/* debian/tmp/usr/sbin/* \ debian/tmp/usr/lib/* @@ -4784,8 +4786,12 @@ dpkg-shlibdeps debian/tmp/usr/bin/* debian/tmp/usr/sbin/* \ compiled libraries or binaries. In such a case, you will need to use the -T option to the dpkg utilities to specify a different substvars file. - For more details on this and other options, see . +

+ +

+ For more details on dpkg-shlibdeps, please see + and + .

@@ -8812,7 +8818,7 @@ install-info --quiet --remove /usr/share/info/foobar.info package.

- + dpkg-source - packs and unpacks Debian source packages @@ -8861,7 +8867,7 @@ install-info --quiet --remove /usr/share/info/foobar.info - + dpkg-buildpackage - overall package-building control script @@ -8920,7 +8926,7 @@ install-info --quiet --remove /usr/share/info/foobar.info

- + dpkg-gencontrol - generates binary package control files @@ -8983,7 +8989,7 @@ install-info --quiet --remove /usr/share/info/foobar.info dpkg-genchanges.

 - + dpkg-shlibdeps - calculates shared library dependencies @@ -9033,19 +9039,24 @@ install-info --quiet --remove /usr/share/info/foobar.info

- For example, the procps package generates two - kinds of binaries, simple C binaries like ps - which require a predependency and full-screen ncurses - binaries like top which require only a - recommendation. It can say in its debian/rules: + For example, a package that generates an essential part + which requires dependencies, and optional parts that + which only require a recommendation, would separate those + two sets of dependencies into two different fields. + At the time of writing, an example for this was the + + It can say in its debian/rules: - dpkg-shlibdeps -dPre-Depends ps -dRecommends top + dpkg-shlibdeps -dDepends program anotherprogram ... \ + -dRecommends optionalpart anotheroptionalpart and then in its main control file debian/control: ... - Package: procps - Pre-Depends: ${shlibs:Pre-Depends} + Depends: ${shlibs:Pre-Depends} Recommends: ${shlibs:Recommends} ... @@ -9066,7 +9077,7 @@ install-info --quiet --remove /usr/share/info/foobar.info - + dpkg-distaddfile - adds a file to debian/files @@ -9105,8 +9116,10 @@ install-info --quiet --remove /usr/share/info/foobar.info - dpkg-genchanges - generates a .changes upload - control file + + + dpkg-genchanges - generates a .changes + upload control file

@@ -9127,8 +9140,10 @@ install-info --quiet --remove /usr/share/info/foobar.info - dpkg-parsechangelog - produces parsed representation of - a changelog + + + dpkg-parsechangelog - produces parsed + representation of a changelog

@@ -9141,8 +9156,10 @@ install-info --quiet --remove /usr/share/info/foobar.info

- dpkg-architecture - - information about the build and host system + + + dpkg-architecture - information about the build and + host system

-- 2.39.5