Attributes edit
- name
- dgHelpBrowser
- location
- https://bitbucket.org/mittelmark/tcl-code/downloads/dgHelpBrowser0.3.12.kit
- description
- Advanced Help Viewer for Tcl documentation, with contents tree, index lists, and bookmark panel. Currently at version 0.3.12. Currently running on Win32, Linux-x86, SunOS-sun4u, OSF1-alpha, Mac-OSX. Other platforms are provided on request.
- updated
- 2005-06
- contact
- dgroth (at) idolinguo.de
HISTORY edit
DDG 2012-02-10 Version 0.3.12:- png image support added for Tclkits version 8.4 and 8.5 (Linux/Win32), 8.6 is inbuild
- if tile widgets are available use ttk::scrollbar at least to plish interface on Linux
- fix mouse wheel bug with Tcl/Tk 8.4
- fixing package mismatch with Tcl/Tk 8.5 - dgHelpBrowser should now run on all systems from Tcl 8.4, Tcl 8.5 and 8.6b2
- fixing broken weblinks
- fixing small scroll issue in the webbrowser
- added Pgtcl1.4 documentation
- added tcl tutorial
- added tsql4mk documentation
- added ratcl 0.92 documentation
- small fix for wikisearch combobox
- fixing gtklook which gives some troubles on certain X-settings
- added Tile 0.6.2 documentation
- added wiki search entry
- added soaptcl docs
- added docs for yeti, fickle, taccle
- added documentation for tclhttpd
- grab fix for the find dialog
- online links are now also defined inside contents.cnt
- added docs for Frink, tkcon,tkinspect,expect
- font now can be choosen also for the tree and the index via Options
- Support for MacOSX-Aqua on Darwin
- relational algebra packages ratcl, tclral
- added sqlite3 docs
- fontsize choosable up to 22 for the browser widget
- adding tdom,tclxml docs
- fixing a bug with the snitini wrapper
- cursor navigation (Key-Up and Key-Down) inside the searchlistbox was added
- added OraTcl,TLS,memchan docus
- some small fixes (see below).
- added comp.lang.tcl link.
- added mousewheel support (thx) to Jeff Hobbs for mentioning this inside the tclkit mailing list
- update in documentation, tcltk -> 8.4.9, tcllib -> 1.7, bwidget -> 1.7, adding actions, xmlrpc,combat and some more docs
- fixing a bug with internal anchors inside snitbrowser-widget
- adding prefixes for some dirs (xotcl, tclkit) inside the index with .prefix-files
- updating tcldocs: nemethi-packages, bwidgets1.7.0
- adding xotcl-docus, nemethis mentry-docs
- improved outfit on UNIX-platforms
Screenshots edit
LV: Oh, how I love this kit.Just a few notes.1. I see the line: anyone interested in implementing the _FormCmd on stderr after some action takes place - I'm uncertain what action it is.DDG: see snitbrowser; somebody should implement the method _FormCmd.2. There's an annoying Tk bug that no one's resolved that shows up in the use of the program. It isn't dgHelpBrower's fault, as far as I am aware. But I have a 2 monitor system. When I have dgHelpBrowser on the right hand monitor, then click on the Options Menu button, then on the html fontsize button, the sub-menu shows up way over on the left monitor. If anyone knows how to fix this, I would surely love to hear about it - and would love to see the fix integrated into Tk 8.5!VK: I think this is very OS dependent. I saw similar behaviour on non-Tk application, but I am not sure right now. What is your OS/PC BTW? I saw this misbehaviour on Windows XP Tablet edition, with application having nothing in common with Tk.LV: I am using SPARC, Solaris 8, GNOME, Metacity.3. When one clicks on the help 'contents' entry, the cursor should change into some sort of 'busy' indicator to let the user know that something is happening, then change back when the processing is completed. While often things happen quickly, there are cases where the processing takes a while (the wiki and comp.lang.tcl entries, for instance) and one is left wondering what is going wrong.DDG: agree but I have always problems with those busy stuffs.4. Question - is it normal for the contents entries to require double clicks? That's what I am seeing here on my sparc solaris 8 gnome desktop.DDG: yes this was normal, now I changed it to single clicks!5. Covering the docs for most of the extensions that appear in activetcl would really be useful - they are, in general, among the most popular. Other docs that would be useful would include things like BLT, OraTcl, listx, mclistbox, memchan, trf, trfcrypt, snack, oomk, tkimg, and tls.LES: misses tDOM.DDG: added memchan,tls and oratcl. oomk is already in (inside mk4tcl). mclistbox is quite old. I would use tablelist instead. Anyway,,, if you want to add your own docs:
- just unwrap the file dgHelpBrowser.kit
- add the docus inside the html dir
- edit contents.cnt,contents.htm
- rewrap
- restart
LES: Wow. This is great! But I did run into a problem: the mouse wheel does not work. It's not just uncomfortable, it's almost impossible to use because I can only scroll up and down a pane by clicking and dragging the scroll bar on the side, and the left panel is pushed so far to the left that the scroll bar is not visible. I can hold and drag the middle vertical separation and enlarge the left pane, but then the right pane's scroll bar disappears off the screen. Dragging the middle vertical separation in either direction, I actually found a spot that makes both scroll bars disappear, but no spot that would make both of them visible.DDG: I enabled the mouse wheel and was putting the scrollbar on the left. This panedwindow always behaves a little bit obscure ..... Please redownload ...LES: Flawless! Many thanks.LES: I am unhappy again :-( This application ran on my Windows system, but refuses to run on my Linux. Tk does not provide a convenient way to copy all that error message text and I am too lazy to copy all that manually, so here [1] is a screenshot. This must be the same problem I had with Jigsaw Puzzler.
LV: Anyone know what change(s) would be required to Tk so that these type of error message text dialogs would support copy/paste, or at least an option to save the text to a file?
DDG: This seems to be a bug inside an older (?) snit-version where it can't use "$self configurelist $args" if no options are actually declared. So Ideclared an option -dummy and it should work now for you as well. (please not the changed download link at the top).LES: Yes, it works now. Many thanks, Detlef. But, if you don't hate me yet, I wish it let me have larger fonts. The maximum size you provide still is quite a bit away from optimum.DDG: Allowed up to 22. Do you want to change the fonts in the tree and index boxes to be enlarged as well ?LV: If you decide to add the resizing of the tree/index box font size, can you make the sizing separate from that of the body font? That way, when I need a really large text, the overall size of the window still remains reasonable.LES: I'm in favor of allowing customization of as much as possible (and with that I mean that everything is possible). But, in this particular case, I am quite satisfied. Thank you very much for your attention and generosity.Whereas jcw favors just the opposite - sensible (as in: go-out-of-your-way-to-get-it-right) defaults, and absolutely minimal well-designed preference dialogs...LES: My experience with and observation of all software, mailing lists and user-base interaction environments tell me that users absolutely love the ability to customize as much as possible.DDG: the new release fullfills all desires floating around ... See the history part on top.PWQ 2005-06-01: On my X11/fvwm system, The treeview on the left has the icons over the top of the category text. Makes it somewhat hard to read. It does not depend on the gui-font selected.DDG: Thanks for this feedback. It seems to have something to do with the gtklook and an incompatibility to the BWidget Notebook. I tried to fix this in the new version. If this does not work try to run the application with:
./dgHelpBrowser.kit -fontfixand tell if this works
ABU 2005-06-07:It cannot work on my Win-XP (equipped with activeTcl 8.4.4) . Every time I run dgHelpBrowser.kit, I get the following fatal error:
integer value too large to represent while executing "read $fp [file size $name]" (procedure "::snitbrowser::Snit_method_ReadFile" line 33) ...DDG: And what occurs if you just use the recent tclkit from JCW [2]. This is a more natural choice to run starkits. An it is easy to stay up to date with TclTk using one single file.ABU: Thanks ! After downloading tclkit (built on tcl 8.4.9) problem has disappeared. dghelpBrowser is a real jewel .
MHo 2009-07-14: The problems noted above, or at least similar ones, persist. The .kit runs only with tclkit, not with activetcl 8.4.19 or 8.5.7....
DDG Unfortunately the tkhtml-library build into dgHelpBrowser is not compatible with the ActiveTcl-distros. If Tcl/Tk8.6b2 appear I will give the hv3 widget: http://tkhtml.tcl.tk/hv3_widget.html
or a pure Tcl-library a try.CliC 2011-01-05 Home page link at top is a 404. Is this package still being developed?
JOB - 2016-10-01 20:43:00The HelpViewer - based on Tkhtml2.0 is a similar approach and is actually working well with tcl/tk 8.6.
