Welcome to the HELP Command How to Use the HELP Command Moving Around within the HELP Command HELP Command Prompts Printing HELP Files HELP Error Messages How to Write HELP Files An Explanation of the Tree Structure of the HELP Command Sample HELP Files Illustrating Use of Tree Structure :HELP: Welcome to the HELP Command Welcomĺ tď thĺ HELĐ Commandˇ Thĺ HELĐ Commanä ió designeä Ť tď assisô you¬ thĺ CP/Í user¬ iî thĺ usĺ oć CP/Í iî generaě Ť anä specifiă CP/Í commandó iî particular® Iô ió designeä Ť aó aî interactive¬ on-linĺ assistancĺ system. HELĐ pulló iî fileó nameä .HLĐ froí disë anä Ť displayó thesĺ tď thĺ useň iî á pageä mode® Thesĺ fileó arĺ oć Ť twď basiă typeó -- indexeä anä non-indexed. Indexeä fileó arĺ thosĺ HELĐ fileó whicč starô witč aî Ť index® Thió ió aî examplĺ oć aî indexeä file® Wheî HELĐ Ť loadó aî indexeä file¬ iô displayó thió indeř tď thĺ useň Ť anä allowó hií tď selecô entrieó froí it® Thĺ useň maů selecô Ť aó manů entrieó aó hĺ desireó iî anů ordeň hĺ desireó bů simplů Ť typinç thĺ letteň oć hió selection® Oncĺ thĺ useň haó madĺ hió Ť selection¬ HELĐ wilě looë uđ thĺ bodů oć texô hĺ selecteä anä Ť displaů iô tď hií iî á pageä mode® Wheî thĺ useň haó finisheä Ť readinç hió selection¬ HELĐ theî returnó hií tď thĺ indeř Ť menu® Typinç á Control-Ă wilě returî thĺ useň tď CP/M. Non-indexeä fileó arĺ thosĺ HELĐ fileó whicč dď noô starô Ť witč aî index® Iî sucč cases¬ HELĐ wilě immediatelů displaů Ť thĺ contentó oć thĺ filĺ tď thĺ useň and¬ wheî thĺ useň haó Ť finisheä lookinç aô it¬ HELĐ wilě returî tď CP/M. HELĐ ió menu-driven¬ anä alě thĺ commandó availablĺ tď thĺ Ť useň aô anů giveî timĺ arĺ displayeä tď him® Thĺ versioî oć HELĐ describeä iî thió HLĐ filĺ ió designeä Ť tď worë witč thĺ ZCPR˛ systeí anä takĺ advantagĺ oć somĺ oć itó Ť special features. Richard Conn :HELP: How to Use the HELP Command The HELP Command is executed in one of three ways: (1) by just typing 'HELP' (2) by typing 'HELP FILENAME', where FILENAME is the name of a disk file named FILENAME.HLP (3) by typing 'HELP FILENAME.TYP', where FILENAME.TYP is the name of a file created in the format of a help file Ić thĺ useň typeó jusô 'HELP'¬ hĺ wilě receivĺ á lisô oć Ť thĺ availablĺ HELĐ Fileó anä mů elecô tď reaä thĺ basiă HELP.HLĐ Ť file® Foň alě otheň formó oć thĺ HELĐ command¬ thĺ useň wilě seĺ Ť thĺ specifieä helđ filĺ information® Generallů speaking¬ thĺ Ť namĺ oć thĺ helđ filĺ shoulä bĺ indicativĺ oć itó subject¬ Ť likĺ CPM.HLĐ shoulä contaiî helđ informatioî oî CP/M. The HELP File Search Hierarchy Wheneveň HELĐ lookó foň á specifieä HELĐ Filĺ (eitheň froí Ť thĺ HELĐ Commanä oň froí aî Informatioî Sectioî whicč Ť specifieó á Nodĺ [seĺ later])¬ HELĐ wilě perforí á searcč foň Ť thĺ indicateä file® Thió searcč goeó aó follows: 1® Undeň ZCPR2¬ HELĐ caî bĺ seô uđ tď follo÷ thĺ Ť externaě path® Aó such¬ HELĐ wilě searcč thĺ currenô directorů Ť (disë anä user© first® Ić iô ió noô seô uđ tď searcč thĺ Ť external path, it will search along its internal path. 2® Ić thĺ HLĐ filĺ ió noô founä undeň thĺ currenô Ť directory¬ HELĐ wilě searcč alonç thĺ ZCPR˛ patč foň it. (Continued Next Frame) HELP File Search Hierarchy, Continued 3® Ić thĺ HLĐ filĺ ió noô founä alonç thĺ ZCPR˛ path¬ Ť theî HELĐ wilě searcč alonç itó internaě patč foň thĺ file® Thió Ť ió á majoň differencĺ betweeî HELĐ anä otheň ZCPR˛ utilities® Tď Ť configurĺ HELĐ witč GENINS¬ yoő shoulä firsô telě GENINÓ thaô Ť HELĐ doeó noô usĺ externaě paths¬ definĺ thĺ internaě path¬ anä Ť theî telě GENINÓ thaô HELĐ useó externaě pathó anä wherĺ thĺ patč Ť begins. 4® Ić thĺ HLĐ filĺ ió noô found¬ HELĐ wilě eitheň Ť displaů thĺ nameó oć thĺ HLĐ fileó alonç thĺ patč anä prinô itó Ť internaě documentatioî oň finä thĺ filĺ HELP.HLĐ anä prinô that. :HELP: Moving Around within the HELP Command Oncĺ thĺ useň ió runninç HELP¬ hĺ ió giveî á seô oć commandó Ť bů whicč hĺ caî displaů thĺ particulaň itemó oć informatioî hĺ ió Ť interesteä in. Afteň issuinç thĺ HELĐ command¬ thĺ useň wilě comĺ uđ iî Ť onĺ oć twď modeó (dependinç oî thĺ typĺ oć HELĐ filĺ referenced)® Ť Iî Indexeä Mode¬ á Menő oć topicó ió displayeä tď thĺ useň anä Ť hĺ caî selecô thĺ desireä topiă bů typinç thĺ letteň iî Ť fronô oć thĺ topiă title» iî Non-Indexeä Mode¬ nď menő ió Ť displayeä anä thĺ entirĺ filĺ ió vieweä aó onĺ Informatioî Ť Section. Aî Informatioî Sectioî ió á collectioî oć screeî displayó Ť (onĺ screeî fulě oć text© calleä Frames® Typically¬ aî Ť Informatioî Sectioî shoulä contaiî á logicaě groupinç oć relateä Ť datá oî á particulaň topic® Iî Indexeä Mode¬ eacč Menő topiă Ť referó tď aî Informatioî Section® Bů selectinç á topic¬ thĺ useň Ť ió placeä intď aî Informatioî Section® Iî Non-Indexeä Mode¬ thĺ Ť entirĺ HELĐ filĺ ió onĺ Informatioî Section. Moving From the Menu Aô thĺ Menő oć á HELĐ file¬ thĺ useň haó twď basiă Ť options® Thesĺ optionó arĺ tď selecô á Menő topiă tď revie÷ oň Ť tď exiô tď CP/M® Ić á Menő topiă ió selected¬ thĺ useň ió Ť placeä intď thaô Informatioî Section. Á thirä optioî aô thĺ Menő oć á HELĐ filĺ ió sometimeó Ť available® Thió optioî ió tď movĺ uđ tď thĺ previouó HELĐ Ť Level® Somĺ Informatioî Sectionó arĺ entirĺ HELĐ fileó iî Ť theiň owî right¬ whicč caî bĺ accesseä independentlů oć thĺ HELĐ Ť filĺ thĺ useň ió currentlů in® Ić thĺ useň enteró onĺ oć thesĺ Ť Informatioî Sections¬ thĺ namĺ oć thĺ currenô HELĐ filĺ ió saveä Ť anä thĺ ne÷ HELĐ filĺ ió loaded® Wheî thió happens¬ thĺ useň Ť ió placeä aô thĺ nexô HELĐ Leveě (aî ascendinç number¬ wherĺ thĺ Ť originaě HELĐ filĺ ió aô HELĐ Leveě 0¬ á HELĐ filĺ calleä froí Ť thió leveě ió aô HELĐ Leveě 1¬ á HELĐ filĺ calleä froí thió leveě Ť ió aô HELĐ Leveě 2¬ etc.)® Wheî thĺ useň ió aô á loweň HELĐ Ť Leveě (useň ió NOÔ aô HELĐ Leveě 0)¬ hĺ haó thĺ optioî tď movĺ Ť tď thĺ nexô higheň HELĐ Leveě (froí HELĐ Leveě ± tď HELĐ Leveě Ť 0¬ foň example). Thĺ concepô oć movinç betweeî HELĐ Leveló ió deriveä froí Ť thĺ concepô oć á Treĺ datá structurĺ froí Computeň Science® Iî Ť thió concept¬ thĺ useň startó aô thĺ rooô oć thĺ treĺ anä theî Ť climbó uđ anä dowî thĺ treĺ tď variouó levels¬ oň nodes® Ť Froí eacč node¬ thĺ useň maů onlů movĺ uđ oň dowî thĺ treĺ -- Ť hĺ can'ô crosó oveň tď á nodĺ aô thĺ samĺ leveě withouô firsô Ť movinç dowî thĺ treĺ anä theî bacë up® Tď illustrate¬ consideň Ť thĺ following: Node A Node B HELP Level _________ ____________ 5 \ Node C / -------------- 4 \ Node D Node E ------------ ---------------- 3 \ Node F / Node G --------------------------- ----------- 2 \ Node H / Node I -------------------------- ------- 1 \ Node J / Root of Tree --> -------------------------- 0 Iî thĺ abovĺ example¬ thĺ useň musô alwayó starô aô thĺ Ť rooô oć thĺ treĺ (Nodĺ J)® Thió ió analogouó tď HELĐ Leveě 0¬ Ť whicč ió wherĺ thĺ useň ió placĺ wheî hĺ issueó thĺ HELĐ Command® Ť Tď geô tď Nodĺ C¬ foň example¬ thĺ useň haó tď climâ thĺ treĺ Ť froí Nodĺ Ę tď Nodĺ Č tď Nodĺ Ć tď Nodĺ Ä tď Nodĺ C® Thió Ť woulä bĺ likĺ thĺ useň enterinç ´ Node-Typĺ Informatioî Ť Sections¬ iî whicč differenô HELĐ fileó arĺ successivelů loaded. No÷ thaô thĺ useň ió aô Nodĺ C¬ let'ó saů thaô hĺ wantó tď Ť gď tď Nodĺ E® Undeň thĺ HELĐ System¬ therĺ arĺ twď wayó tď dď Ť this: 1® Jumđ ofć oć thĺ treĺ anä theî climâ bacë uđ tď Ť Nodĺ E® Here¬ thĺ useň woulä jumđ froí Nodĺ Ă tď Nodĺ Ę anä Ť theî gď tď Nodĺ Č tď Nodĺ Ć tď Nodĺ E® Undeň HELP¬ thĺ useň caî Ť dď thió bů exitinç tď CP/Í anä theî reissuinç thĺ HELĐ Commanä Ť oň bů issuinç thĺ Rooô Commanä (.)» oncĺ aô thĺ rooô oć thĺ Ť tree¬ hĺ theî climbó iô agaiî bů enterinç thĺ appropriatĺ Ť Informatioî Sections. 2® Climâ dowî thĺ treĺ anä theî bacë up® Thĺ useň Ť woulä movĺ froí Nodĺ Ă tď Nodĺ Ä tď Nodĺ Ć anä theî bacë uđ tď Ť Nodĺ E® Thĺ HELĐ useň caî gď tď thĺ previouó leveě bů issuinç Ť thĺ Uđ Leveě (^© command® Iî thió example¬ hĺ woulä Uđ Leveě Ť twicĺ anä theî gď bacë down. Moving Within An Information Section Oncĺ thĺ useň ió withiî á textuaě Informatioî Section¬ hĺ Ť haó severaě capabilitieó foň movinç withiî thió sectioî anä ouô Ť oć thió section. First¬ tď movĺ ouô oć aî Informatioî Section¬ thĺ useň caî Ť returî tď thĺ menő (ić thĺ currenô HELĐ filĺ ió Indexed© oň Ť returî tď CP/M® Additionally¬ ić thĺ useň ió noô oî thĺ rooô Ť (HELĐ Leveě 0)¬ hĺ caî returî tď thĺ previouó HELĐ Leveě (Uđ Ť Level)® Ić thĺ useň ió noô iî aî Indexeä HELĐ file¬ movinç Ť forwarä beyonä thĺ Enä oć Informatioî (EOI© wilě returî hií tď Ť CP/Í ić hĺ ió aô HELĐ Leveě ° oň returî hií tď thĺ previouó HELĐ Ť Leveě ić not. Tď movĺ withiî aî Informatioî Section¬ thĺ datá ió typicallů Ť arrangeä sequentially® Consequently¬ thĺ useň caî movĺ Forwarä Ť tď thĺ nexô Frame¬ Backwarä tď thĺ previouó Frame¬ oň tď thĺ Ť beginninç oć thĺ Informatioî Section® Naturally¬ thĺ useň Ť cannoô movĺ backwarä beyonä thĺ beginninç oć thĺ Informatioî Ť Section® Also¬ ić thĺ useň trieó tď movĺ forwarä beyonä thĺ Ť Enä oć Informatioî (EOI)¬ hĺ ió eitheň returneä tď thĺ Menu¬ Ť returneä tď CP/M¬ oň returneä tď thĺ previouó HELĐ Leveě aó Ť describeä above. :HELP: HELP Command Prompts Thĺ followinç arĺ thĺ basiă promptó foň useň commanä Ť whicč HELĐ displayó tď thĺ useň anä theiň meanings. ^C=CP/M ^=Level .=Root M=Menu S=Start L=Last P=Print - \ \ \ \ \ \ \__Print Info/Frame \ \ \ \ \ \__Goto Last (Previous) Frame \ \ \ \ \__Goto Start of Info Section \ \ \ \__Goto Menu of HELP File \ \ \__Goto Root if NOT at Level 0 \ \ (this is displayed only if NOT at Level 0) \ \__Goto Previous Level \ (this is displayed only if NOT at Level 0) \__Return to CP/M EOÉ ^C=CP/Í ^=Leveě .=Rooô M=Menő S=Starô L=Lasô P=Prinô - \ \________\_______\________\_______\_______\_______\__Same as \ Above \__User is at the End of Information (end of Information Section) Type ^C=CP/M ^=Level .=Root or Enter Selection - \ \ \ \__Enter letter of desired \ \ \ Information Section \ \ \__Goto Root \ \ (this is displayed only if NOT at Level 0) \ \__Goto Previous Level \ (this is displayed only if NOT at Level 0) \__Return to CP/M Preceedinç eacč oć thĺ abovĺ promptó ió aî indicatoň oć Ť thĺ HELĐ Leveě anä Framĺ Numbeň thĺ useň ió currentlů at® Thió Ť indicatoň maů takĺ thĺ followinç forms: \__The user is at the Menu of Level 0 fff: \__Current Frame Number within Information Section (the user is at Level 0) Level lll/ \__Current Level Number (The user is at a Menu Frame) (this is displayed only if the user is NOT at Level 0) Level lll/fff: \ \__Current Frame Number within Information Section \__Current Level Number (this is displayed only if the user is NOT at Level 0) Summary of User Commands Cmd Meaning ^ Go to Previous Level . Go to Root Level M Go to Menu of Current HELP File S Go to Start of Information Section L Go to Previous Frame CR (Carriage Return or Space) Go to Next Frame ^C (Control-C) Return to CP/M P Print Current Screen Display (Frame) or Information Section :HELP: Printing HELP Files Printinç HELĐ Fileó caî bĺ donĺ iî twď basiă wayó -- bů Ť usinç thĺ PHELĐ Utilitů oć ZCPR˛ oň bů usinç thĺ Prinô functioî Ť contained within the HELP Utility itself. Thĺ PHELĐ Utilitů ió useä tď prinô aî entirĺ Helđ File® Iô Ť actó á loô likĺ thĺ PRINT3¬ anä iô haó á varietů oć options¬ Ť includinç thĺ abilitů tď plaî foň printeň outpuô anä tď supporô Ť paging and other "appearance-enhancing" features. Thĺ Prinô Functioî withiî HELĐ ió useä foň quicë printouts® Ť Iô doeó noô pagĺ oň perforí anythinç morĺ exotiă thaî simplů Ť printinç ouô whaô ió containeä iî á parô oć á Helđ File® Wheî Ť thĺ Đ optioî ió given¬ thĺ useň ió askeä tď seô thĺ tođ oć forí Ť (givinç hií timĺ tď turî oî hió printer© anä theî specifů whetheň Ť hĺ wantó tď prinô thĺ currenô Framĺ (Screeî Display© oň thĺ Ť entirĺ informatioî sectioî whicč hĺ ió currentlů in® Afteň Ť selectinç onĺ oć thesĺ twď optionó (thĺ optioî tď aborô ió alsď Ť given)¬ thĺ printouô occuró (maů bĺ aborteä aô anů timĺ bů Ť strikinç á ^C)® Wheî finished¬ thĺ useň ió returneä tď thĺ lasô Ť frame he was viewing. Thió ne÷ Prinô Functioî (availablĺ iî Versionó 4.± anä lateň Ť oć HELP2© ió provideä aó á fundamentaě conveniencĺ tď thĺ user® Ť Iô allowó thĺ useň tď revie÷ thĺ Helđ File¬ and¬ wheî hĺ seeó á Ť particulaň screeî displaů oň informatioî sectioî whicč hĺ valueó Ť enougč tď wanô tď havĺ arounä foň futurĺ referencĺ iî hardcopů Ť form¬ hĺ caî simplů telě HELP˛ tď prinô it® Thió capabilitů ió Ť intendeä tď supporô thĺ concepô oć establishinç HLĐ fileó aó á Ť convenienô anä flexiblĺ waů tď pasó documentatioî oć programó tď Ť thĺ useň oî disë whilĺ simultaneouslů allowinç hií tď easilů Ť print it out if it is of significant interest to him. Foň instance¬ á HLĐ filĺ whicč referó tď á ne÷ prograí maů Ť contaiî aî Informatioî Sectioî oň onĺ Framĺ whicč containó á Ť commanä summary® Thĺ useň caî simplů prinô thió withouô havinç Ť the print the entire HLP file. Aó anotheň example¬ thĺ HELP˛ subsysteí maů bĺ useä bů á Ť homemakeň tď keeđ heň recipeó on® Organizeä usinç thĺ treĺ Ť structurĺ intď reasonablĺ catagorieó (sucč aó roasts¬ desserts¬ Ť etc)¬ whilĺ reviewinç thĺ recipeó shĺ maů finä onĺ shĺ wisheó tď Ť trů foň thĺ evening'ó meaě oň tď pasó oî tď á friend® Ić thĺ Ť recipĺ coveró onlů onĺ screen¬ á Framĺ Prinô ió verů convenient. :HELP: HELP Error Messages Thĺ followinç arĺ thĺ erroň messageó issueä bů HELĐ Ť anä theiň meanings: HELP FATAL ERROR -- File not Found The specified HELP File cannot be found. HELP FATAL ERROR -- File Name Contains Wild Car Thĺ specifieä HELĐ Filĺ containó thĺ characteň "*˘ oň "?"® Ť Thió ió noô alloweä sincĺ iô specifieó aî ambiguouó name. HELP ERROR -- Invalid Response The user issued an invalid command. HELP ERROR -- EOF on HELP File Iî searchinç foň aî Informatioî Section¬ HELĐ raî intď thĺ Ť enä oć thĺ HELĐ File® Thĺ Indexeä HELĐ Filĺ ió improperlů Ť structureä (morĺ indeř entrieó thaî Informatioî Sections). HELP ERROR -- Not Possible to Backup Before Start of Info Aî Ě Commanä waó issueä wheî thĺ currenô Framĺ waó thĺ Ť beginninç oć thĺ currenô Informatioî Section. HELP ERROR -- Node Level Limit Reached -- Aborting Thĺ limiô oć thĺ nestinç oć thĺ HELĐ Leveló ió exceeded® Ť HELĐ limitó thĺ numbeň oć HELĐ Leveló thaô caî bĺ traverseä tď 1° Ť (default¬ whicč caî bĺ changed)¬ anä aî attempô waó madĺ tď Ť enteň HELĐ Leveě 1± (oň defaulô « 1). HELP ERROR -- Invalid File Name in Load Aî Informatioî Sectioî whicč ió tryinç tď loaä á nodĺ (gď Ť tď nexô HELĐ Level© containó aî invaliä filĺ name. HELP ERROR -- No Higher Level to Return to Aî attempô waó madĺ tď gď tď á HELĐ Leveě previouó tď HELĐ Ť Leveě ° (Ţ Commanä issueä froí HELĐ Leveě 0). HELP ERROR -- Not Enough Room for HELP File Thĺ selecteä HELĐ Filĺ ió toď largĺ tď loaä intď thĺ Ť availablĺ memorů iî thĺ user'ó computeň system® Thĺ HELĐ Filĺ Ť shoulä bĺ reduceä iî size» usinç HELĐ Leveló (Nodĺ references© iî Ť thĺ Informatioî Sectionó ió á gooä waů tď dď this. :HELP: How to Write HELP Files Fileó useä bů thĺ HELĐ prograí arĺ eitheň simplĺ CP/M-Ť standarä fileó oć ASCIÉ texô oň ASCIÉ fileó generateä Ť bů thĺ Worä Staň texô editor/formatter® Thesĺ files¬ aó Ť mentioneä above¬ arĺ oć twď basiă typesş indexeä anä non-Ť indexed¬ anä eacč typĺ ió relateä tď thĺ otheň anä ió oć thĺ Ť samĺ basiă format. Grouping of Information Informatioî displayeä tď thĺ useň ió groupeä bů thĺ indeř iî Ť indexeä HELĐ fileó anä maů alsď bĺ groupeä bů lineó beginninç Ť witč Forí Feeä (^L© characters® Groupinç ió aî effectivĺ waů tď Ť logicallů organizĺ informatioî sď thaô meaninç wilě bĺ morĺ Ť cleaň tď thĺ useň anä unitó oć informatioî wilě noô pasó betweeî Ť screeî displays. Thĺ informatioî displayeä tď thĺ useň ió organizeä intď Ť logicaě unitó calleä Informatioî Sectionó anä screeî displayó Ť (onĺ screeî fulě oć text© calleä Frames® Usinç texô editors¬ Ť thĺ useň caî creatĺ hió owî HELĐ fileó anä organizĺ hió Ť informatioî aó hĺ desireó foň displaů tď thĺ HELĐ user. Non-Indexed HELP Files Non-indexeä HELĐ fileó arĺ simplĺ ASCIÉ fileó whicč starô Ť witč á coloî (:© aó thĺ firsô characteň oć thĺ filĺ anä consisô Ť oć ASCIÉ texô (witč eacč linĺ terminateä bů á carriagĺ returî anä Ť linĺ feeä characteň combination)® Thĺ informatioî iî sucč á Ť helđ filĺ consistó oć alě texô afteň thĺ leadinç coloî uđ tď Ť eitheň thĺ terminatinç end-of-filĺ marë (control-Z© oň á ne÷ Ť linĺ whicč startó witč á colon. Indexed HELP Files Indexeä HELĐ fileó arĺ simplĺ ASCIÉ fileó whicč dď noô Ť starô witč á coloî (:© aó thĺ firsô characteň oć thĺ file® Ť Thió typĺ oć HELĐ filĺ consistó oć onĺ oň morĺ normaě ASCIÉ Ť texô lineó aó thĺ firsô lineó oć thĺ filĺ followeä bů Ť informatioî sectionó whicč begiî witč á linĺ whosĺ firsô Ť characteň ió á coloî anä enä witč eitheň thĺ firsô linĺ oć Ť thĺ nexô informatioî sectioî oň thĺ enä oć thĺ file. Tree Structures within Indexed HELP Files Aó mentioneä above¬ thĺ Indexeä HELĐ Filĺ ió divideä intď Ť Informatioî Sections¬ wherĺ eacč Informatioî Sectioî startó witč Ť á coloî (:)® Therĺ arĺ twď basiă typeó oć Informatioî Section: 1® Informatioî Sectionó containinç textuaě material» Ť thió typĺ oć Informatioî Sectioî simplů containó readinç materiaě Ť whicč ió organizeä intď Frames¬ wherĺ á Framĺ ió equaě tď onĺ Ť screeî display. 2® Informatioî Sectionó whicč referencĺ otheň HELĐ Ť files» thió typĺ oć Informatioî Sectioî beginó witč twď colonó Ť (::© insteaä oć onĺ aó iî (1© above» thĺ twď colonó arĺ Ť immediatelů followeä bů thĺ namĺ oć thĺ HELĐ filĺ (thĺ HELĐ filĺ Ť typĺ maů bĺ optionallů specified). Tď illustrate¬ thĺ followinç outlineó thĺ structurĺ oć thĺ Ť twď typeó oć Informatioî Sections: :Title for Type 1 Information Section : [next Information Section] Figure: A Text (Type 1) Information Section ::HLPFILE <-- for HLPFILE.HLP : [next Information Section] ::HLPFILE.TYP <-- for HLPFILE.TYP : [next Information Section] Figure: Examples of Node (Type 2) Information Sections :HELP: The Tree Structure of HELP -- Basic HELP File -- |Info Sect 1 |Info Sect 2 |Info Sect 3 |Info Sect 4 | | Text | HELP File | Text | HELP File | / \ / \ -- SubHelp File 1 -- -- SubHelp File 2 -- |Info Sect 1 |Info Sect 2 | |Info Sect 1 |Info Sect2| | Text | HELP File | | Text | Text | / \ -- SubSubHelp File 1 -- |Info Sect 1 |Info Sect 2 |Info Sect 3 | | Text | HELP File | HELP File | / \ / \ -- Sub3Help File 1 -- -- Sub3Help File 2 -- |Info Sect | |Info Sect 1 |Info Sect 2| | Text | | Text | HELP File | / \ -- Sub4Help File -- |Info Sect 1 |Info Sect 2| | Text | Text | Figure: Sample HELP File Structure Thĺ abovĺ diagraí ió meanô tď illustratĺ ho÷ treĺ Ť structureó caî bĺ implementeä undeň Versionó 1.´ anä beyonä oć Ť HELP® Aó thĺ useň caî see¬ á ne÷ nodĺ oć thĺ treĺ ió createä Ť wheneveň á HELĐ filĺ ió referenceä bů aî Informatioî Sectioî Ť (aó opposeä tď simplů havinç texô iî thĺ Informatioî Section)® Ť Eacč nodĺ becomeó thĺ basĺ oć á ne÷ tree¬ whicč itselć maů Ť contaiî referenceó tď otheň HELĐ files. Froí thĺ previouó diagraí (feeě freĺ tď refeň bacë tď it)¬ Ť SubHelđ Leveě ł containó twď HELĐ files® Thesĺ caî bĺ entereä Ť froí Informatioî Sectioî ˛ anä Informatioî Sectioî ł oć SubHelđ Ť Leveě 2® Bů simplů enterinç onĺ oć thesĺ twď Informatioî Ť Sections¬ thĺ appropriatĺ HELĐ filĺ ió loadeä anä thĺ useň ió Ť placeä aô thĺ nexô level® Froí thesĺ HELĐ files¬ thĺ useň maů Ť movĺ withiî thĺ HELĐ filĺ itselć oň movĺ uđ tď thĺ previouó Ť leveě (naturally¬ thĺ useň alwayó haó thĺ optioî tď exiô tď Ť CP/M). :HELP: Sample HELP Files Illustrating Use of Tree Structure Thĺ followinç Frameó sho÷ thĺ sourcĺ tď threĺ HELĐ Ť Files¬ nameä DEMO.HLP¬ DEMO2.HLP¬ anä DEMO3.HLP® DEMO.HLĐ ió Ť provideó thĺ Rooô Nodĺ tď á treĺ whicč includeó DEMO2.HLĐ anä Ť DEMO3.HLĐ aó subnodes® Additionally¬ DEMO3.HLĐ haó á subnodĺ Ť whicč referenceó DEMO.HLP¬ sď wĺ havĺ á recursivĺ treĺ Ť structure. DEMO.HLP TEST 1 - OK <-- Menu TEST 2 - SIMPLE NEST TEST 3 - INVOLVED NEST TEST 4 - OK :TEST 1 <-- First Info Section (Text) THIS IS TEST 1 ::DEMO2 <-- 2nd Info Section (Node) ::DEMO3 <-- 3rd Info Section (Node) :TEST 4 <-- 4th Info Section (Text) TO BE, OR NOT TO BE, THAT IS THE QUESTION! ... TO TAKE ARMS AGAINST A SEA OF TROUBLES AND BY OPPOSING END THEM. TO DIE, TO SLEEP ... TO SLEEP, PERCHANCE TO DREAM. AYE, THERE'S THE RUB! FOR IN THAT SLEEP, WHAT DREAMS MAY COME! DEMO2.HLP :TEST 2 <-- No Menu -- 1 Info Section THIS IS TEST 2 DEMO3.HLP TEST 3A <-- Menu TEST 3B TEST 3C :TEST 3A <-- First Info Section (Text) THIS IS TEST 3A the rain in Spain falls mainly in the plain :TEST 3B <-- 2nd Info Section (Text) THIS IS TEST 3B ::demo <-- 3rd Info Section (Node)