Where: http://goblet.molgen.mpg.de/dgHelpBrowser.kit Description: Advanced Help Viewer for Tcl documentation, with contents tree, index lists, and bookmark panel. Currently at version 0.3.11. Currently running on Win32, Linux-x86, SunOS-sun4u, OSF1-alpha, Mac-OSX. Other platforms are provided on request. Updated: 06/2005 Contact: dgroth (at) molgen.mpg.de
DDG 2005-06-01 Version 0.3.11
DDG 2005-05-31 Version 0.3.10
DDG 2005-04-18 Version 0.3.9
DDG 2005-03-09 Version 0.3.8
2005-03-08 Version 0.3.7
2005-03-04 Version 0.3.6
2005-03-03 Version 0.3.5
20055-02-28 Version 0.3.4
14.1.2004 Version 0.3.3
BTW can anyone provide and test Mac-OSX tkhtml shared libs ?, Thanks to JCW for providing shared libs for the MacOSX-Aqua.
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.
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.
You can also send me those changes and I might include it in the next release.
6. Two things about $HOME/dgHelpBrowser.ini - first, even though it appears to be saving the font size change off, when I start the program back up again, it doesn't seem to take effect. Also, any chance the file name could be, at least on Unix, something like $HOME/.dgHelpBrowser (so it doesn't show up by default)?
DDG done on [tk windowingsystem] eq "x11" and the fontsize should be rembered also now!
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 [L1 ] 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 seperate 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 1 Jun 05, 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:
and tell if this works
ABU 7 Jun 2005 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) ...
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?