tHIS PROGRAM IS AN APPLICATION DESIGNED TO GIVE THE TYPICAL PROGRAMMER MORE POWER AND MAKE IT EASY TO USE.
hEADEReDITOR IS A HEADER BLOCK EDITOR. tHE HEADER BLOCK IS THE PART OF EVERY gEOS FILE THAT TELLS THE DESKtOP IMPORTANT INFORMATION ABOUT THE FILE. tHIS INFORMATION IS WHAT YOU SEE WHEN YOU SELECT THE "FILE/INFO" MENU OPTION UNDER THE DESKtOP.
wHY WOULD YOU WANT A HEADER EDITOR? wELL, HAVE YOU SEEN THE APPLICATION THAT WAS ACCIDENTALLY ASSEMBLED AS A DESK ACCESSORY? nOT EXACTLY SAFE PRACTICE, SINCE YOU CAN'T RUN AN APPLICATION AS A DESK_ACC, AND gEOS APPLICATIONS WOULD TRY TO LOAD A PROGRAM THAT'S NOT MADE TO RUN AS A DESK_ACC! hAVE YOU EVER WANTED TO HAVE MORE THAN ONE nOTES FILE ON ONE DISK? i USE NOTEPAD AS MY DAILY DIARY, AND IT'S CONVIENT IF i CAN CHANGE THE nOTES system FILE TO AN appl_data, THAT WAY i CAN CHANGE IT'S NAME AND HAVE MORE THAN ONE ON A DISK! eVER WANTED TO KNOW WHERE CERTAIN PROGRAMS LOAD INTO MEMORY? wITH hEADEReDITOR, YOU CAN EXAMINE A FILE'S LOAD ADDRESSES!
hEADEReDITOR DISPLAYS all INFORMATION ON THE HEADER BLOCK AND DIRECTORY ENTRY OF any FILE! nOT ONLY DOES IT DISPLAY THAT DATA, YOU CAN CHANGE IT TO YOUR NEEDS! aND THE EDITOR WILL ALLOW ENGLISH INPUT! yES, YOU ENTER THE FILE TYPE AS A WORD! aN EXAMPLE WOULD BE, system_boot. tHAT'S HOW YOU CHANGE IT! sIMPLE! nO NUMBERS TO MEMORIZE, NO TABLES TO LOOK UP. aLL YOU HAVE TO DO IS REMEMBER THAT PROPER SPELLING!
@note:
sPELLING IS LISTED IN THE FOLLOWING PAGES, AND CAN ALSO BE REFERENCED IN THE geoprogrammer manual THAT COMES WITH EVERY GEOpROGRAMMER PACKAGE.
tHE PROGRAM WAS MADE FOR gEOS 64, BUT IT WILL WORK IN gEOS 128, IN 40 COL. MODE.
wHEN YOU FIRST RUN hEADEReDITOR, YOU WILL SEE TWO MENU ITEMS. iF YOU ARE RUNNING hEADEReDITOR FROM A REAL DISK DRIVE (AS OPPOSED TO AN reu), YOU WILL EXPERIENCE A BRIEF PAUSE WHILE hEADEReDITOR LOADS IT'S SECOND MODULE INTO MEMORY.
@GEOS -
tHIS MENU ITEM HAS ONE SUBMENU ITEM,
@eDITOR INFO.
tHIS DISPLAYS CREDITS AND MAILING INFORMATION.
@FILE -
tHIS MENU ITEM HAS TWO SUBMENU ITEMS. tHEY ARE
@EDIT A HDR
AND
@QUIT eDITOR.
tHE SECOND ITEM WILL EXIT TO THE DESKtOP. tHE FIRST ITEM WILL DISPLAY A FILE SELECTION DIALOG BOX.
@fILE sELECTION
. tHE FILE SELECTION DIALOG BOX DISPLAYS ALL AVAILABLE FILES ON A DISK. iT CAN LIST UP TO 255 gEOS FILES. tHERE IS AN open, disk, drive, AND cancel ICON. i'LL EXPLAIN THE open ICON A LITTLE LATER; THE OTHER ICONS ARE RATHER SELF EXPLANATORY.
iN THE DISPLAY BOX, YOU WILL FIND SIX MORE ICONS. tHESE ICONS WILL ONLY APPEAR IF THERE ARE MORE FILES THAN WILL FIT IN THE DISPLAY WINDOW. (mORE THAN 6 FILES.) tHESE ICONS CONSIST OF: up, down, page up, page down, top, AND bottom. up SCROLLS THE LIST BY ONE; down GOES DOWN BY ONE; page up AND page down MOVE 6 FILES AT A TIME; top AND bottom WILL MOVE YOU TO THE TOP OR THE BOTTOM.
yOU WILL ALSO SEE, NEXT TO THE DISPLAY WINDOW, AN ELEVATOR. tHIS ELEVATOR WILL ONLY APPEAR IF THERE ARE MORE THAN SIX FILES ON THE DISK. tHIS ELEVATOR WILL MOVE AS YOU SCROLL THROUGH THE FILE LIST. yOU CAN ALSO CLICK IN THE ELEVATOR SHAFT AND MOVE THE ELEVATOR UP AND DOWN THE SHAFT. tO MOVE THE ELEVATOR, YOU MUST CLICK IN THE SHAFT, AND HOLD DOWN THE MOUSE BUTTON. oNCE YOU RELEASE THE MOUSE BUTTON, THE ELEVATOR WILL MOVE THE LIST TO THE NEW POSITION.
tHIS ELEVATOR WILL ALSO CHANGE SIZE DEPENDING ON HOW MANY FILES THERE ARE ON A DISK. tHE MORE FILES ON THE DISK, THE SMALLER THE ELEVATOR; THE FEWER FILES, THE LARGER IT WILL BE. tHE WORST-CASE SENARIO WILL BE IF THERE ARE 255 FILES ON A DISK. iN THIS CASE, THE ELEVATOR WILL BE ONE PIXEL HIGH. nO NEED TO WORRY, SINCE CLICKING ANYWHERE IN THE ELEVATOR SHAFT WILL AUTOMATICALLY ATTACH THE ELEVATOR TO THE MOUSE.
tHERE IS ONE OTHER FEATURE OF THIS DIALOG BOX. iT HAS A BLINKING CURSOR. uSE THIS TO INPUT A FILENAME WHEN YOU KNOW THE NAME OF THE FILE, BUT DON'T FEEL LIKE SEARCHING A LIST OF 200 FILES!
@nOW FOR THE eDITOR.
tHE EDITOR IS ACTIVATED BY SELECTING open IN THE DISPLAY BOX. tHIS open COMMAND WILL OPEN THE HIGHLIGHTED FILE NAME. iT WILL READ IN THE HEADER BLOCK AND THE DIRECTORY ENTRY, AND THEN DISPLAY THE EDIT BOX.
oNCE IN THE EDITOR, YOU WILL SEE A LARGE WINDOW IN WHICH YOU WILL FIND 13 FIELDS. tHESE FIELDS ACT LIKE THOSE OF GEOfILE. tO INPUT SOMETHING IN A PARTICULAR FIELD, CLICK IN THE BOX. yOU WILL THEN SEE A CURSOR AND YOU CAN ENTER THE DATA.
tHE 13 FIELDS ARE AS FOLLOWS:
@fILENAME:
tHIS FIELD DISPLAYS THE FILE NAME OF THE CURRENTLY OPEN FILE. cLICK HERE, AND YOU CAN CHANGE THE NAME OF THE FILE THAT YOU WILL SEE ON THE DESKtOP. iT WILL SEARCH THE DIRECTORY FOR ANY DUPLICATE FILENAMES BEFORE EXCEPTING YOUR INPUT.
@fILE TYPE:
tHIS FIELD DISPLAYS THE cOMMODORE dos FILE TYPE. tHE SIX POSSIBLE TYPES ARE: delETED, seqUENTIAL, prOgRAM, usEr, relATIVE, AND cbm (1581 bam PROTECTION TABLE). yOU CAN ENTER THESE IN UPPER CASE OR LOWER CASE; THE EDITOR WILL AUTOMATICALLY CONVERT LOWER CASE LETTERS TO UPPER CASE. note: THE del FILE TYPE WILL MAKE THE FILE APPEAR AS A DELETED FILE, AND YOU WILL NOT BE ABLE TO REEXAMINE IT. tHE DESKtOP WILL ALSO BELIEVE IT TO BE DEAD. aLSO NOTE, THAT IF YOU MAKE A FILE DELETED, THE BLOCKS THAT IT OCCUPIED WILL STILL BE ALLOCATED, SO A validate UNDER DEKStOP WILL BE NECESSARY.
@gEOS TYPE:
tHIS FIELD DISPLAYS THE GEOS FILE TYPE OF THE CURRENTLY OPENED FILE. tHIS MAY CONTAIN ONE OF THE FOLLOWING: basic, assembly, data, system, desk_acc, application, appl_data, font, printer, input_device, disk_device, system_boot, temporary, auto_exec, AND input_128.
@note: sPELLING COUNTS IN THESE TWO FIELDS!
yOU CAN TYPE IN ANY OF THE ABOVE WORDS, AND hEADEReDITOR WILL PROMPTLY CHANGE THE gEOS TYPE OF THE FILE. aGAIN, YOU CAN ENTER THE WORDS IN UPPER OR LOWER CASE LETTERS.
nOTE:
not_geos TYPES ARE UNABLE TO BE OPENED SINCE THEY DON'T HAVE HEADER BLOCKS.
@sTRUCTURE:
tHIS FIELD DISPLAYS THE gEOS STRUCTURE TYPE OF THE FILE. iT WILL EITHER CONTAIN vlir OR sequential. wHEN YOU CLICK ON THIS FIELD, IT WILL AUTOMATICALLY SWITCH TO THE OTHER STRUCTURE TYPE.
@sTART ADDR:
tHIS FIELD DISPLAYS THE STARTING LOAD ADDRESS OF THE FILE. tHIS ADDRESS IS DISPLAYED IN HEXADECIMAL AND CONTAINS FOUR DIGITS. wHEN ENTERING A NEW ADDRESS, YOU SHOULD ENTER 4 DIGITS. iF YOU ENTER LESS THAN 4 DIGITS YOU WILL GET A WEIRD NUMBER.
eXAMPLE: 0400 (FOR $0400)
@eND ADDR:
tHIS FIELD DISPLAYS THE ENDING LOAD ADDRESS OF THE FILE. tHIS ACTS MUCH THE SAME WAY AS THE START ADDR.
@eXEC ADDR:
tHIS IS THE EXECUTE ADDRESS OF THE FILE. tHIS IS THE ADDRESS THE DESKtOP WILL JMP TO WHEN IT RUNS A FILE. tHIS ALSO ACTS THE SAME AS THE START ADDR.
@pERMANENT:
tHIS IS THE PERMANENT NAME OF THE FILE. tHIS EXISTS ON ALL gEOS FILES. tHIS IS WHAT GEOwRITE AND GEOpAINT SEARCH FOR WHEN YOU WANT TO OPEN A DOCUMENT. cHANGE THIS, AND THOSE APPLICATIONS WILL NOT FIND THIS FILE. oN AN APPLICATION'S HEADER, THIS FIELD WILL BE USED BY THE APPLICATION TO FIND ITSELF FOR SOME VARIOUS DISK ROUTINES.
@aUTHOR/dISK:
tHIS IS THE AUTHOR'S NAME, OR THE DOCUMENTS PARENT DISK. yOU CAN ENTER JUST ABOUT ANYTHING HERE, SINCE NOTHING USES THIS PART OF THE HEADER.
@pARENT APPL:
tHIS IS THE PARENT APPLICATION'S NAME. tHIS WILL ONLY HAVE SOMETHING IN IT IF IT IS A DOCUMENT. iF IT IS AN APPLICATION, IT WILL PROBABLY BE BLANK. tHIS FIELD CAN CONTAIN ANY NAME YOU WISH. tHIS IS WHERE THE DESKtOP LOOKS WHEN YOU DOUBLE-CLICK ON A DOCUMENT, TO FIND THE PROPER APPLICATION TO OPEN THE DOCUMENT. eXAMPLE: GEOwRITE v2.1, TELLS DESKtOP TO LOAD UP GEOwRITE VERSION 2.1 AND OPEN UP THIS DOCUMENT.
@wRITE pROTECT:
tHIS SHOWS WHETHER THE FILE IS WRITE PROTECTED OR NOT. tO CHANGE IT, SIMPLY CLICK IN THE FIELD AND IT WILL SWITCH TO THE OPPOSITE SETTING.
@tIME & dATE:
tHIS SHOWS THE DATE AND TIME IN DECIMAL NOTATION. wHEN YOU ENTER THIS, YOU must ENTER IT AS FOLLOWS: year/month/day {$7b}SPACE{$7d} hour:minute. eNTER THE NUMBERS IN DECIMAL, AND DON'T FORGET THE SLASHES, SPACES, AND COLONS. tHE hour IS IN 24 HOUR TIME.
eXAMPLE: 91/2/8 11:36 (FOR 11:36 am ON fEBRUARY THE 8TH OF 1991.)
@sIZE IN BLKS:
tHIS SHOWS THE SIZE OF THE FILE IN BLOCKS. nOTE, BLOCKS ARE NOT THE SAME THING AS kBYTES. fOUR BLOCKS WILL EQUAL ONE k. tHIS NUMBER must HAVE 4 DIGITS, AND IS ENTERED AS HEXADECIMAL.
eXAMPLE: 002f (FOR 47 BLOCKS)
tHERE ARE ALSO ICONS IN THIS EDIT WINDOW. tHEY ARE:
@sAVE, uNDO, eXIT, ->bUF,
@bUF.
tHE SAVE ICON WILL SAVE THE HEADER BACK TO DISK. tHE uNDO ICON WILL REREAD THE HEADER FROM DISK, READING WHATEVER WAS LAST SAVED. tHIS IS LIKE THE "RECOVER FILE" OPTION UNDER GEOwRITE AND GEOpAINT. tHE eXIT ICON WILL EXIT THE EDIT BOX, not SAVING THE HEADER TO DISK, LETTING YOU THEN LOAD ANOTHER FILE. tHE LAST TWO ICONS MAKE USE OF A BUFFER IN THE APPLICATIONS MEMORY. tHE ->bUF ICON WILL SAVE THE CURRENT HEADER TO THE BUFFER, AND THE <-bUF WILL READ IT BACK IN. yOU CAN WRITE A HEADER INTO THE BUFFER, THEN EXIT, LOAD ANOTHER FILE, AND READ THE ORIGINAL HEADER IN FROM THE BUFFER. note: tHE NAME OF THE CURRENT FILE WILL NOT CHANGE WHEN YOU READ FROM THE BUFFER. (tHERE ARE SOME OTHER BYTES THAT ARE NOT TRANSFERRED. tHEY ARE THE HEADER BLOCK POINTERS IN THE DIRECTORY ENTRY, AND THE "BEGINNING BLOCK" POINTERS.)
@fINAL NOTES.
i WOULD LIKE TO INFORM YOU OF AN IMPORTANT DETAIL. tHAT IS, A not_geos PROGRAM WILL NOT HAVE A HEADER BLOCK. sO, IF YOU CHANGE THE gEOS TYPE TO not_geos, AND SAVE IT, YOU WILL NOT BE ABLE TO OPEN THAT FILE AGAIN. hEADEReDITOR WILL DISPLAY A DIALOG BOX SAYING "tHIS FILE HAS NO HEADER BLOCK." tHE HEADER BLOCK WILL STILL BE ON THE DISK, BUT UNDER hEADEReDITOR, IT IS INACCESSABLE. yOU CAN USE GEOdEBUGGER TO CHANGE IT BACK OR ANY OTHER DISK SECOTR EDITOR.
not_geos TYPES ARE NOT DISPLAYED IN THE LIST WINDOW, but, YOU CAN TYPE IN IT'S NAME IN THE LIST BOX AND IT WILL TRY TO OPEN THAT FILE. aGAIN, YOU WILL SEE THE "NO HEADER" MESSAGE.
aLSO, IF YOU CREATE A DELETED FILE, SAVE IT, BUT DO not EXIT, YOU CAN STILL REPAIR IT. jUST ENTER ANOTHER FILE TYPE OTHER THAN del. iF YOU DO CREATE A del FILE TYPE, THEN YOU BETTER VALIDATE THE DISK FROM DESKtOP. rEMEMBER, ONCE YOU CREATE A del FILE, AND EXIT THE EDIT BOX, YOU WILL NOT BE ABLE TO RETRIEVE THAT FILE WITH hEADEReDITOR. nOTE: tHERE ARE A FEW GOOD FILE RETRIEVERS FLOATING AROUND, SO YOUR FILE IS NEVER REALLY UNRETRIEVABLE.
@bLANK DISKS.
iF YOU TRY TO OPEN A BLANK DISK, YOU WILL GET AN "eRROR READING DISK" MESSAGE.
a DISK WITH
not_geos TYPES ON IT WILL CAUSE AN "eRROR READING DISK" MESSAGE ALSO, SINCE THERE WOULD BE NO FILES THAT YOU COULD EDIT ON THAT DISK.
sOME OF THE FIELDS IN THE EDITOR WILL AUTOMATICALLY CONFIRM YOUR INPUT BY REPRINTING WHAT YOU'VE TYPED. eXAMPLE: yOU ENTER "SYSTEM" FOR THE gEOS TYPE, hEADEReDITOR WILL REPRINT "system" AS A CONFIRMATION OF YOUR INPUT.
@aNOTHER POINT.
iF YOU HAVEN'T NOTICED, THIS PROGRAM WILL NOT LET YOU EDIT THE HEADER ICON. tHIS IS SOMETHING i DECIDED NOT TO DO SINCE THERE ARE AT TWO ICON EDITORS THAT i KNOW OF. oNE OF THEM WAS PUBLISHED IN run MAGAZINE. aNOTHER THING i DON'T EDIT IS THE INFO BOX TEXT. tHIS IS THE TEXT YOU SEE WHEN YOU DO THE "FILE/INFO" MENU ITEM FROM THE DESKtOP. wHY DO ANOTHER FIELD IF DESKtOP DOES IT FOR ME?
important:
@nATHAN fIEDLER DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS PROGRAM, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. iN NO EVENT SHALL nATHAN fIEDLER BE LIABLE FOR ANY SPECIAL, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA, OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE, OR OTHER TORTIOUS ACTIONS, ARISING OUT OF OR IN CONNECTION WITH THE USE OF THIS PROGRAM.
iN OTHER WORDS, YOU BETTER KNOW WHAT YOU'RE DOING BEFORE YOU SCREW UP YOUR DISKS, BECAUSE i'M NOT RESPONSIBLE FOR WHAT YOU DO WITH hEADEReDITOR.
tHANK YOU
(CONT)
@aT THIS TIME,
i WOULD LIKE TO THANK jIM cOLLETTE FOR HIS HELP IN THE ELEVATOR FORMULA. iF HE DIDN'T SHOW ME HOW TO USE IT PROPERLY, hEADEReDITOR WOULD NOT HAVE AN ELEVATOR!
htHANKS jIM!
iF YOU HAVE ANY QUESTIONS, PLEASE MAIL ME AT:
nATE fIEDLER
rD 3 bOX 140
bERNVILLE, pa 19506
oR, IF YOU ARE CONNECTED TO q-lINK, YOU CAN e-MAIL ME UNDER THE SCREEN NAME OF nATEf.
tHIS PROGRAM IS SHAREWARE, AND i'M ASKING FOR ANYTHING FROM $5 TO $10. i MIGHT TRY TO RAISE ENOUGH MONEY SO i CAN BUY A 128 AND PROGRAM gEOS ON THAT.
yOU MAY DISTRIBUTE ONLY IF YOU LEAVE THESE DOCUMENTS AND THE APPLICATION ITSELF INTACT. tHAT MEANS no CHANGES AT ALL, TO THE DOCUMENTS OR THE PROGRAM ITSELF. yOU MAY NOT SELL THIS PROGRAM FOR ANY PRICE, IN ANY WAY, SHAPE SIZE, OR FORM.
i AM ALSO LOOKING INTO MAKING MORE CHAOS GRAPHICS PROGRAMS (sEE "CHAOS" AND "CHAOSSOURCE" IN gEOS aRENA LIBRARIES.). i WOULD LIKE TO GET A BOOK ON cHAOS AND FRACTALS AND MAYBE PROGRAM SOME MROE NEAT LOOKING GRAPHICS. (tHE "CHAOS" PROGRAM UPLOADED BY nATEf WAS ORIGINALLY DON IN basic BY mIKE tRAUM FOR run'S mAGIC cOLUMN.)
(.txt)