ASMED ======================================= ================================== Purpose : the editor is intended for use by the embedded programmers, for work with cross softmares for microprocessors, but also may be used im many other purposes for working with the syntax highlighted text and external programs executing. Main features: Unlimited number of editing files. Unlimited file size. User-Definable SYNTAX HIGHLIGHTING Macros extracting for highlighting Project Navigator (Tree). View compiler's errors/messages and track to source. Variable switching beetween the open editor's windows. External programs (and Help-files) executing. Extending with the plug-ins. All properties are user definable. Menu commands: File - New File - create new text file Open Project - open new project file Open File - open existing text file, if selected file extension is "Pro", it is the same as "Open As Project". It is impossible to open the same file twice! Open As Project - create project, open text file and make in as the main project file. Save - save current file SaveAs - save current file under other name Save All - save all open files Special Save - save current file in HTML or RTF format Save As Project - save the current file as the main file of the project and create the project Close - close current window Close All - close all windows Print - printing text Print Setup - Printer Setup Quit - close all open files and quit the program Edit - Undo - to cancel the last operation (depth is unlimited) Redo - to cancel a command Undo Cut, Copy, Paste, Delete - work with the selected text and the clipboard Find, FindNext - search in the text Replace - search and replacement Show Clipboard - show the texts in the clipboard Project - Create Project - creation of the separate directory for the project, project' file and the main file of the project. Define - to make the current file of the editor by the main file of the project and create the project file Tree - to generate a tree of the project (it made automatically when the project loading) Project Manager - to manage files, parts and archives Extract Macros - extraction of the certain words for their syntax highlighting. Wizard - contains a submenu of Plug-Ins start. ZIP Project - ZIP all files in the directory of the project UnZIP Project - unZIP the project. Tools - Grep - search text in a files. ****** - start of the external programs Options - Font - fontchange: << - decreasing >> - increasing Word Wrap - transposition on/off AutoIndent - alignment on/off Syntax - syntax highlighting on/off Line Numbers - show line numbers on/off All Chars - show spaces, tabs, CR - on/off (these 6 commands act only on a current session) Main Setup - system setup Change - change configuration file New - new configuration file create Edit Current - editing of a current configuration file Edit Config - change and editing confuguration file Tree in Tray - set Project Tree position Panels: File Panel - buttons setup of the editor's panel. Tools Panel - buttons setup of the external programs panel. Plug-In Panel - buttons setup of plug-ins panel. All Up - set all panels at the top. Save Panels - save panel's position Show Tips - show or hide "Do You Know" window. All of setup can be called by a double click on an empty place on appropriate panel. Window - Tile, Cascad, Arrange Icons, Zoom - management of accommodation of windows Next/Previous - switching between the open windows Close - closing current window List - the list of the open windows Notes - loading (or creating) the project' description Pr. Tree - goto to the "tree" (Navigator) window Message - goto the message window Close Tray - hide the tree and the messages windows Help - Well, help is help... And in the "About" window it is possible to look at my face, to send me of e-mail or to visit my Internet Homepage. ======================================= ==================================== Switching between the windows: - Through the list of files in the Windows menu - Through the list of windows (Window menu - > List or Alt-0) - Forwards - back (Window menu - > Next/Previous, F6/Sh-F6) - If windows are maximized - through selection board (under editor's window) Tray (a tree - message board): - It is possible to change the tray vertical size and the relative sizes of the tree and message window. - The extreme left vertical board - button - hides and shows the tree window - The extreme button at the left on a status band - hides and shows the tray - Command in the Window menu - > Pr. Tree/Message/Close Tray - Buttons on a editor' panel. The "tree" window: - show a hierarchy of the project. - on right button click there is a menu - tree window can be placed in the Tray or at the left program window side. - all files from addition parts can be run according to it's extentions. Toolbars: - There is a hide/show button at the left on each panel, by pulling for it is possible to make the panel "floating" - toolbars can be placed at the top or at the left/right. The file of the project' description (Notes): the small template is generated. The project: file: Its text is not visible, this file stored all necessary information - title of the main file of the project, options, project type, etc. ----- Configuration (Options->Setup) Change Setup - load another config. Edit Setup - edit any config. Edit Current - edit current config. New Setup - create new config. New, based on - create new config, using existing. Editor Setup: Configuration Name - title of a configuration Syntax Defining Files - the files of the syntax description. Auto Save - autosaving on/off, switching between all files saving or onlu current file, autosave time. Editor Properties - setup of the editors colors. ---- Test Processing: Tree Strings - words, preceding to a file name Cancel Tree Delimetrs - if this chars are exist BEFORE Tree Strings - that this line is not included in a tree File Delimetrs - numerals, which can enclose a name of the file Extract Macroses - file of a configuration of the macroses extraction Plug-Ins List File - the plug-ins list for this configuration. Search Directories - list of the directories, in which search of files for want of to loading from Tree is make. The directories are separated by ";". External Tools: The list of the external programs, icons on their buttons and hot keys Add - to add tool Edit - to edit tool's parametr Delete - delete tool In adding / editing mode: Title - program name Program - name of the program file (com, exe or CME-file) Prefix - prefix, if is necessary. For DOS programs - "command /c", "start /m" or something else . Working Dir - working directory of the program, usually - $ PROJDIR Parametrs - parameters of start of the program Filter - name of the filter-program , for transition from the errors/messages file to the ASMED format. Tool Button - set-up of an icon on a button of the given program Hot Key - hot key. Help File - help file of the current tool, its hot key is the same as at the tool but with Shift. Metanames in parameters: $PROJFILE - name of the main project file $PROJFILW - name of the main project file without the extension $PROJEXT - extension of the name of the main project file (without a point!) $PROJ2FILE - name of the second compiled file in the combined projects $PROJ2FILW - the same, but without the extension $PROJDIR - project directory $PROJECT - name of the project file $EDFILE - name of the file in the current editor's window $EDFILW - name of the file in the current editor's window without the extension Metainstructions in parameters #WAIT - this metainstruction prohibiting restart of the tool #LOCK - lock all ASMED' controls #SAVEALL - save all open files before tool executing #SAVECUR - save current editor file before tool executing ---- Page File Names: Titles and masks for open/close files, by default consist : files of the projects (*.PRO), text files (TXT, ME, LST, INI, JRN, DIZ) And all files (*. *) Default Extention - extension of the name of files by default. ======================================= =================================== External programs executing: Some programs can require the prefix (command /c for the DOS-programs, Start /option etc.), sometimes is required to set working directory of the program. The command line parameters of sthe tool are set by metanames, which are substituted on the actual values. If the name of the filter-program is defined, it will be ecexuting after the tool with its own parametrs. The filter's directory is the same as tool's directory. The program - filter can be the special program (COM, EXE) or script (MSF), written on a built-in pseudo-BASIC. If during work of a filter the file $asmed.err will be created, it will be automatically loaded in the ASMED' message window. It is possible to execute some programms as one tool - the same as ms-dos .bat file - define .CME file with metanames CME-files: batch files for start of a routine. Each line has the following format: [Pref],prg_name,[w_dir],[param],[Flt_pref],[Flt_name],[Flt_Param] [; comments] If all line is comments - FIRST char must be ";" There should be always 6 commas! Examples: 1. Mpasmwin in the project directory, command line - name of the main project file of the project, then start of a filter mpsm2msg with the prefix "command /c" and command line parametr - Name of the main project file without the extension, with adding of the ".err" extension: ,Mpasmwin, $PROJDIR, $PROJFILE, command /c, mpsm2msg, $PROJFILW.err 2. Start piclab programmer in the project directory, without parameters and filter, with the comment. Command /c, piclab.exe, $ PROJDIR,,,,; Programmer --------- MSF-files: filter script, for converting tool's output file to ASMED format IOt is the program (text file), written on built-in Pseudo-BASIC. It is possible to use variables, functions and conditions. The reserved word REM - exclude this line fron executing. Name of a variable s- up to 8 symbols, first should not be a digit. Two variables are reserved for source and target lines - INPUT and OUTPUT. Conditions: .... IF (expression) .... .... ELSE .... .... ENDIF .... The enclosure of conditions is not supposed! Functions: $ Copy (source, form, count) - Copying "count" of symbols from the "from" position $ Copy2Symb (source, symbol) - Copying symbols to the "symbol" position. $ CopyASymb (source, symbol) - Copying symbols after the "symbol" position. $ Delete (source, from, count) - Delete "count" symbols from the "from" position. $ Pos (substring, source) - Return the position of the "substring" $ ConCat (a1, a2... A10) - Junction up to 10 lines in one $ AddSpace (source, count) - Add right spaces up to length "count" $ DelRSpace (source) - Deleting left and right spaces $ Length (source) - Length of a line $ Insert (string, source, pos) - Insert "string" into "source" from the "pos" position A + B, A-B - mathematic with integers. The enclosure of functions is not supposed! For debugging of the script an edit window have line SOURCE, in which it is necessary is to type an example of compiler's error string The line DEST (destination) - that will be received after script executing. At the left - the help on functions and their arguments is represented. At centre - window for input of the program. On the right - buttons: Test - start of the script Clear - clearing of the script window Save - save and exit Exit - exit without saving ======================================= ====================================== Help System: ASMED have multistage help system. F1 - ASMED' help. Ctrl-F1, Shift-F1, Alt-F1 - user definable help,(Ctrl-F12 is context-sensitive) Each tool may have its own help-file, evoked by Shift+[Tool Hot Key] All help files should be a Windows Help. ======================================= ====================================== Structure of the ASMED directories: .....\ - EXE, CME, MSF, HLP files \PLUGINS\ - PLD, DLL, INI files of the DLLs \CONFIGS\ - CFG, EMC, WRD, OPR files \PROJECTn\ - PRO, TXT, and other files of the project \PROJECTm\ -.... ======================================= ====================================== The reserved extensions: PRO - project file CFG - configuration file EMC - extract macroses definitions PLD - plug-ins list for current configuration CME - batch file for the external tools PRL - language dictionary - prologue WRD - language dictionary - words EPL - language dictionary - epilog MSF - file скрипта of a filter of the messages ======================================= ======================================= (с) 1998 Alex Torres, 2:461/28 Fidonet, altor@geocities.com, altor@chat.ru Http://www.geocities.com/SiliconValley/Lab/6311 ======================================= =======================================