home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Amiga Format 64
/
af064sub.adf
/
FileX
/
FileX.doc
< prev
next >
Wrap
Text File
|
1994-06-28
|
23KB
|
740 lines
$VER: FileXDocumentation 2.0 (28.4.94)
FileX - A binary editor
© Copyright 1993-1994 by Klaas Hermanns
Shareware, all rights reserved.
What is FileX?
**************
FileX is a binary file editor which offers the following features:
- Several files can be modified in several windows and/or views at
the same time.
- The edit windows can be opened on any public screen and sized to
any dimension you want.
- Small calculator
- Clipboard converter
- Fontsensitivity
- Locale support if you have OS 2.1 or higher. (English, Finnish,
French, German, Swedish (Dutch, Norwegian (not yet included)))
- Undo and Redo (only limited to your free memory)
- Search and replace with history
- Extensive blockfunctions
- ARexxport with 77 commands and asynchronical command shell
- Printing as hexdump
- `Grab memory' to show and modify memory
- AppWindow. If FileX runs on the workbench, icons can be moved onto
the FileX window and the related file will be loaded automatically.
- Iconify
- Moreover, FileX will be developed further permanently...
Getting started
***************
Getting started from workbench
==============================
Starting FileX from the workbench, the following tooltypes will be
interrogated:
COMMANDS
Name of the ARexxcommandsettings. If this tooltype is not
specified, FileX tries to open `FileXARexxCommands.prefs' from the
current directory. When that fails, the file
`ENVARC:FileX/FileXARexxCommands.prefs' will be opened. If this
file doesn't exist, too, the ARexxcommands will remain unset.
FILE
A filename that shall be opened right after starting FileX.
KEY
Name of the Keyfile. If no name is given, FileX will search for
the file "FileX.Key" in the program, in the "l:" an in the "s:"
drawer.
LANGUAGE
Specifies the language that should be used in the programm. By
default the language from the Workbench Preferences is used.
PORTNAME
Name of the FileX ARexxport. If the port with the specified name
does already exist, the program automatically adds a number to the
name and increases it until a non-existing portname is found.
(`NAME'->`NAME.1'->`NAME.2'). Standardname: `FILEX'.
PUBSCREEN
Name of a public screen on which FileX shall be opened on. If
this tooltype is not specified, FileX will open a window on the
standard public screen.
SETTINGS
Name of the settingsfile to be loaded at the beginning. If there
is no name specified, the program tries to open the file
`FileX.prefs' in the current directory. If that fails,
`ENVARC:FileX/FileX.prefs' will be tried to open. If this file
could not be opened, too, FileX uses the internal settings.
STARTUP
Name of an ARexxscript that will be executed right at the start.
How to start from CLI
=====================
Following arguments will be checked:
COMMANDS/K
KEY/K
LANGUAGE/K
PORTNAME/K
PUBSCREEN/K
SETTINGS/K
STARTUP/K
These tooltypes correspond to the ones for the workbench start.
SYNC/S
This tooltype forces FileX not to detach from Shell.
The menus
*********
Project
=======
New...
Removes the current file from memory.
Open...
Opens a new file in the current view.
Open previously loaded...
Opens a requester that shows you all files that have been loaded
since the starting of the program. By choosing one the file will
be opend again.
Save
Saves the current file with its current name. A filerequester will
be opened if no name has been specified.
Save As...
Saves the current file with a new name.
View
New
If there is enough room within the window, a new view will be
created. The current view will then be split into two
sections.
Split
This will divide the current view into two sections.
Next
The next view will be activated.
Previous
The Previous view will be activated.
Expand
The current view will be brought to the maximum possible size.
All the other views will be only one line tall.
Grow
If possible, the current view will grow one line.
Shrink
If possible, the current view will shrink one line.
Save and Close
The current view's file will be saved and the view itself
will be closed. If there is no view remaining, FileX will be
quit.
Close
The current view will be closed. If it's the last view of a
file, a saftey requester will appear. If it's the very last
view, FileX will be quit.
New
A new window to edit files will be opened.
Split to
This will open a new window (and view) to edit the same file
as in the current view.
Next
The next FileX edit window will be activated.
Previous
The previous Filex edit window will be activated.
Close
The edit window will be closed. If the file has been modified
so far, a requester to confirm will appear.
Grab memory
Opens the `Grab memory' requester, which allows to show and modify
memory. To specify the memory range, use the two gadgets and click
'OK' to continue. The shown memory may be modified like a usual
file.
Print
Prints the whole file as hexdump form.
Iconify
Iconifies FileX. All windows will be closed and the FileX icon
appears on the workbench. By double-clicking on this icon or
moving an other icon over it, FileX will be reactivated.
About...
Some more or less important informations about FileX.
Quit...
Quits FileX.
Edit
====
Mark Block
Switches block-marking on/off.
Cut
Cuts the current marked block out of the file and copies it into
the blockbuffer.
Copy
Copies the current marked block into the blockbuffer.
Fill
Fills the current marked block. The `fill' requester appears to
specify the filling pattern .
Paste
Overwrites the file beginning at the current cursorposition with
the block from the blockbuffer. If this block is longer than the
rest of the current file, a requester will appear and ask if it's
okay to copy the block anyway.
Insert
Inserts (again beginning at the current cursor position) the block
from the blockbuffer to the file. As a result, the file will
become larger.
Append
Adds the block from the blockbuffer to the end of the file.
Print
Prints the block from the blockbuffer as hexdump.
Load block...
Loads a block into the blockbuffer.
Save block...
Saves a block from the blockbuffer as a new file.
Undo
Executes Undo once. This will revoke the last changes.
Redo
Executes Redo once. This will retract the last UNDO(s).
Switch
Switches between ascii and hex.
Search and replace
==================
Search...
This will open a requester to search for a string or hex string.
There are two string gadgets within the requester to specify
search and replace string. Using the four switches, you can select
various options or search modes:
Casesensitiv
If set, the search option will search case sensitive.
Wildcards
If set, the question mark ('?') may be used as wildcard.
Stringsearch
If set, FileX will search for a string. Otherwise, the search
string will be interpreted as hex string. The following
characters are allowed: 'A'-'F', '0'-'9' and spaces (' ').
Example: '46a7Fc32 08'.
Replace
If set, the search and replace mode will be activated. If the
string is found, a requester will appear if you want the
replace string to be inserted. Pressing 'Next' oder
'Previous' will start the search process by searching forwards or
backwards.
Search and replace..
Opens the 'search' requester to search for a string or hexnumber.
Search(and replace) next
Repeats the search(and replace)-action towards the end of the file.
Search(and replace) previous
Repeats the search(and replace)-action towards the beginning of
the file.
Settings
========
Adjust Windowsize
The window will be made smaller that the space between bevelbox
and windowborder disappears. If there are several views with
different settings in one window, free spaces may still exist
nevertheless.
Display
Defines which translationtable is being used to display the ascii
characters:
Characters
Only letters will be shown. The rest is filled with spaces.
ASCII ($20-$7F)
Only show Hex $20-$7f.
all
All characters and the related Ascii-characters will be shown.
User defined
Use a self-defined translationtable to display.
Load...
Load the defined translationstable. A 256 bytes file will be
loaded which assings every byte an Ascii character. This
intends the first byte of this file tells FileX the number of
the ascii-character of byte 00. The second byte determines the
ascii-value of the byte 01 and so on.
Font...
Opens a fontrequester to choose a font for the current window.
Every new window will get this font, too. Other allready existing
windows keep their old font.
Screen
Definitions of the screen FileX shall be opened on:
Default public
The default public screen.
Workbench
The workbench screen.
Public...
A public screen. A requester to choose it appears.
Own public...
An own FileX public screen. A requester to choose the
screenmode appears. If you don't have at least OS 2.1 or the
Reqtools library this function is not available.
Palette...
Opens a paletterequester to set the colors. Requires Reqtools
library! The adjusted colours will only be saved, if you are on
an own screen.
Miscellaneous...
Opens the Miscellaneous requester to define some other things for
FileX:
Altjump
Number of lines the cursor will move with Alt-cursorup/down.
Scroll border
Distance to the upper/lower border from which the view will be
scrolled.
Max undo level
Maximum number of undo levels.
Max undo mem
Maximum memory used for undo/redo.
Clipboard unit
Clipboard unit used for the blockmemory.
Program priority
Priority of the program. Usually only values between -20 and
20 make sense.
Use asl.library
If set, the Asl library will be used for the file and font
requesters. All information requesters are created with the
Intuition library. Normally the Reqtools library is used for
all requesters.
Overwrite
If set, a requester to ask you if a allready existing file
should be overwritten will NOT appear.
Command shell window
Settings for the command shell window.
Command window
Settings for the window that shall be used for the execution
of ARexxscripts.
Display
This defines in which form the file shall be diplayed. It can
be chosen between Hex and Ascii display.
Spaces
Here it's possible to choose how many Bytes shall be shown as
a block. You may specify byte, word and longword blocks. It is
also possible to define no spaces between the blocks.
Load Settings...
Loads a settingsfile.
Save Settings
Saves the settings under the current name.
Save Settings As...
Saves the settings under a new name.
Move
====
Jump to byte...
Moves the cursor to an defined position in the file.
Mark location...
Marks the current cursor position. A requester asks which number
that mark shall be (1-10 possible). Each file has ten different
marks.
Jump to mark...
After typing the number (1-10) into the appering requester, the
cursor will be set to the stored position.
ARexx
=====
Command shell...
Opens a command shell. Within this shell you may give easy
ARexxcommands to FileX. The result(s) will be displayed at once.
You can go on working with FileX simultaneous.
Execute command...
Executes an ARexxscript. Again a requester to choose the name will
be opened.
Assign command...
An ARexxscript will be assigned to one of the 10 menu items. One
of the 10 menu items will be assigned an ARexxscript. A
filerequester to choose the name and another requester to chose
the number (0-9) appear.
Empty command #[0-9]
10 menu items to be filled with ARexxscripts that shall be quickly
executable.
Load commands...
Loads a settingsfile for the ARexxscripts. If the files
`FileXARexxCommands.prefs' and
`ENVARC:FileX/FileXARexxCommands.prefs' could not be found, the
ARexxcommands remain unset.
Save commands
Saves the commands under the current name.
Save commands as...
Saves the commands under a new name.
Misc
====
Open calculator...
Opens a small calculator. The cycle gadget or the cursorup/-down
key change the numbersystem. The gadgets '>' and '<' copy the
current figure into the clipboard or to move a figure from the
clipboard in the calculator. The Plus/Minus gadget or the '.' key
change the sign of the figure. With the backspace key you may
delete the last entered number and with the DEL key you may whipe
out the whole figure. Space activates the edit window again.
Note: If you miss an ON or AC key, use the '=' key. It has the
same function with the slight difference that the display won't be
cleared.
Open clipboard converter...
The Clipboard converter is a powerful tool, but very simple to use.
It can be used for converting numbers into raw bytes and vice
versa.
With the upper cycle gadget you can adjust as what the current
clipboard contents shall be interpreted. The display on the right
shows the contents. You can choose 'Bin'ary, 'Dec'imal,
'Hex'adecimal, 'Oct'al, 'Raw' for the raw, not interpreted
contents, and 'Text'. The only difference between 'Raw' and 'Text'
is the display. 'Raw' shows the contents in hex, 'Text' as a text.
The lower cycle gadget defines, to what the current contents should
be converted to. The display on the right shows the result, a
conversion would bring. A click on 'Convert' and the contents will
be converted.
What about a simple example:
The clipboard contains the string "6265 7374". The insertion of
the contents into the shell would show the text "6265 7374". The
insertion into FileX would show on the right, in the ascii area,
the text "6265 7374", too. If you want to insert it on the left,
you can use the clipboard converter. Simply switch the contents to
'Hex' and the target to 'Raw' and press convert. The upper display
shows 'not valid' now because there is no hex string in the
clipboard anymore. An insertion into FileX would show the value
"62657374" on the left side now.
The ARexxport
*************
FileX has got an ARexxport with 77 commands. The documentation about
that feature can be found in the file `FileXARexx.doc' resp.
`FileXARexx.guide'. Some example programs are stored in the ARexx
directory.
Already scheduled for the next version:
***************************************
- Onlinehelp
- XPK support
- Edit on device.
Please note:
************
For the file, font, screemode and the palette requester as well as
all other requesters the Reqtools library may be used, which is
copyrighted © bei Nico François.
The program `ARexxBox' by Michael Balzer was used to create the
basis of the ARexxport.
Acknowledgments
***************
Robert Gorthsmanns, Thomas Hornik, Thomas Hertz and Jörg Groenewald
for the betatesting
Benjamin Schörner
for the betatesting and the (very quick and dirty) English
translation of the documentation.
Reinhard Geisler
for the COCUNI(++ 49-02832-80861, the best box at the Niederrhein)!
Michael Balzer
for his ARexxBox.
Nico François
for his Reqtools library.
SAS
for their superb C-Developmentsystem.
License
*******
The copyright for FileX remains by the author in any form!
FileX is *NOT* public domain! FileX is shareware. If you use this
program longer than a period of two weeks, you must register. For 20 DM
or 15 US Dollar, you'll get a personal key file that allows you to use
all functions of FileX and stops the nerving requester at the
beginning. Without special permission of the author the program may
only be used by the registered person.
To register, fill in the orderform called `FileX.reg'. You may send
it back by normal mail or e-mail. E-mail is only possible if you
transfer the money to me.
Distribution
************
The keyfile MAY NOT be spread in ANY way.
The unregistered version may only be spread if the following files
are included:
FileX.info
FileX/MagicWBIcons.info
FileX/FileX
FileX/MagicWBIcons
FileX/FileX.info
FileX/Docs
FileX/Docs.info
FileX/Catalogs
FileX/ARexx
FileX/ARexx.info
FileX/Install
FileX/Install.info
FileX/FileX.020
FileX/FileX.020.info
FileX/MagicWBIcons/FileX_tool.info
FileX/MagicWBIcons/FileX.info
FileX/MagicWBIcons/Drawer.info
FileX/MagicWBIcons/FileX.doc.info
FileX/MagicWBIcons/FileX.guide.info
FileX/MagicWBIcons/FileX.reg.info
FileX/Docs/Deutsch
FileX/Docs/Deutsch.info
FileX/Docs/English
FileX/Docs/English.info
FileX/Docs/Deutsch/FileX.dok
FileX/Docs/Deutsch/FileXARexx.dok
FileX/Docs/Deutsch/FileX.guide
FileX/Docs/Deutsch/FileXARexx.guide
FileX/Docs/Deutsch/FileX.reg
FileX/Docs/Deutsch/FileX.dok.info
FileX/Docs/Deutsch/FileXARexx.dok.info
FileX/Docs/Deutsch/FileXARexx.guide.info
FileX/Docs/Deutsch/FileX.guide.info
FileX/Docs/Deutsch/FileX.reg.info
FileX/Docs/English/FileX.doc
FileX/Docs/English/FileXARexx.doc
FileX/Docs/English/FileX.guide
FileX/Docs/English/FileXARexx.guide
FileX/Docs/English/FileX.reg
FileX/Docs/English/FileX.doc.info
FileX/Docs/English/FileXARexx.doc.info
FileX/Docs/English/FileXARexx.guide.info
FileX/Docs/English/FileX.guide.info
FileX/Docs/English/FileX.reg.info
FileX/Catalogs/deutsch
FileX/Catalogs/français
FileX/Catalogs/suomi
FileX/Catalogs/svenska
FileX/Catalogs/FileXCats.lha
FileX/Catalogs/deutsch/FileX.catalog
FileX/Catalogs/français/FileX.catalog
FileX/Catalogs/suomi/FileX.catalog
FileX/Catalogs/svenska/FileX.catalog
FileX/ARexx/Spezialsuchen.filex
FileX/Install/ReadMe
FileX/Install/LiesMich.info
FileX/Install/Install
FileX/Install/ReadMe.info
FileX/Install/Deutsch.info
FileX/Install/LiesMich
FileX/Install/English.info
As long as no file is missing or modified in any way, this archive
of FileX may be spread on CD, disk and other mediums or per e-mail. It
is not allowed to demand more than 5 DM (or the same amount in your
country's currency) for this program, if it's spread on disk.
Moreover, you may not use FileX for commercial purposes without a
written permission from the author.
FileX has been conscientiously tested, so it *should* work properly.
Please note that the author can *NOT* be held responsible for *ANY*
kind of damaged.
Localization
************
Since Version 1.1 it's possible to localize FileX. This feature
requires at least OS 2.1 or higher. This means, that all texts used in
the program can be translated and used in the program. The required
Catalog description and translation files can be found in the
`Catalogs' directory. At the moment there are translations in German,
English, Dutch, Finnish, Norwegian and Swedish. If someone translates
the texts in a different language, I would be very pleased to get the
corresponding catalog translation file, so I can include it in the next
version.
Contactaddress:-)
*****************
For bugreports!, postcards, suggestions, new ideas, problems, gifts
or any kind of stuff, I can be reached under the following addresses:
Klaas Hermanns
Weberstraße 42
47533 Kleve
Germany
E-mail: dalton@cocuni.GUN.de
Acc. 539 7088, Bank Code 324 500 00, Sparkasse Kleve.
History
*******
What's new in Version...
V1.1:
- Localesupport (English/German)
- The window's width can finally be varied.
- In additon to the Hex/Ascii display, you may now display Hex or
Ascii only, too.
- In Hex-display-mode, you can choose how many Bytes shall be shown
as a block. You may specify byte, word and longword blocks. It is
also possible to define no spaces between the blocks.
V2.0:
- Several Files can be edited at the same time. So you can divide
one window in several editareas (like CED) or even use several
windows at the same time (like TheEdge or GoldEd).
- Finally there is a status line in which you can see the current
cursorposition, the name and the length of the file.
- Key files for registered users. So it's very easy to get your
registered version by e-mail.
- In string gadgets you can select gadget shortcuts with the right
amiga key now.
- The clipboard is now supported directly. You don't need to use
"Load from Clip" or "Save from Clip" anymore.
- A small calculator for simple operations in hexadecimal, decimal,
octal or binary.
- The search requester is even more easy now. There are only two
string gadgets, one for the search and one for the replace string.
With a switch you can swap between 'search' and 'search and
replace'.A history function, like the one in the shell, remembers
all previously entered search strings.
- A clipboard converter allows you to convert the contents of the
clipboard in varius ways. So you can change a textstring,
including a number, into the right number.
- FileX remembers all the names of the files read from the
beginning. Per list requester you can choose old files and open
them again.
- The ARexx port has been expanded to support the new functions.
The command shell is now asynchron.