home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Black Box 4
/
BlackBox.cdr
/
desktop
/
apcal310.arj
/
APCAL.HLP
< prev
next >
Wrap
Text File
|
1992-01-02
|
35KB
|
653 lines
APCAL_HLP_V3.10 m
<HLP_GRP00001>
General Help Page 1 of 6
This program contains functions for displaying yearly and monthly
calendars; editing and printing monthly calendars and daily appoint-
ments; and setting alarms to remind yourself of important events.
Throughout the help text in this program the convention used to denote
when 2 keys must be pressed at the same time is to combine them with
a plus (+) sign. For example Alt+d indicates to press and hold down
the Alt key and then press the d key. Then release both. The arrow
keys are denoted by Right, Left, Up and Down.
PULL DOWN MENU
--------------
The pull down menu at the top of the screen has several options which
can be used throughout the program. To activate this menu press the
Alt key. This will highlight the "File" field. The right and left
arrow keys can be used to move from one field to another. To pull
down the sub-menu for a field press the Enter key. Pressing one of
the bold characters on the top line of the pull down will move
to that field and pull down its sub-menu. If a sub-menu is already
pulled down then the bold characters on the top line are no
<HLP_GRP00002>
General Help Page 2 of 6
longer active. The up and down arrow keys can be used to move from
one sub-menu field to another. Pressing Enter selects the currently
highlighted sub-menu field. Pressing the bold character of one
of the sub-menu fields automatically selects it. Pressing Esc exits
the pull down without making a selection. Once a selection is made
or Esc pressed the appropriate action is taken and control is returned
to the main menu below.
When a field in the pull down menu is not currently active it is dis-
played in a different color (usually dark grey on most color monitors
and totally blacked out on monochrome monitors). Selecting one of
these fields does nothing.
The following sections describe the main menu fields of the pull down
menu. The "Edit" section is different depending on what section of
the program you are in. It is described in the help for each section.
Some of the pull down options can be executed directly without going
through the pull down, these options list the appropriate key(s) (to
the right in parenthesis) to type to execute the command directly.
<HLP_GRP00003>
General Help Page 3 of 6
Files
-----
The files section of the main pull down has the following options:
Save, Delete, Print, Dos Shell and Exit.
Save - Saves the currently displayed appointment, monthly calendar or
alarm file.
Delete - Deletes the currently displayed appointment, monthly calendar
or alarm file.
Print - Prints the currently displayed appointment or monthly calendar
file.
Dos Shell - Temporarily brings up the DOS command line. It is import-
ant to remember to type "exit" when you are done to return to the
program since it is still taking up memory. If you wish to perma-
nently leave the program use the "Exit" selection below.
Exit - Ends the program and unloads it from memory.
<HLP_GRP00004>
General Help Page 4 of 6
Options
-------
The options section of the main pull down has the following options:
Appointments (F2), Alarm (F3), Month Calendar (F4), Year Calendar
(F5) and Month/Appt. (F6).
Appointments - switches to the appointment edit screen. The appoint-
ment file for the currently selected date is displayed.
Alarm - switches to the arbitrary alarm edit screen. The arbitrary
alarms for the currently selected date (if any) are displayed.
Month Calendar - switches to the monthly calendar edit screen. The
monthly calendar for the currently selected date is displayed.
Year Calendar - switches to the yearly calendar display.
Month/Appt. - switches to the split screen month/appointment display.
<HLP_GRP00005>
General Help Page 5 of 6
Search
------
The search section of the main pull down has the following options:
Forward (F7) and Backward (Shift+F7). This pull down sub-menu is only
active when the split screen month/appointment display is active.
Forward - search for the given text in appointment files after the
current date.
Backward - search for the given text in appointment files before the
current date.
<HLP_GRP00006>
General Help Page 6 of 6
Program Config.
---------------
The configuration section of the main pull down has the following
options: Color, Appointment Template, Printer, Holidays, Start Screen
and Alarm.
Color - configures the program colors.
Appointment Template - configures the default appointment screen.
Printer - configures printer parameters.
Holidays - configures the holidays that are automatically built into
the monthly calendars when the are first created.
Start Screen - configures the first screen that appears when the pro-
gram is loaded.
Alarm - configures the alarm parameters.
<HLP_GRP00201>
Appointment Help Page 1 of 5
For help on other topics exit this screen by pressing the Tab key
until the END field is highlighted and press Enter. Then press Alt+h
(press ALT and the h key at the same time) to bring up the help pull
down menu. Use the up and down arrow keys to highlight the desired
topic and press Enter. If this is your first time in APCAL then you
should probably select the "General" topic.
The appointment edit screen is used to enter your schedule for the
currently selected date. If a previous schedule was saved for this
date then it will appear. If not, then the appointment template will
be displayed (see "Configuration" help).
The arrow keys are used to move around the screen. Appointment text
can be typed into each appointment slot. The File options on the pull
down menu can be used to save, print and delete the appointment file.
<HLP_GRP00202>
Appointment Help Page 2 of 5
The following keys can be used in the appointment edit screen. Some
of these can also be selected from the pull down menu.
Insert toggles insert mode on and off.
Delete deletes the character at the current cursor position.
Home moves to the beginning of the appointment line.
End moves to the end of the appointment line.
Backspace moves the cursor left and deletes the character at that
position.
Enter moves to the beginning of the next line.
F1 brings up this help screen.
F3 switches to the arbitrary alarm screen.
F4 switches to the monthly calendar screen.
F5 switches to the yearly calendar screen.
F6 switches to the split screen month/appointment display.
F9 is used to toggle editing of the time fields.
<HLP_GRP00203>
Appointment Help Page 3 of 5
Alt activates the pull down menu. Pressing Alt plus one of the
bold characters in the top pull down line activates that
pull down menu.
Alt+c copies the current line to a scratch buffer.
Alt+m copies the current line to scratch and then erases it.
Alt+i overwrites the current line with the contents of the
scratch buffer created by the last Alt+c or Alt+m.
Alt+d deletes the characters from the cursor position to the end
of the line.
Alt+l deletes the current line.
Alt+a brings up the alarm parameter menu for the appointment at
the current cursor position.
<HLP_GRP00204>
Appointment Help Page 4 of 5
To set/remove an alarm for the appointment at the current cursor posi-
tion press Alt+a. This brings up the appointment alarm menu. The
first field in the alarm menu toggles the alarm ON and OFF. Press the
space bar to toggle between the 2 values. Tab moves to the next field
and Shift+Tab moves to the previous. The next field sets the number
of minutes before the appointment the alarm will sound. Entering any-
thing other than an integer number of minutes causes a beep and the
field cannot be exited until an integer is entered. The duration
field sets the number of minutes the alarm will continue to sound if
it is snoozed. It must also be an integer.
For example if the current appointment time is 2:00 pm and the number
of minutes before value is set to 15 and the duration is set to 15
then the alarm will sound at 1:45 pm. If Alt+s is pressed when the
alarm sounds then the alarm will snooze for the time period set in the
alarm configuration. If this value is 5 then the alarm will sound
again 5 minutes from the time at which Alt+s was pressed. This con-
tinues until Alt+e is pressed or the time is later than 2:00 pm (1:45
plus the 15 minute duration).
<HLP_GRP00205>
Appointment Help Page 5 of 5
Pressing Enter on the OK field sets the alarm using the entered para-
meters and ends the alarm menu. Pressing Enter on the CANCEL field
ends the alarm menu and discards any changes made to the parameters.
Pressing Esc on any field has the same effect.
Appointments with alarms have a check in the alarm column. Up to 10
alarms can be set for any day. This includes any alarms set in the
arbitrary alarm menu.
<HLP_GRP00301>
Arbitrary Alarm Help Page 1 of 4
For help on other topics exit this screen by pressing the Tab key
until the END field is highlighted and press Enter. Then press Alt+h
(press Alt and the h key at the same time) to bring up the help pull
down menu. Use the up and down arrow keys to highlight the desired
topic and press Enter. If this is your first time in APCAL then you
should probably select the "General" topic.
There are 2 types of alarms that can be set in this program: Appoint-
ment alarms and Arbitrary alarms. The appointment alarms are assoc-
iated with an appointment and are set in the appointment edit screen.
Arbitrary alarms are arbitrary in the sense that they can be set for
any time range and are not associated with an appointment.
The top portion of the arbitrary alarm screen consists of the message
text for each alarm set for the current date. The arrow (->) at the
left points to the selected alarm. The parameters associated with
this alarm are displayed in the box in the bottom portion of the
screen. The up and down arrow keys can be used to select other alarms
in the list. The File options on the pull down menu can be used to
save and delete the alarm file for the currently selected date.
<HLP_GRP00302>
Arbitrary Alarm Help Page 2 of 4
The following keys can be used in the arbitrary alarm screen. Some
of these can also be selected from the pull down menu.
F1 brings up this help screen.
F2 switches to the appointment screen.
F4 switches to the monthly calendar screen.
F5 switches to the yearly calendar screen.
F6 switches to the split screen month/appointment display.
Alt activates the pull down menu. Pressing Alt plus one of the
bold characters in the top pull down line activates that
pull down menu.
Alt+a adds another alarm.
Alt+d deletes the currently selected alarm.
Alt+m modifies the currently selected alarm.
When Alt+a or Alt+m is pressed the parameter menu at the bottom of
the screen is activated. These parameters can then be edited. Alt+a
adds a new alarm and Alt+m allows the modification of the parameters
for the currently selected alarm. Tab moves to the next field and
Shift+Tab moves to the previous field in this menu.
<HLP_GRP00303>
Arbitrary Alarm Help Page 3 of 4
The first field in the alarm parameter menu determines whether the
alarm is a REGULAR or BOOT alarm. The space bar toggles between the
2 values. Regular alarms occur for the time interval given in the
start and end time fields. Boot alarms occur when the computer is
first booted and continue until midnight unless terminated.
The start time fields set the time when the alarm will first sound
if it is a REGULAR alarm. The hours field must be an integer between
1 and 12 and the minutes field must be an integer between 0 and 59.
Entering anything else causes a beep and the field cannot be exited
until a valid integer is entered. The last field on the start time
line indicates whether the time is am or pm. Use the space bar to
toggle between the 2 values.
The end time sets the end of a REGULAR alarm. The fields have the
same restrictions as the start time fields.
The start and end time are not set for BOOT alarms.
<HLP_GRP00304>
Arbitrary Alarm Help Page 4 of 4
For example if a regular alarm is set to start at 1:45 pm and end at
2:00 pm then the alarm will first sound at 1:45 pm. If Alt+s is
pressed when the alarm sounds then the alarm will snooze for the time
period set in the alarm configuration. If this value is 5 then the
alarm will sound again 5 minutes from the time at which Alt+s was
pressed. This continues until Alt+e is pressed or the time is later
than 2:00 pm.
The message field sets the text that will be displayed when the alarm
sounds.
Pressing Enter on the OK field sets the alarm using the entered para-
meters and ends the alarm parameter menu. Pressing Enter on the
CANCEL field ends the alarm parameter menu and discards any changes
made to the parameters. Pressing Esc on any field has the same effect.
Up to 10 alarms can be set for any day. This includes any alarms set
in the appointment menu.
<HLP_GRP00401>
Monthly Calendar Help Page 1 of 3
For help on other topics exit this screen by pressing the Tab key
until the END field is highlighted and press Enter. Then press Alt+h
(press Alt and the h key at the same time) to bring up the help pull
down menu. Use the up and down arrow keys to highlight the desired
topic and press Enter. If this is your first time in APCAL then you
should probably select the "General" topic.
The monthly calendar screen can be used just like a wall calendar.
If a previous calendar was saved for this date then it will appear.
Otherwise a new calendar is built and any configured holidays that
occur within the month are added (see "Configuration" help). The
arrow keys are used to move around within a day block. Any text can
be typed into a day block. The File options on the pull down menu can
be used to save, print and delete the calendar.
<HLP_GRP00402>
Monthly Calendar Help Page 2 of 3
The following keys can be used in the calendar edit screen. Some of
these can also be selected from the pull down menu.
Insert toggles insert mode on and off.
Delete deletes the character at the current cursor position.
Home moves to the beginning of the current day block line.
End moves to the end of the current day block line.
Backspace moves the cursor left and deletes the character at that
position.
Enter moves to the beginning of the next line in the day block.
Tab to highlight the next day in the calendar.
Shift+Tab to highlight the previous day in the calendar.
F1 brings up this help screen.
F2 switches to the appointment screen.
F3 switches to the arbitrary alarm screen.
F5 switches to the yearly calendar screen.
F6 switches to the split screen month/appointment display.
Alt activates the pull down menu. Pressing Alt plus one of the
bold characters in the top pull down line activates that
that pull down menu.
<HLP_GRP00403>
Monthly Calendar Help Page 3 of 3
Ctrl+Right is used to pull up the next monthly calendar.
Ctrl+Left is used to pull up the previous monthly calendar.
Ctrl+Home returns to the actual date.
<HLP_GRP00501>
Yearly Calendar Help Page 1 of 2
For help on other topics exit this screen by pressing the Tab key
until the END field is highlighted and press Enter. Then press Alt+h
(press Alt and the h key at the same time) to bring up the help pull
down menu. Use the up and down arrow keys to highlight the desired
topic and press Enter. If this is your first time in APCAL then you
should probably select the "General" topic.
The yearly calendar screen displays 9 months on the screen at once
(well, almost a year) and allows you to scroll through them using the
arrow keys or Tab and Shift+Tab. This screen sets the month and year
that is used when other options are selected. For example highlight-
ing May 1995 and pressing F4 will bring up the monthly calendar for
May 1995.
<HLP_GRP00502>
Yearly Calendar Help Page 2 of 2
The following keys can be used in the yearly calendar screen. Some of
these can also be selected from the pull down menu.
Tab to highlight the next monthly calendar.
Shift+Tab to highlight the previous monthly calendar.
F1 brings up this help screen.
F2 switches to the appointment screen.
F3 switches to the arbitrary alarm screen.
F4 switches to the monthly calendar screen.
F6 switches to the split screen month/appointment display.
Alt activates the pull down menu. Pressing Alt plus one of the
bold characters in the top pull down line activates that
pull down menu.
Ctrl+Home to return to the actual date.
<HLP_GRP00601>
Month/Appt Screen Help Page 1 of 2
For help on other topics exit this screen by pressing the Tab key
until the END field is highlighted and press Enter. Then press Alt+h
(press Alt and the h key at the same time) to bring up the help pull
down menu. Use the up and down arrow keys to highlight the desired
topic and press Enter. If this is your first time in APCAL then you
should probably select the "General" topic.
The split screen month/appointment display is used to quickly scan
your appointments for the coming days. The arrow keys or Tab and
Shift+Tab can be used to highlight different days in the month. The
appointment file for that date is displayed on the right. You may
also locate a specific appointment by searching forward or backward
from the currently highlighted date for a specified text string in an
appointment file. This screen also sets the date that is used if
another option is selected. For example pressing F2 will bring up
the appointment edit screen for the appointment file displayed on the
right in the month/appt screen.
<HLP_GRP00602>
Month/Appt Screen Help Page 2 of 2
The following keys can be used in the month/appt screen. Some of
these can also be selected from the pull down menu.
Tab to highlight the next day.
Shift+Tab to highlight the previous day.
F1 brings up this help screen.
F2 switches to the appointment screen.
F3 switches to the arbitrary alarm screen.
F4 switches to the monthly calendar screen.
F5 switches to the yearly calendar screen.
F7 search for the given text in the appointment files for
future dates.
Shift+F7 search for the given text in the appointment files for
past dates.
Alt activates the pull down menu. Pressing Alt plus one of the
bold characters in the top pull down line activates that
pull down menu.
Ctrl+Right scrolls the month display one month ahead.
Ctrl+Left scrolls the month display one month back.
Ctrl+Home return to current date.
<HLP_GRP01001>
Color Configuration Help Page 1 of 2
This screen allows the configuration of the colors used by the pro-
gram.
To make a selection from the pop-up menu highlight it using the up
and down arrow keys and press Enter or just type the field's bold
character. The following options are available on the pop-up menu.
Normal Text - Sets the normal text color. For example the color this
text is in.
Highlighted Text - Sets the color of highlighted normal text. For ex-
ample the color of the current day selected in the split screen
month/appt display and the color of the current month selected in
the yearly calendar display.
Lowlight Text - Sets the color of lowlight text. For example the
color of the appointment section of the split screen month/appt
display.
Pop-up Normal - Sets the color of the pop-up menu.
Pop-up Highlighted - Sets the color of the selected field in the
pop-up menu.
<HLP_GRP01002>
Color Configuration Help Page 2 of 2
Save - Saves the current color selection to the configuration file.
If this is not done then any changes made to the color selection
will remain in effect for this session only.
Restore Defaults - Reads the values set in the configuration file and
sets the colors to those values.
Help - Brings up this help screen.
Quit - Exits the color configuration.
<HLP_GRP01101>
Appointment Template Help Page 1 of 1
This screen allows the appointment screen template to be edited. This
is the initial screen that is displayed if no appointment file for
the currently selected date is found. You may configure the times to
match your typical schedule and set any text that you always want to
appear in a particular appointment slot. For example you may want to
block out the 12:00 to 1:00 pm slots for lunch. You can change the
appointment schedule times and appointment slots in the appointment
edit menu to allow for daily variations to your schedule. The ap-
pointment template is just a starting point for each day.
To make a selection from the pop-up menu highlight it using the up
and down arrow keys and press Enter or just type the field's bold
character. The following options are available on the pop-up menu.
Edit - Allows the editing of the appointment template. Press Esc to
end editing and return to the pop-up menu. Most of the available
keys in appointment editing (see "Appointment" help) are valid here.
Save - Saves the appointment template.
Help - Brings up this help screen.
Quit - Exits appointment template configuration.
<HLP_GRP01201>
Printer Configuration Help Page 1 of 3
This screen allows you to select the printer to which all print opera-
tions will send their output. It also allows you to configure new
printers and modify the parameters of existing ones.
The up and down arrow keys can be used to move the arrow (->) on the
left through the list of printers. The parameters for the printer to
the right of the arrow are displayed in the right portion of the
screen. The currently selected printer (the one that print output
will be sent to) is highlighted.
The following keys can be used in this configuration menu.
F1 brings up this help screen.
F2 selects the default printer. Move the arrow (->) on the
left to the desired print device using the up and down
arrow keys and press F2. That printer will then be high-
lighted and all print output will go to it.
F3 toggles the device that the print will be sent to. Press-
ing F3 cycles through the list of valid options.
<HLP_GRP01202>
Printer Configuration Help Page 2 of 3
F4 toggles the mode between GRAPHIC and NON-GRAPHIC. In
GRAPHIC mode IBM graphic line characters are output. In
NON-GRAPHIC mode these characters are converted to normal
ASCII characters.
F5 allows the editing of the name of the selection currently
pointed to. Control is passed to the Printer Name field on
the right. Change the name and press Enter to accept it or
press Esc to cancel the changes. Control is then returned
to the printer list on the left.
F6 allows the editing of the first escape sequence of the sel-
ection currently pointed to. Control is passed to the
"Escape Sequence Before Printing" field on the right. This
sequence is output exactly as it appears in the menu to the
printer before any other output to the printer. To input
values that are not ordinary ASCII characters press and hold
down the Alt key and type the decimal value for the char-
acter on the numeric key pad (e.g. Alt+2+7 produces the
escape character). Press Enter to accept or Esc to cancel
the changes and return control to the printer list on the
left. If the desired sequence is too long for the input
<HLP_GRP01203>
Printer Configuration Help Page 3 of 3
field then the text "FILE:" followed by the name of a file
containing the escape sequence can be entered.
F7 allows the editing of the second escape sequence of the
selection currently pointed to. This sequence is the last
thing output to the printer for each print job. Editing
this field is exactly like the first escape sequence above.
F8 adds a new printer to the list. When F8 is pressed the
program prompts for each of the parameters on the right and
then returns control to the printer list. The new printer
is added at the end of the list.
F9 deletes the printer currently pointed to.
F10 saves the printer configuration.
ESC exits the printer configuration.
<HLP_GRP01301>
Holiday Configuration Help Page 1 of 3
This screen allows you to add, modify and delete the holidays that are
automatically placed into the monthly calendars when they are first
generated.
The up and down arrow keys can be used to move the arrow (->) on the
left through the list of holidays. The parameters for the one cur-
rently pointed to are displayed to the right.
The following keys can be used in this configuration menu.
F1 brings up this help screen.
F2 allows the editing of the holiday parameters. The first
field sets the type of holiday. Use the space bar to cycle
through the possible selections. Press Enter when the
desired one appears. The program will then prompt you for
the remaining parameters required for the selected holiday
type. Press Esc in any field to cancel the edit and dis-
card any changes. Pressing Enter on the last field accepts
the changes.
<HLP_GRP01302>
Holiday Configuration Help Page 2 of 3
F3 adds a new holiday at the end of the list. The procedure
is the same as for F2, above. The initial values for the
fields are set to those of the holiday currently pointed to.
F4 deletes the holiday currently pointed to.
F5 saves the configuration to a file.
Page Up brings up the previous page, if any.
Page Down brings up the next page, if any.
ESC exits the configuration.
There are 3 types of holidays that may be set:
Month/Day Every Year - these occur on a specific month and day
every year (e.g. December 25 for Christmas).
Month And Nth Day Of Week - these occur on a specific day of the
week in a month (e.g. 4th Thursday in November for Thanks-
giving).
Month/Day/Year - these only occur on one specific date (e.g. April
19, 1992 for Easter).
The "Name Line 1:" and "Name Line 2:" parameters set the text that
will appear in the calendar on the date for the holiday. The year
field gives the year minus 1900 (e.g. 92 for 1992). The month field
<HLP_GRP01303>
Holiday Configuration Help Page 3 of 3
can be toggled through the months using the space bar. The day field
toggles from 1 through the number of days in the month. The day of
week field toggles through the days of the week.
NOTE - changes to the holiday configuration will not be reflected in
monthly calendars that have already been saved. This infor-
mation is only used when the calendar is first built.
<HLP_GRP01401>
Start Screen Configuration Help Page 1 of 1
This screen allows you to select the first screen that is displayed
when the program is loaded.
The up and down arrow keys can be used to move the arrow (->) on the
left through the list of screens. The currently selected screen is
highlighted.
The following keys can be used in this configuration menu.
F1 brings up this help screen.
F2 selects the initial screen. Move the arrow (->) on the
left to the desired screen using the up and down arrow keys
and press F2. That screen will then be highlighted.
F3 saves the current selection to the configuration file.
ESC exits the screen configuration.
<HLP_GRP01501>
Alarm Configuration Help Page 1 of 3
This screen allows the configuration of the pop-up alarm.
To make a selection from the pop-up menu highlight it using the up
and down arrow keys and press Enter or just type the field's bold
character. The following options are available on the pop-up menu.
Edit - Allows the editing of the alarm parameters. Press Tab to move
to the next field in the parameter menu and Shift+Tab to move to
the previous field. Press Esc to end editing and return to the
pop-up menu. If you move into a field and change it and then press
Esc the changes will be discarded. To process the changes press
Tab and then press Esc.
Play Alarm - plays the alarm as it will sound using the current alarm
parameters. The alarm sounds for the given duration. It can be
terminated before the end by pressing any key.
Save - Saves the alarm parameters.
Help - Brings up this help screen.
Quit - Exits alarm configuration.
<HLP_GRP01502>
Alarm Configuration Help Page 2 of 3
The alarm consists of 2 tones with an intervening pause. The frequen-
cy values (1st and 4th fields in the parameter menu) can have values
from 20 to 20000 Hertz. Lower numbers produce a lower pitched sound.
The duration of the tones (2nd and 5th fields) and intervening pause
(3rd field) are input in tenths of seconds. For example a value of
10 represents 10 tenths of a second or 1 second. The durations can
vary from 0 to 100 (0 to 10 seconds). A value of zero for a tone
means that tone will not play. A zero pause produces no pause.
From 0 to 99 of the tone 1/pause/tone 2 sequences can be sounded for
the alarm. A zero value produces no sound.
The snooze duration field sets the number of minutes between when
ALT+s is pressed to snooze an alarm and when the alarm will resound.
This value can range from 1 to 99 minutes.
The color bar sets the color of the pop-up alarm message. Use the
left/right arrow keys to change the color selection and the up/down
keys to switch between configuring the foreground and background
color.
<HLP_GRP01503>
Alarm Configuration Help Page 3 of 3
The appointment alarm parameters set the initial values that are dis-
played in the "Number of minutes before:" and "Duration (minutes):"
fields when an appointment alarm is set (see "Appointment" help).
NOTE - Changes to these parameters (except the appointment alarm para-
meters) do not take effect until the alarm tsr is reloaded.
Entering an invalid value in a field produces a beep and the
field cannot be exited until a valid value is entered.