home *** CD-ROM | disk | FTP | other *** search
/ Frozen Fish 1: Amiga / FrozenFish-Apr94.iso / bbs / alib / d8xx / d860 / azmake.lha / AzMake / AzMakedok.eng < prev    next >
Text File  |  1993-04-14  |  9KB  |  218 lines
  1. ============================================================================
  2.  
  3.           AAAAAAA   ZZZZZZZ   M     M   AAAAAAA   K    K  EEEEEEE
  4.           A     A        Z    MM   MM   A     A   K   K   E
  5.           A     A       Z     M M M M   A     A   K  K    E
  6.           AAAAAAA    ZZZZZ    M  M  M   AAAAAAA   KKK     EEEE
  7.           A     A     Z       M     M   A     A   K  K    E
  8.           A     A    Z        M     M   A     A   K   K   E
  9.           A     A   ZZZZZZZ   M     M   A     A   K    K  EEEEEEE
  10.  
  11. ============================================================================
  12. Version 2.3
  13.  
  14. AzMake is a work enviorment for Aztec C. You can compile, link, print your
  15. source... (Of course you need the MANX Aztec C Software)
  16.  
  17. This Program is SHAREWARE. You can give it to anyone you like, as long as
  18. the program is not changed in any way and this Doc-File is left intact.
  19. You may not sell it, or give it away with any kind of comercial software
  20. (exept you have a written permission by the author).
  21. This Program may be icluded in "Amiga Lib Disks" by Fred Fish , "Franz"
  22. by Holger Franz and "Amiga Szene" by SEP, no other series.
  23. I spent much time in AzMake, and I'd like to be rewarded for my work. So
  24. there is a little restriction build in the program. The Copyright Info
  25. will appear in irregular distances and you have to read some information
  26. before the CONTINUE gad will work. This is a fully working version, exept
  27. of the message that will appear. If you pay the contribution, you'll get
  28. a version without this "feature" and the full source code (Aztec C 5.2).
  29. I suggest US$15 or DM20 (There is included a disk with the files and the
  30. postage I have to pay).
  31. I can't be responsible for any damage caused by the use or disuse of AzMake.
  32.  
  33.  
  34. Installation
  35. ------------
  36. --------------------------> IMPORTANT <---------------------------------
  37. This version will only run under Kick 2.0 or higher (??)
  38. ------------------------------------------------------------------------
  39.  
  40. Get your system started normaly. Set your enviorment vars as used. AzMake
  41. can be started from the Shell (Cli) or Workbench.
  42. AzMake will work under priority -1, so it won't slow down the compiler,
  43. assembler and linker.
  44. Be shure that cc, as and ln are found, so set your path correct. If you
  45. run AzMake from WB, put them in c:.
  46. Finish the program by closing the window.
  47.  
  48.  
  49. The gadgets:
  50. ------------
  51.  
  52. Mini:
  53.     Will make the window very small and place it in the top left of the
  54.     Workbench. You can drag it anywhere and the next time it will appear
  55.     at your favourite place. You can get the full windows by activating
  56.     the MINI window and press the right mousebutton. If you select the
  57.     MINI gadget, AzMake will test the current height of the output win,
  58.     and if you reopen the full window the output will appear in it's
  59.     old height. (WIDTH IS ALWAYS 640)
  60.  
  61. Info:
  62.     There will appear an info about this Program, same as the "reminder
  63.     to pay".
  64.  
  65. Cc:
  66.     This will call cc to compile the program in the "MainFile" gadget.
  67.     All the options standing in the "Compiler Opt" gad are used.
  68.     It will work like this: cc <MainFile> <Compiler Opt>
  69.     Make shure that the path is set correct and "cc" is found.
  70.     Clicking any gadget during compilation will have no effect.
  71.  
  72. As:
  73.     This will call as to assemble the program. See Cc.
  74.     The ending <.asm> will be connected to the mainfile.
  75.     (It is only useful to use "As" when you compile with "-a", or
  76.     load a ".asm" file)
  77.  
  78. Ln:
  79.     Link the program. ln <MainFile>.o <Linker Opt>
  80.     For more info look Cc.
  81.  
  82. Cc & Ln:
  83.     If you are shure that there are no errors in your source, use this
  84.     gadget. It will work like clicking Cc and Ln after the other.
  85.     Of course this is not useful if your "Compiler Opt" contains "-a".
  86.     IMPORTANT: If there are errors while compiling AzMake will try to
  87.     link the object file nevertheless.
  88.  
  89. Dir:
  90.     The current dir will be printed on your monitor.
  91.  
  92. Pick File:
  93.     A filerequester will appear. Choose the file you want to compile.
  94.     AzMake only accepts files with the extension ".c", ".h" or ".asm".
  95.     If an option file exists, the options will be loaded automaticaly.
  96.  
  97. Save Options:
  98.     The Options for cc, as, ln will be saved in a file named as your
  99.     programm, with the extension ".azcfg". If you pick the workfile
  100.     afterwards, the options will load automaticaly.
  101.  
  102. NewShell:
  103.     This will open a new Shell. It acts like "NewShell" in DOS, so you
  104.     can immediately test your programms.
  105.  
  106. Run Program:
  107.     The program named in the "MainFile" gad will be started. It will
  108.     use the same stdin, stdout, stderr as AzMake. Maybe you prefer
  109.     a Shell to start and test your program.
  110.  
  111. Print Source:
  112.     Your source <MainFile> will be printed. You need PRT: as a mounted
  113.     device, all options in the Preferences set will be used.
  114.  
  115. Kill Window:
  116.     If any program will leave an open window, or will die (TASK HELD),
  117.     work can go on, but how to close the windows? KillWindow will list
  118.     all windows found on Workbench with their names and positions.
  119.     Select the one you want to close and click "OK". But be careful:
  120.     Closing the wrong window (if there ist still a task that wants to
  121.     change anything in the window ) will perhaps force a GURU.
  122.     If you are not shure, select the "CANCEL" gad.
  123.  
  124. MainFile:
  125.     The name of he program you want to compile, link ...
  126.     The suffix of the program ".c, .asm, .o" is not displayed. This
  127.     gad is only used to inform about the selected program. To select
  128.     another, please use >> Pick File <<.
  129.  
  130. Compiler Opt:
  131.     Options for cc.
  132.  
  133. Assembler Opt:
  134.     Options for as.
  135.  
  136. Linker Opt:
  137.     Options for ln. The default is "-lc".
  138.  
  139.  
  140. All functions of the gadgets can also be called by pressing the underlined
  141. character of the gad. CAPS will be ignored.
  142.  
  143.  
  144. The menus :
  145. -----------
  146. Mini:
  147.     Same as gadget MINI.
  148.  
  149. About:
  150.     A siple request with a little copyright note.
  151.  
  152. Quit:
  153.     Leave AzMake. Same function as closing the window.
  154.  
  155. Save Startup:
  156.     Similar to "Save Options", but there is created a file >s:AzMake.cfg<.
  157.     Everytime you start AzMake, it will look for this file and load your last
  158.     saved Options. So you can start to work immediately after loading AzMake.
  159.     If the file >s:AzMake.cfg< is not found, nothig will happen, AzMake will
  160.     start with no file loaded.
  161.  
  162. Load Startup:
  163.     This will load >s:AzMake.cfg<. If you tested inbetween other programs
  164.     and want to return to your favourite program.
  165.  
  166. Delete Startup:
  167.     >s:AzMake.cfg< will be deleted, if there is a wrong path, because your
  168.     harddisk is reorganized, or you don't want to load anything while
  169.     starting AzMake.
  170.  
  171. Delete ().o File:
  172.     After linking the ().o File will be deleted. This may be usefull if you
  173.     are low on disk capacity. BUT AzMake will not notice if there is an error
  174.     while linking and delete the ().o file in every case, so if you only
  175.     linked with the wrong library you have to recompile.
  176.  
  177.  
  178.     ----------------                 ARexx              ------------------------
  179.  
  180. AzMake opens an ARexx port named >> REXX_AZMAKE <<. So you can send via Arexx
  181. commands to AzMake.
  182. IMPORTANT: RexxMast has to be started before you can start AzMake.
  183. If you want to run another copy of AzMake, this can't work, because only
  184. one port with the name >> REXX_AZMAKE << can be opened, so AzMake No 2 will
  185. notify about this and quit.
  186. AzMake accepts the following commands in ARexx mode:
  187. cc , as , ln , ccln . (CAPSED characters are also allowed)
  188. All commands will act as if they were called by selecting the gadget.
  189. This is usefull if you work with an editor that uses ARexx commands, so
  190. you can select the right options and file, mini the window and call AzMake
  191. by the ARexx commands from your editor. AzMake will only open an output win
  192. to show you the compiler, assembler, linker messages. Close it to get rid of
  193. the output window.
  194. Example (Compile your file from shell) :
  195. 1.DH0:>rx "address REXX_AZMAKE cc" (return)
  196. (Editor macro):
  197. "address REXX_AZMAKE cc"
  198.  
  199.  
  200.  
  201. Excuse my school english.
  202.  
  203. ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
  204.  
  205. I'd like to say once more, that this program is SHAREWARE. All rights
  206. are reserved.
  207. If you pay, you'll get a disk with a fully working version, and all C source
  208. codes. (Of course, this version is a fully working one, but
  209. the automatic copyright info will be away)
  210.  
  211. Christian Friedel
  212. Jägerstraße 6
  213. 5064 Rösrath 3 (From July 1993 51503 Rösrath)
  214. W-Germany
  215.  
  216. ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
  217.  
  218.