TURBO HELP UTILITY This file explains how to use THELP. COM. thelP is a memory-resident utility that provides online help for Turbo Pascal and Turbo C. If you are using Turbo Debugger, for example, you can load THELP, then run the debugger and get online help for Pascal or C while you are debugging Table of Content arting 2. Command-line Options Summary 3. Detailed Explanation of Keys Used When ThELP is Active 4. Detailed Explanation of Command line Options 1. Starting THELP Load thelp at the dos command line simply by typing THELP Make sure the Turbo help file(TURBo. HLP for Turbo Pascal TCHELP. TCH for tuRbo c)is in the current directory or use the/F command line option described below. Memory Usage-THELP requires about 8K bytes ( 32K swap file 40K with no swapping Default hotkey- The default hotkey is Numeric-Keypad-5(scan code 4ch, shift state oOh) Paste spee The default pasting speed is FASt. You' ll have to experiment if it pastes too quickly for your editor. Note that you should turn off autoindent in the integrated environment before using the paste feature (Ctrl-Q I toggles autoindent) If you are using Sidekick Plus or Sidekick lx, make sure you load theLP before you load SideKick. 2. Command-line Options Summary
TURBO HELP UTILITY ------------------ This file explains how to use THELP.COM. THELP is a memory-resident utility that provides online help for Turbo Pascal and Turbo C. If you are using Turbo Debugger, for example, you can load THELP, then run the debugger and get online help for Pascal or C while you are debugging. Table of Contents ----------------- 1. Starting THELP 2. Command-line Options Summary 3. Detailed Explanation of Keys Used When THELP is Active 4. Detailed Explanation of Command line Options 1. Starting THELP ------------------ Load THELP at the DOS command line simply by typing THELP. Make sure the Turbo help file (TURBO.HLP for Turbo Pascal, TCHELP.TCH for TURBO C) is in the current directory or use the /F command line option described below. Memory Usage - THELP requires about 8K bytes (+ 32K swap file); 40K with no swapping. Default hotkey - The default hotkey is Numeric-Keypad-5 (scan code 4ch, shift state 00h). Paste speed - The default pasting speed is FAST. You'll have to experiment if it pastes too quickly for your editor. Note that you should turn off autoindent in the integrated environment before using the paste feature (Ctrl-Q I toggles autoindent). If you are using SideKick Plus or SideKick 1.x, make sure you load THELP before you load SideKick. 2. Command-line Options Summary
Here is a summary of the command line options. If you use more than one option, they must be separated by spaces /B Use bios for video /C#xx Select color: #=color number, xx=hex color value /Dname Full path for disk swapping (implies /S1) /Fname Full path and filename of help file p scr /Xxyy Change hotkey: xx=shift state(hex) yy=scan code(hex) Force number of rows on screen: xx=25, 43, 50 /M+, /M- Display help text: on monochrome screen(+) on default screen(-) Pasting speed: 0=Slow, 1=medium, 2=fast /R Send options to resident THELP /S Default Swapping Mode: 1=Use Disk, 2=Use EMs, Remove help from memory Write Options to THELP COM and exit 3. Detailed Explanation of Keys Used When thelp is Active Arrow keys: Move the highlight from item to item within the current help screen. PgUp/PgDn: Move from screen to screen if additional screens are available ENTER Select help entry for the item highlighted in the current help screen. ndex FI from any help screen brings up the Help Index. ALT-Fl Displays in reverse order the last 20 screens you have reviewed
------------------------------- USAGE: THELP [options] Here is a summary of the command line options. If you use more than one option, they must be separated by spaces. /B Use BIOS for video /C#xx Select color: #=color number, xx=hex color value /Dname Full path for disk swapping (implies /S1) /Fname Full path and filename of help file /H,/?,? Display this help screen /Kxxyy Change hotkey: xx=shift state(hex), yy=scan code(hex) /Lxx Force number of rows on screen: xx=25,43,50 /M+,/M- Display help text: on monochrome screen(+), on default screen(-) /Px Pasting speed: 0=slow, 1=medium, 2=fast /R Send options to resident THELP /Sx Default Swapping Mode: 1=Use Disk, 2=Use EMS, 3=No Swapping /U Remove THELP from memory /W Write Options to THELP.COM and exit 3. Detailed Explanation of Keys Used When THELP is Active --------------------------------------------------------- Arrow keys: Move the highlight from item to item within the current help screen. PgUp/PgDn: Move from screen to screen if additional screens are available. ENTER: Select help entry for the item highlighted in the current help screen. ESC: End Help. F1: Help Index. F1 from any help screen brings up the Help Index. ALT-F1: Displays in reverse order the last 20 screens you have reviewed
CTL-Fl Bring up help screen for thelp's he Select new help file.F or f brings up a window that allows you to change help files on the fly. Type in the complete path name of the new help file, and it will be read into memory and initialized to the help index of the new file. If the new file does not exist, or is in an invalid format, THELP will beep twice, and return you to the original file Jump to specified help page number .J orj brings up a window that allows you to jump to any particular page(9999 max) in the help file.The only editing key permitted in this window is Back Space. ESC aborts, CR(or four digits) completes Search help file for specified keyword.K or k brings up a window in which you can enter a keyword(40 characters max), and have THELP search the help file for a match. If there is no matching keyword in the current help file, ThELP will beep twice and return you to the original help screen. I key Paste highlighted keyword into application.I'or i inserts the current highlighted keyword into the keyboard buffer, and immediately pops down. Paste entire help screen into application. Por p' inserts the entire current help page (as it appears in the help window) into the current application, and then immediately pops down Pasting can be interrupted with C or Break. Save help screen to disk file(THELP SAv).'S'or s' from any help screen saves the current help page to the disk file ThELP. Sav, in the current directory If the file already exists, the new help information is appended to the end <Hotkey Combo> Pressing the hotkey combination when using THELP
CTL-F1: Bring up help screen for THELP's hot keys. F key: Select new help file. 'F' or 'f' brings up a window that allows you to change help files on the fly. Type in the complete path name of the new help file, and it will be read into memory and initialized to the help index of the new file. If the new file does not exist, or is in an invalid format, THELP will beep twice, and return you to the original file. J key: Jump to specified help page number. 'J' or 'j' brings up a window that allows you to jump to any particular page (9999 max) in the help file. The only editing key permitted in this window is BackSpace. ESC aborts, CR (or four digits) completes. K key: Search help file for specified keyword. 'K' or 'k' brings up a window in which you can enter a keyword (40 characters max), and have THELP search the help file for a match. If there is no matching keyword in the current help file, THELP will beep twice and return you to the original help screen. I key: Paste highlighted keyword into application. 'I' or 'i' inserts the current highlighted keyword into the keyboard buffer, and immediately pops down. P key: Paste entire help screen into application. 'P' or 'p' inserts the entire current help page (as it appears in the help window) into the current application, and then immediately pops down. Pasting can be interrupted with ^C or ^Break. S Key: Save help screen to disk file (THELP.SAV). 'S' or 's' from any help screen saves the current help page to the disk file THELP.SAV, in the current directory. If the file already exists, the new help information is appended to the end. <Hotkey Combo> Pressing the hotkey combination when using THELP
on a second monitor ends this session of the resident help, but leaves the current help screen on the monochrome monitor 4. Detailed Explanation of Command-line Options /B Use bios for video his option forces thelp to use Interrupt 10h Bios video calls for all writing to/reading from the video display. Normally, THELP will write directly to video RAM. Note that the use of this option negates the effect of the /M switch described below the alternate monitor may not be used if /B is in effect. This option is enabled with’/B+', and disabled with’/B-’( enable is the default) /C#x Select color: #=color number xx=hex color value There are eight possible colors, described as follows: 1= Color Normal te 2= Monochrome Normal Text 3= Color Possible reference pages: top/bottom description line 4= Monochrome Possible reference pages: top/bottom description line 5= Color border Color 6=Monochrome border color 7= Color Current Reference Selection 8= Monochrome current reference selection Any or all of these eight colors may be specified on the command The color numbers for a standard IBM-compatible Color Display are as follows First digit (background) Second Digit(Fore ground) 1—Blue 1—Blu Cyan 3 4-- Red
on a second monitor ends this session of the resident help, but leaves the current help screen on the monochrome monitor. 4. Detailed Explanation of Command-line Options ------------------------------------------------ /B -- Use BIOS for video This option forces THELP to use Interrupt 10h BIOS video calls for all writing to/reading from the video display. Normally, THELP will write directly to video RAM. Note that the use of this option negates the effect of the /M switch described below; the alternate monitor may not be used if /B is in effect. This option is enabled with '/B+', and disabled with '/B-' (enable is the default). /C#xx Select color: #=color number, xx=hex color value There are eight possible colors, described as follows: 1 = Color Normal Text 2 = Monochrome Normal Text 3 = Color Possible reference pages; top/bottom description line 4 = Monochrome Possible reference pages; top/bottom description line 5 = Color Border Color 6 = Monochrome Border Color 7 = Color Current Reference Selection 8 = Monochrome Current Reference Selection Any or all of these eight colors may be specified on the command line. The color numbers for a standard IBM-compatible Color Display are as follows: First Digit (Background) Second Digit (Foreground) 0 -- Black 0 -- Black 1 -- Blue 1 -- Blue 2 -- Green 2 -- Green 3 -- Cyan 3 -- Cyan 4 -- Red 4 -- Red
5— Magenta 5-- Magenta 6—Br 6-- Brown 8—Into ORing the color value with 9— Intense blue Hex 80 produces a blinking A --Intense green color unless blinking has been B-- Intense Cyan disabled C -- Intense red D E-- Intense Brown (Yellow) F-- Intense Grey(White) On Monochrome monitors, the attribute values can differ widely, so some experimentation would be needed. Note that the monochrome attributes are used in only two cases: when the current vid mode is 7, or when force mono is used(see the /M option) /Dnar Full path for disk swapping(implies /S1) This option is used to override where Thelp will place its swap files when swapping to disk. A full path should be specified, but a trailing is not necessary If no /d option is pecified, under dos 3. x swap files are placed in the directory where THELP COM resides. Under Dos 2.x, swap files are placed by default in C: \ Using this option also sets the flag that forces disk swapping instead of checking first for EMs. /Fname Full path and filename of help file The name that follows the /F option should be the full drive/directory pathname of the help file to use; e.g. THELP/FC: \ TP\TURBO. THELP /FC: \TURBOC\TCHELP. TCH By default, ThELP looks for the help file on the logged drive and directory. /H, /?, - Display help screen
5 -- Magenta 5 -- Magenta 6 -- Brown 6 -- Brown 7 -- Grey 7 -- Grey 8 -- Intense Black ORing the color value with 9 -- Intense Blue Hex 80 produces a blinking A -- Intense Green color unless blinking has been B -- Intense Cyan disabled. C -- Intense Red D -- Intense Magenta E -- Intense Brown (Yellow) F -- Intense Grey (White) On Monochrome monitors, the attribute values can differ widely, so some experimentation would be needed. Note that the monochrome attributes are used in only two cases; when the current video mode is 7, or when force mono is used (see the /M option) /Dname -- Full path for disk swapping (implies /S1) This option is used to override where THELP will place its swap files when swapping to disk. A full path should be specified, but a trailing '\' is not necessary. If no /D option is specified, under DOS 3.x swap files are placed in the directory where THELP.COM resides. Under DOS 2.x, swap files are placed by default in C:\. Using this option also sets the flag that forces disk swapping instead of checking first for EMS. /Fname -- Full path and filename of help file The name that follows the /F option should be the full drive/directory pathname of the help file to use; e.g., THELP /FC:\TP\TURBO.HLP THELP /FC:\TURBOC\TCHELP.TCH By default, THELP looks for the help file on the logged drive and directory. /H,/?,? -- Display help screen