.FI .LM 8;RM 72;CE 11 FUNNELWEB 40-COLUMN EDITORS - Vn 5.01 ------------------------------------- Corrected and updated - Mar / 94 Part I -- GENERAL FEATURES -------------------------- (1) Introduction --- ------------ The latest development in the Funnelweb system for the TI-99/4a computer is an extensive rewrite of the 40-column system editor. For better or for worse it remains as compatible with the original TI-Writer and E/A editors as can be managed, with some lessons from experience, since these have been a good match to the capabilities of the basic TI-99 system. The new editor comes in two versions. o - a minimal version with all basic functions, updating the previous Vn 4.40 issue. o - a second form which incorporates multilingual features previously available only in an incompatible form in the European version of TI-Writer. It also has All-Characters mode which allows use on screen of the full 8-bit IBM PC character graphics set (as supported by most modern printers), and provides pathname support for hard drive users and right margin adjust in reformattting also. See FWDOC/ED42 for specific details. These 40-column editors may be used on 80-column systems as well (TI-99 and Geneve) but the standard 80-column version (issued separately - note the new large buffer version using EVRAM 64 Kb buffer does not support 40-col mode) is dual mode and will serve as a superior 40-column editor as well, with much superior SD functions. As in all previous versions it does not depend on any given manufacturer's specific hardware extensions and may be run on a minimal system as long as it can load Funnelweb, the original TI-Writer or E/A modules not being necessary. In particular it is compatible with the Extended Basic module. This part of the documentation covers general features while the second part reviews command line and control functions in more detail. A third part describes the features and limitations of the alternative version (/AEH) of the editor. Those not already familiar with Funnelweb or TI-Writer should consult TI's original manual (which remains TI copyright material and may still be available from TI in the US at final clearance prices), or else various User Groups have tutorial material or experienced users willing to assist. These documents will concentrate on changes from the original TI-Writer. The editor is identified internally as Vn 5.00 (5.01 for new /AEH) but loads with no problems from Vn 4.40 of Funnelweb. At this stage in the history of the TI-99/4a there is no longer any grand plan to issue a full update of Funnelweb, but as individual parts are updated they will be so identified. (2) File Descriptions --- ----------------- This supplementary package contains editor and auxiliary files, and various utility programs. The character files other than CHAR@1 may turn up in archived form. If more than one file fits the category an asterisk is used as wildcard in the name. Entries followed by a "*" have been revised for the Jul/04/93 issue. .LM +3;RM -3 ED, EE -- Baseline editor program files. ED/AEH, EE/AEH -- Program files for enhanced editor. See FWDOC/ED42 for details. * HELP4* -- Help files in program file format with * an alpha character. CHAR*1 -- Character files for Euro-Writer mode. CHAR@* -- Full 8-bit character files for All-Chars version (* numeric). F4TX*E -- Command text language files for E/W and All-Chars. INSTALL/ED -- Configuration utility program. CONFIG/40 -- Fully annotated configuration file. CON/ED -- Abbreviated configuration file. 4PRINTFILE -- Sample help file prototype. HELPMAKE40 -- Help file construction utility. CHRCOAL/S -- Typical source file for PC character sets. CHARUTIL -- Character file analysis utility. FWDOC/ED40 -- This file. * FWDOC/ED41 -- Command and control details. * FWDOC/ED42 -- Enhanced editor special features. * .LM -3;RM +3 The ED, EE, FWDOC/TIWR files from your Vn 4.40 Funnelweb distribution disk(s) are now obsolete, as is the part of FWDOC/EASM describing edit functions. The minimum requirement on your Funnelweb working disk is ED, EE (or another pair renamed to this) for default only use of the editor, with help files as desired. For non-English (E/W or All-Chars) usage, add character and command text files as needed. The language and character files sets are not all complete. This reflects both my limited language abilities and the level of interest in Funnelweb from those parts. German and Swedish are complete, and French largely so. Dutch has some English terms left, but I am assured most Dutch users are familiar with them. Italian is incomplete, and Spanish has not even been considered. It may be that some national language users will prefer to use English command text, in which case the UK file should be copied to the relevant filename. Please contact me if you are able to help with further development of non-English command text files. (3) Editor Modes and Load --- --------------------- The Funnelweb system editor supports two main modes, Word Processor and Programmer's Editor, from the same set of files. The choice is made implicitly from the alternate main Funnelweb selection screens, but may be intercepted and reset at load time. FWDOC/ED41 gives more details of the internal program modes for each of these. The editor files ED, EE are Funnelweb Option 1 program files, as is permanently configured in Funnelweb itself. This means that the main menu may be used to load any other editor (or other program) in this form and name. Going the other way, the Loaders screen may be used to load the files. If s etc are to be visible in the word processor, Option 1 should be used to refresh the character set unless it is configured or forced to load another character file. (4) Character Sets --- -------------- The baseline editor uses the character set C1 or C2 as loaded by the Opt. 1 loader path, while the enhanced editor gives further possibilities. Whatever the character set, the >1F pattern (the edge char in Basic) is always redefined as the solid mid-line for use as a distinctive screen divider in freeze mode. The cursor of the moment is the >1E pattern. The editor files must be loaded from Funnelweb under a 2 letter filename for character, language, and help files to be found. The enhanced editor in its special multilingual modes loads new sets of characters, as described in FWDOC/42. (5) Help Function --- ------------- A series of help screens may be invoked from the main command line. The help screens are loaded from disk as program files direct to VDP screen memory to speed response, and the number is limited only by the filename series. The filenames expected are HELP4A, HELP4B and so on. A set of useful help screens is provided, with more being added for your selection. Some of these will be useful only with All-Chars mode. Content of the help screens is completely at the user's discretion, and a sample original file is included. Help files are prepared as a 24 line by 40 column DV/80 file with the Editor and converted to program file format using HELPMAKE40. The help file loader in the Editor starts with HELP4A unless it has been turned off by INSTALL/ED from the CONFIG/40 specification. If one of the series is not found the loading terminates. Pressing pages forward, pages back, and exits the Help mode. Re-entry to the sequence is at the screen last viewed on the previous invocation of Help. The selection of help screens as supplied in this package have the following contents :- .LM +3;RM -3 HELP4A -- part 1 of a list of Editor functions with keys to use. HELP4B -- part 2 of this list. HELP4C -- summary of Formatter dot commands HELP4D -- details of Editor extended PrintFile options HELP4E -- illustration of box drawing characters for All-Chars mode HELP4F -- other 8-bit characters for All-Chars classified by type HELP4G -- list of All-Chars 8-bit characters in ASCII order HELP4H -- E/A quick reference part 1 for TMS-9900 op-codes HELP4I -- continuation as part 2 of op-code list HELP4J -- E/A quick reference part 3 for system addresses and color table. .LM -3;RM +3 (6) Show Directory Functions --- ------------------------ The Show Directory screen is much the same as in previous Editors. The filename and detail display on each line is similar to that in DiskReview except that no check is done on program file type. Fractured files are indicated by an asterisk. Print Directory now uses and goes to the DirectoryPrint device. This is initialized at load time to the PrintFile device but maintained separately after that.

