Bug#153704: marked as done (debian-policy: bordering on gibberish, using lynx (and links))
Your message dated Sat, 31 Aug 2002 06:34:38 -0400
with message-id <E17l5aQ-0005Zx-00@auric.debian.org>
and subject line Bug#153704: fixed in debian-policy 3.5.7.0
has caused the attached Bug report 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 I am
talking about this indicates a serious mail system misconfiguration
somewhere. Please contact me immediately.)
Debian bug tracking system administrator
(administrator, Debian Bugs database)
--------------------------------------
Received: (at submit) by bugs.debian.org; 21 Jul 2002 01:03:35 +0000
>From lazarus@overdue.ddts.net Sat Jul 20 20:03:35 2002
Return-path: <lazarus@overdue.ddts.net>
Received: from 64-212-200-56.nrp1feld.roc.ny.frontiernet.net (phoenix.overdue.ddts.net) [64.212.200.56]
by master.debian.org with esmtp (Exim 3.12 1 (Debian))
id 17W58F-0004RG-00; Sat, 20 Jul 2002 20:03:31 -0500
Received: by phoenix.overdue.ddts.net (Postfix, from userid 1002)
id A50FD73033; Sun, 21 Jul 2002 01:02:53 +0000 (UTC)
From: Lazarus Long <lazarus@overdue.ddts.net>
Subject: debian-policy: bordering on gibberish, using lynx (and links)
To: submit@bugs.debian.org
X-Mailer: bug 3.3.10.1
Message-Id: <20020721010253.A50FD73033@phoenix.overdue.ddts.net>
Date: Sun, 21 Jul 2002 01:02:53 +0000 (UTC)
Delivered-To: submit@bugs.debian.org
Package: debian-policy
Version: 3.5.6.1
Severity: important
<humour>
2) Important Bug. Has a major effect on the usability of a package,
without rendering it completely unusable to everyone.
3) Dangerous bug. Makes the package in question unusable by anyone or
mostly so, or causes data loss, or introduces a security hole allowing
access to the accounts of users who use the package.
2.5) Nasty bug. Makes the package in question unusable by anyone
in console, or mostly so.
</humour>
Seriously, debian-policy borders on gibberish using lynx, and links
is not much better. I was just attempting to look something up in
policy while conversing with a debian developer, but couldn't provide
him with a citation, since the package is in such useless condition.
Policy should be accessible to all, not just X11 users.
If you care to reproduce what is included below, the commandline is
as follows:
$ lynx -dump file://localhost/usr/share/doc/debian-policy/policy.html/index.html | head -n 135
As a quick aside, let me check links, with
$ links /usr/share/doc/debian-policy/policy.html/index.html | head -n 10
Debian Policy Manual (p1 of 20)
Link: [1]start
Link: [2]prev
Link: [3]next
Link: [4]contents
Link: [5]copyright
Link: [6]chapter
Link: [7]chapter
Link: [8]chapter
Link: [9]chapter
Link: [10]chapter
Link: [11]chapter
Link: [12]chapter
Link: [13]chapter
Link: [14]chapter
Link: [15]chapter
Link: [16]chapter
Link: [17]chapter
Link: [18]chapter
Link: [19]appendix
Link: [20]appendix
Link: [21]appendix
(Not very useful, although it seems to have dealt poorly with piping to head.)
It continues through
Link: [204]subsection
Link: [205]subsection
btw.
The rest of this bug report is the ugliness from lynx, and the commandline
above, which you might want to bypass if you have sensitive eyes.
You won't miss much.
<ugliness>
$ lynx -dump file://localhost/usr/share/doc/debian-policy/policy.html/index.html | head -n 135
#[1]start [2]prev [3]next [4]contents [5]copyright [6]1 About this
manual [7]2 The Debian Archive [8]3 Control files and their fields
[9]4 Version numbering [10]5 Packaging Considerations [11]6 Package
maintainer scripts and installation procedure [12]7 Declaring
relationships between packages [13]8 Configuration file handling [14]9
Shared libraries [15]10 The Operating System [16]11 Files [17]12
Customized programs [18]13 Documentation [19]A Introduction and scope
of these appendices [20]B Binary packages (from old Packaging Manual)
[21]C Source packages (from old Packaging Manual) [22]D Control files
and their fields (from old Packaging Manual) [23]E Configuration file
handling (from old Packaging Manual) [24]F Alternative versions of an
interface - <code>update-alternatives</code> (from old Packaging
Manual) [25]G Diversions - overriding a package's version of a file
(from old Packaging Manual) [26]1.1 Scope [27]1.2 New versions of this
document [28]1.3 Feedback [29]2.1 Package copyright and sections
[30]2.2 Priorities [31]2.3 Binary packages [32]2.4 Source packages
[33]3.1 Syntax of control files [34]3.2 List of fields [35]4.1 Version
numbers based on dates [36]5.1 Time Stamps [37]5.2
<samp>debian/rules</samp> - the main building script [38]5.3
<samp>debian/changelog</samp> [39]5.4 <samp>debian/substvars</samp>
and variable substitutions [40]5.5 <samp>debian/files</samp> [41]5.6
Restrictions on objects in source packages [42]5.7 Descriptions of
packages - the <samp>Description</samp> field [43]6.1 Introduction to
package maintainer scripts [44]6.2 Maintainer scripts Idempotency
[45]6.3 Controlling terminal for maintainer scripts [46]6.4 Summary of
ways maintainer scripts are called [47]6.5 Details of unpack phase of
installation or upgrade [48]6.6 Details of configuration [49]6.7
Details of removal and/or configuration purging [50]7.1 Syntax of
relationship fields [51]7.2 Binary Dependencies -
<samp>Depends</samp>, <samp>Recommends</samp>, <samp>Suggests</samp>,
<samp>Enhances</samp>, <samp>Pre-Depends</samp> [52]7.3 Conflicting
binary packages - <samp>Conflicts</samp> [53]7.4 Virtual packages -
<samp>Provides</samp> [54]7.5 Overwriting files and replacing packages
- <samp>Replaces</samp> [55]7.6 Relationships between source and
binary packages - <samp>Build-Depends</samp>,
<samp>Build-Depends-Indep</samp>, <samp>Build-Conflicts</samp>,
<samp>Build-Conflicts-Indep</samp> [56]9.1 Handling shared library
dependencies - the <samp>shlibs</samp> system [57]9.2 The
<samp>shlibs</samp> files present on the system [58]9.3 How to use
<code>dpkg-shlibdeps</code> and the <samp>shlibs</samp> files [59]9.4
The <samp>shlibs</samp> File Format [60]9.5 Providing a
<samp>shlibs</samp> file [61]9.6 Writing the
<samp>debian/shlibs.local</samp> file [62]10.1 Filesystem hierarchy
[63]10.2 Users and groups [64]10.3 System run levels and
<samp>init.d</samp> scripts [65]10.4 Console messages from
<samp>init.d</samp> scripts [66]10.5 Cron jobs [67]10.6 Menus [68]10.7
Multimedia handlers [69]10.8 Keyboard configuration [70]10.9
Environment variables [71]11.1 Binaries [72]11.2 Libraries [73]11.3
Shared libraries [74]11.4 Scripts [75]11.5 Symbolic links [76]11.6
Device files [77]11.7 Configuration files [78]11.8 Log files [79]11.9
Permissions and owners [80]12.1 Architecture specification strings
[81]12.2 Daemons [82]12.3 Using pseudo-ttys and modifying wtmp, utmp
and lastlog [83]12.4 Editors and pagers [84]12.5 Web servers and
applications [85]12.6 Mail transport, delivery and user agents
[86]12.7 News system configuration [87]12.8 Programs for the X Window
System [88]12.9 Perl programs and modules [89]12.10 Emacs lisp
programs [90]12.11 Games [91]13.1 Manual pages [92]13.2 Info documents
[93]13.3 Additional documentation [94]13.4 Accessing the documentation
[95]13.5 Preferred documentation formats [96]13.6 Copyright
information [97]13.7 Examples [98]13.8 Changelog files [99]B.1
Creating package files - <code>dpkg-deb</code> [100]B.2 Package
control information files [101]B.3 The main control information file:
<samp>control</samp> [102]B.4 Time Stamps [103]C.1 Tools for
processing source packages [104]C.2 The Debianised source tree
[105]C.3 Source packages as archives [106]C.4 Unpacking a Debian
source package without <code>dpkg-source</code> [107]D.1 Syntax of
control files [108]D.2 List of fields [109]E.1 Automatic handling of
configuration files by <code>dpkg</code> [110]E.2 Fully-featured
maintainer script configuration handling [111]2.1.1 The Debian Free
Software Guidelines [112]2.1.2 The main section [113]2.1.3 The contrib
section [114]2.1.4 The non-free section [115]2.1.5 The non-US sections
[116]2.1.6 Further copyright considerations [117]2.1.7 Subsections
[118]2.3.1 The package name [119]2.3.2 The maintainer of a package
[120]2.3.3 The description of a package [121]2.3.4 Dependencies
[122]2.3.5 Virtual packages [123]2.3.6 Base packages [124]2.3.7
Essential packages [125]2.3.8 Maintainer scripts [126]2.3.8.1
Prompting in maintainer scripts [127]2.4.1 Standards conformance
[128]2.4.2 Package relationships [129]2.4.3 Changes to the upstream
sources [130]2.4.4 Documenting your changes [131]2.4.5 Error trapping
in makefiles [132]2.4.6 Obsolete constructs and libraries [133]3.2.1
<samp>Package</samp> [134]3.2.2 <samp>Version</samp> [135]3.2.3
<samp>Standards-Version</samp> [136]3.2.4 <samp>Distribution</samp>
[137]5.3.1 Defining alternative changelog formats [138]5.7.1 Notes
about writing descriptions [139]7.5.1 Overwriting files in other
packages [140]7.5.2 Replacing whole packages, forcing their removal
[141]10.1.1 Filesystem Structure [142]10.1.2 Site-specific programs
[143]10.1.3 The system-wide mail directory [144]10.2.1 Introduction
[145]10.2.2 UID and GID classes [146]10.3.1 Introduction [147]10.3.2
Writing the scripts [148]10.3.3 Managing the links [149]10.3.4
Boot-time initialization [150]10.3.5 Example [151]11.7.1 Definitions
[152]11.7.2 Location [153]11.7.3 Behavior [154]11.7.4 Sharing
configuration files [155]11.7.5 User configuration files ("dotfiles")
[156]11.9.1 The use of <code>dpkg-statoverride</code> [157]12.8.1
Providing X support and package priorities [158]12.8.2 Packages
providing an X server [159]12.8.3 Packages providing a terminal
emulator [160]12.8.4 Packages providing a window manager [161]12.8.5
Packages providing fonts [162]12.8.6 Application defaults files
[163]12.8.7 Installation directory issues [164]12.8.8 The OSF/Motif
and OpenMotif libraries [165]C.1.1 <code>dpkg-source</code> - packs
and unpacks Debian source packages [166]C.1.2
<code>dpkg-buildpackage</code> - overall package-building control
script [167]C.1.3 <code>dpkg-gencontrol</code> - generates binary
package control files [168]C.1.4 <code>dpkg-shlibdeps</code> -
calculates shared library dependencies [169]C.1.5
<code>dpkg-distaddfile</code> - adds a file to
<samp>debian/files</samp> [170]C.1.6 <code>dpkg-genchanges</code> -
generates a <samp>.changes</samp> upload control file [171]C.1.7
<code>dpkg-parsechangelog</code> - produces parsed representation of a
changelog [172]C.1.8 <code>dpkg-architecture</code> - information
about the build and host system [173]C.2.1 <samp>debian/rules</samp> -
the main building script [174]C.2.2 <samp>debian/control</samp>
[175]C.2.2.1 User-defined fields [176]C.2.3
<samp>debian/changelog</samp> [177]C.2.3.1 Defining alternative
changelog formats [178]C.2.4 <samp>debian/substvars</samp> and
variable substitutions [179]C.2.5 <samp>debian/files</samp> [180]C.2.6
<samp>debian/tmp</samp> [181]C.4.1 Restrictions on objects in source
packages [182]D.2.1 <samp>Package</samp> [183]D.2.2
<samp>Version</samp> [184]D.2.3 <samp>Architecture</samp> [185]D.2.4
<samp>Maintainer</samp> [186]D.2.5 <samp>Source</samp> [187]D.2.6
Package interrelationship fields: <samp>Depends</samp>,
<samp>Pre-Depends</samp>, <samp>Recommends</samp>
<samp>Suggests</samp>, <samp>Conflicts</samp>, <samp>Provides</samp>,
<samp>Replaces</samp> [188]D.2.7 <samp>Description</samp> [189]D.2.8
<samp>Essential</samp> [190]D.2.9 <samp>Section</samp> and
<samp>Priority</samp> [191]D.2.10 <samp>Binary</samp> [192]D.2.11
<samp>Installed-Size</samp> [193]D.2.12 <samp>Files</samp> [194]D.2.13
<samp>Standards-Version</samp> [195]D.2.14 <samp>Distribution</samp>
[196]D.2.15 <samp>Urgency</samp> [197]D.2.16 <samp>Date</samp>
[198]D.2.17 <samp>Format</samp> [199]D.2.18 <samp>Changes</samp>
[200]D.2.19 <samp>Filename</samp> and <samp>MSDOS-Filename</samp>
[201]D.2.20 <samp>Size</samp> and <samp>MD5sum</samp> [202]D.2.21
<samp>Status</samp> [203]D.2.22 <samp>Config-Version</samp>
[204]D.2.23 <samp>Conffiles</samp> [205]D.2.24 Obsolete fields
_________________________________________________________________
$
</ugliness>
-- System Information
Debian Release: sarge
Kernel Version: Linux phoenix 2.4.18 #1 Sun Mar 3 20:15:51 UTC 2002 i586 unknown unknown GNU/Linux
Versions of the packages debian-policy depends on:
ii fileutils 4.1.9-3 GNU file management utilities
---------------------------------------
Received: (at 153704-close) by bugs.debian.org; 31 Aug 2002 10:38:08 +0000
>From rmurray@auric.debian.org Sat Aug 31 05:38:08 2002
Return-path: <rmurray@auric.debian.org>
Received: from auric.debian.org [206.246.226.45] (mail)
by master.debian.org with esmtp (Exim 3.12 1 (Debian))
id 17l5dn-00031y-00; Sat, 31 Aug 2002 05:38:07 -0500
Received: from rmurray by auric.debian.org with local (Exim 3.35 1 (Debian))
id 17l5aQ-0005Zx-00; Sat, 31 Aug 2002 06:34:38 -0400
From: Manoj Srivastava <srivasta@debian.org>
To: 153704-close@bugs.debian.org
X-Katie: $Revision: 1.17 $
Subject: Bug#153704: fixed in debian-policy 3.5.7.0
Message-Id: <E17l5aQ-0005Zx-00@auric.debian.org>
Sender: Ryan Murray <rmurray@auric.debian.org>
Date: Sat, 31 Aug 2002 06:34:38 -0400
Delivered-To: 153704-close@bugs.debian.org
We believe that the bug you reported is fixed in the latest version of
debian-policy, which is due to be installed in the Debian FTP archive:
debian-policy_3.5.7.0.dsc
to pool/main/d/debian-policy/debian-policy_3.5.7.0.dsc
debian-policy_3.5.7.0.tar.gz
to pool/main/d/debian-policy/debian-policy_3.5.7.0.tar.gz
debian-policy_3.5.7.0_all.deb
to pool/main/d/debian-policy/debian-policy_3.5.7.0_all.deb
A summary of the changes between this version and the previous one is
attached.
Thank you for reporting the bug, which will now be closed. If you
have further comments please address them to 153704@bugs.debian.org,
and the maintainer will reopen the bug report if appropriate.
Debian distribution maintenance software
pp.
Manoj Srivastava <srivasta@debian.org> (supplier of updated debian-policy package)
(This message was generated automatically at their request; if you
believe that there is a problem with it please contact the archive
administrators by mailing ftpmaster@debian.org)
-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1
Format: 1.7
Date: Sat, 31 Aug 2002 02:18:02 -0500
Source: debian-policy
Binary: debian-policy
Architecture: source all
Version: 3.5.7.0
Distribution: unstable
Urgency: low
Maintainer: Debian Policy List <debian-policy@lists.debian.org>
Changed-By: Manoj Srivastava <srivasta@debian.org>
Description:
debian-policy - Debian Policy Manual and related documents
Closes: 47298 69311 81852 97755 100346 100472 106280 106826 109672 111025 112828 113525 114949 116134 118608 131441 134977 137521 137521 138681 139067 139820 139832 139969 140697 141307 141903 143770 144297 144411 145067 146703 146756 147554 150456 151328 152965 153704 154142 154660 155680 156546 157131
Changes:
debian-policy (3.5.7.0) unstable; urgency=low
.
* Fixed some broken hrefs in links
* No longer use local debiandoc stuff (it's been fixed upstream)
* Added table of contents (index.html) to policy-process.sgml, fixing
the new error reported to bug #137521 closes: Bug#137521
* Fixed a couple of typos closes: Bug#139832
* Ran through the policy document looking for long instances of text in
the <tt> tag, and changed it to <file> where appropriate. This is
since the <file> tag can handle line breaking, but the <t> flag does
not. closes: Bug#139820
* Change the requirement to ask permission to make devices to merely
requiring a notification. closes: Bug#106280
* Added a build dependson docbook utils. closes: Bug#154660
* Since this is being built with a newer version of debiandoc-sgml, this
should display better with lynx. closes: Bug#153704
* Add in the crypto-in-main amendment. closes: Bug#81852, Bug#144411
* we no longer have task packages, instead, we define tasks using a
special field in the control file (and these should be added only
after discussion on the mailing lists) closes: Bug#97755
* Clarify wording in the section for packages providing fonts.
closes: Bug#109672
* Fix the doc base file for policy process closes: Bug#137521, Bug#147554
closes: Bug#146756
* using set -e is not dubious advice. Rejecting this. closes: Bug#139969
* Make the directory one is building under ./debian/ be up to the
maintainer, instead of mandating ./debian/tmp/ closes: Bug#144297
* Add a standards version closes: Bug#145067
* Added virtual package debconf-2.0 closes: Bug#151328
* Added The Window Manager Specification Project support to the default
window manager selection mechanism closes: Bug#155680
* The confusion between /var/mail and /var/spool/mail seems to have been
disambiguated. closes: Bug#114949
* Mention the new Build-Depend-Indep semantic and the new
build-indep/build-arch rules in upgrading checklist closes: Bug#116134
* Made package naming rules in policy consistent. I did not eliminate
the duplication, since I don't want to make major changes to the flow,
since we are supposed to be re-writing policy anyway. closes: Bug#131441
* Clarified wording about cases where we may have concrete and virtual
packages with the same name. closes: Bug#134977
* Fixed typo 'be be' closes: Bug#138681
* Fixed typo in appendix G -- example of diversion closes: Bug#140697
* fix typo shlib: -> shlibs: closes: Bug#141903
* Provide a link between two sections dealing with virtual packages.
closes: Bug#143770
* Fixed xtifr's email address in the menu policy closes: Bug#152965
* Allow shared library names to be have a hyphen between library name
and soversion if the library name ends in a number. closes: Bug#100472
* Permit some libraries to only install static libs. closes: Bug#100346
* Remove the debug option, add noopt closes: Bug#157131, Bug#113525
* provide dhcp-client virtual package. closes: Bug#154142
* We do not need bits in policy that ``should not be enforced''.
closes: Bug#150456
* We are building this with the latest debianndoc-sgml. closes: Bug#146703
* Finish incorporating all of the accepted changes in Bug#72335, and
this closes: Bug#141307, Bug#156546
* Added virtual package aspell-dictionary closes: Bug#139067
* Added virtual package radius-server closes: Bug#118608
* Clarifying manual pages is not a policy issue. closes: Bug#112828
* Corrected the ldconfig handling instructions. closes: Bug#111025
* Not a policy issue. closes: Bug#106826
* Removed the /usr/doc/ symlink clause. closes: Bug#47298, Bug#69311
Files:
f0da89116b92e54347d2924dcb891bc3 792 doc optional debian-policy_3.5.7.0.dsc
538deca6636d771319afea1405dcc196 569509 doc optional debian-policy_3.5.7.0.tar.gz
13c3dd1a4cad18ecb08d13f7605ca9d6 595702 doc optional debian-policy_3.5.7.0_all.deb
fc34e5d47979c1fe6bbbfae067bc25e5 93119 byhand - policy.txt.gz
12f50e6fdbfeda37e11a4588c172b351 2137 byhand - menu-policy.txt.gz
56b51697d5f7924c4c6f95b7e75386fb 1563 byhand - mime-policy.txt.gz
4f02b12bef47d46284be9aedabae845a 4497 byhand - policy-process.txt.gz
d5b675249edb9396659d5ef8c427f9dc 4400 byhand - perl-policy.txt.gz
e84ca799d0bd503879c7332ce7010037 104301 byhand - policy.html.tar.gz
745262ba198b4cd35549768b400ad054 2804 byhand - menu-policy.html.tar.gz
6c9855fc81bbd236d964b00fff6b50db 2163 byhand - mime-policy.html.tar.gz
1936adb9629913a178c5977101073df8 5200 byhand - policy-process.html.tar.gz
ad20fd4399f0cf475919d2c47bac9f69 5804 byhand - perl-policy.html.tar.gz
57bfae059e907807da5ca6978bef12f3 6104 byhand - debconf_specification.txt.gz
2b6ac31aefc3ed74bad716b3fb2eb60f 30171 byhand - debconf_specification.html
3ed7aa5a489834b24bb28ff377a34aa9 10982 byhand - libc6-migration.txt
754f5c28f50298c94d96ee39aa3a0026 9170 byhand - virtual-package-names-list.txt
445f783dd5d3d56e23c32974889f7d69 175739 byhand - policy.ps.gz
7a4d94570f1cb1f7f99c68e42fef5bdf 411899 byhand - policy.pdf.gz
540f308e7fac7ec81f2c065f6a0aabc3 17344 byhand - upgrading-checklist.txt
93679f707ec4cbc94b6f667afb1f2600 34997 byhand - fhs-2.1.html.tar.gz
4beb6c43e8a0845e619e798b5516d217 103024 byhand - fhs.txt
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.0.7 (GNU/Linux)
iD8DBQE9cIM+Ibrau78kQkwRAme5AJ9p2Nvn8QcNjtGt/Z31fFm6qkxEUgCgr4Ch
iAYeNJy71t9IdQ1nMkoXnlU=
=NMk/
-----END PGP SIGNATURE-----
Reply to: