home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 1 / FFMCD01.bin / bbs / libdisks / d700t799 / disk750.lha / Create / Create.doc < prev    next >
Encoding:
Text File  |  1992-10-13  |  7.0 KB  |  264 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.                             DOCUMENTATION
  14.  
  15.  
  16.                 Create  VERSION  1.1  FREEWARE VERSION
  17.  
  18.  
  19.                         written 1992 von H.P.G.
  20.  
  21. INDEX:
  22.  
  23.  
  24.  
  25.             INDEX
  26.             General Description
  27.             System Requirements
  28.             Legal Stuff
  29.             FEATURES
  30.             Installation
  31.             Starting Create
  32.             Create START PARAMETERs
  33.             Technical
  34.             Last
  35.             Address
  36.             List of Files
  37.  
  38.  
  39.  
  40.  
  41. General Description:
  42.  
  43.  
  44.         Create creates new Files or new Dirs.
  45.         Therefor you can specify as many Names as you want.
  46.         Also you can specify e.g. 3 dirs and 5 files.
  47.  
  48.         Create is an enhancement of the c:Makedir command.
  49.  
  50.         You can e.g. use Create  in  your  Startup-Sequence  instead  of
  51.         calling MakeDir.
  52.  
  53.         With Create you`re also able to create new  files.  Some  people
  54.         may ask why should I create am EMPTY file.
  55.  
  56.         Well  there are some programs, like texteditors or paintprograms
  57.         that can be called by specifying a filename.
  58.         If  the filename exists they will load it at startime. But if it
  59.         doesn`t yet exists:
  60.  
  61.         - you could get nervous by an ugly message requester
  62.  
  63.         - or you`ll get a simple message like 'couldn`t find specified
  64.           file`
  65.  
  66.         - or the program simply terminates (this would be the badest
  67.           case) by displaying an errortext
  68.  
  69.         You can now use Create to get rid of this.
  70.         The best way to solve such problems is to write a batchfile,
  71.         that must be located in the current AmigaDOS-searchpath.
  72.         ( e.g. in the s:- or c:- Dir).
  73.  
  74.         Ex.:
  75.  
  76.         Assuming you use a texteditor with the name texted you can use
  77.         the following batchfile
  78.  
  79.         .Key FileName          ; name of the text
  80.  
  81.         if EXISTS <FILENAME>   ; text still Text exists
  82.             TextEd <FILENAME>  ; normally call of texted
  83.         endif
  84.         else                   ; if not
  85.             Create <FILENAME> QUIET ; first call Create then
  86.             TextEd <FILENAME>  ; call texted with the new cerated filename
  87.         endif
  88.  
  89.         Now you can save this batchfile as e.g. 's:TED' and set the
  90.         S-Bit with 'Protect s:TED +s'.
  91.  
  92.  
  93.         Notice:
  94.  
  95.             If you specify QUIET no status- or success-messages will be
  96.             printed out.
  97.  
  98.         If you then type 'TED' follwing by the name of an not currently
  99.         existent filename, it first will be created and then the editor
  100.         will be called.
  101.  
  102.         No more requesters and stupid messages will appearing.
  103.  
  104.         This is also available for paint programs and music eds etc.
  105.  
  106.  
  107. System Requirements
  108.  
  109.         To use Create you need at minimum Kickstart 2.xx Version 37.xx.
  110.  
  111.         Because of using a lot of new OS 2.0 features  Create is not
  112.         able to run under Version 1.2 and 1.3.
  113.  
  114.  
  115. Legal Stuff:
  116.  
  117.  
  118.         This program and all files come with it also the docfiles are
  119.         released as FREEWARE.
  120.  
  121.         this means:
  122.  
  123.             everybody may use Create,
  124.  
  125.             everybody may copy Create, if:
  126.  
  127.                 1. you copy all included files see list below
  128.                 2. no changes are made , this means the program amd all
  129.                    included files must stay in the origin form.
  130.                    Exception: you may archieve it ; but in this way you
  131.                    must also archieve the whole package.
  132.                 3. if you recompile it, you have to include a notice to
  133.                    the original author. if you also want to (re)
  134.                    distribute in this form you have to send me a copy.
  135.                 4. you may not sell Create
  136.                        except:   you`re allowed to take a small copy fee
  137.                                  which may not extend 5$.
  138.                 5. if you want to include Create or one of the included
  139.                    files as a part of a commercial package, you must
  140.                    have written permission of the author
  141.                    (address see below)
  142.  
  143.  
  144.         I take no warranty or garanty for the function of this program.
  145.         The whole risk of using it stays by the user.
  146.  
  147.  
  148.  
  149.  
  150. FEATURES:
  151.  
  152.         - Creating of Dirs and Files.
  153.  
  154.         - Multiples specifications supported
  155.  
  156.         - very small code size
  157.  
  158.         - It owns a QUIET option, which enables you to use Create in
  159.           every kind of batchfiles.
  160.  
  161.  
  162. Installation:
  163.  
  164.         Just copy Create to your c: dir or any other dir in your current
  165.         AmigaDOS searchpath.
  166.  
  167. Starting Create:
  168.  
  169.  
  170.         Create must be startet from Cli. Alternatively you can use the
  171.         'ExecuteCommand' WBench menuitem.
  172.  
  173.  
  174. Create START PARAMETERs:
  175.  
  176.         Create has the following
  177.  
  178.         Syntax: Craete File_Or_Dir/M/A,[QUIET/S]
  179.  
  180.  
  181.         File_Or_Dir/M/A  one or more  The given name is the file or dir you
  182.                          strings      wants to create. You can specify
  183.                                       multiples files and/or dirs.
  184.                                       If you wnat to create dirs you must put
  185.                                       an '/' at the end of the name. Otherwise
  186.                                       you will get a new file.
  187.  
  188.  
  189. !!!! WARNING:  You should take care that some copier and cruncher, like LHA
  190.                or LHArc have problems with files with the size of 0 Bytes.
  191.                So you should look for empty files and dirs and delete them
  192.                before you want to archieve or crunch something.
  193.  
  194.  
  195.         QUIET  --------------    If you specify QUIET no messages about
  196.                                  successfully operations will be printed
  197.                                  Normally Create informs you if it had
  198.                                  created a file or dir.
  199.                                  This is very useful if you want to use
  200.                                  Create in batchfiles.
  201.                                  If an error occures Create sets its
  202.                                  ReturnCode to 5 (warn). This normally
  203.                                  terminates a batchfile execution.
  204.  
  205.  
  206. *** If you start Create without spacifying any PARAMETER a little
  207. *** helptext will be displayed. Also if you give a wrong commandline
  208. *** to Create.
  209.  
  210.  
  211. Technical:
  212.  
  213.  
  214.         Create is compiled with the Manx Aztec C V 5.2a - Compiler
  215.  
  216.         Create uses the new ReadArgs DOS - functions for CommandLine-
  217.         Parsing. Also I used functions as Lock, Unlock, ParentDir etc...
  218.  
  219.  
  220. Last:
  221.  
  222.         I hope Create would be used by many people.
  223.  
  224.         If you find any bugs please let me know.
  225.  
  226.         Also serious critic and/or ideas are wellcomed.
  227.  
  228.  
  229.  
  230. Address:
  231.  
  232.          Send all messages to:
  233.  
  234.  
  235.  
  236.                 Hans - Peter Guenther
  237.  
  238.                 Gruener Weg 5
  239.  
  240.                 3501 Fuldatal 2
  241.  
  242.                 GERMANY
  243.  
  244.  List of Files:
  245.  
  246. (If you miss any of the following files your release is incomplete)
  247.  
  248. Create            : the binary
  249. Create.info
  250. Create.dok        : the english documentation
  251. Create.dok.info
  252. Create.doc        : the german documentation
  253. Create.doc.info
  254.  
  255. ---
  256. END
  257.  
  258.  
  259. Have Fun ...
  260.  
  261.  
  262.         H.P.G
  263.  
  264.