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]

Reply via email to