home *** CD-ROM | disk | FTP | other *** search
/ Magazyn Exec 5 / CD_Magazyn_EXEC_nr_5.iso / Programy / Programowanie / AmigaE / dech.lha / DECH / DECH.Readme < prev    next >
Encoding:
Text File  |  2001-03-10  |  9.2 KB  |  284 lines
  1. About DECH - Deniil E-Compiler Handler v1.38!
  2. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  3.  
  4. Made in 2001-03-10
  5.  
  6.  
  7. Intro:
  8. ~~~~~~
  9. This program is made for you who program in Amiga-E and
  10. compile alot, which is usual, and is tired of CLI/Shell
  11. or the Workbench menu (ToolsDaemon)!
  12.  
  13. With this program can you easy select one or more files
  14. that you often compile and then with just ONE mouse-click
  15. compile the active file and one more click to run it!
  16. Or, why not both compile and run with one mouse-click!
  17.  
  18. News:
  19. ~~~~~
  20. * NEW * As everybody know, E-programs have their own internal
  21.         stacksize and does not care what stack DOS is setting
  22.         it to. Therefor I have now finally removed the
  23.         "Stack of executed programs" and replaced it with
  24.         "Stack of the compiler" instead which will make also
  25.         CreativE to work with DECH.
  26.  
  27. * NEW * It was impossible to set the size of the output window
  28.         with the 'Adjust console-window'-feature.
  29.  
  30. v1.37
  31. * Finally the ProgDir: and current dir is set to the
  32.   actual directory where the project being executed
  33.   exists and not always to the ProgDir: of DECH!
  34.  
  35. * Now the string-requester that is used for arguments
  36.   accepts an empty string. (I finally got the autodocs
  37.   for ReqTools :))
  38.  
  39. * The string-requester should now open on the same
  40.   pubscreen as DECH. Don't think it did that before..
  41.  
  42. v1.36
  43. * Now you can change the order of the files in the
  44.   Button-lister.
  45.  
  46. * Fixed a small update bug in the lister-handling.
  47.  
  48. v1.35
  49. * Added a pubscreen selector in the Prefs/More.. -window.
  50.  
  51. * Now checking pubscreen is delayed 2 seconds if "Start
  52.   editor on startup" and a pubscreen is selected. This
  53.   is so the pubscreen will have time to open.
  54.  
  55. * Now the info-window is only opened if the mouse is
  56.   above DECH main-window.
  57.  
  58. * Now added a possibility to disable the RP/Rn buttons.
  59.  
  60. * The windows refresh better now when using MCP's solid
  61.   windowsizing.
  62.  
  63. * Fixed a problem when executing programs without arguments.
  64.  
  65.  
  66.  
  67. Usage:
  68. ~~~~~~
  69.  
  70. Please start the program before you try to understand the usage..! :-)
  71.  
  72.  EC: E-Compile the first file in the right list
  73.  RP: Run the Program compiled with EC
  74.  Cn: Compile the n:th file in the right lister of the file-selector
  75.  Rn: Run the Program compiled with Cn
  76.  --
  77.  ED: Select a file to open with your favorite text-EDitor
  78.  V : Select a file to open with your favorite text-Viewer
  79.  FS: Open/close the FileSelector
  80.  C : Open/close the output that is a Console by default. (se notes below!)
  81.  ? : Open/close the prefs-editor
  82.  Q : Quit
  83.  
  84. All this buttons can also be controlled from the keybord:
  85.  EC: F10
  86.  RP: 0
  87.  Cn: Fn, i.e. F1..F9
  88.  Rn: n,  i.e. the numberkeys 1..9
  89.  ED: 'e'
  90.  V : 'v'
  91.  FS: 'f'
  92.  C : 'c'
  93.  ? : '?'
  94.  Q : 'q'
  95.  
  96. You can press the right mouse-button or 'Help' to get a small
  97. info-window with information of what the different gadgets do,
  98. or in v1.33+ you get the list of what was supposed to be the
  99. gadgets Cn/Rn if you "Reduce gadgets" (see below).
  100.  
  101.  
  102. The editor- and viewer-selector:
  103. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  104. If you press 'ED' or 'V' you will get a little window with
  105. some numbers and a "C". With the editor also an "N".
  106. Any number will open the corresponding file in your favorite
  107. text-editor/viewer.
  108. The C stands for 'Cancel'.
  109. The N stands for 'New/empty editor'.
  110. The keys 'n', 'c' and the numbers 1..n also works here.
  111.  
  112.  
  113. The fileselector:
  114. ~~~~~~~~~~~~~~~~~
  115. The left lister is where all files comes in after you have
  116. selected them with 'Add'. One file or more will also always be
  117. present in the right lister where every item is a button in the
  118. main-window or a selected if you set the "Reduced gadgets".
  119.  
  120. What the buttons do:
  121.  Add:    Add a file to the left lister.
  122.  Delete: Remove a file from the left lister.
  123.  Clear:  Clear all files in the left lister.
  124.  Sort:   Sort all files in the left lister.
  125.  Load:   Load the entire config with files and settings.
  126.  Save:   Save the above..
  127.  Quit:   Quit program and copy back all files from
  128.           Ram:DECH/ if you wish.
  129.  OK:     Exit the file-selector.
  130.  
  131.  >Add>:  Copy a filename from the left to the right lister.
  132.  >Refr>: Refresh the selected filename in the right lister
  133.           with the selected filename in the left lister.
  134.  >Del>:  Delete the selected filename from the right lister and
  135.           if the file is in Ram:DECH/ you will be questioned to
  136.           copy back the file from Ram:DECH first.
  137.  \/ /\:  With these you can move a file up and down in the right lister.
  138.  ToRam>: Copy the selected file in the right lister to "Ram:DECH/"
  139.           with all it's corresponding '*local' modules!
  140.  Safety: Safety-copy the selected file from Ram:DECH/ back to
  141.           disk it's original place on disk without changing
  142.           anything in the lister.
  143.  GetRam: Copy back all files copied to Ram:DECH/ to their original
  144.           places on disk and delete the files in Ram:DECH/.
  145.  
  146.  
  147. The prefs-window (?):
  148. ~~~~~~~~~~~~~~~~~~~~~
  149. "Auto-run program after compiling"
  150.   This will let you with a click on just EC both first compile
  151.   and then also run the program.
  152.  
  153. "Popup string-requester before running program"
  154.   This will let you type in some arguments before a program
  155.   is executed. Useful when testing CLI applications.
  156.  
  157. "Auto-refresh first file"
  158.   This makes the first file in the "Button"-lister be
  159.   automatically changed to whatever you press or select
  160.   in the left "Source-code"-lister.
  161.  
  162. "Start editor on startup"  with  "Edit:"
  163.   With this enabled DECH will start your texteditor with a selected
  164.   file. The file is selected with "Edit:". This is useful if
  165.   you work on a programs that crashes all the time and you
  166.   would like DECH to open up this very file automatically after
  167.   every restart.
  168.  
  169. "Reduce gadgets to EC and RP"
  170.   This will as it say reduce all Cn-/Rn-gadgets in the main-
  171.   window to just EC and RP and the selection is then made in
  172.   the info-window you get when you click the right mouse-button.
  173.  
  174. "Disable Rn- and RP- button(s)"
  175.   Use this if you often accidently presses a RP/Rn button.
  176.  
  177. "Do not warn when closing console"
  178.   This will just skip the requester when you close the console
  179.   and have executed a program in it.
  180.   *** REMEMBER!! This IS dangerous if a program is still
  181.                  outputting text to that console! ***
  182.  
  183. "Don't touch the stdout console"
  184.   This forces DECH to not use the specified "Output:".
  185.  
  186. "Auto-open console on startup"
  187.   Will do exacly what it says :)
  188.  
  189. |More..| will open another prefs window described below.
  190.  
  191. |Adjust console-window| lets you with a simple move place your
  192.                         console wherever on the screen you want.
  193.  
  194. |Save| will save the entire config-file to ENVARC:DECH.config.
  195.  
  196. |OK| will close this window.
  197.  
  198.  
  199. More prefs.. -window:
  200. ~~~~~~~~~~~~~~~~~~~~~
  201. Editor:    Your favorite editor with path.
  202.            Has an argument-string at the right.
  203.  
  204. Viewer:    Your favorite viewer with path.
  205.            Has an argument-string at the right.
  206.  
  207. Compiler:  The compiler with path and eventual arguments.
  208.  
  209. Output:    An output-file, console or whatever you like.
  210.            You can set up to four %d's that will be the
  211.            coordinates of a console-window.
  212.  
  213. PubScreen: The name of a pubscreen you want DECH to open on.
  214.            To get a console to open on the same screen you have to
  215.            add  /SCREEN YOURPUBSCREEN  to the Output: line.
  216.  
  217. "Get"      Popup a pubscreen selector which you can use to pick a
  218.            currently open pubscreen, it fixes the Output too.
  219.  
  220. "Priority of editor:"
  221.   This is the task-priority of the editor when you start
  222.   it from DECH.
  223.  
  224. "Priority of executed programs:"
  225.   This is the task-priority of the programs you start from DECH.
  226.   It is smart to set this <0 so that if some program would hang
  227.   in a loop, it wouldn't jam the system!
  228.  
  229. "Stacksize of the compiler:"
  230.   The stacksize the compiler will get. Must be dividable by 4!
  231.  
  232. |Save| will save the entire config-file to ENVARC:DECH.config.
  233.  
  234. |OK| closes the window.
  235.  
  236.  
  237. Usage of the console:  IMPORTANT!  (to prevent crash..)
  238. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  239. When you use the console it is important that if you have started
  240. a program through 'RP' (or 'Rn') with the console opened and the
  241. program outputs text to the console that you must not close it or
  242. things might go very wrong!!
  243. It is better to close the console and then start your program,
  244. editor or viewer so that it will get the original 'stdout'-variable
  245. instead, unless you're just debugging a project of yours and don't
  246. want your screen full of consoles everytime you test your program :)
  247.  
  248. You can, in the prefs-window, set "Don't touch the stdout console"
  249. if you start DECH from a CLI/Shell.
  250.  
  251.  
  252. Bugs:
  253. ~~~~~
  254. * It's not possible to read data from the console DECH opens.
  255.   Don't know why.
  256.  
  257.  
  258. Author:
  259. ~~~~~~~
  260. Daniel Westerberg
  261. e-mail:  deniil@algonet.se
  262.  
  263. Send bug-reports and/or suggestions to me.
  264.  
  265.  
  266. OnyxSoft support..
  267. ~~~~~~~~~~~~~~~~~~
  268. If you like our products, found bugs, have complains or
  269. ideas etc. etc. Don't hesitate to contact us..
  270.  
  271. OnyxSoft productions can be found on our HomePage.
  272. Updates and new releases will be there first..
  273.  
  274. OnyxSoft e-mail   : daniel@onyxsoft.nu
  275. Deniil's e-mail   : deniil@algonet.se
  276. OnyxSoft HomePage : www.onyxsoft.nu/
  277. Deniil's HomePage : www.algonet.se/~deniil/
  278.  
  279. We just love to get response from other Amiga-freaks!!
  280.  
  281. As this program is made by Deniil I prefer that you
  282. mail to "deniil@algonet.se" rather than onyxsoft.. Thanx!
  283.  
  284.