[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Bug#153704: debian-policy: bordering on gibberish, using lynx (and links)

Package: debian-policy
Severity: important

       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.

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

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.

$ 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]
   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

-- 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: