Package: dhelp Version: 0.5.24 Severity: wishlist You were smart enough to search the debian package database but should have done more with what you found there.
dhelp is a good start but it needs to integrate the different document systems. One search box should search all sources You should be able to browse the tree by: - package category - package name - program name - manpage name - info directory - possibly even gnome/kde/debian menu organization Once you browse, it should provide access to all documentation in one place: - registered html files. - man pages - info pages - if you are browsing by program name, it should also show the name of the package which contains it, the category, and the maybe name of the other executables (or you click on the package name to see that). Search box: Search query: _______________________________________ [submit] [x] Search package names [x] Search program names [x] Search manpages [x] Seach info files [ ] Search installed package descriptions [ ] Name [ ] short description [ ] long description [ ] Provides [ ] Search uninstalled packages [ ] Name [ ] short description [ ] long description [ ] Provides [Click here to search packages.debian.org] [click here to search freshmeat.net] [click here to search www.debianhelp.org] Program dhelp: Category: [debian] / [debian tools] Package: [dhelp] HTML: [dhelp] Browse [/usr/share/doc/dhelp/] Manpage: [dhelp(1)] See also: Info documents: (none) Other programs in same package: [sgml2dhelp] [dhelp2dwww] [dhelp-parse] Package: dhelp (installed: 0.5.24) Description: online help system Category: [debian] / [debian tools] Package: [dhelp] HTML: [dhelp] Browse [/usr/share/doc/dhelp/] Manpage: [dhelp(1)] Info documents: (none) Website: Gnome help: (none) KDE help: (none) Depends: [libc6] (>= 2.3.6-6), [libdb3] (>= 3.2.9+dfsg), [debconf] | [debconf-2.0], [perl-modules] Recommends: [mozilla-firefox] | [www-browser] Suggests: [httpd], [swish++], [info2www], [man2html] Provides: Required by: Suggested by: Recommended by: Executable programs: [dhelp] [/usr/sbin/dhelp_parse] [/usr/share/doc/dhelp/sgml2dhelp.pl] [/usr/share/dhelp2dwww.pl] Copyright/license info: [copyright] Read all documentation with a WWW browser. dhelp builds a index of all installed HTML documentation. You don't need a WWW server to read the documentation. dhelp offers a very fast search in the HTML documents. You can access the online help system with the dhelp program or with your browser. The URL to point your browser at is http://localhost/doc/HTML/index.html if you have a WWW server installed or file://localhost/usr/share/doc/HTML/index.html if not. dpkg --listfiles dhelp Package: amaya (not installed) Package: amaya Priority: optional Section: web Installed-Size: 18348 Maintainer: Regis Boudin <[EMAIL PROTECTED]> Architecture: i386 Version: 9.51-2.1 Provides: www-browser Depends: ttf-freefont, libc6 (>= 2.3.6-6), libexpat1 (>= 1.95.8), libfreetype6 (>= 2.2), libgcc1 (>= 1:4.1.0), libgl1-mesa-glx | libgl1, libglu1-mesa | libglu1, libjpeg62, libpng12-0 (>= 1.2.8rel), libraptor1 (>= 1.4.9), librdf0 (>= 1.0.4), libstdc++6 (>= 4.1.0), libwww-ssl0 (>= 5.4.0), libwxbase2.6-0 (>= 2.6.3.2.1.1), libwxgtk2.6-0 (>= 2.6.3.2.1.1), zlib1g (>= 1:1.2.1) Filename: pool/main/a/amaya/amaya_9.51-2.1_i386.deb Size: 5492358 MD5sum: 11166b2d99da30f67294f2937a0cc09f SHA1: 787086f6a817b9a3454e1d535c65d4b46bbe48d9 SHA256: a310a08e4f218dbe11cb13b6db19f52623ec226e37869727b71120c9aa098e7f Description: Web Browser, HTML Editor and Testbed for Draft W3C standards Amaya is a WYSIWYG HTML Editor and browser with support for many of the latest standards from the W3C and other features, such as: - eXtensible HyperText Markup Language (XHTML) - Scalable Vector Graphics (SVG) - Math Markup Language (MathML) - Cascading Style Sheets (CSS) - Resource Description Framework (RDF) - XML Link (XLink) - XML Pointer Language (XPointer) - Collaborative annotations If you want to take shortcuts, just provide the package view and let all the searching and browsing by category/program name/manpage name/ info page name take you to that one master page. Note that since dhelp_parse, sgml2dhelp.pl, and /usr/share/dhelp2dwww.pl are not in the normal path, full pathname was listed. If you are not already doing so, hook into the dpkg system so each time a new package is installed it is scanned for documentation in the background, whether it registers it or not. Right after you install a package is when you are most likely to want to see the docs. If there is no hook, use /var/log/dpkg.log. Integrate some information about packages which are not installed. You have the database of availible packages from apt. Uninstalled packages can be listed under installed packages and in a smaller font. I.E. apt-cache search --full dhelp dhelp fails to find the gnome-help file (DocBook) for gnome terminal: help:///usr/share/gnome/help/gnome-terminal/C/gnome-terminal.xml But gnome-help can find it if you search, so gnome-terminal is not alone in knowing its location. Plus the doctype gives it away. dhelp likewise fails to find the khelpcenter help file (docbook) for kcalc: /usr/share/doc/kde/HTML/en/kcalc/index.docbook INDEXDIR: /home/whitis/.kde/share/apps/khelpcenter/index/ FINDCMD: find /usr/share/doc/kde/HTML/en/ -name index.docbook -- System Information: Debian Release: 4.0 APT prefers unstable APT policy: (990, 'unstable'), (500, 'testing'), (500, 'stable') Architecture: i386 (i686) Shell: /bin/sh linked to /bin/bash Kernel: Linux 2.6.16-1-686 Locale: LANG=en_US, LC_CTYPE=en_US (charmap=ISO-8859-1) Versions of packages dhelp depends on: ii debconf [debconf-2.0] 1.5.11 Debian configuration management sy ii libc6 2.3.6.ds1-9 GNU C Library: Shared libraries ii libdb3 3.2.9+dfsg-0.1 Berkeley v3 Database Libraries [ru ii perl-modules 5.8.8-7 Core Perl modules Versions of packages dhelp recommends: ii amaya [www-browser] 9.51-2.1 Web Browser, HTML Editor and Testb ii epiphany-browser [w 2.14.3-3 Intuitive GNOME web browser ii iceape-browser [www 1.0.6-1 The Iceape Internet browser ii iceweasel [www-brow 2.0.0.1+dfsg-1 lightweight web browser based on M ii konqueror [www-brow 4:3.5.5a.dfsg.1-4 KDE's advanced file manager, web b ii links [www-browser] 0.99+1.00pre12-1.1 Character mode WWW browser ii lynx [www-browser] 2.8.5-2sarge2.2 Text-mode WWW Browser ii opera9-static-binar 9.0.20060411.1-1duo1 Opera Web Browser (static) ii w3m [www-browser] 0.5.1-5.1 WWW browsable pager with excellent -- debconf information: dhelp/www-browser-console: lynx dhelp/www-browser-x: mozilla -- To UNSUBSCRIBE, email to [EMAIL PROTECTED] with a subject of "unsubscribe". Trouble? Contact [EMAIL PROTECTED]