This is the latest, and hopefully last, major release of the Info widget
posted on two other occasions to comp.sources.x. I will continute to
provide fixes and small functionality updates as necessary, of course, but
feel that this is now as featureful as it needs to be, given its intended
use.
The following changes have been made since the last release:
o Resource entry fixed; no longer coredumps on RISC machines.
o Goto function now more properly implemented.
o Info files may now be compressed to save space - as long as they
end with a .Z suffix, xinfo will automatically uncompress them for
you.
o More bugs fixed; memory no longer leaks like water through a sieve.
Whoops. Code was also cleaned up a bit more.
o Widget now subclassed from composite, not paned, making it more
portable to other widget sets. Also handles geometry management
much more effectively.
o Mouse selections in the text now supported. If something looks
interesting and you click on it, regardless of where it is,
something will happen. Maybe even what you wanted.
o Any resource that could be user specified without changing the
basic functionality of the widget has been put into the resource
database. Resources in general are now used much more effectively.
This doesn't mean that you actually need to know how to set them
(keine angst, RMS), since a reasonable set of defaults are
available (and will be automatically installed).
o The HELPFILE is gone; the help text is now a resource string. This
means you can now give your users xinfo help in Pashto or Finnish,
if you want, simply by editing the database.
o Better support for color. I.E. I thought up some reasonable
defaults that you can enable if you've got a color system.
o Various accelerators for making life easier have been added.
o A popup dialog for getting required arguments. XInfo no longer just
beeps at you and gives you a whiny message about what you should
have done, it jumps up and asks you for it.
o The following text was added (finally):
When creating the info widget, the following resources are retrieved from
the resource database:
----------
---------------------------------------------------------------------
Name Class Type Notes Default ----------
---------------------------------------------------------------------
bellVolume BellVolume Int CSG 50
callback Callback XtCallbackList CSG NULL
infoFile InfoFile String CSG XpDefaultInfoFile
infoNode InfoNode String CSG XpDefaultInfoNode
infoPath InfoPath String CSG XpDefaultInfoPath
printCommand PrintCommand String CSG XpDefaultPrintCommand
retainArg RetainArg Boolean CSG FALSE ----------
---------------------------------------------------------------------
bellVolume Determines how loud to ring the bell when something wants
to complain.
callback If specified, is called when the info widget wants to
"quit" it is left up to the caller to decide what
"quitting" means.
infoFile Which info file to read from. Generally defaults to "dir".
infoNode Which info node to try and find. Generally defaults to
"top".
infoPath Colon separated path to follow when looking for info files.
printCommand Which unix command to run when the user asks to print the
current node. This command will be run on a temporary file
containing the node's text and header information.
retainArg Determine whether or not to leave text (if any) in the
argument area around after selecting a node.
CONTENTS -------------------------------------------------------
This directory contains the sources for an "Emacs Info" browsing widget,
subclassed from the Composite widget.
The following files are important:
Info.c, Info.h, InfoP.h - Comprise the Info widget (as is customary)
xinfo.c - A simple application of the info widget (also demonstrates
usage of the quit callback).
XInfo.ad - Application defaults.
Compiling should be fairly straigtforward. You may want to edit some of the
defaults in Info.h to match the configuration at your site, though this
really should be changed in the resource database if at all possible.
Those wishing for an more elaborate view of the twisty mechanations of my
mind (regarding this code, at least) should read the NOTES file.
Questions, suggestions, bug fixes or large anonymous cash donations (all
currencies accepted) should be sent to:
Jordan Hubbard
ARPA: jkh@meepmeep.pcs.com
(OR): jkh@meepmeep.pcs.de (europe)
