home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Shareware 1 2 the Maxx
/
sw_1.zip
/
sw_1
/
TEXT
/
DM1092.ZIP
/
MANUAL.DOC
< prev
next >
Wrap
Text File
|
1992-09-27
|
45KB
|
1,141 lines
DI$KNET Magazine - USER MANUAL - Last Updated 10/92
Copyright 1992 by InfoPress Publishing
All Rights Reserved.
┌─────────┐
┌─────┴───┐ │ (R)
──│ │o │──────────────────
│ ┌─────┴╨──┐ │ Association of
│ │ │─┘ Shareware
└───│ o │ Professionals
──────│ ║ │────────────────────
└────╨────┘ MEMBER
DI$KNet Magazine MANUAL.DOC
──────────────────
Table of Contents:
──────────────────
Introduction to DI$KNet Magazine . . . . . . . 2
Overview of HyperHelper . . . . . . . . . . . . 2
Section 1 - Getting Started . . . . . . . . . . 3
What You Need to Run HyperHelper . . . . . . 4
Making a Working Copy . . . . . . . . . . . . 4
Hard Disk Installation . . . . . . . . . . . 4
Floppy Drive Operation . . . . . . . . . . . 5
StandAlone or TSR Options . . . . . . . . . . 5
Quick Key Reference . . . . . . . . . . . . . 5
Section 2 - Using the Mouse . . . . . . . . . . 6
Mousing Around . . . . . . . . . . . . . . . 6
Close Button . . . . . . . . . . . . . . . . 6
Zoom Button . . . . . . . . . . . . . . . . . 7
Paging . . . . . . . . . . . . . . . . . . . 7
Scrolling . . . . . . . . . . . . . . . . . . 7
Resize the Window . . . . . . . . . . . . . . 7
Move the Window . . . . . . . . . . . . . . . 8
Hypertext Links . . . . . . . . . . . . . . . 8
Undo/Redo/Bookmark Concept . . . . . . . . . 10
Section 3 - Using the Keyboard . . . . . . . . 10
Keyboard Commands . . . . . . . . . . . . . . 10
Quit Commands . . . . . . . . . . . . . . . . 11
Scrolling Commands . . . . . . . . . . . . . 11
Move & Resize Window Commands . . . . . . . . 12
Link Selection Commands . . . . . . . . . . . 12
Searching for Topics . . . . . . . . . . . . 12
Section 4 - Appendices . . . . . . . . . . . . 13
Exporting Cards for Printing . . . . . . . . 13
HyperHelper Print Program . . . . . . . . . . 14
HyperHelper Configuration Program . . . . . . 14
Browser Error Messages . . . . . . . . . . . 14
Quick Help - Mouse . . . . . . . . . . . . . 15
Quick Help - Keyboard . . . . . . . . . . . . 16
Tech Support & Copyright Notice . . . . . . . 16
User Manual Page 1 of 18
DI$KNet Magazine MANUAL.DOC
─────────────────────────────────
Introduction to DI$KNet Magazine:
─────────────────────────────────
My wife recently reminded me about the way I justified spending some
serious bucks on my first computer. I swore that the computer would
empower me to do the work of three people and I could go into
business for myself. This business would earn more than enough in
it's first year to pay for all the computer equipment I was about to
lug home. That was in 1982.
It is now 1992. The enterprise I had envisioned is only now on the
horizon. I'm also writing this on my second computer purchase - an
absolute requirement if I were to stay abreast of technology. One
problem, though, two newer generations of PCs are now fighting to
become commodity items and a third generation is under development in
the labs of the chip makers.
During this onslaught of technology, between 1982 and the present, a
lot of things have happened. I've learned how to develop computer
programs that actually are doing the work of more than a dozen
people. I've gone to college and knocked out most of a degreee in
computer management. I've done my part in Operation Desert Storm.
And, I've become a grandfather. Rather an eventful decade on a
personal level.
During this same time, some fairly significant events have been
occuring in the world at large. The Iron Curtain has fallen.
Economies are undergoing shifts toward globalization. European
nations are uniting into a common market. More importantly for the
individual, however, is the increasing destabilization of the
workplace, both in the private and public sectors.
For anyone that has been asleep at the switch for a while, there is
no such thing as "job security" anymore. Thousands of workers are
finding themselves in the unemployment line each time corporate
shareholders put the squeeze on companies to increase profits by
downsizing. Budget cuts in government agencies have likewise
produced the "do more with less" mindset at the federal, state, and
local levels. I'm not talking about short-term layoffs, where the
plant shuts down for two weeks and everyone goes off "on vacation".
I am specifically referring to permanent layoffs where the jobs are
lost forever.
All of this societal upheaval has left me pondering the future for
several years now. It's not just my future, either. I'm genuinely
concerned about the folks in those unemployment lines and their
future. The way I see it, both industry and government are turning
their collective backs on those people. How long before the same
happens to you or me?
User Manual Page 2 of 18
DI$KNet Magazine MANUAL.DOC
This leads me to the reasons I started DI$KNet Magazine. I believe
self-employment is the answer to an uncertain future for many, myself
included. I believe people need help understanding the capabilities
of new technologies and how to apply them effectively in starting and
operating new businesses. They need help from the practicioners that
use technology tools every day, not from journalists.
With every issue of this publication, I will show you how you can
equate PC to Profitable Computing. I'll share the experience and in-
sights of myself and others in ways to leverage your technology
investment. DI$KNet Magazine will be an interactive publication
unlike any you've experienced. From humble beginnings, I am forming
a distribution network to support on-going dialogue with my readers,
enabling me to deliver the information you need to grow efficient,
profitable businesses.
Many of you already possess skills and expertise far superior to my
own. You may choose not to register for a subscription as a result.
That's understandable. At the same time, consider sharing some of
your knowledge. Tell me about the new PC technology I've yet to
discover that will affect my readers. I'm always open to new ideas
and new applications. Frankly, I wouldn't mind publishing a magazine
that is "of the people and for the people."
Let me welcome all of you to the Premier Issue of DI$KNet Magazine.
Our editorial focus for this issue is intentionally narrow and in-
depth. As we grow, so will the breadth of our coverage. I invite
any and all Letters To The Editor with your feedback on the content
of this or future issues. I hope you find my publication of benefit.
Best Regards,
Rick Bryan, Editor/Publisher
User Manual Page 3 of 19
DI$KNet Magazine MANUAL.DOC
────────────────────────
Overview of HyperHelper:
────────────────────────
HyperHelper is the hypertext authoring system used by InfoPress
Publishing to develop the program you are using. Hypertext is a
relatively new way of viewing documents on your computer, in much
the same way as you would browse through a book or magazine in
printed form.
Using hypertext links, embedded in the text you see on your
screen, you can quickly jump to another place in the document
which contains related material. You will also see special com-
mand links in the menu bar at the top of your screen. These
links offer more power and flexibility in viewing this program.
HyperHelper breaks a file into pieces, referred to as "cards".
All of the cards from any given file are then compiled into a
"deck". Any card may contain text that exceeds the width or
height of you screen. But, you will still be able to view all
the contents of each card, regardless of size.
HyperHelper gives you a "history" capability by remembering the
most recent cards you have viewed. If you want to go back to a
previous card, you can. Also, a bookmark feature is included,
allowing you to move backward and forward through the cards you
have read.
We are confident you will enjoy using HyperHelper and encourage
you to explore its capabilities. The keyboard commands are very
simple to learn and are likely to be similar to many popular
applications you already own. For those of you that use a mouse,
HyperHelper is outright fun!
───────────────────────────
Section 1 - Getting Started
───────────────────────────
This section tells you how to install HyperHelper. It tells you
how to quickly get started using your program, also.
TOPICS COVERED
──────────────
What You Need to Run HyperHelper
Making a Working Copy
Hard Disk Installation
Floppy Drive Operation
StandAlone or TSR Options
Quick Key Reference
User Manual Page 4 of 19
DI$KNet Magazine MANUAL.DOC
─────────────────────────────────
What You Need to Run HyperHelper:
─────────────────────────────────
Minimum Requirements
────────────────────
IBM PC or compatible computer
DOS 2.1 or greater
256K RAM
Any standard monochrome or color monitor
(graphics card not required)
One floppy drive, or
Hard disk (recommended)
Unless otherwise noted in the README.DOC file, this program
runs in text mode (not graphics) and supports most display
sizes (80x25, 80x50, etc.)
──────────────────────
Making a Working Copy:
──────────────────────
If you intend to run HyperHelper from a floppy drive, we strongly
recommend you make a working copy of your program disk, using the
DOS DISKCOPY command (or utility program of your choice). Refer
to your DOS manual, if you are not sure how to proceed. Place
the original in a safe place away from small children, magnets,
and ill-behaved pets.
───────────────────────
Hard Disk Installation:
───────────────────────
To load the program from your distribution disk onto your hard
disk, follow the steps outlined below:
1. Create a directory for the program files.
2. Change to the directory you just created.
3. Insert your distribution disk into drive A (or B).
4. Copy the distribution disk onto your hard disk.
5. Check the README.DOC for program startup instructions.
A sample set of commands to accomplish these steps might look
like this (assuming "C" is your hard drive):
C:\>MD HFORUM<Enter>
C:\>CD HFORUM <Enter>
C:\HFORUM>COPY A:*.* <Enter>
C:\HFORUM>TYPE README.DOC|MORE <Enter>
User Manual Page 5 of 19
DI$KNet Magazine MANUAL.DOC
The "|MORE" switch will page the README.DOC file one screen at a
time. Hit any key to view the next page.
───────────────────────
Floppy Drive Operation:
───────────────────────
If you plan to run HyperHelper from your floppy drive, place your
distribution disk in drive A (or B), then type:
A:\README.DOC|MORE <ENTER>
or
B:\README.DOC|MORE <ENTER>
The README.DOC file will contain instructions to start your program.
──────────────────────────
StandAlone or TSR Options:
──────────────────────────
The HyperHelper browser (aka viewing program) allows your program
to run in stand-alone mode from the command line. However, you
may prefer to view your program from the the TSR (Terminate-Stay
Resident) mode. Whatever your preference, we have included
batch files that automate program startup for you.
When in TSR mode, your program and HyperHelper are loaded into
memory - no more than 58K of RAM - for later viewing. You can
start your program by holding the ALT key, and pressing the
period key (ALT─Period). This hot─key combination can be modi-
fied with the HyperHelper Configuration Program, provided upon
registration of your program.
────────────────────
Quick Key Reference:
────────────────────
If you are anxious to start using this program and don't want to
take the time to read the documentation, highlight the word
'Help' in the top-line menu and press Enter. F1, H, or h will
also work. This will call up a brief overview of the basic
commands, an explanation of the screen layout with mouse
commands, and additional keyboard commands you can use.
The Quick Key Reference is always available from any screen in
this program. We do suggest you take the time, at some point, to
read through the documentation, as it is provided to help you get
the most from this program.
User Manual Page 6 of 19
DI$KNet Magazine MANUAL.DOC
───────────────────────────
Section 2 - Using the Mouse
───────────────────────────
This section tells you how to control HyperHelper with the
point-and-shoot approach of your mouse.
TOPICS COVERED
──────────────
Mousing Around
Close Button
Zoom Button
Paging
Scrolling
Resize the Window
Move the Window
Hypertext Links
Undo/Redo/Bookmark Concept
───────────────
Mousing Around:
───────────────
The HyperHelper browser window has a number of "hot spots" which
allow the mouse to totally control your viewing of the program.
These "hot spots" (also called buttons) may not appear if the
mouse isn't currently being used.
Mouse operation with HyperHelper is no different than with other
programs. The phrase "clicking the mouse" means to press down
the left mouse button and then release it. When we say "click
and drag", you should press and hold down the left button while
moving the mouse cursor around. The right mouse button is used
only for paging up.
─────────────
Close Button:
─────────────
Check the top left hand corner of your screen. Notice the small
box directly above the three horizontal lines? That's the close
button. Clicking the mouse on this button will close the Hyper-
Helper window and exit the program.
User Manual Page 7 of 19
DI$KNet Magazine MANUAL.DOC
────────────
Zoom Button:
────────────
Now look at the top right hand corner of your screen. The double
up─down arrow is the zoom button. Repeatedly clicking the mouse
on the zoom button will make the window alternate between the
largest and smallest sizes.
───────
Paging:
───────
Next, check the lower left hand corner of your screen. The num-
ber in the corner represents the current card number, but can
also be used by the mouse to page up or page down. Clicking the
left mouse button on this number displays the next card, in num-
bered sequence. Clicking the right mouse button will display the
previous card, again in numbered sequence.
──────────
Scrolling:
──────────
As we mentioned earlier, the text in any given card can exceed
the width and height limitations of your screen. When this hap-
pens, HyperHelper automatically places scroll bars on the right
side and bottom of the window on your screen. Each scroll bar
has two arrows and an elevator button. The elevator button tells
you where you are in the text, relative to the total amount of
text in the card.
Clicking the mouse on an arrow scrolls the text in the appropri-
ate direction, one character at a time. Hold down on the mouse
button to scroll continuously. You can click and drag the eleva-
tor buttons from top to bottom, or side to side.
You can also jump through the text on the card by positioning the
mouse on the scroll bar where no buttons appear and clicking.
This is one of the fastest way to view oversize cards.
──────────────────
Resize the Window:
──────────────────
The dot in the lower right hand corner functions as a resize
button. Clicking and dragging on this dot allows you to shrink
or stretch the window to any size you desire. Releasing the
User Manual Page 8 of 19
DI$KNet Magazine MANUAL.DOC
mouse button allows the window to assume its new size. Notice
the dashed rectangle that appears as you are re─sizing your
window.
────────────────
Move the Window:
────────────────
The window can be moved on your screen as long as it is smaller
than full size. Position your mouse anywhere on the border that
you don't see a scroll bar or button. Now, simply click and drag
with the mouse to move your window. There's that dashed rectan-
gle again, to help you in positioning the window location.
────────────────
Hypertext Links:
────────────────
The real power and flexibility of HyperHelper is found in the
hypertext links on your screen. There are two types of links:
menu bar links which appear at the top of every screen; and, text
links which appear in the body of the text on a card.
Menu bar links typically perform a command that links you to some
part of the deck you are viewing. Working from left to right as
you view the menu bar on your screen, these links perform the
following functions:
This link takes you to the last card of any deck, which
includes a copyright notice from InfoPress Publishing.
This card also tells you how to contact us for support.
TOC This is the Table of Contents link. The TOC link helps
you view a deck in sequential order. When you use this
link, you are taken to the TOC and the link for the next
topic to be read is highlighted. The TOC link also serves
as a handy map of where you are in your deck.
Undo This link allows you to move backwards through the history
in a sequential manner to see the last 25 cards you viewed.
Anytime you link to another card using a text link, you
can return to the spot you just left by using this link.
Redo If you have used the Undo link at least once, the Redo
link moves you forward through the history. With up to 25
cards in the history, you should have enough flexibility
to view every link on a related topic and return to the
point you started from. It's a lot tougher to explain it
User Manual Page 9 of 19
DI$KNet Magazine MANUAL.DOC
than it is to understand, once you've tried it yourself.
Maybe this picture will help you grasp the concept.
Srch The Search command will open a small window and allow you
to perform a search for a topic. Two types of searches
can be performed, prefix and sub-string. Select the type
of search desired and type in the topic you are searching
for. If your topic is found in the deck, the link is
automatically traversed. If the keyword doesn't exist, a
pick list of topics will be presented for your selection.
You are free to choose from the list, or hit ESCape to end
your search. By the way, keyword searches are not case-
sensitive; both upper- and lowercase are acceptable. Do a
search for the word "search" for more details.
Mark The Mark link is used to place a bookmark on the card you
are viewing. This allows more selective review than the
Undo history, with up to seven bookmarks of your choice.
Export The Export link allows you to copy the contents of the
card you are viewing into a separate file on your com-
puter. This lets you print a hard copy of the card for
reference purposes.
Help The Help link will bring up a Quick Key Reference to get
you started using this program with either mouse or key-
board commands.
Quit Don't need to say much here, do we? This will end your
viewing session and return you to DOS.
Text links transform your on─screen viewing into 3─dimensional
viewing by allowing you to rapidly traverse from one part of the
text to another (and back). They are normally used to link you
to another card with material which relates to the card you are
viewing.
As you get ready to traverse a link, look at the card number in
the lower left hand corner of the window. After using the link,
check the number again. Don't be surprised if you have instantly
moved from card number 4 to card 150!
Using links with a mouse is so easy it is actually enjoyable.
Just position the mouse cursor on the menu bar or text link you
wish to traverse and click the left button. You're there in the
blink of an eye! Don't forget, anytime you have traversed a text
link, you can return immediately to your starting point by using
the Prev link in the menu bar.
User Manual Page 10 of 19
DI$KNet Magazine MANUAL.DOC
──────────────────────────
Undo/Redo/Bookmark Concept
──────────────────────────
First Screen
SEQUENTIAL Viewed SELECTIVE
────────── ╔══════════════════════╗ ─────────
║ Grocery Store Tape ║ MARK (F)orward
REDO ║ ║
║ Apples $ 3.98 ║
║ Oranges 2.49 ║
║ Beans .79 ║
║ Corn 3.15 ║
║ Lettuce .89 ║
║ Ceral 2.79 ║
║ Bread 1.39 ║
║ Milk 1.98 ║
║ Sugar 2.50 ║
UNDO ║ TOTAL $19.96 ║ MARK (B)ack
╚══════════════════════╝
Last Screen Viewed = BookMark
──────────────────────────────
Section 3 - Using the Keyboard
──────────────────────────────
This section tells you how to control HyperHelper using simple,
but powerful, keyboard commands.
TOPICS COVERED
──────────────
Keyboard Commands
Quit Commands
Scrolling Commands
Move & Resize Windows
Link Selection Commands
Searching for Topics
──────────────────
Keyboard Commands:
──────────────────
HyperHelper is extremely easy to use, even if you don't have a
mouse. Note that Shift and Alt key combinations require you to
hold down on either the Shift or Alt keys and press another key
at the same time. All available keyboard commands are described
in the table below:
User Manual Page 11 of 19
DI$KNet Magazine MANUAL.DOC
Key Description
──────────────────────────────────────────────────────────
U ................. Undo the last jump
R ................. Redo the last jump undone
B ................. Go backwards on the bookmark tape
F ................. Go forwards on the bookmark tape
T ................. Go to the top of the current section
Ctrl-Home ......... Table of Contents/current card toggle
H, F1 ............. Display the Help card
O ................. Open a different hypertext deck
E ................. Export card text
P ................. Print card text
Shift-Ins ......... Paste card text to foreground
PgUp .............. Go to the previous page
PgDn .............. Go to the next page
Ctrl-PgUp ......... Go to the card before this one
Ctrl-PgDn ......... Go to the card after this one
S ................. Search for topics
Q, Esc, Ctrl-Esc .. Quit the browser.
Z ................. Zoom the window size
Space, Tab ........ Move forward to next visible link
BackSpace, Shift-Tab Move backward to next visible link
Alt-Space ......... Activate first menu link
F10 ............... Go to menu
Alt-<X> ........... Activate menu entry having <X>
as bold letter
Note: Lower case works for letter commands as well.
Any item on the top line menu can be executed by pressing the ALT
key and the first letter of the item, except the link to the last
card. This link is located on the far left side of the menu bar.
──────────────
Quit Commands:
──────────────
If you want to leave HyperHelper and return to another applica-
tion, but still want to see what's on the card you are viewing,
use ALT─X to quit. Otherwise, exit by pressing the q, Q, or ESC
keys.
───────────────────
Scrolling Commands:
───────────────────
The arrow keys are used to scroll through the text on a card or
to move between links. If you press an arrow key and a link be─
comes visible, the link will automatically be highlighted. If
User Manual Page 12 of 19
DI$KNet Magazine MANUAL.DOC
you simply want to scroll through the text, ignoring the links,
use the Shift─Arrow combination.
──────────────────────────────
Move & Resize Window Commands:
──────────────────────────────
The browser window can be moved or re─sized by using the w or W
keys to enter "window mode". Pressing W once places you in the
move mode, while pressing W twice puts you in the resize mode.
The arrow keys are then used for moving or re─sizing.
In re─sizing mode, a dashed rectangle will flash around the win-
dow border. In move mode, a double, solid line border will flash
around the window border. After moving or re─sizing to suit your
preference, press Enter to retain the new size or location.
────────────────────────
Link Selection Commands:
────────────────────────
To select a link, use the arrow keys to move the highlight bar
over the link you wish to traverse. Then press Enter. Both menu
bar links and text links can be executed in this manner. The up
and down arrow keys move you through the text links, and the left
and right arrow keys move across the menu bar links.
─────────────────────
Searching for Topics:
─────────────────────
The card deck may be searched for topics, if they were pro-
grammed into the deck. Topics can be thought of as an index in
the back of a book. Like indexes, topics are used to quickly
locate information within your program deck.
Using the s or S command will open a Topic Search window with a
dialog box. First, you must select the type of search to be per-
formed. The three possible choices are:
Prefix - The text you enter will attempt to match a topic with
a similar prefix.
Substring - The text you enter will try to match with similar
text located anywhere within a given topic.
Last - This choice simply brings up the last topic pick list
window you used.
User Manual Page 13 of 19
DI$KNet Magazine MANUAL.DOC
After choosing the type of search you want, type in the word or
words you would like to match. Note, search terms are not
case─sensitive; both upper─ and lowercase are acceptable. Press
Enter or click the left mouse button. HyperHelper then searches
the topics database and displays the card with a matching topic.
If no exact match is found, another window will be displayed with
a pick list of all candidate topics, sorted in alphabetical
order. The closest match found during the search will be high-
lighted. You may choose a topic from this list or cancel the
search.
With prefix searches, if no match is found, the topic with the
closest match is highlighted. All of the topics in the deck are
included in the pick list. With substring searches, if no match
is found, you will receive an error message. If more than one
match is found, only those topics containing the search term you
entered will appear in the pick list. As a general rule of
thumb, prefix searches are considered faster than substring
searches.
──────────────────────
Section 4 - Appendices
──────────────────────
Exporting Cards for Printing
HyperHelper Print Programs
HyperHelper Configuration Program
Browser Error Messages
Quick Help - Mouse
Quick Help - Keyboard
Tech Support & Copyright Notice
─────────────────────────────
Exporting Cards for Printing:
─────────────────────────────
Cards can be exported individually to a file on your computer for
subsequent printing. An export link can be executed by entering
e or E from the keyboard. You can also use the arrow keys to
move the highlight bar over the Export link in the top-line menu
bar and press Enter, or move your mouse cursor to this link and
click the left mouse button.
This pops-up the Export window, prompting you for an output file
name. The file name, including path name for drive and directory
(if desired), are typed into the edit field of the window. While
in the edit field, the arrow keys let you move left or right, and
the BackSpace and Delete keys can be used to delete characters.
User Manual Page 14 of 19
DI$KNet Magazine MANUAL.DOC
The Insert key will let you toggle between insert and overwrite
modes. The Home key takes you to the beginning of the field, and
the End key takes you to the end of the field.
Press Enter when you're finished, to save the card to file, or
press ESCape at any time to abort the Export operation. Please
respect our copyright and export cards for your reference only.
──────────────────────────
HyperHelper Print Program:
──────────────────────────
The HyperHelper print utility HP can be used to print out one or
all of the cards in a compiled deck. The output is directed to
standard output (the screen), which you can then redirect to a
file or to the printer. To run HP, type the following from the
command-line:
hp [options] hypertext_file
Note: An extension of .htx is assumed on the hypertext file.
Here are some quick examples:
hp -n 15 hforum Prints card #15 to screen
hp -n 15 hforum > prn Prints card #15 to printer
hp hforum > hforum.doc Writes the whole deck to hforum.doc
The options available for HP are:
-n <c> Print only the specified card. (The default is
to print all cards).
-n <b> <e> Print the cards in the range from <b> to <e>.
-sc Print each card's number (ie. deck position)
after the caption.
-pl <n> Sets the page length to <n> lines. (The default
is 55 lines.) A form feed character is inserted
between each page.
-sp Turns on "smart" paging, where cards that will
fit on a page are never split across pages.
-ps <n> Starts a new page for all cards having section
levels less than or equal to n. (The default is 0).
User Manual Page 15 of 19
DI$KNet Magazine MANUAL.DOC
-np Don't page at all. That is, no form-feed characters
are ever sent.
──────────────────────────────────
HyperHelper Configuration Program:
──────────────────────────────────
This program is a HyperHelper utility that gives you total con-
trol over the HyperHelper configuration on your computer. It is
fully menu─driven and allows you to change the settings on the
following:
Border Style Snow Checking
Colors Mouse Action
Shadows History Size
Scroll Bar Style Hot Key Definition
Card Selection on Pop─Up
The HyperHelper configuration utility HHCFG allows you to easily
experiment with and change the configuration of the browser.
With HHCFG, you can retrieve and store the configuration data
within the browser program itself. Alternatively, you can read
and write batch files which specify command-line options for
the configuration. You can even mix these modes: reading from a
program file and writing to a batch file, and vice versa. Thus,
HHCFG allows you to easily copy, modify, and transfer configura-
tion data between program files and batch files.
Tip: Make changes to the browser program file when you wish to
use the same options over and over as the default set. Create
batch files when you want to have several sets of options for the
same browser.
To run HHCFG, use the following command-line:
hhcfg infile [outfile]
The input file can be a batch file (having a .bat extension),
or any HyperHelper browser program. Actually, you can use
any program file that has the proper configuration data. For
example, HHCFG will work on a combined browser/deck. It will
even work on itself! The HHCFG utility will determine if the
file is valid and will give you an error message if it's not.
WARNING: Do not use HHCFG on a packed browser program file,
(such as those created by EXEPACK, or LZEXE). Attempting to do
so may corrupt the file.
User Manual Page 16 of 19
DI$KNet Magazine MANUAL.DOC
If you specify a batch file as input, it must contain proper
command-line options as given on the HyperHelper Browser Options
card. One way to ensure this is to first create the batch file
with HHCFG.
The output file can be either a program file or a batch file.
If you don't specify an output file, then the input file will
be used for output as well.
When specifying files on the command-line, you may use the
appropriate extensions, or let HHCFG try to figure them out.
For example:
hhcfg hforum Use hforum for input and output
hhcfg hforum blue Use hforum for input, blue.bat
for output
hhcfg hforum.exe blue.bat Same as previous line
If the output is to a program file, the configuration data will
be stored inside the file. This configuration data is used as
the default set of options for the browser. You can override
these defaults from the command-line when you execute the
browser. For example, you might use a batch file created with
HHCFG to override the default options.
If the output is to a batch file, a list of command-line options
will be written. The browser program to call in this batch file
is determined by the input file to HHCFG. For instance, if the
input file is hforum.exe, then hforum will be used as the program
name in the output batch file. If the input file is a batch file,
then the program name is determined from the first word stored in
the batch file.
───────────────────────
Browser Error Messages:
───────────────────────
As with any program, it is possible you may occasionally receive
an error message. You are most likely to receive error messages
when one of our program files has been corrupted or the name of
the file has been changed. We strongly recommend you make backup
copies of any of our programs onto floppy disks, in order to re-
cover from such events with the least amount of effort.
Error opening file: The file to be opened either does not exist
or isn't located on the drive/directory specified.
User Manual Page 17 of 19
DI$KNet Magazine MANUAL.DOC
Seek error or Read/write error: An error occurred while accessing
the hypertext file. Usually caused by a mangled hypertext or
source file, but could also indicate a disk drive problem. If
you can't get this error to go away and you're sure it's not your
disk drive, contact InfoPress Publishing for technical support.
Invalid htx file-Sync byte missing or Invalid htx file-Data mis-
match: The hypertext file is corrupted. Copy new file from the
backup you made and try again. If problem persists, contact
InfoPress Publishing for technical support.
Not enough memory: The browser couldn't allocate enough memory
to continue execution. The browser requires anywhere from 40 to
58k of memory, depending on the configuration.
Invalid path: The given path has an invalid drive or directory
specified. Check for spelling errors or improper floppy drive
operation.
No match found: The topic searched for was not found in the
topic database.
──────────────────
Quick Help - Mouse
──────────────────
If you have a mouse, you can click on the hot spots
as indicated in the following figure:
Menu Entry ──────┐
│ Zoom
┌─ Close Button │ Button ┐
│
┌────────────────────────────────────────┐
│ Contents Undo Srch Help Quit ── Scroll Arrow
│───────────────────────────────────────────░
│ Card test goes here. Here's a hyper- ▓ ── Elevator Button
│ text link to take you back. ░
│
└125─░░░░░░░░░░░░░░░░░░░░░│░░░░░░░░░░░░░░░ ┘ ── Resize Corner
│
└── Card/paging button └── Hypertext link
User Manual Page 18 of 19
DI$KNet Magazine MANUAL.DOC
─────────────────────
Quick Help - Keyboard
─────────────────────
U ................. Undo the last jump
R ................. Redo the last jump undone
B ................. Go backwards on the bookmark tape
F ................. Go forwards on the bookmark tape
T ................. Go to the top of the current section
Ctrl-Home ......... Table of Contents/current card toggle
H, F1 ............. Display the Help card
O ................. Open a different hypertext deck
E ................. Export card text
P ................. Print card text
Shift-Ins ......... Paste card text to foreground
PgUp .............. Go to the previous page
PgDn .............. Go to the next page
Ctrl-PgUp ......... Go to the card before this one
Ctrl-PgDn ......... Go to the card after this one
S ................. Search for topics
Q, Esc, Ctrl-Esc .. Quit the browser.
Z ................. Zoom the window size
Space, Tab ........ Move forward to next visible link
BackSpace, Shift-Tab Move backward to next visible link
Alt-Space ......... Activate first menu link
F10 ............... Go to menu
Alt-<X> ........... Activate menu entry having <X>
as bold letter
Note: Lower case works for letter commands as well.
─────────────────────────────────
Tech Support and Copyright Notice
─────────────────────────────────
Copyright 1992 by InfoPress Publishing
All Rights Reserved Worldwide
For unique publishing solutions, please contact:
InfoPress Publishing
P.O. Box 282107
Columbus, OH 43228-2107
Phone: 614-878-4957
or send E-Mail to CompuServe ID 73210,544.
Portions of this program are:
Copyright (c) 1988-1991 by Azarona Software
User Manual Page 19 of 19