home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 2 / DATAFILE_PDCD2.iso / utilities2 / meditate / MEditate / Manual next >
Text File  |  1994-02-07  |  30KB  |  731 lines
  1.                 **************************************
  2.                 *             !MEditate              *
  3.                 *          © Andrew Bennett          *
  4.                 *            Quick Manual            *
  5.                 *              Freeware              *
  6.                 **************************************
  7.  
  8.        This is is a shortened version of the manual, intended to be
  9. printed out and used as a reference.
  10.  
  11. SECTION 1 - General Info
  12. ~~~~~~~~~~~~~~~~~~~~~~~~
  13.  
  14. Copyright
  15. ~~~~~~~~~
  16.        This software and the associated files are  the copyright of
  17. Andrew Bennett and Neil Davies unless other wise stated.  The
  18. package may be freely distributed as long as it remains unaltered
  19. and no more than £2 is charged for the disc.  The only condition
  20. for use is that you send us me a copy of anything released with
  21. this package, and that you leave our copyright message in the !Help
  22. file.  A mention in your mag would be nice as well, but that's up
  23. to you. If you wish to use this software for commercial purposes
  24. you must get specific permission.  Users can get upgrades if you
  25. supply a disc (preferably with some PD on it) and a stamp, I will
  26. send the latest version that is available.
  27.  
  28.        This software is supplied 'as is'.  The authors cannot be
  29. held responsible for any damage or data loss resulting from the use
  30. or misuse of this package.
  31.  
  32.        Please report any bugs and feel free to make suggestions so
  33. that we can continue to improve the software.
  34.  
  35. Changes from version 3.08 (first PD release)
  36. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  37. Version 3.11 (limited release):
  38.  - Minor Bug fixes
  39.  - A new colour selector to replace the origional naf one.
  40.  - Now supports sprites from any mode except 256 colour ones.
  41.  - Icon bar installation for Read-Only version.
  42.  
  43. Version 3.31 (second PD release)
  44.  - Minor bug fixes.
  45.  - New, simpler, menu system.  Click on the menu button to bring up
  46. an Amiga style menu bar.  Adjust no longer has a function.
  47.  - A new text rippling routine, much faster because it stops
  48. rippling when the article stops changing.  It uses less memory as
  49. well.
  50.  - You can now only edit one line at a time but the up and down
  51. arrow keys move you to the previous or next line, rippling as you
  52. move.
  53.  - Keyboard shortcuts for text input. Shift+cursor keys moves the
  54. cursor by a whole word and Ctrl+cursor keys moves to the start or
  55. end of a line
  56.  - The edit mode stays active until it is turned off, rather than
  57. it only staying on for one operation.
  58.  - Menus and dialogue boxes will stay readable and roughly the same
  59. colour whatever palette you use.  This only works with the default
  60. palette, I don't know why.
  61.  - Icon bar system for Read-Only version now checks that there is
  62. enough screen memory to go back into the mag.
  63.  - Turned the insert graphics routine into two separate routines -
  64. insert graphics and load sprites.
  65.  - Pointer now turns into a cross hair to showthat you need to drag
  66. a box over an area.
  67.  - New improved line editing in articles.
  68.  - Formatting characters in the editor can be toggled on and off.
  69.  - Major bug fix:  Items paced on the far right of a menu would
  70. appear on the left side.  This has cause a small compatibility
  71. problem with earlier versions although it is easily fixed, see the
  72. "ReadMe1st" file.
  73.  - Major bug fix:  Program would crash if you deleted a empty menu.
  74.        Cor, havn't I been busy :-)
  75. ____________________________________________________________________
  76.  
  77. SECTION 2 : Standard Program Elements
  78. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  79. Certain parts of the program crop up often such as file selectors,
  80. these are described here.
  81.  
  82. File Selectors:
  83. ~~~~~~~~~~~~~~~
  84.         A standard selector is used when choosing files or sprites. 
  85. It shows a list of names (with filetypes if appropriate) and two
  86. icons to scroll up and down.  Directories can be entered, and you
  87. can return to the starting directory by selecting the <parent> from
  88. the top of the list.
  89.  
  90. Dialogue Boxes:
  91. ~~~~~~~~~~~~~~~
  92.         When input from the keyboard is required a dialogue box is
  93. used which is similar in function to those found on the desktop. 
  94. Often existing text is presented in the box for editing.
  95.  
  96.  left arrow            : move left
  97.  shift + left arrow    : move left by one word
  98.  ctrl + left arrow     : move to beginning of line
  99.  right arrow           : move right
  100.  shift + right arrow   : move right by one word
  101.  ctrl + right arrow    : move to end of line
  102.  delete and backspace  : delete to the left of the cursor
  103.  copy                  : delete to the right
  104.  Ctrl-U                : clear whole line
  105.  return                : finish editing
  106.  
  107. When editing an article these extra functions are available:
  108.  up arrow              : move up by one line
  109.  shift + up arrow      : move to top of page
  110.  down arrow            : move down by one line
  111.  shift + down arrow    : move to bottom of page
  112.  f1                    : insert newline character
  113.  
  114.        In some cases you will be limited to the length of string
  115. that can be inputted (e.g. with some filenames) but in others there
  116. is no limit (not strictly true since BASIC can only handle strings
  117. of 256 characters).  In these cases the text will scroll left and
  118. right.
  119.  
  120. The Colour Requester:
  121. ~~~~~~~~~~~~~~~~~~~~~
  122.        When you wish to change colours in a magazine you will be
  123. shown a palette on which to make your choices.  The foreground
  124. colour is selected by clicking with 'select' on one of the sixteen
  125. colours shown.  The background is selected by using the 'adjust
  126. button'.  Your colour choices are shown just below the palette so
  127. that you can experiment with different combinations before you make
  128. a final decision.  When you are satisfied with the colour
  129. combination you click on the word "DONE" and the changes are
  130. applied.
  131.  
  132. The New Menu System:
  133. ~~~~~~~~~~~~~~~~~~~~
  134.        As of version 2.31 there is a new menu system, which is a
  135. vast improvement on the previous system.  It is based on the menu
  136. system of other computers i.e. the Mac and Amiga.  A menu bar is
  137. brought up by pressing and holding the "menu" button (the middle
  138. one) on your mouse.  On the menu bar there should be a number of
  139. options (plus a time/date which has no function other than to tell
  140. the time), whilst still holding down the menu button you can move
  141. your mouse over these options.  Doing so will cause a menu to drop
  142. down from which you can make a selection by letting go of the menu
  143. button whilst over your choice, which is highlighted.  Letting go
  144. elsewhere will result in no selection being made and the menu
  145. dissappearing and moving back onto the bar before you let go will
  146. allow you to open the other menus.
  147.  
  148.        In short, hold down the middle button, move over the menu
  149. bar, move over a menu selection and let go.
  150. _________________________________________________________________
  151.  
  152. SECTION 3 : Help!
  153. ~~~~~~~~~~~~~~~~~
  154.  
  155.  The Application Directory
  156.  ~~~~~~~~~~~~~~~~~~~~~~~~~
  157.    The Application directory contains the resources used by
  158. MEditate, bar the articles.  If you open this directory you will
  159. see all the usual files that an application has plus a directory
  160. called "magsystem". "Magsystem" contains all the files that are
  161. loaded by the magazine when it starts up.  In the 'read-only'
  162. version the tracker-player and music files would be stored here,
  163. but the editor does not  run the music.  In this directory are
  164. three other files essential to the magazine:
  165.  
  166.  1) "!pointer"  This file simply contains the pointer sprite. 
  167. It's colours are controled by the palette file in the Articles
  168. directory, use the desktop palette application to alter it.
  169.  
  170.  2) "bannerfile"   All the graphics used by the menu system are
  171. stored in this sprite file.  The sprites may be from any mode
  172. other than 256 colour modes.  All mode 12 graphics should use the
  173. default palette that you have chosen, other sprites will have
  174. their own pallets mapped onto the current palette.  If you open it
  175. you will see the sprite for the control panel plus any other
  176. graphic that appears on a menu.  The control panel  should have a
  177. large area for the main window and contain the following 3
  178. buttons: Previous Page/Menu, Next Page, Exit Article/Root Menu. 
  179. In addition to these two optional buttons are available: Exit t