Bug#153704: debian-policy: bordering on gibberish, using lynx (and links)
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
--
To UNSUBSCRIBE, email to debian-policy-request@lists.debian.org
with a subject of "unsubscribe". Trouble? Contact listmaster@lists.debian.org
Reply to: