Your message dated Mon, 13 Oct 2014 21:47:38 +0200 with message-id <[email protected]> and subject line Re: Bug#698999: Links to the Policy for dpkg's manual pages. has caused the Debian Bug report #698999, regarding Links to the Policy for dpkg's manual pages. to be marked as done.
This means that you claim that the problem has been dealt with. If this is not the case it is now your responsibility to reopen the Bug report if necessary, and/or fix the problem forthwith. (NB: If you are a system administrator and have no idea what this message is talking about, this may indicate a serious mail system misconfiguration somewhere. Please contact [email protected] immediately.) -- 698999: http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=698999 Debian Bug Tracking System Contact [email protected] with problems
--- Begin Message ---Package: dpkg Version: 1.16.9 Severity: wishlist Tags: patch Dear dpkg maintainers, on debian-devel, I was suggested to propose a patch to deb-symbols(5), dpkg-shlibdeps(1) and dpkg-gensymbols(1), with a link to the Policy. https://lists.debian.org/debian-devel/2013/01/msg00394.html Here is a patch that does so not only for the symbols, but also for the control data files and the substitution variables. Have a nice week-end, -- Charles Plessy Tsurumi, Kanagawa, Japan.>From 0c2d87205b69eb48c8e2ef482c85f8163b1f0a97 Mon Sep 17 00:00:00 2001 From: Charles Plessy <[email protected]> Date: Sat, 26 Jan 2013 11:40:21 +0900 Subject: [PATCH] man: added hyperlinks to the Debian Policy. See https://lists.debian.org/debian-devel/2013/01/msg00394.html --- man/deb-control.5 | 2 ++ man/deb-shlibs.5 | 2 ++ man/deb-src-control.5 | 2 ++ man/deb-substvars.5 | 2 ++ man/deb-symbols.5 | 2 ++ man/dpkg-genchanges.1 | 3 +++ man/dpkg-gencontrol.1 | 3 +++ man/dpkg-gensymbols.1 | 2 ++ 8 files changed, 18 insertions(+) diff --git a/man/deb-control.5 b/man/deb-control.5 index e179ab1..bf9042f 100644 --- a/man/deb-control.5 +++ b/man/deb-control.5 @@ -286,6 +286,8 @@ Description: GNU grep, egrep and fgrep. .fi .\" .RE . +.BR http://www.debian.org/doc/debian-policy/ch-controlfields.html#s-binarycontrolfiles +.br .SH SEE ALSO .BR deb (5), .BR deb\-version (5), diff --git a/man/deb-shlibs.5 b/man/deb-shlibs.5 index a6fa586..6944ed1 100644 --- a/man/deb-shlibs.5 +++ b/man/deb-shlibs.5 @@ -64,6 +64,8 @@ This is not the only reason the dependencies might need to be tightened; again, see the Debian Policy Manual for details. . .SH SEE ALSO +.BR http://www.debian.org/doc/debian-policy/ch-sharedlibs.html#s-sharedlibs-shlibdeps +.br .BR deb\-control (5), .BR dpkg\-shlibdeps (1), .BR deb\-symbols (5). diff --git a/man/deb-src-control.5 b/man/deb-src-control.5 index 17f85b3..884a3d4 100644 --- a/man/deb-src-control.5 +++ b/man/deb-src-control.5 @@ -372,6 +372,8 @@ Description: Debian package development tools .SH SEE ALSO +.BR http://www.debian.org/doc/debian-policy/ch-controlfields.html#s-sourcecontrolfiles +.br .BR deb\-control (5), .BR deb\-version (5), .BR dpkg\-source (1) diff --git a/man/deb-substvars.5 b/man/deb-substvars.5 index a8d3640..43b04eb 100644 --- a/man/deb-substvars.5 +++ b/man/deb-substvars.5 @@ -170,6 +170,8 @@ The point at which field overriding occurs compared to certain standard output field settings is rather confused. .SH SEE ALSO +.BR http://www.debian.org/doc/debian-policy/ch-source.html#s-substvars +.br .BR dpkg (1), .BR dpkg\-genchanges (1), .BR dpkg\-gencontrol (1), diff --git a/man/deb-symbols.5 b/man/deb-symbols.5 index 5d9ea0f..1ecdc50 100644 --- a/man/deb-symbols.5 +++ b/man/deb-symbols.5 @@ -77,5 +77,7 @@ libGL.so.1 libgl1 .SH SEE ALSO .BR http://wiki.debian.org/Projects/ImprovedDpkgShlibdeps .br +.BR http://www.debian.org/doc/debian-policy/ch-sharedlibs.html#s-sharedlibs-symbols +.br .BR dpkg\-shlibdeps (1), .BR dpkg\-gensymbols (1). diff --git a/man/dpkg-genchanges.1 b/man/dpkg-genchanges.1 index 885e745..d143dd6 100644 --- a/man/dpkg-genchanges.1 +++ b/man/dpkg-genchanges.1 @@ -163,3 +163,6 @@ prepared. reads the data here when producing a .B .changes file. + +.SH SEE ALSO +.BR http://www.debian.org/doc/debian-policy/ch-controlfields.html#s-debianchangesfiles diff --git a/man/dpkg-gencontrol.1 b/man/dpkg-gencontrol.1 index 33d53c1..cf9951c 100644 --- a/man/dpkg-gencontrol.1 +++ b/man/dpkg-gencontrol.1 @@ -157,3 +157,6 @@ prepared. .B dpkg\-gencontrol adds the presumed filenames of binary packages whose control files it generates here. + +.SH SEE ALSO +.BR http://www.debian.org/doc/debian-policy/ch-controlfields.html#s-debiansourcecontrolfiles diff --git a/man/dpkg-gensymbols.1 b/man/dpkg-gensymbols.1 index 088e448..6f7ce97 100644 --- a/man/dpkg-gensymbols.1 +++ b/man/dpkg-gensymbols.1 @@ -474,5 +474,7 @@ Show the version and exit. .br .BR http://people.redhat.com/drepper/dsohowto.pdf .br +.BR http://www.debian.org/doc/debian-policy/ch-sharedlibs.html#s-sharedlibs-symbols +.br .BR deb\-symbols (5), .BR dpkg\-shlibdeps (1). -- 1.7.10.4
--- End Message ---
--- Begin Message ---Hi! On Sat, 2013-01-26 at 12:58:15 +0100, Guillem Jover wrote: > On Sat, 2013-01-26 at 11:47:14 +0900, Charles Plessy wrote: > > Package: dpkg > > Version: 1.16.9 > > Severity: wishlist > > Tags: patch > > > on debian-devel, I was suggested to propose a patch to deb-symbols(5), > > dpkg-shlibdeps(1) and dpkg-gensymbols(1), with a link to the Policy. > > > > https://lists.debian.org/debian-devel/2013/01/msg00394.html > > > > Here is a patch that does so not only for the symbols, but also for > > the control data files and the substitution variables. > > This might seem strange, but to me this only adds poiners to > “redundant” information, which can be more confusing than not. > > The way I see this is just as a link for linking purposes (something > that might not be bad in itself depending on the context), because if > any information of substance is missing from the dpkg man pages that > is covered by the Debian policy then that would be a bug on dpkg, and > the other excess information in Debian policy should just be vendor > specific decisions, something that dpkg should not really be concerned > with and that might get the reader confused if they do not need to > abide by those restrictions, consider that dpkg is used beyond Debian > and Debian-derived systems, and as such I'd like to keep it as neutral > as possible on those regards. > > I see the Debian policy as a subset of the things that can be done > with dpkg. Most of the few current references to the Debian policy > manual are pretty recent, and something I've considered rewording and > in some cases removing. Given the above, and that I've already started writing man pages for dsc(5), deb-changes(5) and deb-changelog(5), which will be integrated in dpkg 1.18.x, where I'll be removed most if not all policy references, I'm closing this report. Thanks, Guillem
--- End Message ---
