Article # 25, added by Geoworks, historical record
| first | previous | index | next | last |

How to enable help editor in GeoWrite, and contexts not mentioned that need to be supported.



The best editor I've found for making help files for geodes is GeoWrite,
especially after it's been updated by the Bindery upgrade. Once GeoWrite
has been updated by Bindery, it has the "Clear All Hyperlinks" and "Clear
All Contexts" which are very useful features. But even so, if you only
have GeoWrite you will be able to create and maintain help files. I
recommend against using Bindery itself, since the help files that in
generates cause crashes on the OmniGo when you use text styles. 

Once you've got GeoWrite as an editor, you'll have to turn on the "Help
Editor" feature, if you haven't done so already. To do this, look in the
GEOS.INI file and find the [configure] section. If there isn't one, create
it by typing "[configure]" on a lin e by itself. Then add the line
"helpEditor=true" right below "[configure]". Now boot GEOS and start
GeoWrite. Click on the Options menu and select "Change User Level", then
click on the Fine Tune button. At the end of the list of options you
should see "H elp Editor". Turn this feature on, if it isn't already.
Click on Ok, then click on the Ok in the "Change User Level" dialog, and
now you should see a "Help Editor" menu in GeoWrite. Don't forget to
select "Save Configuration" in the Options menu. 

Now you can begin writing the help file. The Help Object Library chapter
in the Objects Reference will guide you through creating a help file. Now
on to more complex issues. 

You should know that there are many contexts in GEOS that are not
mentioned anywhere. For instance, if you create a geode that has a
PrintControl object in it, you will have a "dbPrint" context in that
PrintControl. That means when the user of your progra m brings up the
Print box, they can click on the ? button and get help on printing.
However, GEOS does not provide the dbPrint help context, you have to. That
means you have to define a context somewhere in your help file with the
name "dbPrint". 

There's more of these secret contexts. Most I've found are related to
using the GenDocumentControl. Here is a list of them, with a brief
description: 

dbDCBig - The main GenDocumentControl dialog, with the New, Open, Template, Exit.
dbDCOpen - The dialog for opening a file.
dbDCSaveAs - The dialog for saving a file under a new name.
dbDCCopy - Dialog for copying the document to another directory.
dbDCGetPass - The dialog for getting a password on a locked document.
dbDCSetPass - The dialog for setting the password to lock a document.
dbDCRename - Dialog for renaming the document.
dbDCSetType - The dialog for setting the document type.