home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
The Datafile PD-CD 5
/
DATAFILE_PDCD5.iso
/
utilities
/
a
/
armedit
/
Docs
/
ARMEDIT
next >
Wrap
Text File
|
1997-02-21
|
3KB
|
99 lines
File : ARMEDIT
Date : 21-Feb-97
Author : © A.Thoukydides, 1996, 1997
Description : Description of the PC ARMEDIT command that is part of the ARMEdit
suite.
INTRODUCTION
The "ARMEDIT" command allows DOS files to be edited using a RISC OS editor.
To use this command it is necessary to load the ARMEdit module before
starting the PC front-end, and to have both the !ARMEdit front-end and a
suitable RISC OS editor running.
The External Data Editing Protocol is used to control the edit. Both Zap
and StrongEd support this protocol (see comments below), but unfortunately
Edit does not.
USAGE
The syntax is:
ARMEDIT [/?] <file> [<file> [...]]
ARMEDIT [/?] /L <file> [<line> [<file> [<line> [...]]]]
where
/? - Displays some help text.
/L - Filenames are followed by line number to place cursor at.
<file> - Wildcarded name of files to edit.
<line> - Line number to position cursor at.
All files are treated as text files when being edited.
USE WITH ZAP
Zap uses several techniques for choosing the mode to edit a file in. These
include using the filetype, filename and the contents of the file. Due to the
operation of the External Data Editing Protocol, only the file leaf name will
be used. Hence, to enable selection of editing modes the following lines
should be placed at the start of the !Zap.Keys file:
&500 &FFF \#\*/c +C
&500 &FFF \#\*/cc +C
&500 &FFF \#\*/c++ +C
&500 &FFF \#\*/h +C
&500 &FFF \#\*/asm +Assembler
Other mappings can be added in a similar fashion. Files that do not match any
of the patterns will be placed in Text mode.
USE WITH STRONGED
Some versions of StrongEd do not support The External Data Editing Protocol
correctly. If you experience problems with the ARMEDIT utility still polling
edits that have been ended, then try upgrading to the latest version of
StrongEd.
OTHER POINTS TO NOTE
If a suitable editor is not running, then the command will exit without
giving an error message - no attempt is made to automatically load a suitable
editor.
Filenames may contain standard DOS wildcards, i.e. "?" for single characters,
and "*" for multiple characters. Files are matched using the same rules as
used by other DOS commands.
The cursor position is selected by counting new-line characters (ASCII 10).
If the editor changes the line end character sequences then the cursor may be
positioned on the wrong line.
THINGS TO DO
The following are changes that may be made to the ARMEDIT command sometime in
the future.
None at the moment!
VERSION HISTORY
0.00 (10-Sep-96) Original development version.
0.01 (12-Sep-96) Current status and operation is displayed.
Better error handling and recovery.
Multiple files can be simultaneously edited.
Initial cursor position may be specified.
0.02 (14-Oct-96) Rewrite after source code lost when PC partition corrupted.
0.03 (05-Feb-97) Temporary files are deleted before quitting.
1.03 (21-Feb-97) First official release version.