rotect and nprotect of files now use these more obvious keys. Pressing marks the Display/80 file under the cursor bar in the directory as the LoadTemp file, and pressing marks the Workfile, and pressing riginal restores these to their values at entry to SD. Exit from SD is by . A one way paged file view function is implemented using when a Display/80 file is between the cursor bars, and can scroll through files of indefinite length. The SD screen shows the diskname, sectors used and sectors free counts, and the number of bytes remaining in the text buffer. This includes the effects of buffer encoding and E/W will give a lower figure than 7-bit modes on the same file. The empty buffer value may change with future revisions. (7) New Load/Save Functions --- ----------------------- The Load/Save module now has code which performs extensive validation tests on incoming tab records from any mode into any mode. Loading and saving of text records bypass DSR search and go directly to the opened DSR for improved speed. A line count is at the upper right of the screen. Changes under user selection are in the option codes for PrintFile. .LM +3;RM -3 M -- sets PF to output the file in DisFix/128 TI file format with MS-DOS end of line separators and end of text marker. U -- does similarly for Unix format with separators and at end of text. M and U both cancel the L option for line numbers. P -- if a printer start-up control code sequence has been installed this will be sent to the print device before any text records. Q -- if a printer reset control code sequence has been installed this will send it to the print device after all text records have been output. A -- opens the DV/80 output file in Append mode. This will help editing or construction of very long files. .LM -3;RM +3 There is no provision for external files in the M/U formats to be read in directly, and external conversion programs will be needed to produce DV/80 files first for loading by the Editor. For information on the other PF options carried over from earlier editions, consult the help file for a brief account, or else the TI-Writer manual. (8) Configuration of ED --- ------------------- The program INSTALL/ED (program file - FW option 2 ) allows a range of initial options to be installed in ED from a DV/80 text file. CONFIG/40 is such a file, and is its own documentation. Keep for reference, but a cut down version such as CON/ED will do just as well. The baseline editor ignores all references to language selection. (9) Printing --- -------- The usual Funnelweb modification of the Formatter, or other alternatives such as the RAG Formatter, will work as before with 7-bit files. Printer codes to set national character sets will depend on your particular printer. All-Chars files should print directly from the Editor to printers (most nowadays) that support the PC character graphics set. A rewrite of the Formatter would seem to be in order at this stage, using the existing TI-Writer manual as base specification in the absence of original source code, but life seems just too short with too many other things to do. The existing Funnelweb Formatter functions with the following enhancements over the TI original. .LM -3;RM +3 (i) The printer device-name is preconfigured in the main FW/LOAD program by CF/CG and may be changed to suit your convenience. (ii) The Formatter will display the filename last used or marked. If it cannot locate a name then the utility pathname set in FUNNELWEB with CF/CG becomes the default. (iii) The key now returns directly to FUNNELWEB's central menu screen. The Formatter does not need to reload from disk if reselected immediately. (iv) Pressing AID invokes the a directory routine similar to QD. File QF is loaded if present on the boot disk when the Formatter first loads for this to be available. File marking is active, but is not apparent until the workfile name is edited - is not enough but even a cursor movement will do. (v) The Formatter may now have 4 disk files open at the same time. (vi) The FO/FP files load purely as an Option 2 (E/A 5) program, and another Formatter program in this form may be substituted. .LM -3;RM +3 (10) Fairware Notice ---- --------------- This program is distributed as FAIRWARE. Consequences of its use are entirely the responsibility of the user. The files as sent out are fully functional, unlike the frequent and unpleasant custom of "cripple-ware" in the PC world. The usual FAIRWARE conditions remain in force for this extension of the FUNNELWEB system. If you don't think it is worth supporting or don't bother to, then be honest and don't use it, but at the very minimum please show your appreciation of the free trial by passing it on to others who may. (11) Final Words ---- ----------- Please report any bugs found, or send suggestions. The existing functionality is very close to the limit that can be squeezed into standard TI-99 hardware. If something is added other things may have to give. WARNING - the Myarc HFDC when used as a floppy disk controller is known to corrupt files when multiple fractures occur. At least some DSR ROMs for 80-track operation of Myarc FDCs are known to get wrong last sector allocation in files. The Funnelweb Editor cannot correct for either of these equipment faults. .CO Tony McGovern .CO 215 Grinsell St. .CO Kotara, NSW 2289 .CO Australia .CO (049) 52 3162 .CO Mar 30th / 94 .CO e-mail - phpam@cc.newcastle.edu.au .CO Delphi - GLOBAL01 on TI Net .NF .FI .LM 8;RM 72;CE 8 FUNNELWEB 40-COLUMN EDITORS - Vn 5.00 ------------------------------------- PART II -- COMMAND and CONTROL ------------------------------ (1) Editor Modes --- ------------ Each of the Word Processor (W/P) and Program Editor (P/E) has two sub-modes, toggled by . In W/P these are the familiar word-wrap mode (solid cursor) and fixed mode (hollow rectangular cursor), and are essentially the same as set out in the TI-Writer manual to which you are referred. In P/E mode the initial state is a modified and locked fixed mode with hollow cursor, and is set up for writing source code in languages such as c-99. Tabs are initialized to E/A editor settings. Word-wrap is disabled to prevent accidental reformatting of source files into one giant paragraph, and s are never written except by special character mode. toggles to a new ASMode (with diamond cursor) for writing assembly source code. In this mode each line is partially parsed as assembler code before it is stored in the text buffer when the cursor leaves the line. The label, opcode, and operand fields are automatically up-cased as required by the assembler and some checking is done for common errors such as unmatched quotes or "." instead of "," in the operand field, and non-alpha characters in opcodes. (2) New and Updated Editor Command Line --- ----------------------------------- Several new command line 2-letter entries have been introduced in various categories. An important and the most obvious change to command mode is that text may be scrolled by line or page using the normal set of up/down scroll control keys. This allows the text to be inspected anywhere during command line entries, so that line numbers do not have to be remembered for large Copy/Move/Delete operations. The new entries are specified here by their English language version. .LM +3;RM -3 -- for Tabs is not strictly new, but now brings up a second command line which asks TABSETS (1-3)? and indicates the current setting as the default entry. Tab records are saved with files by the Word Processor and not by the Program Editor, but are recognized by both. -- for Help mode brings up a series of help screens which are loaded from the Funnelweb disk with paging between them by and exit by . See FWDOC/ED40 for details of preparing Help screens. -- for Quick Quit back to F'Web. The editor maintains a "file-edited" flag, and if any text entry has been done since loading or saving the current file, a reminder to save the current work first will be issued. This warning also operates before Purge. -- for LoadTemporary file. The temporary loadfile name may be entered directly, or marked in SD with . This allows for inserting all or part of external files into the edit workfile without disturbing its name. -- for set showDirectoryPrinter name. This allows the device name used by rint Directory in SD to be preset to something other than the PF name. It is initialized to the PF print device at load time. -- for MarK position in file. This sets a marker after line number entry, or else enter this with at the current top line, which may be scrolled to any line in the workfile while still in CMD mode. in Edit mode is an alternative method. -- for choice of WildCard character for use in FS/RS search strings. This initialized as the "*" character. < > -- a blank CMD line. On the main CMD line this returns to the Edit mode at the original exit point. -- from the main command line a number acts like a Show lines command. "E" for EoF is not recognized in this direct return as a letter may conflict with other commands. You can just use a big number, say 2222, instead of but it is easier to use for Show line. .LM -3;RM +3 Some control key presses now have new special functions in CMD mode, and mostly were of no function before. Where the new function also applies in Edit mode it will be listed in that section. For a summary of all key functions see the help screens supplied as HELP4A and HELP4B. .LM +3;RM -3 now writes the current top of page line number at the cursor position on the command line in insert mode. If you must have on the command line use or special character mode. exits from command mode to the current top of page. It has the same effect as followed by . exits from command mode to the departure point from edit mode. .LM -3;RM +3 (3) Find and Replace String --- ----------------------- Find/Replace String commands now take up to 3 numbers ahead of the string entry. Two numbers give the start and finish column for the search. For 3 numbers or 1 number the first or only number is the number of match occurrences to skip before stopping. This is similar to the E/A editor. In case you had not noticed, RS always worked like this. Also when no more matches are found, BOTH FS and RS give an audible bloop and stop where they are. The start position for the search is resumed with . Any non-numeric character may be used as delimiter, so that /ABC/defg/ or -ABC-defg- or aABCadefga as RS string entry will all search for string ABC to be replaced with string defg. A wildcard character, set by , can be included in the search string. The search procedure ignores the character in the text line corresponding to each wildcard occurrence in the search string. Neither delimiter or wildcard can be a regular part of the search string. (4) New Edit Mode Functions --- ----------------------- Changes have been made to the edit control keys so that many functions are available from the left hand in a compact block without stretching. Some keys were already in place such as the cursor diamond which duplicates , and as shadow of . .LM +3;RM -3 pages towards the start of file (). pages towards the end of file ( fctn-4>). places the cursor after the end of the current line and is no longer the alternate Oops key which remains on . shows the first page of the file. shows the last page of the workfile. breaks the current line at the cursor in all modes, but does not enable s with in word-wrap mode. In W/P fixed mode it replaces which splits the line only in wordwrap mode. rejoins lines that has broken. More precisely in wordwrap mode in the W/P it remains as an alternative key to as reformat. In all other modes it inserts the contents of the next non-blank line (blank includes paragraph break lines with only) into the current line at the cursor position. Leading spaces and trailing spaces and s are trimmed from the inserted material. If the effect displeases, just use Oops immediately. So there is now a way in the various fixed modes to insert material into a line without having to retype it. The redefined no longer duplicate . In Program Editor search, instead of for s marking paragraphs, for either asterisks "*" in the first column as marking assembly comment lines, or for the c-99 comment delimiter "/*" at the start of a line. Strictly speaking the search is for the first non-blank line following the target item. This substitutes jumping between comment lines in source code for paragraph jumping in W/P text. It also removes the annoyance of time consuming traversals to the start or end of source files if these keys are accidentally pressed in P/E mode. Some minor changes have been made to improve safety and convenience in editing. in Edit mode now inserts a New line to match usage on PCs, as in Borland editors. Some other new functions are provided. .LM +3;RM -3 freezes the bottom part of the screen under a solid line drawn across the screen on the line below the cursor. Horizontal windowing does not shift the frozen part in 40-column mode. sets a bookmark for the line at the current cursor line. It is equivalent to MarKing in command mode. effectively does a Show Line with the currently marked ( or MarK) line at top of screen. It is reasonably intelligent in the face of changing workfile contents, and if confused reverts to line #1. It has been disabled as the system reset key combo. returns to the Original line after some operations such as , RS, and FS. in the Program Editor only, inserts a blank line following the current line and places the cursor on the new line under the first character of the current line. If this line was blank the cursor stays in its current column. It retains its New Para function in word processor mode. in the Program Editor only, deletes the current line if and only if it is blank between the current left and right margins. This makes it a lot safer for deleting a bunch of blank lines than which can do real damage in careless moments. It remains as Reformat in W/P word-wrap mode (solid cursor). .LM -3;RM +3 (5) Performance Enhancements --- ------------------------ This update retains all enhancements of recent Funnelweb editor versions over the TI original, and those not mentioned elsewhere in these notes are listed here. .LM +3;RM -3 (i) Text buffer capacity in 7-bit modes is increased by improved encoding, the degree depending on buffer contents. (ii) The color selections using are the 10 configured in FUNNELWEB using CF/CG. (iii) The printer device-name is read in from the main program and used as default for PF and directory printout in SD. (iv) The current Funnelweb system workfile name is used as LF and SF default. At the initial Funnelweb load a default workfile name may be configured with CF/CG into FUNNELWEB. If left blank the default utility pathname or the pre-existing filename will be set. If your system has 32Kb RAM in battery backed form, as on some RAMdisks, it may well survive power cycling if not otherwise wiped out by programs such as MENU on HRDs. Use FW as your auto-boot program on HRDs. (v) The system Quit key ( in AVPC machines) remains disabled at all times while in the Editor, including SD. (vi) The text buffer manager routines have been completely rewritten and screen painting has been speeded up slightly to give "crisper" screen scrolling. Delay in word-wrap has been reduced so that there is less problem with loss of keystrokes, and Reformat is faster. (vii) Delete Lines is greatly speeded up, particularly on freshly loaded files. (viii) Copy Lines is now very rapid, and does not leave partial copies if 'Text Buffer Full' would occur. (ix) Move Lines is now instantaneous and no longer can cause the 'Text Buffer Full' condition. It now merely shuffles line numbers instead of copying and then deleting. I have a suspicion TI's programmers were following big company rules for structured programming, with the usual result of bloated and slow code. (x) A right margin warning beep has been incorporated as a beep occurring 5 spaces in from the right margin during typing. (xi) Alpha case conversion is provided, in either Edit or Command modes. converts a lower case letter under the cursor to upper case, and below it on the keyboard converts upper to lower case, with auto-repeat. (xii) The End-of-File message has been replaced with a full width ruler line which shifts with window and line number selection. (xiv) The margin release key now gives full release on both left and right margins. .LM -3;RM +3 (6) No Longer Supported --- ------------------- The Recover Edit function from the command line is no longer included. This had lost most of its original function in Funnelweb as the text buffer contents are overwritten on return to Funnelweb, unlike the original TI-Writer which returned to GPL code in the module GROM. As noted above under Quick Quit, a warning is issued if the file contents have been added to since last loading or saving. This matches common practice on PCs. The Oops line recovery function remains unaltered on . APPENDIX - Updates and Bugfixes ------------------------------- Updates are mentioned only briefly. For details of new or improved features, see the relevant sections of these document files. .LM +3;RM -3 o May 1993 -- Initial release o July 1993 -- Second release Changes : (1) Program files provided for basic editor, and for an enhanced version, which now gives the Euro-writer support. (2) Keys in SD in both editors altered so that replace for page up/down. no longer exits SD in normal ED. System consistent delay loops used in SD also. (3) Command language text auxiliary files removed to special request status. Bug-Fixes : (1) Reloading of FW/LOAD from enhanced ED has been reworked and corrected. (2) el files in enhanced SD now returns correctly, and Directory print-out corrected in both versions. o March 1994 - third release Changes : (1) Right Margin Adjust added to /AEH version, using as alternatve reformat key. Bug-Fixes (1) RS fixed in /AEH to match correction in fixed baseline model. .LM -3;RM +3 .CO Tony McGovern .CO 215 Grinsell St. .CO Kotara, NSW 2289 .CO Australia .CO (049) 52 3162 .CO Mar / 30 / 94 .CO e-mail phpam@cc.newcastle.edu.au .CO Delphi GLOBAL01 on TI Net .NF .FI .LM 8;RM 72;CE 11 FUNNELWEB 40-COLUMN EDITORS - Vn 5.01 ------------------------------------- Corrected & enhanced - Mar,Apr / 1994 PART III -- ENHANCED EDITOR --------------------------- (1) The Alternative Editors --- ----------------------- This package of files for the Vn 5.01 Funnelweb 40-column Editor contains a further set of editor program files under the modified names ED/AEH, EE/AEH. The one you choose to use should be renamed to ED, EE for use on your Funnelweb work-disk if you require language capability, or the pathname facility. Alternatively, either or both sets may be given another 2-letter name set to load from another central menu slot, or from a User List. These files provide all functions of the baseline 40-column editor except that right margin adjust, TI EuroWriter, PC character graphics capability, and pathname functions in SD, have been added. These have until now been available only in the 80-column Editor. A minor disadvantage of the enhanced editor is that the program files take more room on disk. The price paid for this increased functionality is that the Funnelweb kernel can no longer be stored in VDP during Editor operation for instant reappearance on exit, but must be reloaded from the Funnelweb boot-disk. This is handled automatically, but will cause noticeable delay from floppy disk. Users of Horizon or similar RAMdisks will hardly notice the change, and it should be quite rapid from hard disk. You will however lose any on-the-fly customizations, such as marking of program or object file defaults for the Loaders screens. If neither FW or LOAD are found, it will return to the title screen. Operation is similar to that used on the earlier FW version of DM-1000 except that the original boot path is assumed always, with no option to change it. We recommend that users with 80-column capability use the original small buffer 80-col Editor instead, as it supports all features of both 40-col editors and more, and can display in 40-col mode also (but not the new 64 Kb EVRAM buffer version). This is still on the 80-col or combo disks as files E8, E9. (2) Language Capability --- ------------------- TI released in Europe in 1983 (in Germany at least) a multilingual Version 2.0 of TI-Writer which supported the range of languages implicit in the TI-Writer module selection screen. We will refer to editors of this style as Euro-Writer or E/W. Unfortunately E/W writes Tab records to file which are fatally incompatible with the original USA issue of TI-Writer. It also had a whole range of auxiliary text and character files, and a new Formatter with special transliteration files for the new characters. The new Funnelweb Editor supports both the original TI/Wr and E/W with selection at load time, either preconfigured (see later) or from the selection screen. The file loader handles all existing tab records (TI-Wr, E/W, F'Web) transparently. The user selection screens are brought up by pressing as the program starts. First choice is between Word Processor and Program Editor. The next choice is from 3 options. .LM +3;RM -3 <1> Default 7-bit, in which no further character or command files are loaded. <2> National 7-bit, which is standard TI-Wr, but loads national command and character files. This will be useful in languages and applications which can coexist with a modified 7-bit character set, and is available in both enhanced editors. <3> All-characters, which supports the PC character graphics set as implemented in most modern printers. It is described in detail in a later section. <4> TI Euro-Writer, which apart from some redefined normal characters, allows entry of various modified versions of vowels, using keys and . These are encoded as ASCII 128 to 167 (>80 - >A7). You will need your Euro-Formatter and transliteration files to handle these E/W files correctly in printing if they contain modified vowel characters. These are NOT provided with this package. .LM -3;RM +3 The next option box allows selection (1-8) of the various national languages. Option 1, Default, is the base line option with no further file loads. Modes (2-8) use various auxiliary files. National 7-bit and E/W mode load text/command files F4TXE, and the TI E/W files CHAR1. Loading an E/W file into the 7-bit Editor modes may corrupt the file as the MSbit is stripped from all characters. If in doubt, load into E/W mode. (3) Euro-Writer Operation --- --------------------- Some new key functions are used in Euro-Writer mode, on keys which were not used in the original TI-Writer. They are enabled when E/W mode is configured or selected at load time. .LM +3;RM -3 in Euro-Writer mode only, modifies the normal vowel under the cursor to one with a circumflex accent. Vowels so modified must be retyped to normal form for changing the accent. Some of the modified forms may already be available in some national character files as alternative versions of regular 7-bit ASCII codes. ,, similarly apply umlaut, grave, and acute accents respectively. .LM -3;RM +3 All other functions are as for the baseline editor, except that the tab records written when in specific E/W mode are as for the European TI-Writer and so incompatible with most previous editors. Printing from this version will require the TI Vn 2.0 European formatter as the special characters are not widely supported. No work has yet been done on interfacing the the E/W Formatter, and we do NOT intend to supply it or its auxiliary files. For the moment change the word in your copy at >30 in the first sector of FORMA1 from >130A to >100A so that you at least can use it with Funnelweb or E/A. Edit the drive # and language letter in the string DSK1.TXTFA in sector >0D, and at >20 of sector >0E change >D800 to >9800 to disable the language selection path from the TI/Wr module. (4) All-Characters Operation --- ------------------------ All-Chars allows use of the full 8-bit IBM PC character graphics set as supported by most modern printers, and accessed by printing directly from the Editor via PF (a Formatter version to support this is not available at this time, and may well never be done). New character files CHAR@x are needed on the Funnelweb work-disk. The command text files remain the same as for the 40-column E/W mode, at the cost of a little redundancy in each. National 7-bit mode remains as for the E/W model. This mode may be configured in, or selected from the load time selection screens. A full 8-bit character file, CHAR@x where "x" reflects the language choice is loaded, along with the command text file in languages other than English. The 7-bit characters in the language files are as for E/W and the 8-bit set (ASCII 128-254) are as in the CHAR@1 file. The ASCII control characters are represented in TI-Writer form rather than the IBM code page 437 format. At this time files are as for TI Euro-writer in the 7-bit component. In languages which use 8-bit EuroWriter characters in command text files, these text files may need to be modified (either from source or using a sector editor). In All-Chars mode the text buffer encoding used is as for the EuroWriter mode in that Editor, and buffer capacity will be smaller than for 7-bit modes. Tab records may be configured to be of either original TI-Writer or Euro-Writer form. Remember if you are sending files to other people that only the Vn 5.0x Funnelweb editors will handle both forms gracefully. Loading an All-Chars file into normal mode will in general corrupt the file by stripping out the extra bit set for IBM graphics characters, and in places where this is not done as in Help screens intended for All-Chars advice, random patterns will appear instead. The 8-bit character mode is toggled by pressing , but in the 40-column version there is no specific indication that this mode is in effect except by the characters typed on the screen. The space bar in this mode will result in a character on the screen, and the right shift keys should be used for spacing right. Entering command mode always cancels the 8-bit mode, but it may be reset there. All characters may be entered (ASCII 0-254), but ASCII 255 (which would be in this mode) is always replaced by a regular space (ASCII 32) when a line is transferred to the text buffer (this is because >FF is used as a flag byte in text buffer encoding). This key may be used to correct accidental entries in this mode, but the change to a blank from the marker arrow character will not be immediately apparent on screen. Some tools are included to help construction of char-files. CHRCOAL/S is source code for constructing these from character pattern data. It also serves as an example of how a program written to run under Funnelweb can call system services such as QD directory. CHARUTIL extracts source data from existing char-files. These utilities are included because I found existing public domain char-set tools quite inadequate for practical use. (5) Enhanced Show Directory --- ----------------------- The SD function has been extensively revised for the All-Chars Editor. Individual directory pages now contain up to 16 files, and the current work-file and temporary load-file names are shown explicitly. The drive selection is now entered after the SD screen appears. A second one-time page scrolling View mode is available from , which shows only the first half of each line on the 40 column screen. Particularly with program source files, this may well show enough information for View purposes with less on screen confusion. (6) Enhanced Pathname Support --- ------------------------- The enhanced editor offers the same pathname support functions in SD as in the 80-column Editor. from the command line brings up a pathname for editing. This is initialized at load time as either the Funnelweb utility path or as installed from CONFIG/ED. The pathname entered must end with a "." or it will be ignored. SD then reads the directory associated with this path as described for <0> below. The command line text in the separate command text files does not contain any explicit mention of "HardDisk", to keep these common between both 40-col versions. In HD pathname mode all disk access is at the DSR file level, so fracturing of files cannot be detected. The protection status of files is indicated but cannot be altered, as the sub-programs other than for floppy disk DSRs are not currently supported. Marking and viewing are file level operations and are available as usual. Special behavior for the pathname mode is associated with several keys. .LM +3;RM -3 <0> -- as the disk number reads the Internal, Relative 38 catalog pseudo-file for the pathname as configured or as last entered by from the command line. This entry uses an assembly language version of the standard Basic program for reading the catalog file as specified by TI for any drive or as extended by Myarc to directories on hard drives. This mode operates at file DSR level and a directory so obtained does not indicate fractured files. File protection is shown, but nothing can be done about it, as alteration may require sub-programs not defined for standard floppy disk DSRs. Marking, deleting, and viewing function normally. The sectors used/free display may well be nonsensical for hard disk directories, but is retained for occasions when it is correct. -- in pathname mode reads the parent directory of the currently displayed sub-directory. The sub-directory name is also trimmed off the pathname stored in the name buffer. -- still marks the Display/80 file under the cursor bar as the current workfile, as used for LF and SF. In addition in pathname mode, if the cursor bar is on a Sub-Dir entry, it will cause that sub-directory name to be appended to the existing pathname, and the catalog is generated for that sub-directory. The augmented pathname becomes the current pathname as stored in the name buffer. .LM -3;RM -3 (7) Right Margin Adjust --- ------------------- This provides an alternative path for reformat in word-wrap mode, in which each line is adjusted as its content is decided by the reformat so that an even right margin is obtained, for tidy appearance when printed directly from the Editor, without requiring the Formatter or painstaking adjustment of each and every line. The key which formerly shadowed now adds right margin adjust to each line after the normal reformat has decided what is to be on the line. This paragraph as you see it on screen is an example of its function - it makes more sense in full width texts. The functionality is exactly the same as in the new large buffer 80-col editor. Apr/20/94 Modifications o Changes -- Added features are right margin adjust, line hit indicator for RS All. o Bug fixes -- Purge after Quit lockup, replace string corruption and lockups. Tony McGovern 215 Grinsell St. Kotara, NSW 2289 Australia (049) 52 3162 e-mail - phpam@cc.newcastle.edu.au Delphi - GLOBAL01 on TI Net Apr / 20 / 94 .NF