home *** CD-ROM | disk | FTP | other *** search
Text File | 1994-06-12 | 35.8 KB | 1,924 lines |
-
- $VER: FileXARexxDocumentation 2.0 (29.5.94)
-
-
- FileX - A binary editor
-
- © Copyright 1993-1994 by Klaas Hermanns
-
- Shareware, all rights reserved.
-
- Introduction
- ************
-
- FileX has an arexx port which is based on the Commodore Amiga User
- Interface Style Guide.
-
- If there is nothing different specified for the PORTNAME at the
- beginning, the port will be named `FILEX'. In case that this port name
- does already exist, a number is being added to the name and increased
- until a not already used name is found. (`NAME'->`NAME.1'->`NAME.2')
-
- The arguments will be evaluated in the way AmigaDOS does. If the
- different argument types are unknown, the following list can be used as
- a reference.
-
- <arg>
- A simple string. It's not necessary to specify the argument's name.
-
- <arg>/S
- Switch. Will be set through declaring an argument.
-
- <arg>/K
- Key word. This argument must be given with an argument's name.
- (`<arg> = value' oder `<arg> value'.
-
- <arg>/N
- Number. This argument must be a decimal number.
-
- <arg>/T
- Changing switch. Through specification of this argument a value
- will change its condition.
-
- <arg>/A
- This argument must be given.
-
- <arg>/F
- The rest of the line will be understood as an argument, although if
- there are some more keywords
-
- <arg>/M
- Serveral values are possible.
-
- For all commands that return something it's possible to set a
- variable to the return value by specifing the name of it with the
- argument VAR. The same applies to the argument STEM and its
- stemvariables.
-
- All commands with an ID argument return rc = 5, if the ID is
- invalid. If there is no ID given the current file/view/window is used
- for the command.
-
- Command overview
- ****************
-
- Name: Arguments => Return codes:
- --------------------------------------------
- ACTIVATE
- ACTIVATEVIEW VIEWID=VID/K/N
- ACTIVATEWINDOW WINDOWID=WID/K/N
- ADJUSTWINDOWSIZE WINDOWID=WID/K/N
- APPEND VIEWID=VID/K/N
- ASSIGNCOMMAND NUMBER/K/N,NAME/K
- CHANGEWINDOW LEFTEDGE/K/N,TOPEDGE/K/N,HEIGHT/K/N,WIDTH/K/N,WINDOWID=WID/K/N
- CLEAR FORCE/S,VIEWID=VID/K/N
- CLOSE VIEW/S,WINDOW/S,FORCE/S,VIEWID=VID=WINDOWID=WID/K/N
- COLUMN DELTA/N/A,VIEWID=VID/K/N
- CURSOR UP/S,DOWN/S,LEFT/S,RIGHT/S,VIEWID=VID/K/N
- CUT VIEWID=VID/K/N
- DEACTIVATE
- EXECUTECOMMAND NUMBER/K/N,NAME/K
- EXPANDVIEW VIEWID=VID/K/N
- FAULT VAR/K,STEM/K,NUMBER/N/A => DESCRIPTION
- FILL VIEWID=VID/K/N
- FIND PROMPT/S,HEX/S,BACKWARDS/S,QUIET/S,TEXT/F,VIEWID=VID/K/N
- FINDCHANGE PROMPT/S,HEX/S,ALL/S,BACKWARDS/S,QUIET/S,FIND,CHANGE,VIEWID=VID/K/N
- FINDNEXT BACKWARDS/S,QUIET/S,VIEWID=VID/K/N
- FONT NAME/A,SIZE/N/A,WINDOWID=WID/K/N
- GETATTR OBJECT/A,FIELD,ID/K/N,STEM/K,VAR/K
- GETBLOCK VAR/K,STEM/K => BLOCK
- GETBYTES VAR/K,STEM/K,POS/N/A,NUMBER/N/A,FILEID=FID/K/N => HEXSTRING
- GOTOBOOKMARK NUMBER/N,VIEWID=VID/K/N
- GOTOBYTE POS/N/A,VIEWID=VID/K/N
- GOTOCOLUMN COLUMN/N/A,VIEWID=VID/K/N
- GOTOLINE LINE/N/A,VIEWID=VID/K/N
- GRABMEMORY START/N/A,END/N/A,FORCE/S,VIEWID=VID/K/N
- GROWVIEW VIEWID=VID/K/N
- HELP VAR/K,STEM/K,COMMAND => COMMANDDESC,COMMANDLIST/M
- INSERT VIEWID=VID/K/N
- LINE DELTA/N/A,VIEWID=VID/K/N
- LOADBLOCK NAME
- LOADCOMMANDS NAME
- LOADDISPLAYTYP NAME
- LOADSETTINGS NAME
- LOCKGUI
- MOVEWINDOW LEFTEDGE/N,TOPEDGE/N,WINDOWID=WID/K/N
- NEW VIEW/S,WINDOW/S
- NEXT VIEW/S,WINDOW/S
- NOP
- OPEN FILENAME,FORCE/S,VIEWID=VID/K/N
- PASTE VIEWID=VID/K/N
- POSITION SOF/S,EOF/S,SOL/S,EOL/S,VIEWID=VID/K/N
- PREVIOUS VIEW/S,WINDOW/S
- PRINT FILEID=FID/K/N
- PRINTBLOCK
- QUIT FORCE/S
- REDO NUMBER/N,FILEID=FID/K/N
- REQUESTFILE VAR/K,STEM/K,TITLE/K,PATH/K,FILE/K,PATTERN/K => FILENAME
- REQUESTNOTIFY PROMPT
- REQUESTRESPONSE BUTTONS/K,PROMPT/K
- REQUESTSTRING VAR/K,STEM/K,PROMPT/K,DEFAULT/K => STRING
- RX VAR/K,STEM/K,CONSOLE/S,ASYNC/S,COMMAND/F => RC/N,RESULT
- SAVE FILEID=FID/K/N
- SAVEAS NAME,FILEID=FID/K/N
- SAVEBLOCK NAME
- SAVECOMMANDS
- SAVECOMMANDSAS NAME
- SAVESETTINGS
- SAVESETTINGSAS NAME
- SETATTR OBJECT/A,FIELD,ID/K/N,FROMSTEM/K,FROMVAR/K
- SETBLOCK BLOCK/A
- SETBLOCKMARK VIEWID=VID/K/N
- SETBOOKMARK NUMBER/N,VIEWID=VID/K/N
- SETBYTES POS/N/A,HEXSTRING/A,FILEID=FID/K/N
- SETSCREEN NAME/K,OWN/S
- SHRINKVIEW VIEWID=VID/K/N
- SIZEWINDOW HEIGHT/N,WIDTH/N,WINDOWID=WID/K/N
- SPLIT VIEW/S,WINDOW/S
- UNDO NUMBER/N,FILEID=FID/K/N
- UNLOCKGUI
- WINDOWTOBACK WINDOWID=WID/K/N
- WINDOWTOFRONT WINDOWID=WID/K/N
- ZIPWINDOW WINDOWID=WID/K/N
-
- Befehlsbeschreibungen
- *********************
-
- ACTIVATE
- ========
-
- Synopsis:
- ACTIVATE
-
- Function:
- Reactivates FileX from iconify.
-
- Example:
- DEACTIVATE /* Equivalent to menu: `Project/Iconify' */
-
- /* Now an icon will appear on the workbench. FileX `sleeps'. */
-
- ACTIVATE /* Open FileX with all windows again */
-
- See also:
- DEACTIVATE
-
- ACTIVATEVIEW
- ============
-
- Synopsis:
- ACTIVATEVIEW VIEWID=VID/K/N
-
- Function:
- Activates an view.
-
- Arguments:
- VIEWID=VID/K/N:
- ID of a view that should be activated.
-
- ACTIVATEWINDOW
- ==============
-
- Synopsis:
- ACTIVATEWINDOW WINDOWID=WID/K/N
-
- Function:
- Activates an edit window.
-
- Arguments:
- WINDOWID=WID/K/N:
- ID of a edit window that should be activated.
-
- ADJUSTWINDOWSIZE
- ================
-
- Synopsis:
- ADJUSTWINDOWSIZE WINDOWID=WID/K/N
-
- Function:
- Adjusts the window to the size of edit views.
-
- Arguments:
- WINDOWID=WID/K/N:
- ID of a window.
-
- See also:
- Menu: `Settings/Adjust window size'
-
- APPEND
- ======
-
- Synopsis:
- APPEND VIEWID=VID/K/N
-
- Function:
- Appends the current block to the end of a file.
-
- Arguments:
- VIEWID=VID/K/N:
- ID of a view that belongs to the file.
-
- See also:
- Menu: `Edit/Append'
-
- ASSIGNCOMMAND
- =============
-
- Synopsis:
- ASSIGNCOMMAND NUMBER/K/N,NAME/K
-
- Function:
- Set one of the commands in the arexx menu.
-
- Arguments:
- NUMBER/K/N:
- Number between 0 and 10 which defines the command's position.
- A requester will appear if no number has been specified.
-
- NAME/K:
- Command's file name. If no name is given a file requester
- will appear.
-
- Example:
- ASSIGNCOMMAND 0 'dh5:myarexxcommands/filexcommand'
-
- See also:
- Menu: `ARexx/Assign command', LOADCOMMANDS, SAVECOMMANDS,
- SAVECOMMANDSAS
-
- CHANGEWINDOW
- ============
-
- Synopsis:
- CHANGEWINDOW
- LEFTEDGE/K/N,TOPEDGE/K/N,HEIGHT/K/N,WIDTH/K/N,WINDOWID=WID/K/N
-
- Function:
- Changes the position and/or size of a edit window.
-
- Arguments:
- LEFTEDGE/K/N:
- New left offset.
-
- TOPEDGE/K/N:
- New top offset.
-
- HEIGHT/K/N:
- New height.
-
- WIDTH/K/N:
- Neq width.
-
- WINDOWID=WID/K/N
- ID of a edit window that should be changed.
-
- If one of these arguments is not given, it is not changed.
-
- Example:
- /* Window to maximum size */
- CHANGEWINDOW LEFTEDGE 0 TOPEDGE 0 HEIGHT 4000 WIDTH 4000
-
- See also:
- ZIPWINDOW, MOVEWINDOW, SIZEWINDOW, Attributes: `WINDOW/#?'
-
- CLEAR
- =====
-
- Synopsis:
- CLEAR FORCE/S,VIEWID=VID/K/N
-
- Function:
- Clears a view.
-
- Arguments:
- FORCE/S:
- The changes requester will be suppressed.
-
- VIEWID=VID/K/N
- ID of a view that sould be cleared.
-
- Return codes:
- rc = 5, if the requester is cancelled.
-
- See also:
- Menu: `Project/New'
-
- CLOSE
- =====
-
- Synopsis:
- VIEW/S,WINDOW/S,FORCE/S,VIEWID=VID=WINDOWID=WID/K/N
-
- Function:
- Closes a view or a window.
-
- Arguments:
- VIEW/S:
- The ID is an view ID.
-
- WINDOW/S:
- The ID is an window ID.
-
- FORCE/S:
- The changes requester will be suppressed.
-
- VIEWID=VID=WINDOWID=WID/K/N:
- ID of a view resp. window that should be closed.
-
- See also:
- QUIT
-
- COLUMN
- ======
-
- Synopsis:
- COLUMN DELTA/N/A,VIEWID=VID/K/N
-
- Function:
- Moves the cursor to the left or to the right.
-
- Arguments:
- DELTA/N/A:
- Number of steps. Positive numbers move the cursor to the
- right.
-
- VIEWID=VID/K/N
- ID of a view.
-
- See also:
- GOTOBYTE, GOTOCOLUMN, GOTOLINE, LINE
-
- COPY
- ====
-
- Synopsis:
- COPY VIEWID=VID/K/N
-
- Function:
- Copies the current marked block to the block buffer.
-
- Arguments:
- VIEWID=VID/K/N
- ID of a view.
-
- See also:
- Menu: `Edit/Copy', SETBLOCKMARK
-
- CURSOR
- ======
-
- Synopsis:
- CURSOR UP/S,DOWN/S,LEFT/S,RIGHT/S,VIEWID=VID/K/N
-
- Function:
- Move the cursor.
-
- Arguments:
- UP/S:
- Moves the cursor one step up.
-
- DOWN/S:
- Moves the cursor one step down.
-
- LEFT/S:
- Moves the cursor one step to the left.
-
- RIGHT/S:
- Moves the cursor one step to the right.
-
- VIEWID=VID/K/N:
- ID of a view.
-
- UP and DOWN as well as LEFT and RIGHT exclude each other.
-
- See also:
- GOTOBYTE, LINE, COLUMN
-
- CUT
- ===
-
- Synopsis:
- CUT VIEWID=VID/K/N
-
- Function:
- Cuts the current marked block out.
-
- Arguments:
- VIEWID=VID/K/N:
- ID of a view.
-
- See also:
- Menu: `Edit/Cut', SETBLOCKMARK
-
- DEACTIVATE
- ==========
-
- Synopsis:
- DEACTIVATE
-
- Function:
- Iconifies FileX. The window will be closed and an icon will appear
- on the workbench.
-
- ATTENTION!: All arexx comannds which output something in an edit
- window or change an edit window in any way, can lead to a crash
- during the iconify.
-
- See also:
- ACTIVATE
-
- EXECUTECOMMAND
- ==============
-
- Synopsis:
- EXECUTECOMMAND NUMBER/K/N,NAME/K
-
- Function:
- Executes an arexx command.
-
- Arguments:
- NUMBER/K/N:
- Number between 0 and 9 of an with ASSIGNCOMMAND installed
- command.
-
- NAME/K:
- Name of an arexx script. Both arguments exclude each other.
-
- See also:
- ASSIGNCOMMAND
-
- EXPANDVIEW
- ==========
-
- Synopsis:
- EXPANDVIEW VIEWID=VID/K/N
-
- Function:
- Expands the current view to its maximum size. All other views in
- the window will become one line height.
-
- Arguments:
- VIEWID=VID/K/N:
- ID of a view.
-
- See also:
- SHRINKVIEW, GROWVIEW
-
- FAULT
- =====
-
- Synopsis:
- FAULT VAR/K,STEM/K,NUMBER/N/A => DESCRIPTION
-
- Function:
- Determines the text belonging to an dos error code.
-
- Arguments:
- NUMBER/N/A:
- Dos error code.
-
- Return codes:
- DESCRIPTION:
- The error text.
-
- Example:
- FAULT 114
-
- /* Result value using localized workbench: */
- /* `: Falsches Namensmuster' */
-
- FILL
- ====
-
- Synopsis:
- FILL VIEWID=VID/K/N
-
- Function:
- Fills the current marked block with the curent fill string.
-
- Arguments:
- VIEWID=VID/K/N:
- ID of a view.
-
- Example:
- /* If there is a block already marked, */
- /* then neutralize it. */
-
- GETATTR VIEW MARK
- if result=TRUE then SETBLOCKMARK
-
- /* Set fillstring to `Fill fillaround!' */
-
- SETATTR APPLICATION FILLSTRING FROMVAR '"Fill fillaround!"'
-
- /* Set cursor to the fill-area's beginning */
- GOTOBYTE 10
-
- /* Set block mark */
- SETBLOCKMARK
-
- /* Move cursor */
- GOTOBYTE 100
-
- /* Fill the area */
- FILL
-
- /* Remove block marking */
- SETBLOCKMARK
-
- See also:
- Menu: `Edit/Fill', SETBLOCKMARK, SETATTR
-
- FIND
- ====
-
- Synopsis:
- FIND PROMPT/S,HEX/S,BACKWARDS/S,QUIET/S,TEXT/F,VIEWID=VID/K/N
-
- Function:
- Searches a string or a hex string within the current file. By
- success, the cursor is being positioned at the string's beginning.
- The search begins at the current cursor position.
-
- Arguments:
- PROMPT/S:
- Opens the searchrequester. BACKWARDS and QUIET will be
- ignored.
-
- HEX/S:
- Hex search.
-
- BACKWARDS/S:
- Search backwards.
-
- QUIET/S:
- No requester if the search fails.
-
- TEXT/F:
- The search string or the hex search string.
-
- VIEWID=VID/K/N:
- ID of a view.
-
- Return codes:
- rc = 5, if the search fails.
-
- Example:
- /* Search the string `$VER:' without opening */
- /* a requester by failure */
- FIND QUIET TEXT '$VER:'
-
- See also:
- Attributes: `APPLICATION/#?SEARCH', FINDNEXT, FINDCHANGE, Menu:
- `Search&Replace/#?'
-
- FINDCHANGE
- ==========
-
- Synopsis:
- FINDCHANGE
- PROMPT/S,HEX/S,ALL/S,BACKWARDS/S,QUIET/S,FIND,CHANGE,VIEWID=VID/K/N
-
- Function:
- Searches a string or a hexstring within a file and replaces it
- throgh a new one. Maybe a requester appears to verify the
- replacement. The search will start from the current
- cursorposition.
-
- Arguments:
- PROMPT/S:
- Opens the search requester. ALL, BACKWARDS and QUIET will be
- ignored. ignoriert.
-
- HEX/S:
- Hex search.
-
- ALL/S:
- All found positions will be replaced without requester each
- time.
-
- BACKWARDS/S:
- Search backwards.
-
- QUIET/S:
- No reqeuster if the search fails.
-
- FIND:
- Search text or hex string.
-
- CHANGE:
- Replace text or hex string.
-
- VIEWID=VID/K/N:
- ID of a view.
-
- Return codes:
- rc = 5, if the search fails.
-
- Example:
- /* Replaces `Claas' by `Klaas' */
- FINDCHANGE QUIET ALL 'Claas' 'Klaas'
- FINDCHANGE BACKWARDS QUIET ALL 'Claas' 'Klaas'
-
- See also:
- FINDNEXT, FIND, Menu: `Search&Replace/#?'
-
- FINDNEXT
- ========
-
- Synopsis:
- FINDNEXT BACKWARDS/S,QUIET/S,VIEWID=VID/K/N
-
- Function:
- Continues the last search operation, i.e. either search or
- search&replace.
-
- Arguments:
- BACKWARDS/S:
- Coninue search backwards.
-
- QUIET/S:
- No requester if the search fails.
-
- VIEWID=VID/K/N:
- ID of a view.
-
- Return codes:
- rc = 5, if search fails.
-
- See also:
- FIND, FINDCHANGE
-
- FONT
- ====
-
- Synopsis:
- FONT NAME/A,SIZE/N/A,WINDOWID=WID/K/N
-
- Function:
- Sets the font of an edit window.
-
- Arguments:
- NAME/A:
- Font name.
-
- SIZE/N/A:
- Font size.
-
- WINDOWID=WID/K/N:
- ID of a window.
-
- Example:
- FONT 'horror.font' 8
-
- GETATTR
- =======
-
- Synopsis:
- GETATTR OBJECT/A,FIELD,ID/K/N,STEM/K,VAR/K
-
- Function:
- Gets the value of one or more variables used in the program.
-
- Arguments:
- OBJECT/A:
- Name of the object.
-
- FIELD:
- Name of the field.
-
- ID/K/N:
- Possible with the objects WINDOW, VIEW and FILE. If not given,
- the current view/window/file is used to determine the value.
-
- If FIELD is not given, a STEM variable must be specified which
- will be filled with all values of the object.
-
- Example:
- GETATTR WINDOW TITLE
-
- /* Result contains now the titel of the window */
- /* Not very interesting, but who cares :-) */
-
- See also:
- Attributes, SETATTR
-
- GETBLOCK
- ========
-
- Synopsis:
- GETBLOCK VAR/K,STEM/K => BLOCK
-
- Function:
- Determines the contents of the block buffer, i.e. the contents
- clipboard.
-
- Return codes:
- BLOCK:
- The block buffer as a hex string.
-
- See also:
- SETBLOCK
-
- GETBYTES
- ========
-
- Synopsis:
- GETBYTES VAR/K,STEM/K,POS/N/A,NUMBER/N/A,FILEID=FID/K/N =>
- HEXSTRING
-
- Function:
- Determines the value of a number of bytes at a position in the
- file.
-
- Arguments:
- POS/N/A:
- Start of the block.
-
- NUMBER/N/A:
- Number of bytes to get.
-
- Return codes:
- HEXSTRING:
- Block as a hex string.
-
- FILEID=FID/K/N:
- ID of a file.
-
- See also:
- SETBYTES
-
- GOTOBOOKMARK
- ============
-
- Synopsis:
- GOTOBOOKMARK NUMBER/N,VIEWID=VID/K/N
-
- Function:
- Sets the cursor to a position previously marked with SETBOOKMARK.
-
- Arguments:
- NUMBER/N/A:
- Number between 1 and 10.
-
- VIEWID=VID/K/N:
- ID of a view.
-
- See also:
- SETBOOKMARK
-
- GOTOBYTE
- ========
-
- Synopsis:
- GOTOBYTE POS/N/A,VIEWID=VID/K/N
-
- Function:
- Set the cursor to a specified position.
-
- Arguments:
- POS/N/A:
- Offset to the start of the file.
-
- VIEWID=VID/K/N:
- ID of a view.
-
- See also:
- COLUMN, GOTOCOLUMN, GOTOLINE, LINE
-
- GOTOCOLUMN
- ==========
-
- Synopsis:
- GOTOCOLUMN COLUMN/N/A,VIEWID=VID/K/N
-
- Function:
- Sets the cursor to a specified column.
-
- Arguments:
- COLUMN/N/A:
- Column number.
-
- VIEWID=VID/K/N:
- ID of a view.
-
- See also:
- COLUMN, GOTOBYTE, GOTOLINE, LINE
-
- GOTOLINE
- ========
-
- Synopsis:
- GOTOLINE LINE/N/A,VIEWID=VID/K/N
-
- Function:
- Sets the cursor to a specified line.
-
- Arguments:
- LINE/N/A:
- Line number.
-
- VIEWID=VID/K/N:
- ID of a view.
-
- See also:
- COLUMN, GOTOBYTE, GOTOCOLUMN, LINE
-
- GRABMEMORY
- ==========
-
- Synopsis:
- GRABMEMORY START/N/A,END/N/A,FORCE/S,VIEWID=VID/K/N
-
- Function:
- Displays a memory area instead of a file.
-
- Arguments:
- START/N/A:
- Start of the memory area.
-
- END/N/A:
- End of the memory area.
-
- FORCE/S:
- If the current file is changed, the requester will be
- suppressed.
-
- Return codes:
- rc = 5, if the requester is cancelled.
-
- Example:
- GRABMEMORY 200000 280000 FORCE
-
- See also:
- Menu: `Project/Grab memory'
-
- GROWVIEW
- ========
-
- Synopsis:
- GROWVIEW VIEWID=VID/K/N
-
- Function:
- If possible the the view grows one line.
-
- Arguments:
- VIEWID=VID/K/N:
- ID of a view.
-
- See also:
- SHRINKVIEW, EXPANDVIEW
-
- HELP
- ====
-
- Synopsis:
- HELP VAR/K,STEM/K,COMMAND => COMMANDDESC,COMMANDLIST/M
-
- Function:
- Finds out either an overview of all specified arexx commands or the
- synopsis of a command.
-
- Arguments:
- COMMAND:
- Commands name, whose synopsis shall be determined.
-
- If COMMAND is not specified, a command overview will be returned.
-
- Return codes:
- If COMMAND is given:
- COMMANDDESC:
- Synopsis of the command. Else:
- COMMANDLIST/M:
- Number of commands and overview of all commands.
-
- INSERT
- ======
-
- Synopsis:
- INSERT VIEWID=VID/K/N
-
- Function:
- Insert the current block of the block buffer at the current cursor
- position.
-
- Arguments:
- VIEWID=VID/K/N:
- ID of a view.
-
- See also:
- Menu: `Edit/Insert', SETBLOCKMARK
-
- LINE
- ====
-
- Synopsis:
- LINE DELTA/N/A,VIEWID=VID/K/N
-
- Function:
- Moves the cursor a specified number of lines up or down.
-
- Arguments:
- LINE/N/A:
- Number of lines. Positive numbers move the cursor down.
-
- VIEWID=VID/K/N:
- ID of a view.
-
- See also:
- COLUMN, GOTOBYTE, GOTOCOLUMN, GOTOLINE
-
- LOADBLOCK
- =========
-
- Synopsis:
- LOADBLOCK NAME
-
- Function:
- Loads a block into the block buffer(clipboard).
-
- Arguments:
- NAME:
- Block name. If not given, a file requester will pop up.
-
- Return codes:
- rc = 5, if the block couldn't be loaded.
-
- See also:
- SAVEBLOCK
-
- LOADCOMMANDS
- ============
-
- Synopsis:
- LOADCOMMANDS NAME
-
- Function:
- Loads a set of arexx comannds.
-
- Arguments:
- NAME:
- If not given, a file requester pops up.
-
- Return codes:
- rc = 5, if the file couldn't be loaded.
-
- See also:
- Menu: `ARexx/Load commands', SAVECOMMANDS, SAVECOMMANDSAS
-
- LOADDISPLAYTYP
- ==============
-
- Synopsis:
- LOADDISPLAYTYP NAME
-
- Function:
- Loads the user display typ.
-
- Arguments:
- NAME:
- If not given, a file requester will pop up.
-
- Return codes:
- rc = 5, if the file couldn't be loaded.
-
- See also:
- Menu: `Settings/Display/#?'
-
- LOADSETTINGS
- ============
-
- Synopsis:
- LOADSETTINGS NAME
-
- Function:
- Loads a settings file.
-
- Arguments:
- NAME:
- If not given, a file requester will pop up.
-
- Return codes:
- rc = 5, if the file couldn't be loaded.
-
- See also:
- Menu: `Settings/Load Settings...'
-
- LOCKGUI
- =======
-
- Synopsis:
- LOCKGUI
-
- Function:
- Locks all edit windows. The user can't make any input. Just size
- and position of the windows can be modified.
-
- Return codes:
- rc = 5, if the windows cannot be locked. This is possible when
- there's still a requester open.
-
- See also:
- LOCKGUI
-
- MOVEWINDOW
- ==========
-
- Synopsis:
- MOVEWINDOW LEFTEDGE/N,TOPEDGE/N,WINDOWID=WID/K/N
-
- Function:
- Moves the edit window.
-
- Arguments:
- LEFTEDGE/N:
- New left offset.
-
- TOPEDGE/N:
- New top offset.
-
- WINDOWID=WID/K/N:
- ID of a window.
-
- NEW
- ===
-
- Synopsis:
- NEW VIEW/S,WINDOW/S
-
- Function:
- Opens a new view(and window).
-
- Arguments:
- VIEW/S:
- The current view is divided into two new views.
-
- WINDOW/S:
- Opens a new edit window.
-
- See also:
- Menu: `Project/(View|Window)/New', SPLIT
-
- NEXT
- ====
-
- Synopsis:
- NEXT VIEW/S,WINDOW/S
-
- Function:
- Activates the next view/window.
-
- Arguments:
- VIEW/S:
- The next view in the current window is activated.
-
- WINDOW/S:
- The next window is activated.
-
- See also:
- PREVIOUS
-
- NOP
- ===
-
- Synopsis:
- NOP
-
- Function:
- This command does nothing.
-
- OPEN
- ====
-
- Synopsis:
- OPEN FILENAME,FORCE/S,VIEWID=VID/K/N
-
- Function:
- Opens a file.
-
- Arguments:
- FILENAME:
- If not given, a file requester will pop up. Auswahl.
-
- FORCE/S:
- The changes requester will be suppressed.
-
- VIEWID=VID/K/N:
- ID of a view.
-
- Return codes:
- rc = 5, if the file can't be loaded.
-
- See also:
- CLEAR, SAVE, SAVEAS
-
- PASTE
- =====
-
- Synopsis:
- PASTE VIEWID=VID/K/N
-
- Function:
- Pastes the current block into the file at the current cursor
- position.
-
- Arguments:
- VIEWID=VID/K/N:
- ID of a view.
-
- See also:
- Menu: `Edit/Paste', SETBLOCKMARK
-
- POSITION
- ========
-
- Synopsis:
- POSITION SOF/S,EOF/S,SOL/S,EOL/S,VIEWID=VID/K/N
-
- Function:
- Sets the cursor.
-
- Arguments:
- SOF/S:
- Start of file.
-
- EOF/S:
- End of file.
-
- SOL/S:
- Start of line.
-
- EOL/S:
- End of line.
-
- VIEWID=VID/K/N:
- ID of a view.
-
- As well SOF and EOF as SOL and EOL exclude each other.
-
- PREVIOUS
- ========
-
- Synopsis:
- PREVIOUS VIEW/S,WINDOW/S
-
- Function:
- Activate the previous view resp. edit window.
-
- Arguments:
- VIEW/S:
- The previous view should be activated.
-
- WINDOW/S:
- The previous window should be activated.
-
- See also:
- NEXT
-
- PRINT
- =====
-
- Synopsis:
- PRINT FILEID=FID/K/N
-
- Function:
- Prints the whole file.
-
- Arguments:
- ID of a file.
-
- PRINTBLOCK
- ==========
-
- Synopsis:
- PRINTBLOCK
- Synopsis:
- PRINTBLOCK
-
- Function:
- Prints the contents of the block buffer(clipboard).
-
- QUIT
- ====
-
- Synopsis:
- QUIT FORCE/S
-
- Function:
- Quits FileX.
-
- Arguments:
- FORCE/S:
- The changes requester is suppressed.
-
- See also:
- CLOSE
-
- REDO
- ====
-
- Synopsis:
- REDO NUMBER/N,FILEID=FID/K/N
-
- Function:
- Redos a number of `undos'.
-
- Arguments:
- NUMBER/N:
- Number of steps. If not given, just the last `undo' is redone.
-
- FILEID=FID/K/N:
- ID of a file.
-
- REQUESTFILE
- ===========
-
- Synopsis:
- REQUESTFILE VAR/K,STEM/K,TITLE/K,PATH/K,FILE/K,PATTERN/K =>
- FILENAME
-
- Function:
- Opens a file requester and returns a file name.
-
- Arguments:
- TITLE/K:
- Title of the file requester.
-
- PATH/K:
- Default path.
-
- FILE/K:
- Default file.
-
- PATTERN/K:
- A pattern.
-
- Return codes:
- Falls rc = 5, if the requester was cancelled.
-
- Sonst:
- FILENAME:
- Select file with path.
-
- Example:
- REQUESTFILE TITLE '"Select a script:"' PATTERN '#?.filex'
-
- REQUESTNOTIFY
- =============
-
- Synopsis:
- REQUESTNOTIFY PROMPT
-
- Function:
- Opens a simple notify requester with just one lonely gadget.
-
- Arguments:
- PROMPT:
- Title of the requester.
-
- REQUESTRESPONSE
- ===============
-
- Synopsis:
- REQUESTRESPONSE BUTTONS/K,PROMPT/K
-
- Function:
- Opens a Requester with several gadgets.
-
- Arguments:
- BUTTONS/K:
- A string that defines the gadgets(see example).
-
- PROMPT/K:
- Title.
-
- Return codes:
- rc contains the number of the selected gadgets. The right most
- gadget has got the nuber 0. All others are enumerated from left to
- right beginning with 1.
-
- Example:
- /* Requester with four gadgets */
- REQUESTRESPONSE BUTTONS `"Gadget 1|Gadget2|Gadget 3|Gadget 0"'
-
- say '"You''ve chosen gadget number"' rc '.'
-
- REQUESTSTRING
- =============
-
- Synopsis:
- REQUESTSTRING VAR/K,STEM/K,PROMPT/K,DEFAULT/K => STRING
-
- Function:
- Opens a requester to enter a string.
-
- Arguments:
- PROMPT/K:
- Title.
-
- DEFAULT/K:
- Default string.
-
- Return codes:
- rc = 5, if the requester was cancelled.
-
- Else:
- STRING
- Entered string.
-
- RX
- ==
-
- Synopsis:
- RX VAR/K,STEM/K,CONSOLE/S,ASYNC/S,COMMAND/F => RC/N,RESULT
-
- Function:
- Executes an arexx script.
-
- Arguments:
- CONSOLE/S:
- If set, a console window for input and output will be opened.
-
- ASYNC/S:
- Start the script asyncron.
-
- COMMAND/F:
- Name of the arexx script.
-
- Return codes:
- If executed synchronous.
- RC/N,RESULT:
- Return codes of the script.
-
- SAVE
- ====
-
- Synopsis:
- SAVE FILEID=FID/K/N
-
- Function:
- Saves the file. If the file does not have a name, a file requester
- will pop up.
-
- Arguments:
- FILEID=FID/K/N:
- ID of a file.
-
- Return codes:
- rc = 5, if saving failed.
-
- SAVEAS
- ======
-
- Synopsis:
- SAVEAS NAME,FILEID=FID/K/N
-
- Function:
- Saves the file under a new name.
-
- Arguments:
- NAME:
- New name of the file. If not given, a file requester will pop
- up.
-
- FILEID=FID/K/N:
- ID of a file.
-
- Return codes:
- rc = 5, if saving failed.
-
- SAVEBLOCK
- =========
-
- Synopsis:
- SAVEBLOCK NAME
-
- Function:
- Saves the current contents of the block buffer(clipboard).
-
- Arguments:
- NAME:
- If not given, a file requester will pop up.
-
- Return codes:
- rc = 5, if saving failed.
-
- SAVECOMMANDS
- ============
-
- Synopsis:
- SAVECOMMANDS
-
- Function:
- Saves the arexx command list from the menu under the current name.
-
- Return codes:
- rc = 5, if saving failed.
-
- SAVECOMMANDSAS
- ==============
-
- Synopsis:
- SAVECOMMANDSAS NAME
-
- Function:
- Saves the arexx command list from the menu under a new name.
-
- Arguments:
- NAME:
- If not given, a file requester will pop up.
-
- Return codes:
- rc = 5, if saving failed.
-
- SAVESETTINGS
- ============
-
- Synopsis:
- SAVESETTINGS
-
- Function:
- Saves the current settings under their current name.
-
- Return codes:
- rc = 5, if saving failed.
-
- SAVESETTINGSAS
- ==============
-
- Synopsis:
- SAVESETTINGSAS NAME
-
- Function:
- Saves the current settings under a new name.
-
- Arguments:
- NAME:
- If not given, a ... ehh, what do you guess? ... file
- requester will pop up.
-
- Return codes:
- rc = 5, if saving failed.
-
- SETATTR
- =======
-
- Synopsis:
- SETATTR OBJECT/A,FIELD,ID/K/N,FROMSTEM/K,FROMVAR/K
-
- Function:
- Set one or more variables of the program to a new value.
-
- Arguments:
- OBJECT/A:
- Object name.
-
- FIELD:
- Field name.
-
- ID/K/N:
- Possible with the objects WINDOW, VIEW and FILE. If not given,
- the variable of the current view/window/file is set.
-
- FROMSTEM/K:
- Name of a stem variable containing the values.
-
- FROMVAR/K:
- Name of a variable containing the value.
-
- If FIELD is not specified, a FROMSTEM-variable must be specified.
- In this variable, several values of the object can be stored.
-
- Example:
- meinestemvariable.STRINGFILL = TRUE
- meinestemvariable.FILLSTRING = 'Klaas ist stupid!'
-
- SETATTR APPLICATION FROMSTEM meinestemvariable
-
- See also:
- Attributes, GETATTR
-
- SETBLOCK
- ========
-
- Synopsis:
- SETBLOCK BLOCK/A
-
- Function:
- Puts a number of bytes in the block buffer(clipboard).
-
- Arguments:
- BLOCK/A:
- Hex string.
-
- Example:
- SETBLOCK '"0071 12feee de"'
-
- SETBLOCKMARK
- ============
-
- Synopsis:
- SETBLOCKMARK VIEWID=VID/K/N
-
- Function:
- Switches between block mark mode and normal mode.
-
- Arguments:
- VIEWID=VID/K/N:
- ID of a view.
-
- See also:
- Menu: `Edit/Mark', Attributes: `PROJECT/MARK', COPY, CUT, FILL
-
- SETBOOKMARK
- ===========
-
- Synopsis:
- SETBOOKMARK NUMBER/N,VIEWID=VID/K/N
-
- Function:
- Sets a mark at the current cursorposition. By using GOTOBOOKMARK,
- this mark can be jumped at.
-
- Arguments:
- NUMBER/N:
- Number between 1 and 10, which defines the mark's number.
-
- VIEWID=VID/K/N:
- ID of a view.
-
- See also:
- GOTOBOOKMARK
-
- SETBYTES
- ========
-
- Synopsis:
- SETBYTES POS/N/A,HEXSTRING/A,FILEID=FID/K/N
-
- Function:
- Sets a defined number of bytes at a specified position.
-
- Arguments:
- POS/N/A:
- Position, the bytes shall be set to.
-
- HEXSTRING/A:
- Hex string containing the bytes.
-
- FILEID=FID/K/N:
- ID of a file.
-
- Example:
- SETBYTES 200 '"4b6c 6161 73"'
-
- See also:
- GETBYTES
-
- SETSCREEN
- =========
-
- Synopsis:
- SETSCREEN NAME/K,OWN/S
-
- Function:
- Definition of the screen FileX shall be opened on.
-
- Arguments:
- NAME/K:
- Name of an public screen.
-
- OWN/S:
- An own screen shall be opened. A screen mode requester will
- pop up.
-
- SHRINKVIEW
- ==========
-
- Synopsis:
- SHRINKVIEW VIEWID=VID/K/N
-
- Function:
- Shrinks a view by one line.
-
- Arguments:
- VIEWID=VID/K/N:
- ID of a view.
-
- See also:
- EXPANDVIEW, GROWVIEW
-
- SIZEWINDOW
- ==========
-
- Synopsis:
- SIZEWINDOW HEIGHT/N,WIDTH/N,WINDOWID=WID/K/N
-
- Function:
- The FileX window height and width may be modified.
-
- Arguments:
- HEIGHT/N:
- New height.
-
- WIDTH/N:
- New width.
-
- WINDOWID=WID/K/N:
- ID of a window.
-
- SPLIT
- =====
-
- Synopsis:
- SPLIT VIEW/S,WINDOW/S
-
- Function:
- Opens a new view with the same file as the current one.
-
- Arguments:
- VIEW/S:
- The current view is divided into two new views.
-
- WINDOW/S:
- Opens a new edit window.
-
- See also:
- Menu: `Project/(View|Window)/Split', NEW
-
- UNDO
- ====
-
- Synopsis:
- UNDO NUMBER/N,FILEID=FID/K/N
-
- Function:
- A defined number of changes made to the file will be undone.
-
- Arguments:
- NUMBER/N:
- Number of changes which shall be possible to be undone. If
- not specified, only the last change will be undone.
-
- FILEID=FID/K/N:
- ID of a file.
-
- UNLOCKGUI
- =========
-
- Synopsis:
- UNLOCKGUI
-
- Function:
- If the GUI was locked, it will be unlocked.
-
- See also:
- LOCKGUI
-
- WINDOWTOBACK
- ============
-
- Synopsis:
- WINDOWTOBACK WINDOWID=WID/K/N
-
- Function:
- The window will be moved to the back.
-
- Arguments:
- WINDOWID=WID/K/N:
- ID of a window.
-
- WINDOWTOFRONT
- =============
-
- Synopsis:
- WINDOWTOFRONT WINDOWID=WID/K/N
-
- Function:
- The window will be moved to the front.
-
- Arguments:
- WINDOWID=WID/K/N:
- ID of a window.
-
- ZIPWINDOW
- =========
-
- Synopsis:
- ZIPWINDOW WINDOWID=WID/K/N
-
- Function:
- Same function as the zip gadget of the FileX window has got.
-
- Arguments:
- WINDOWID=WID/K/N:
- ID of a window.
-
- Attributes
- **********
-
- Some variables of FileX can be read by the option GETATTR. Probably
- they may also be modified through SETATTR. Both commands require at
- least the objectname and maybe a fieldname or an ID, too.
-
- There are three different fieldtypes: Strings, numbers and boolean
- values (`TRUE' or `FALSE').
-
- Following are all objects and their belonging fields. For every
- field, its name and the type will be displayed, moreover if it can only
- be read. After that, a contents description follows.
-
- APPLICATION-Objekt:
- ===================
-
- "SCREEN", String, read only:
- Name of the public screen FileX is opened on.
-
- "VERSION", String, read only:
- Versionnumber of FileX.
-
- "REGNUMBER", Number, read only:
- Registration number. 0 statnds for the unregistered version.
-
- "REGNAME", String, read only:
- Name of registered user.
-
- "AREXX", String, read only:
- Name of the arexx port.
-
- "MAXUNDOMEMSIZE", Number:
- Maximum size of the undo memory.
-
- "MAXUNDOLEVEL", Number:
- Maximum number of undo levels.
-
- "ALTJUMP", Number:
- Jump width in lines for Alt-CURSORUP/DOWN.
-
- "SCROLLBORDER", Number:
- Distance in lines to the upper/lower limit from where on the window
- shall be scrolled.
-
- "CLIPBOARDUNIT", Number:
- Unit that should be used for the block buffer.
-
- "COMMANDSHELLWINDOW", String:
- Description of the command shell window.
-
- "COMMANDWINDOW", String:
- Description of the shell window for arexx scripts.
-
- "OVERWRITE", Bool:
- TRUE, if no requester before saving an already existing file shall
- appear.
-
- "USEASL", Bool:
- TRUE, if the Asl library and the Intuition library should be used
- instead of the Reqtools library.
-
- "PRIORITY", Number:
- Taskpriority of FileX.
-
- "SEARCHSTRING", String:
- Search string.
-
- "REPLACESTRING", String:
- Replace string.
-
- "STRINGSEARCH", Bool:
- TRUE for string search, FALSE for hex search.
-
- "CASESENSITIVSEARCH", Bool:
- TRUE for casesensitiv searching.
-
- "WILDSEARCH", Bool:
- TRUE to use the question mark(`?') as a wildcard.
-
- "FILLSTRING", String:
- Fill string.
-
- "STRINGFILL", Bool:
- TRUE for stringfill, FALSE for hex fill.
-
- "WINDOWS"-Objekt:
- =================
-
- 1..n
- ID of a window.
-
- "COUNT", Number, read only:
- Number of IDs, i.e. the number of opened edit windows.
-
- "WINDOW"-Objekt:
- ================
-
- "LEFT", Number, read only:
- Window offset to the left border.
-
- "TOP", Number, read only:
- Window offset to the right border.
-
- "WIDTH", Number, read only:
- Width of the window.
-
- "HEIGHT", Number, read only:
- Height of the window.
-
- "TITLE", String, read only:
- Current title of the window.
-
- "MIN_WIDTH", Number, read only:
- Minimun width of the window.
-
- "MIN_HEIGHT", Number, read only:
- Minimum height of tht window.
-
- "MAX_WIDTH", Number, read only:
- Maximum width of the window.
-
- "MAX_HEIGHT", Number, read only:
- Minimun height of the window.
-
- "VIEWCOUNT", Number, read only:
- Number of views.
-
- "VIEWS", String, read only:
- IDs of all views in this window. Separated by a space.
-
- "FILES"-Objekt:
- ===============
-
- 1..n
- ID of a file.
-
- "COUNT", Number, read only:
- Number of IDs, i.e. the number of opened files.
-
- "FILE"-Objekt:
- ==============
-
- "FULLNAME", String:
- Full file name with path.
-
- "PATH", String:
- Path of the file name.
-
- "NAME", String:
- Name without path.
-
- "CHANGES", Number, read only:
- Number of changes.
-
- "FILELEN", Number, read only:
- Length of the file.
-
- "MEMPOS", Number, read only:
- Start address of the file in the memory. If the lenght of the file
- is changed, the start address might change, too.
-
- "VIEWCOUNT", Number, read only:
- Number of views showing the file.
-
- "VIEWS", String, read only:
- IDs of all views showing the file. Separated by a space.
-
- "VIEW"-Objekt:
- ==============
-
- "LINES", Number, read only:
- Number of lines.
-
- "BYTESPERLINE", Number, read only:
- Number of bytes per line.
-
- "DISPLAYTYP", Number:
- Current display type.
-
- "DISPLAY", Number:
- Defines in which form the file shall be displayed: 1 = only
- hexddisplay, 2 = only Asciidisplay, 3 = Hex-ASCII mixed display.
-
- "DISPLAYSPACES", Number:
- Defines how many Bytes shall be grouped to a block in the
- hexdisplay: 3 = no blocks, 0 = one byte blocks, 1 = word blocks, 2
- = long word blocks.
-
- "CURSORPOS", Number, read only:
- Current cursor position.
-
- "MARKPOS", Number, read only:
- Position of the mark's beginning.
-
- "EDITASCII", Bool:
- TRUE, when the active cursor is in the ascii area.
-
- "MARK", Bool, read only:
- TRUE, if a block is being marked at the moment.
-
- "FILE", Number, read only:
- ID of the displayed file.
-
- "WINDOW", Number, read only:
- ID of the belonging edit window.
-
-