home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Amiga Elysian Archive
/
AmigaElysianArchive.iso
/
newc_dev
/
create.lha
/
Create
/
Create.doc
< prev
next >
Wrap
Text File
|
1992-10-13
|
7KB
|
264 lines
DOCUMENTATION
Create VERSION 1.1 FREEWARE VERSION
written 1992 von H.P.G.
INDEX:
INDEX
General Description
System Requirements
Legal Stuff
FEATURES
Installation
Starting Create
Create START PARAMETERs
Technical
Last
Address
List of Files
General Description:
Create creates new Files or new Dirs.
Therefor you can specify as many Names as you want.
Also you can specify e.g. 3 dirs and 5 files.
Create is an enhancement of the c:Makedir command.
You can e.g. use Create in your Startup-Sequence instead of
calling MakeDir.
With Create you`re also able to create new files. Some people
may ask why should I create am EMPTY file.
Well there are some programs, like texteditors or paintprograms
that can be called by specifying a filename.
If the filename exists they will load it at startime. But if it
doesn`t yet exists:
- you could get nervous by an ugly message requester
- or you`ll get a simple message like 'couldn`t find specified
file`
- or the program simply terminates (this would be the badest
case) by displaying an errortext
You can now use Create to get rid of this.
The best way to solve such problems is to write a batchfile,
that must be located in the current AmigaDOS-searchpath.
( e.g. in the s:- or c:- Dir).
Ex.:
Assuming you use a texteditor with the name texted you can use
the following batchfile
.Key FileName ; name of the text
if EXISTS <FILENAME> ; text still Text exists
TextEd <FILENAME> ; normally call of texted
endif
else ; if not
Create <FILENAME> QUIET ; first call Create then
TextEd <FILENAME> ; call texted with the new cerated filename
endif
Now you can save this batchfile as e.g. 's:TED' and set the
S-Bit with 'Protect s:TED +s'.
Notice:
If you specify QUIET no status- or success-messages will be
printed out.
If you then type 'TED' follwing by the name of an not currently
existent filename, it first will be created and then the editor
will be called.
No more requesters and stupid messages will appearing.
This is also available for paint programs and music eds etc.
System Requirements
To use Create you need at minimum Kickstart 2.xx Version 37.xx.
Because of using a lot of new OS 2.0 features Create is not
able to run under Version 1.2 and 1.3.
Legal Stuff:
This program and all files come with it also the docfiles are
released as FREEWARE.
this means:
everybody may use Create,
everybody may copy Create, if:
1. you copy all included files see list below
2. no changes are made , this means the program amd all
included files must stay in the origin form.
Exception: you may archieve it ; but in this way you
must also archieve the whole package.
3. if you recompile it, you have to include a notice to
the original author. if you also want to (re)
distribute in this form you have to send me a copy.
4. you may not sell Create
except: you`re allowed to take a small copy fee
which may not extend 5$.
5. if you want to include Create or one of the included
files as a part of a commercial package, you must
have written permission of the author
(address see below)
I take no warranty or garanty for the function of this program.
The whole risk of using it stays by the user.
FEATURES:
- Creating of Dirs and Files.
- Multiples specifications supported
- very small code size
- It owns a QUIET option, which enables you to use Create in
every kind of batchfiles.
Installation:
Just copy Create to your c: dir or any other dir in your current
AmigaDOS searchpath.
Starting Create:
Create must be startet from Cli. Alternatively you can use the
'ExecuteCommand' WBench menuitem.
Create START PARAMETERs:
Create has the following
Syntax: Craete File_Or_Dir/M/A,[QUIET/S]
File_Or_Dir/M/A one or more The given name is the file or dir you
strings wants to create. You can specify
multiples files and/or dirs.
If you wnat to create dirs you must put
an '/' at the end of the name. Otherwise
you will get a new file.
!!!! WARNING: You should take care that some copier and cruncher, like LHA
or LHArc have problems with files with the size of 0 Bytes.
So you should look for empty files and dirs and delete them
before you want to archieve or crunch something.
QUIET -------------- If you specify QUIET no messages about
successfully operations will be printed
Normally Create informs you if it had
created a file or dir.
This is very useful if you want to use
Create in batchfiles.
If an error occures Create sets its
ReturnCode to 5 (warn). This normally
terminates a batchfile execution.
*** If you start Create without spacifying any PARAMETER a little
*** helptext will be displayed. Also if you give a wrong commandline
*** to Create.
Technical:
Create is compiled with the Manx Aztec C V 5.2a - Compiler
Create uses the new ReadArgs DOS - functions for CommandLine-
Parsing. Also I used functions as Lock, Unlock, ParentDir etc...
Last:
I hope Create would be used by many people.
If you find any bugs please let me know.
Also serious critic and/or ideas are wellcomed.
Address:
Send all messages to:
Hans - Peter Guenther
Gruener Weg 5
3501 Fuldatal 2
GERMANY
List of Files:
(If you miss any of the following files your release is incomplete)
Create : the binary
Create.info
Create.dok : the english documentation
Create.dok.info
Create.doc : the german documentation
Create.doc.info
---
END
Have Fun ...
H.P.G