CP/M

home *** CD-ROM | disk | FTP | other *** search

/ CP/M / CPM_CDROM.iso / lambda / soundpot / f / fu-12.lbr / FU.DZC / FU.DOC

Wrap

Text File | 1993-10-26 | 15.6 KB | 387 lines

.mt2 .mb2 .po0 FU-12.COM A File Utility Filσ Utilit∙ i≤ ß ful∞ screeε binar∙ filσ editor« Thσ edito≥ ì screeε anΣ curso≥ function≤ arσ patterneΣ afte≥ Wordstar« Thσ displa∙ ì i≤ identica∞ t∩ DDT« FU-12 als∩ include≤ ß windoweΣ ful∞ functioε ì calculato≥ fo≥ binary¼ hex¼ anΣ decima∞ integer. FU-12.COM 1984 (c) Copyright by Roger Donais Grafton Cole 7506 Republic Court #201 5332 Anchor Court Alexandria VA 22306 Fairfax VA 22032 703-765-0615 703-425-6329 Released for non-commercial, private use only. If you find this program useful and include it in your library, ß donatioε oµ $10.0░, sen⌠ t∩ onσ oµ thσ abovσ addres≤ woulΣ bσ ì áááááappreciated. User response will determine if future updates and similar programs will be released to public domain. In any event, those persons that support us will be notified of all updates, which will be made available for the cost of media and shipping. Futurσ enhancement≤ t∩ FU-12 wil∞ includσ: Codσ sizσ reduction. ImproveΣ full screen editing. Expanding the ^K file manipulation functions. Split screeε viewinτ oµ ß seconΣ file« Thσ seconΣ filσ wil∞ ì ááááááááááááááábe reaΣ onl∙ bu⌠ ß togglσ wil∞ allo≈ al∞ curso≥ anΣ ì áááááááááááááááscrol∞ commands t∩ operatσ oε thσ seconΣ file« Aε ì áááááááááááááááadditiona∞ commanΣ wil∞ al∞ow lockinτ thσ tw∩ file≤ ì ááááááááááááááátogether A ne≈ prograφ tha⌠ wil∞ allo≈ direc⌠ disδ manipulatioε i≤ iε thσ ì áááááworks« I⌠ wil∞ bσ ß merge≥ oµ FU-12 anΣ thσ publiπ domaiε D╒ (Disδ ì áááááUtility). FU-12.CO═ i≤ writteε iε TURB╧ PASCAL« Thσ sourcσ i≤ availablσ fo≥ ì $20.0░ plu≤ mediß anΣ shipping« An∙ comments¼ positivσ o≥ negative¼ anΣ bug≤ report≤ wil∞ bσ ì appreciated --- enjoy. CONVENTIONS USED IN THIS DOCUMENT page 2 of 8\ [xxx] xxx is an optional. Example: [drive] filename. <cr> Carriage return. ^ Indicate≤ thσ followinτ characte≥ i≤ ß contro∞ ì ááááááááááááááááááácharacter. Example: ^C [h] Indicate≤ tha⌠ thσ displa∙ i≤ affecteΣ b∙ termina∞ ì áááááááááááááááááááhigh-lighting¼ i.e« inversσ video¼ dim¼ etc. LOADIN╟ ┴ FILE A>FU-12 B:FOO.BAR Wil∞ invokσ FU-12 anΣ loaΣ thσ filσ FOO.BA╥ froφ ì ááááááááááááááááááááádrivσ B. A>B:FU-12 ááWil∞ invokσ FU-12 oε drivσ B« Yo⌡ wil∞ bσ prompteΣ ì áááááááááááááááááááááfo≥ aε inpu⌠ filσ spec« Thi≤ i≤ thσ pre-edi⌠ ì áááááááááááááááááááááscreen. A>FU-12 - Will invoke FU-12 and bring up the calculator only. Iµ thσ inpu⌠ filσ doe≤ no⌠ exist, ß FIL┼ DOE╙ NO╘ EXIS╘ erro≥ ì message will be displayed and you will be prompted for a new file spec. Thσ entirσ inpu⌠ filσ i≤ reaΣ int∩ memory¼ thu≤ inpu⌠ filσ sizσ i≤ ì limiteΣ t∩ availablσ memor∙ size« Iµ thσ inpu⌠ filσ i≤ to∩ large¼ ß ì FIL┼ T╧ LARG┼ erro≥ i≤ displayeΣ anΣ yo⌡ arσ lef⌠ iε thσ pre-edi⌠ ì screen. A <cr> will exit from the pre-edit mode to the system. THE FU-12 SCREEN DISPLAY page 3 of 8\ Thσ firs⌠ linσ oµ thσ screeε i≤ FU-12'≤ statu≤ line« Thσ seconΣ linσ ì contain≤ ß 'rulerº line« Thσ remainder oµ thσ screeε i≤ divideΣ int∩ ì threσ field≤ iε thσ samσ manne≥ a≤ DDT« Thσ firs⌠ fielΣ show≤ thσ ì addres≤ of the first byte on the line. Thσ seconΣ fielΣ display≤ 1╢ ì byte≤ oµ thσ inpu⌠ filσ iε hex« Thσ las⌠ fielΣ display≤ thσ samσ 1╢ ì byte≤ iε ASCII« Thσ ASCI╔ fielΣ ha≤ thσ seventΦ bi⌠ se⌠ t∩ zer∩ fo≥ ì all bytes. Thus both a 41h and a C1h will be displayed a 'A'. Status line: The status line displays the following information. address The logical hex address of the cursor position. BC:xxxx (Bytσ Count⌐ Thσ tota∞ decima∞ bytσ coun⌠ froφ thσ ì ááááááááááááááááááááábeginninτ oµ thσ filσ t∩ thσ curren⌠ curso≥ ì áááááááááááááááááááááposition. SP:xxxx (Secto≥ Position⌐ Thσ decimal bytσ coun⌠ froφ thσ ì ááááááááááááááááááááábeginninτ oµ thσ curren⌠ secto≥ t∩ thσ curren⌠ ì ááááááááááááááááááááácurso≥ position. SN:xxxx (Secto≥ Number⌐ Thσ decima∞ secto≥ number currentlyì ááááááááááááááááááááácontaining the cursor« Sector numbers begin withì zero.áááááááááááááááááááá SZ:xxxx (SiZe⌐ Thσ last decima∞ sector number iε thσ ì áááááááááááááááááááááinpu⌠ file. Sector numbers begin with zero. **EDIT** [h] Indicate≤ tha⌠ all commands tha⌠ caε physicall∙ ì áááááááááááááááááááááchangσ thσ filσ arσ active. Default is OFF. Wheεeve≥ ß valiΣ commanΣ i≤ entereΣ i⌠ i≤ echoeΣ iε thσ firs⌠ ì threσ column≤ oµ thσ statu≤ line« All commanΣs whicΦ accept aε ì executioε speed wil∞ ech∩ thσ curren⌠ ratσ a≤ ▒ thr⌡ 1░ ì (10=keyboarΣ 0⌐ directl∙ followinτ thσ command« Defaul⌠ i≤ 7« Thσ ì speeΣ may bσ continuousl∙ changeΣ whilσ thσ commanΣ i≤ operatinτ witΦ ì 1 a≤ thσ fastes⌠ speeΣ anΣ ░ thσ slowes⌠ speed. Iµ ß commanΣ require≤ additioε input¼ thσ statu≤ linσ i≤ cleareΣ ì excep⌠ fo≥ thσ command« Thσ promp⌠ wil∞ appea≥ afte≥ thσ commanΣ anΣ ì thσ inpu⌠ wil∞ bσ echoeΣ afte≥ thσ prompt« Iµ additiona∞ inpu⌠ i≤ ì required¼ thσ statu≤ linσ i≤ agaiε cleareΣ fo≥ thσ ne≈ promp⌠ anΣ ì input. THE FU-12 SCREEN DISPLAY page 4 of 8\ Rule≥ linσ [h]║ Iε botΦ thσ he° anΣ ASCI╔ field≤ thσ lo≈ nibble oµ thσ addres≤ ì ááá(displayeΣ a⌠ thσ beginninτ oµ thσ line⌐ i≤ displayeΣ ove≥ thσ ì áááappropriatσ byte. Addres≤ Column║ Addresse≤ arσ alternatel∙ high-lighteΣ t∩ indicatσ onσ secto≥ ì áááblocks« Thi≤ allow≤ visua∞ determinatioε oµ secto≥ boundaries« ì áááHigh-lightinτ i≤ baseΣ oε thσ physica∞ secto≥ coun⌠ froφ thσ to≡ oµ ì áááthe file. Entry conventions: Hex number entry is case independent. Incorrec⌠ he° number≤ caε bσ keyeΣ in¼ bu⌠ wil∞ givσ aε erro≥ ì áááwhen entered. A <cr> terminates all command entry. COMMANDS page 5 of 8\ Thσ command≤ arσ patterneΣ afte≥ Wordsta≥ anΣ iε man∙ instancesì arσ identical« ì Program control commands: áá TAB/^I Toggle≤ thσ curso≥ betweeε thσ he° anΣ ASCI╔ fields« Thσ ì áááááááááácurso≥ remain≤ oε thσ curren⌠ byte« Thσ curso≥ remain≤ iε ì ááááááááááthe current field for all commands until changed by TAB. ^V Toggle≤ betweeε thσ edi⌠ anΣ non-edi⌠ modes« Thσ statu≤ linσ ì ááááááááááindicate≤ wheε iε thσ edi⌠ mode. ^O Prompt≤ fo≥ aε offset« Thσ offse⌠ (iε hex⌐ i≤ addeΣ t∩ thσ ì ááááááááááfirs⌠ bytσ oµ thσ filσ anΣ reflecteΣ iε thσ addres≤ field. ^P áPrompt≤ fo≥ aε offset« Thσ offse⌠ (iε hex⌐ become≤ thσ ì áááááááááábytσ a⌠ thσ curren⌠ curso≥ positioε anΣ is reflecteΣ iε thσ ì ááááááááááaddres≤ field« The ruler linσ i≤ no⌠ changed. All entries on the status line, with the exception of the hexidecimal cursor address contiue to reflect physical positioning within the file. Cursor and scroll commands: ^S (^H) Cursor left one character ^A Cursor left one byte in hex field, else same as ^S (^H) ^D Cursor right one character ^F Cursor right one byte in hex field, else same as ^D ^E Cursor up one line ^X Cursor down one line ^QE Cursor to top of screen ^QX Cursor to bottom of screen ^QS Cursor to left margin of field ^QD Cursor to right margin of field ^QR Cursor to the beginning of the file ^QC Cursor to the end of the file ^Z Scroll up one line ^C Scroll up one screen ^QZ Continuous upward scroll with speed control ^W Scroll down one line ^R Scroll down one screen ^QW Continuous downward scroll with speed control ^G Prompt≤ fo≥ ß he° address« Wheε executeΣ witΦ ß valiΣ he° ì áááááááááááaddres≤ thσ displa∙ i≤ updateΣ t∩ the ne≈ address¼ anΣ thσ ì ááááááááááácursor is placed on the appropriate byte. The address is the logical address as modified by an offset established with the ^O or ^P commnads. COMMANDS page 6 of 8\ File manipulation: Sincσ FU-1▓ log≤ ofµ al∞ drive≤ beforσ savinτ ß file¼ yo⌡ ì ma∙ freel∙ changσ disk≤ withou⌠ incurrinτ ß disδ changσ error« ┴ ì previou≤ BA╦ filσ havinτ thσ samσ namσ a≤ thσ edi⌠ filσ wil∞ bσ ì eraseΣ anΣ thσ editeΣ filσ saveΣ a≤ typσ $$$« Iµ operatioε wa≤ ì successfull¼ thσ origina∞ inpu⌠ filσ i≤ renameΣ t∩ BA╦ anΣ thσ ì temporar∙ $$ñ filσ i≤ renameΣ t∩ thσ origina∞ filσ type« FU-1▓ ì wil∞ asδ fo≥ you≥ confirmatioε beforσ i⌠ wil∞ abandoε ß dirt∙ ì filσ (onσ tha⌠ wa≤ changeΣ during edit). ^KA Abort to system, do not save file ^KQ Quit to pre-edit, do not save file ^KS Save file, cursor and display remain unchanged ^KD Save file, exit to pre-edit ^KX Save file, exit to system Find command: ^QF Searche≤ thσ filσ fo≥ thσ inpu⌠ string« Unles≤ otherwisσ ì ááááááááááádirected¼ thσ searcΦ begin≤ a⌠ thσ curso≥ positioε anΣ ì áááááááááááproceed≤ t∩ thσ enΣ oµ thσ file« Thσ curso≥ wil∞ sto≡ oε ì áááááááááááthσ firs⌠ bytσ oµ thσ firs⌠ strinτ tha⌠ matche≤ thσ inpu⌠ ì ááááááááááástring« Thσ inpu⌠ strinτ caε bσ eithe≥ hex¼ ASCII¼ o≥ ß ì ááááááááááácombinatioε oµ both« áááááááá Wheε invokeΣ yo⌡ wil∞ bσ prompteΣ fo≥ ß searcΦ string« ì áááááááááááAfte≥ strinτ entry¼ yo⌡ wil∞ bσ prompteΣ fo≥ option≤ entry« ì áááááááááááIµ n∩ strinτ i≤ entered¼ ß <cr╛ wil∞ abor⌠ thσ finΣ ì ááááááááááácommand« Thσ searcΦ i≤ donσ iε thσ backgrounΣ (n∩ screeε ì áááááááááááupdate)¼ however¼ tw∩ he° number≤ followinτ thσ commanΣ oε ì áááááááááááthσ statu≤ linσ givσ thσ followinτ information« Thσ firs⌠ ì áááááááááááhe° numbe≥ i≤ thσ logica∞ beginninτ o≥ enΣ oµ thσ file¼ ì ááááááááááádependinτ oε whethe≥ thσ searcΦ i≤ backwarΣ o≥ forward« ì áááááááááááThσ seconΣ he° numbe≥ i≤ thσ logica∞ bytσ addres≤ whicΦ i≤ ì ááááááááááábeinτ compareΣ fo≥ ß match. String Entry: Each hex byte must be proceeded a '$'. ASCII is taken as is. Space is a character. An ASCII '$' is entered as $24. EXAMPLE: $1B$65THIS IS INVERSE VIDEO$0D Options: case and order independent ┬ SearcΦ froφ curso≥ positioε t∩ beginninτ oµ ì file. U Ignore case in both input and target string. $hh Byte wide bit mask where hh is a hex number. Thσ masδ i≤ logically anddeΣ witΦ botΦ thσ inpu⌠ strinτ and the target. EXAMPLE: $7F would mask the 7th bit ^L Continue search for next match. ^U Abort the search. THE CALCULATOR page 7 of 8\ Invokinτ thσ calculato≥ open≤ ß windo≈ a⌠ thσ bottoφ oµ thσ ì display« Iµ thσ curso≥ i≤ iε thσ windo≈ wheε thσ calculato≥ i≤ ì invoked¼ thσ displa∙ wil∞ scrol∞ s∩ tha⌠ thσ curso≥ linσ i≤ iε view« ì Wheε thσ calculato≥ windo≈ i≤ closed¼ thσ origina∞ displa∙ i≤ ì restored. Thσ calculato≥ i≤ compriseΣ oµ aε inpu⌠ register (x⌐ anΣ threσ ì stacδ register≤ (y¼ z¼ anΣ t)« Entr∙ anΣ operatioε is iε RPN« Iµ yo⌡ ì arσ familia≥ witΦ Hewlett-PackarΣ calculators¼ thσ operatioε i≤ ì identical. Thσ displa∙ show≤ al∞ fou≥ register≤ fo≥ threσ differeΣ numbe≥ ì bases« Thσ lef⌠ i≤ hex¼ cente≥ i≤ decimal¼ anΣ righ⌠ i≤ binary« Al∞ ì threσ numbe≥ basσ display≤ arσ kee≡ curren⌠ regardles≤ oµ whicΦ numbe≥ ì base you are working with. Thσ curso≥ wil∞ bσ displayeΣ t∩ thσ right oµ thσ ° register oµ thσ ì curren⌠ numbe≥ base« Numbe≥ entr∙ i≤ right justified¼ anΣ appear≤ iε ì the x register.ì Number entry and display format: Maximum number size: Decimal 65535 Hex FFFF Binary 1111 1111 1111 1111 All overflow or underflow is ignored áááá Thσ decima∞ displa∙ ha≤ tw∩ columns¼ onσ fo≥ signeΣ number≤ ì áááááááanΣ onσ fo≥ unsigneΣ decimal« Onl∙ unsigneΣ decima∞ entr∙ ì ááááááái≤ allowed¼ bu⌠ result≤ oµ al∞ calculation≤ wil∞ bσ displayeΣ ì áááááááiε botΦ columns« ┴ minu≤ entr∙ caε bσ made b∙ ì ááááááásubtractinτ aε unsigneΣ numbe≥ froφ zero. ┴ specia∞ modσ oµ entr∙ allow≤ direc⌠ entr∙ oµ thσ valuσ oµ ì áááááááan∙ ke∙ oε thσ ke∙ board« Wheε thσ ES├ ke∙ i≤ pressed¼ thσ ì ááááááácurso≥ i≤ replaceΣ b∙ 'Ascii'« Thσ nex⌠ ke∙ presseΣ wil∞ ente≥ ì áááááááthσ eigh⌠ bi⌠ valuσ thσ thσ key« Thi≤ include≤ shifted¼ alt¼ ì áááááááanΣ contro∞ keys. Register actions: |t register| stack lift: x>y y>z z>t and t is discarded |z register| |∙ registerⁿ stacδ drop║ thσ resul⌠ oµ aε operatioε oε ì |x register| x and y is placed in x. zero>t t>z z>y Numbe≥ entr∙ i≤ terminateΣ anΣ appropriatσ ì ááááááááááááááááááááááááástacδ operation≤ performeΣ b∙ al∞ calculato≥ ì ááááááááááááááááááááááááácommand≤ except DEL. THE CALCULATOR page 8 of 8\ Commands: ^╘ Open≤ thσ calculato≥ window« Oncσ opeε ^╘ toggle≤ betweeε thσ ì ful∞ screeε edit mode anΣ thσ calculator« Wheε iε thσ ful∞ ì áááááááscreeε edi⌠ modσ al∞ ful∞ screeε command≤ arσ iε effect« Wheε ì áááááááreturninτ t∩ thσ calculator¼ i⌠ i≤ iε thσ samσ statσ a≤ beforσ ì ááááááátoggleinτ t∩ thσ ful∞ screeε edit. ^├ Close≤ thσ calculato≥ window« Thσ windo≈ caε onl∙ bσ closeΣ ì ááá whilσ iε thσ calculato≥ mode¼ sincσ ^├ i≤ ß scrol∞ commanΣ iε ì áááááááthσ ful∞ screeε edi⌠ mode« Wheε thσ calculato≥ i≤ reopened¼ ì áááááááit i≤ iε thσ samσ statσ i⌠ wa≤ lef⌠ iε wheε thσ windo≈ wa≤ ì ááááááápreviousl∙ closed. ^D (^F) Circula≥ movσ righ⌠ betweeε numbe≥ base display≤ t∩ ì áááááááááááááááselect the current working number base. ^╙ (^H,^A⌐ Circula≥ movσ lef⌠ betweeε numbe≥ base display≤ t∩ ì select the current working number base. Stack operations: ^E Circular roll up of the registers. x>y y>z z>t t>x ^X Circular roll down of the registers. x>t y>x z>y t>z ^V Swaps x and y registers DELete Durinτ numbe≥ entry¼ thσ DE╠ wil∞ deletσ onσ digit¼ ì ááááááááááááááái.e« i⌠ perform≤ ß shif⌠ right« Afte≥ aε entr∙ ha≤ ì ááááááááááááááábeeε terminated¼ thσ DE╠ wil∞ clea≥ thσ ° register t∩ ì ááááááááááááááázero. <cr> ENTE╥ terminate≤ numbe≥ entry¼ x>∙ anΣ thσ remaininτ ì ááááááááááááááástacδ i≤ lifted« Operations: + (=) arithmetiπ add, x is added to y, stack is droppedì - (_⌐ arithmetiπ subtract¼ ° i≤ subtracteΣ froφ y¼ stacδ dropsì * arithmetiπ multiply¼ y is multiplied by x, stack dropsì / (?,`,~) arithmetic divide, x divided into y, stack drops < (,) binar∙ shif⌠ lef⌠ onσ position¼ onl∙ thσ ° registe≥ i≤ ì áááááááááááááááaffected > (.) binar∙ shif⌠ righ⌠ onσ position¼ onl∙ thσ ° registe≥ i≤ ì áááááááááááááááaffected Unfortunatel∙ thσ structurσ oµ thσ prograφ doe≤ no⌠ allo≈ fo≥ ì tablσ ke∙ definitions« Thσ key≤ fo≥ al∞ thσ calculato≥ function≤ werσ ì designeΣ fo≥ easσ oµ usσ oε thσ DIMENSIO╬ 6800░ keyboarΣ (IB═ PC)« ì Iε orde≥ t∩ redefinσ thσ keyboarΣ functions¼ yo⌡ wil∞ neeΣ t∩ changσ ì thσ source and recompile.