Programmer 7500

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

/ Programmer 7500 / MAX_PROGRAMMERS.iso / EDITORES / CEPE.ZIP / CEPE.DOC < prev next >

Wrap

Text File | 1988-09-30 | 27.5 KB | 758 lines

──────── CεPε ───── Code εditor & Programming εnviroment ──────── Version 2.0 (C) Copyright by José Rodríguez Alvira, 1988 ┌─────────────────────────────────────────────────────────────────────────────┐ │ CεPε is a shareware program. You may distribute this program freely │ │ if no fee is charged and documentation & utilities are included. If │ │ you find this program useful then your contribution will be appreciated. │ │ You will be contacted when next version comes out. │ │ Suggestions are welcomed. │ └─────────────────────────────────────────────────────────────────────────────┘ Features: α Full screen-editor. α Copy, move, delete blocks. α Search & replace words and strings. α Undo α Split screen in user defined windows lets you work with two files at the same time. α Move data from one file to the other. α Quick access to any module of your program. α Compile, Debug & Run your program from the editor environment. α Pop-up decimal/hexadecimal calculator α Background printing α Horizontal and vertical scrolling. α Line numbers compatible with MASM, and most compilers. α Full-screen Graphic characters editor with color support for designing menus. α It draw boxes: ╔═════════════════════════╗ ║ ┌─────────────────────┐ ║ ║ └─────────────────────┘ ║ ╚═════════════════════════╝ α Supports other graphic characters like: ░ ▒ ▓ ╦ ╠ ╣ ╩ ╬ █ ▄ ▌ ▐ ▀ ° ∙ · ┬ ├ ┤ ┴ ┼ « » α And all the Extended Ascii character set: âêîôû£₧ƒ¥áéíóúÿçÇñÑàèìòùÄÉÖÜäëïöü¡¿αßΓπΣσµτΦΘΩδ∞φε∩≡±≥≤⌠⌡÷≈√ⁿ² α Keyboard macros. α Written mostly in Assembly language for speed. ──────── CεPε ───── Editing ─── CεPε works like most editors. After typing a line you can either press ENTER or move the cursor off the line using the arrow keys. Backspace and delete work as usual. Insert mode default is off. Use INSERT to turn it on. An "I" will appear in the top line to indicate it. Lines can be up 256 bytes long. Text scrolls horizontally when you reach column 80. Cursor movement ────── ARROW KEYS - Move cursor HOME - Moves the cursor to the beginning of the current line. END - Moves to the End CTRL+RIGHT ARROW - To the next word. CTRL+LEFT ARROW - To the previous word. TAB - Move cursor to next tab (can be modified). Page movement ─────── PgUp and PgDn - Scroll text one screen up or down. CTRL+PgUp and CTRL+PgDn - Scroll text one line CTRL+HOME - Go to the first line. CTRL+END - Go to the last line. Line editing ─────── ALT+F3 - Adds an empty line at cursor position. CTRL+F4 - Deletes current line. (Copies it to a buffer, see Edit Menu). CTRL+F1 - Deletes to the end of line. ALT+F1 - Makes a new line out of all the characters from cursor position to the end of the line. ALT+F2 - Joins current line and the next line. ALT+F4 - Toggle switch. When ON, each time you press ENTER a new line will be added after current line. Default if OFF. NOTE: For copying, deleting, moving blocks and other editing see Edit Menu. Indentation ─────── Use TAB, Arrow keys or the Spacebar. CεPε will remember the indentation level up to 80 colums. ──────── CεPε ───── Running CεPε ─── Type "CEPE" at the DOS Command line: C>c:\source\cepe You can load up to two files by specifying their names in the command line. There are also two switches: /C ==== Tells CεPε NOT to use colors in case of a color monitor. /K ==== Disable Macros. Example: C>CEPE /K SOURCE1.ASM /C SOURCE2.C You can specify switches anywhere in the command line. ──────── CεPε ───── F2 Main MεNU ─── The Main Menu options are: File Directory, Load File, Save File, File Directory, Open secondary File Close Secondary File, New, Dos Shell, Options and Quit. ┌─────────────────────────────────────────────────────────────────────────────┐ │ │ │ Using CεPε Menus │ │ │ │ CεPε has six Menus. Using the functions keys you can open any one of │ │ them while editing: │ │ │ │ F1 » Help F2 » Main F3 » Edit F4 » Search F5 » Print F6 » Run │ │ │ │ To choose from the PopUp menus you can either press the highlighted │ │ letter of the desired option or use the arrow keys and Enter. │ │ │ │ Pressing Escape closes any menu. You can also use Escape as an Exit key │ │ to almost anything in CεPε. │ └─────────────────────────────────────────────────────────────────────────────┘ ─── Load File ── Select "Load" from the main menu. Type the drive, path and name. ─── Save File ── Select "Save". Type the drive, path and name. If you have previously loaded the file you will see the name of the file already written for you, in this case you can press Enter. ─── File Directory ── Select "File Directory". A box will appear with your default drive and path followed by "*.*" or by "*.EXT" in case you have specified a default extension in "Options" (see below). Press ENTER or type a new search string. A window will appear with the names and the size of the files found. A little arrow will point to the first file. Move the arrow to the name of the file you want to load and press Enter. A menu will appear in the bottom line. You must select if you want to load this file as main file or secondary file. If there are too many files CεPε will write to the screen until the window is full. It will then ask to choose from the files in the window or press spacebar to see the other files available. If CεPε finds a subdirectory it will write it to the screen highlighted. If you choose it CεPε will add it to the search path and show what it finds there. (You must specify *.* to be able to see subdirectories). ─── Load Secondary File ── CεPε lets you work with two files at the same time. When you load a se- condary file the screen will be divided in two. The Main file in the top window, the Secondary file in the bottom window. To modify the size of the window use F7 (will make bottom window bigger) or F9 (make top window bigger). To move the cursor from one window to the other use ALT+F7. You can edit both files and move blocks of text from one file to the other. NOTE: The top line File size, Edit File and Cursor will show the name, size and cursor position of the active file. ─── Close Secondary File ── To close the bottom window choose this option. If your file has been edited you will be asked if you want to save it. So use this option to SAVE secondary files. ─── New ── If you want to begin a new file, New erases whatever you have in memory. If you have two files New will erase the active file. ─── Dos Shell ── This option loads a copy of COMMAND.COM, to return type Exit at the Dos prompt. It can be used to use Dos services from within the Editor. Your files will be safe in memory when you use this option. A copy of the COMMAND.COM must be present in the same drive and path from where your system was booted. ─── Quit ── Returns to DOS. If your file or files have been edited since the last save you will be asked to save them. ─── Options ── When you select "Options" a box with two fields will appear. ┌─────────────────────────────────────────────────────────────────────────────┐ │ Using Fields │ │ │ │ To move to the next field you use TAB, DOWN ARROW or ENTER, To move │ │ to the previous field use SHIFT+TAB or UP ARROW. You can use BACKSPACE, │ │ DELETE and INSERT to edit data in this fields. │ │ │ │ You can exit by pressing ESC. │ └─────────────────────────────────────────────────────────────────────────────┘ You can tell CεPε to use a default extension so that you don't have to specify it when loading or saving files. You can also specify the Tab setting (2-9). If you leave the Default Extension field empty CεPε will not add extensions to filenames. CεPε will add the Default Extension to any filename without extension. You can override the Default Extension setting by adding another exten- sion when you load or save a file. If you want to load a file with no extension add a '.' at the end of the filename. You can save this options to disk by pressing F10. If you don't press F10 what you have entered will work while the program is in memory. To exit the option box press Esc. NOTE: CεPε saves this data in a file called CEPE.SYS. This file is created in the default drive. You can have different CEPE.SYS files in different subdirectories. This way CEPE.EXE can behave differently when you change your default drive or subdirectory. ──────── CεPε ───── F3 Edit MεNU ─── ─── Copy Block ── Before copying, moving or deleting blocks you must first mark it. ┌─────────────────────────────────────────────────────────────────────────────┐ │ Marking Blocks │ │ │ │ Move the cursor to the top or first line of the block. Press F10. │ │ Move the cursor to the bottom or last line of the block. Press F10. │ │ Blocks are marked until you write something, so you must mark and │ │ use these marks inmmediately. │ └─────────────────────────────────────────────────────────────────────────────┘ Once you have marked a block, press F3 to open the Edit Menu and choose Copy Block. The text you have marked will be copied to a special buffer, you can now insert it anywhere in your text or in another file using Insert Block option from the Edit Menu. ─── Insert Block ── Mark and copy a block. Move your cursor to the desired position for the block. Chose Insert Block from the Edit menu. You can copy blocks from the main to the secondary file and from the secondary to the main. Blocks can be also be imported and exported to/from the GRAF EDITOR (see below). You can also copy to a new file you load since text will remain in the buffer until you copy something else. NOTE: When you delete a line using CTRL+F4 it is copied to the buffer, so you can restore it using Insert Block. ─── Del/Move Block ── Works like Copy Block but it deletes from your file the original block. CTRL+F4 works like Del/Move Block but only for the current line. ─── Copying words ── To copy one or more words move the cursor to the first letter you want to copy and press ALT+F10. A "<" will appear, move the cursor to the last letter (in the same line) and press ALT+F10 again (">" will appear). You can now insert this word anywhere by pressing F8. If Insert mode is ON, text will move when you insert a word, if it is OFF, the new word will overwrite the old word. ─── Undo ── You can Undo editing in the current line as long as the cursor has not moved from it using Undo from the Edit menu. To restore a line deleted by CTRL+F4 use Insert Block. ─── Graf ── Selecting this option will take you to a full-screen Extended Ascii Editor. Here you can draw menus for your program. You can exchange data with the Editor as well as save it to disk. When you enter the GRAF EDITOR the screen will clear a the GRAF BOX will appear in the lower left corner: ╔════════════════════════════════════════════════════╗ ║ CURSOR: 21 15 F1 Help F2 Menu Esc Exit ║ ║ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz║ ║│─┌┐┘└├┤┬┴┼║═╔╗╝╚╠╣╦╩╬╒╕╛╘╞╡╥╨╫╓╖╜╙╟╢╤╧╪░▒▓█▄▌▐▀ ║ ╚════════════════════════════════════════════════════╝ You can see in this box what character is assigned to what letter. For example if you press 'A' you will see in the screen '│'. This box also gives you the cursor position (0,0 is the top left corner), and the direction in which the cursor will move after writing a character. In this case it will move down. CURSOR MOVEMENT Use the ARROW KEYS. HOME, END, PgUp and PgDn move the cursor in diagonals. TAB moves the cursor right 10 spaces. F5 moves the cursor left 10 spaces. F6 moves the cursor right 10 spaces. F7 moves the cursor up 5 spaces. F8 moves the cursor down 5 spaces. TO CHANGE CURSOR DIRECTION ==> PRESS F3 TO CHANGE THE CHARACTER SET ==> PRESS F4 You can toggle the GRAF BOX on and off by pressing F9. You can also move it around the screen by pressing ALT+U (Up), ALT+D (Down), ALT+R (Right) and ALT+L (Left). COLORS The default foreground and backgrounds colors are white and black. Use ALT+F10 to select new colors. By selecting a new color and then erasing the whole screen you can change the background color of the whole screen. (See below ERASING THE SCREEN). You can also change the background color of an area by using ERASE BLOCK (CTRL+F4). BLOCKS You can move, copy, delete, change color, and move marked blocks from the Graf Editor to the Editor. TO MARK A BLOCK Press F10, a reverse video Box will appear on the screen. Using the arrow keys move the top left corner of this box to the top left corner of the area you want to mark, press Enter. Now use the arrow keys to move the Bottom left corner and press Enter. The area is marked. You can also use the HOME, END, PgUp and PgDn keys. MOVING A BLOCK Mark and area of the screen. Press CTRL+F1. A Reverse video box will appear around the area you are about to move. Use the arrow keys to move the area around the screen. Press ENTER or ESC to Exit. COPYING A BLOCK Press CTRL+F2 instead of CTRL+F1. Using the arrow keys move a copy of the marked area out of the marked area, press ENTER to exit. You can move the marked area over the screen without erasing anything. CENTERING A BLOCK Mark the block. Press CTRL+F1 followed by the spacebar. CHANGING A BLOCK'S COLOR Mark a block. Press CTRL+F3. Using the arrow keys select the foreground color. Press TAB and use the arrow keys to select the background color. The spacebar will toggle between blink and not blink. Press ENTER to Exit with the new color or ESC to return to the old color. ERASING A BLOCK Mark a block. Press CTRL+F4. A reverse video box will appear to show you the area about to be erased. Press ENTER to erase or ESC to abort. DRAWING BOXES You can easily draw a box by marking an area and pressing ALT+F1. A box will appear. Using TAB you can select different types of boxes. Press ENTER when the desired one appears. ERASING THE SCREEN Press CTRL+F5 and Enter. MOVING DATA BEETWEEN THE EDITOR AND THE GRAF EDITOR. You can move data from the editor to the Graf Editor by using the "Copy Block" or the "Del\Move Block" feature (F3 Edit Menu in the main editor). Go to the Graf Editor, press F2 and select "Insert Block". You can move data from the Graf Editor to the Editor by marking a block and then selecting "Ascii Block" from the Graf Menu. A reverse video box will appear to show you the area that will be copied, press ENTER. Go to the editor, use the Edit Menu's "Insert block" option to insert the Block from the Graf Editor. If you select "Data Block" from the Graf Menu, the marked block will will be copied to assembly language data format. Each character ASCII Code followed by the color atribute. For example: DB 20H,7,0C2H,70H Go to the editor, use the Edit Menu's "Insert block" option to insert the Block from the Graf Editor. SAVING AND LOADING FILES You can save the GRAF EDITOR screen (including colors) by selecting "Save" from the Graf Menu. Using the "Load" option you can load a previously saved file. HELP / EXIT Press F1 for Help, ESC to Exit. ──────── CεPε ───── F4 Search MεNU ─── ─── Find ── When you select Find a box will appear. First using the arrow keys you must select the search mode. A=a means that the search will not make distinctions between upper and lower cases. If you want to make a distinction between them choose A<>a. Press ENTER when the de- sired search mode is selected. Write the string you want to find in the field "Find". Press F10 to begin the search. Text will scroll and the cursor will move to your word or string. If you want to stay there ===> press ENTER If you want to continue searching ===> press the Spacebar If you want to quit the search ===> press Esc When CεPε reaches the end of your file it displays the message "End of Text". ─── Change ── Same as Find. Just fill the extra field "To:" with the new word or string. If you want to change ===> press ENTER If you want to continue searching without replacing ===> press the Spacebar If you want to quit the search ===> press Esc ──────── CεPε ───── F5 Print MεNU ─── To print all your document choose Print All. To print only part of your document mark a block of text and choose Print Block. The text will be printed in the background so you can continue working inside the editor even with the same file your printing. You can cancel the process by selecting "Cancel" from the Print Menu. You cannot use the Run Menu or Exit the program while a file is printing. You can use the Dos Shell but the printing will stop until you go back to the Editor. If you go to Graf editor printing will also stop. NOTES: CεPε sends a form feed to your printer after the last line only when it prints an entire document. You can add most control characters to your text when printing to program your printer. ──────── CεPε ───── F6 Run MεNU ─── You can run your compiler, debugger or almost any program from CεPε. First you must specify the name, drive, path etc., of your programs using Options from the Run menu. ─── Compiler ── You can either use a Make utility or a Batch file to compile your programs. If you have a Make Utility select Options from the Run Menu and enter the drive, path name and EXTENSION of your program in the first field "Compiler /Drive/Path:". Use the second field to enter the command line needed by your program. If you want to use a batch file method then you must enter in the compiler field the name of COMMAND.COM. In the command line field begin by entering "/C" (this switch tells Command.Com to execute the name of the batch file that follows) followed by the name of your batch file. CεPε will give control to your compiler and display the message "Press any key to continue." when the job is done. You will be back in the editor as soon as you press any key. NOTES: When CεPε runs any program from the Run menu it frees all memory used for your text files. This gives your programs as much memory as possible. CεPε will ask you to save any edited file when running a program. You must give the drive, path, and EXTENSION of your files or CεPε will not be able to find them. You can redirect output from your compiler to a file (using ">"). Then you can tell CεPε to load this file as secondary file to see the error messages from your compiler in the bottom window. ─── Debug & Run ── Debug & Run work like Compile. You could even use them to call a compiler or linker. They can be also be used to run utilities programs. ──────── CεPε ───── F1 Help MεNU ─── Program help gives you a table of the keys used by CεPε. There are two ASCII tables. Key codes will ask you to press a key or a combination of keys. It will then displays the ASCII & SCAN codes of the key(s) in hexadecimal notation. The Calculator adds, subtracts, multiplies and divides either in decimal or hexadecimal notation. When you select this option the Calculator appears in the first three rows of the top window. At the left there are two fields "Input Dec" and "Input Hex". This is were you enter the numbers. In the Center there are two fields "Total Dec" and "Total Hex" were the Calculator will write the results of your operations. Use the Tab key to move the cursor from one input field to the other. You must use Decimal notation when you are in the "Input Dec" field and Hexadecimal notation when you are in the "Input Hex" field. Any way as you type a number the Calculator will write in the other field the equivalence. Press Enter and the numbers will move to the Total fields. To add: The calculator default is add, so any new number you type will be added. To substract: Preceed the number with a '-' (decimal only). To multiply: Type the first number. Press '*'. Type the second number. The Calculator will return to default (addition). To divide: Similar to multiply. Use '/' to select division. To Clear: Move cursor to Input Dec. Select Multiply and type Enter. To Exit: Press ESC. The calculator will remain on the screen. Press END, Scroll text or select the top window in case you are in the bottom window to erase calculator from the screen. ──────── CεPε ───── Keyboard Macros ─── You can define up to 10 keyboard macros of up to 15 keystrokes each. Macros are assigned to keys SHIFT+F1 to SHIFT+F10. DEFINING A MACRO Press CTRL+F10. Using the arrow keys and ENTER select a key for your Macro. Press any key. CεPε is now recording your keystrokes. Press ESC to end. Next time you press the SHIFT Function key combination CεPε will repeat all the keys it has recorded. This macros are saved in the default drive in a file named 'CEPE.MCR'. A demo CEPE.MCR file is included. Be sure this file and a file named MACRO.HLP are in the default drive. Press SHIFT+F1. This macro loads a secondary file (MACRO.HLP) that explains the function of the macros defined in the demo file. You can redefine macros as often as you like. When they are modified they are automatically saved to disk by CεPε. You can disable Macros by using the /K switch. This could be useful in case of conflicts with memory resident programs or programs that you want to run from within CεPε's environment. ──────── CεPε ───── Special characters ─── You can easily use many of the extended ASCII characters using ALT+key combination. Program help table will give you a list of all the characters available. There are 3 groups of characters. The first group have all the foreign languages characters (áéíóí etc.), the second group has graphic characters (╦╠╣┌┐└┘ etc.) and the third has mathematical and Greek cha- racters (±≤÷ αßΓπΣ etc.). ALT+F5 ===> Group I ALT+F6 ===> Group II ALT+F8 ===> Group III The GRAF EDITOR (see Edit Menu) offers a more effective way to work with these characters. ──────── CεPε ───── Switches ─── /C = Tells CεPε not to use colors in a color monitor. /K = Use this switch if you don't want CεPε to intercept the Keyboard interrupt. Macros will not work if you use this switch. ──────── CεPε ───── Utilities ─── CUT.EXE will divide a file into several smaller files of 30K each. CεPε cannot work with files bigger than 64k. Use the CUT utility to divide the file into several smaller files. Usage: CUT [Drive],[Path],Filename.ext CUT will create output files in the default drive. They will have the same name as the input file. The extension will be @@A, @@B, etc. After working with this files you can join them using the batch file PASTE.BAT: JOIN OUTPUTFILE.NAME FILE1.@@A FILE2.@@B .... (up to 6 files) GRAF2BAS.EXE Files saved by the GRAF EDITOR can be converted to BASIC'S Bload/Bsave format by this utility. Usage: A>GRAF2BAS <INPUT FILENAME> <OUTPUT FILENAME> /M You must give the two filenames and specify drive or path if needed. The switch can be either C (for color monitors) or M (for mono). If you don't specify any switch, C will be assumed. Your BASIC program would look like this: BLOAD "FILENAME.EXT" Your file will appear on your screen. NOTE: BASIC stores the Video Buffer segment address in the file header. But you can specify the video buffer segment address using DEF SEG to override it. This way the same file could work in both types of monitors. BAS2GRAF.EXE This programs converts a file created by BASIC using BSAVE into a file that can be loaded by GRAF. Works like GRAF2BAS except that there are no switches. Example: A>BAS2GRAF <INPUT FILENAME> <OUTPUT FILENAME> -CRLF Takes out carriage returns and line feeds out of an ASCII FILE. Makes possible to use the DOS's TYPE command to see a file with lines of more than 78 columns. If you leave the carriage and line feeds DOS will put a blank line between each line of your file. Usage: A>-CRLF <INPUT FILENAME> <OUTPUT FILENAME> ──────────────────────────────────────────────────────────────────────── Suggestions are welcomed. Be sure to send me your address so that I can contact you when a new version comes out. Write to: José Rodríguez Alvira, El Monte Sur 190 Apt. B-342, Hato Rey, Puerto Rico, 00918