home *** CD-ROM | disk | FTP | other *** search
/ Magazyn Amiga Shareware Floppies / ma69.dms / ma69.adf / Misc / Misc.guide (.txt) < prev    next >
Amigaguide Document  |  1996-07-08  |  44KB  |  829 lines

  1. @database "Misc.guide"
  2. @next "MAIN"
  3. @$VER: Misc HyperText documentation v1.15
  4. @(C) 1995 CircleSoft
  5. @Author Dag 
  6. @remark // You should not be reading this!
  7. @remark  ******************************************************************
  8. @remark  If you are reading this, you are not using Multiview or Amigaguide
  9. @remark  or any other Amigaguide-hypertext viewer. Or you are simply too
  10. @remark  curious. I suggest you exit and start your Amigaguide-viewer,
  11. @remark  if you're not sure you have one, try double-clicking on this
  12. @remark  file's icon or typing:
  13. @remark        Multiview <full path to this file>
  14. @remark  or
  15. @remark        Amigaguide <full path to this file>
  16. @remark  from a shell, if this doesn't work, you are probably using an old
  17. @remark  version of AmigaDOS, Misc requires OS 2.0 or newer, so if this is
  18. @remark  the case, and you aren't running any hacks, you might as well
  19. @remark  remove this from your system. If the problem is something else,
  20. @remark  you can try to read it like this, but it will be a real hard job.
  21. @remark  Everything enclosed in `@{' and `}' are commands, ignore them.
  22. @remark  ******************************************************************
  23. @remark //
  24. @remark // Main
  25. @node MAIN "Misc.guide/Main"
  26. @next INTRO
  27.                          CircleSoft presents
  28.              ###   ###      ###    ###########    ##########
  29.             ##### #####    ##### ##############  ############
  30.             ###########    ##### #############  ############
  31.            #############    ###    #######      #####
  32.           ###############   ###      ########   #####
  33.          ################# #####  ############# ############
  34.          ##### ##### ##### ##### ##############  ############
  35.           ###   ###   ###   ###   ############    ##########
  36.                                   v1.11
  37.                           
  38. @{b}By  Dag 
  39. gren@{ub}
  40.                          
  41. 1995 CircleSoft@{ub}
  42.               (http://www.abo.fi/~jbeijar/circle.html)
  43.     @{i}@{b}NOTE:@{ub} If the ASCII graphics don't look good, you have an old version
  44.           of amigaguide.library, or you have a lousy taste!@{ui}
  45.         @{"    INTRO     " link INTRO} Why this program?
  46.         @{"  COPYRIGHT   " link COPYRIGHT} Can you use it?
  47.         @{" REQUIREMENTS " link REQUIREMENTS} What do you need to use it?
  48.         @{" INSTALLATION " link INSTALLATION} How can you get going?
  49.         @{"    USAGE     " link USAGE} Uhh, then how do we do?
  50.         @{" HINTS & TIPS " link HINTS} Nifty little tips to make your life easier!
  51.         @{"   HISTORY    " link HISTORY} The story of Misc so far.
  52.         @{"     BUGS     " link BUGS} Six million ways to die!
  53.         @{"     TODO     " link TODO} Where do you want to be tomorrow?
  54.         @{"   CONTACT    " link CONTACTS} What to do when a bug occurs?
  55.         @{"    OUTRO     " link OUTRO} Some final things to say...
  56.                                                                           |
  57.     About us:
  58.         @{"   CIRCLESOFT   " link CIRCLESOFT} Who are we?
  59.         @{" OTHER PRODUCTS " link PRODUCTS} Check these out!
  60.   <<< CircleSoft >>>
  61. @endnode
  62. @remark //
  63. @remark // Introduction
  64. @remark ********************************************************************************************
  65. @node INTRO "Misc.guide/Introduction"
  66. @next COPYRIGHT
  67. @prev MAIN
  68.     @{fg fill}@{b}  _ _  __ _______
  69.      / V \\/  \\ __> __>
  70.     /  @{fg text}INTRODUCTION@{fg fill}__
  71.     \\_\\_/_/_/<___/___>@{ub}@{fg text}
  72. Ah, Misc the ultimate misc. utility has now reached it's second release.
  73. For those of you who have been hiding under a rock in outer Siberia for the
  74. last few years; Misc is a nifty utility that can complete two tasks, for
  75. now. One of them is to keep notes, like a standard NoteIt utility, this is
  76. what most of you will use it for. Here you can write down small pieces of
  77. text, small notes, without firing up an editor for it.
  78.     The other use of Misc is to keep logs, it provides a simple way of
  79. creating logs. Take a look at it. This is particularily useful for
  80. developers, who want to keep a History file of a program.
  81.   But why on earth did we name it Misc, and what the h*ck is that bloody
  82. rodent (or whatever it is for a creature) doing on all the icons? The name
  83. Misc comes from two things; Firstly, The program does multiple (two)
  84. things, and secondly, we have a bad imagination. And that stupid rodent...
  85. It's not stupid, it's the result of a phonecall that was going on for too
  86. long. We call him WinX (pronounced `wingks'), he has also got a friend
  87. called WinY (pronounced `whiny'). WinY hasn't made it to the real world
  88. yet, he's nothing but a name for the moment. The reason WinX is on all
  89. icons is that we couldn't come up with a better icon for a program like
  90. Misc. And we're trying to brainwash you!
  91.   Yes, having said that, here comes the critical point, Misc uses @{"MUI" link OTHERPPLPROGRAMS}!
  92. (Yes! Louder! I wanna hear you scream!) So, some of you will like this and
  93. some of you won't. This program was made for them of you who will. One
  94. thing to the ones who don't like it: It won't stay in memory (like a
  95. commodity or something), so you won't really suffer from it using @{"MUI" link OTHERPPLPROGRAMS}.
  96. Another note for all you d*rks who think MUI-programs never free all memory
  97. they are using, they DO! The library stays in memory, yes, but the memory
  98. is freed if a program needs it. (And you can free it manually by typing
  99. `Avail Flush' in a shell.) We can further mention that this program uses
  100. the @{"Textfield.gadget" link OTHERPPLPROGRAMS}. That will hardly make anyone scream, but it's also
  101. great, it provides great editing facilities from the bottom to the top.
  102. @endnode
  103. @remark //
  104. @remark // Copyright
  105. @remark ********************************************************************************************
  106. @node COPYRIGHT "Misc.guide/Copyright"
  107. @next REQUIREMENTS
  108. @prev INTRO
  109.     @{fg fill}@{b}  _ _  __ _______
  110.      / V \\/  \\ __> __>
  111.     /    @{fg text}COPYRIGHT@{fg fill}<__
  112.     \\_\\_/_/_/<___/___>@{ub}@{fg text}
  113. Misc and all related files are copyright  @{b}
  114. 1995 CircleSoft@{ub}.
  115. That's @{"us" link CONTACTS}
  116. The program is distributed on an "as is" basis, no warranty of any kind is
  117. applied, you are using this program entirely on your own risk.
  118. The program may be redistributed as much you ever like, as long as the
  119. following conditions are observed:
  120.     @{b}o@{ub} The archive and files have to remain intact, no files may be
  121.       added, changed, removed, edited or altered in any other way.
  122.     @{b}o@{ub} It may not be included in any commercial distribution, without
  123.       written permission by the Author.
  124. @endnode
  125. @remark //
  126. @remark // Requirements
  127. @remark ********************************************************************************************
  128. @node REQUIREMENTS "Misc.guide/Requirements"
  129. @next INSTALLATION
  130. @prev COPYRIGHT
  131.     @{fg fill}@{b}  _ _  __ _______
  132.      / V \\/  \\ __> __>
  133.     /  @{fg text}REQUIREMENTS@{fg fill}__
  134.     \\_\\_/_/_/<___/___>@{ub}@{fg text}
  135. To run Misc, you need the following:
  136.     @{b}o@{ub} At least AmigaOS 2.0 or higher. We don't really know what version of
  137.       the OS is needed. If it doesn't work with your setup, please tell us.
  138.     @{b}o@{ub} @{"MagicUserInterface" link OTHERPPLPROGRAMS} (v3.1 or above) by Stefan Stuntz. Not included
  139.       with archive.
  140.     @{b}o@{ub} @{"Textfield.gadget" link  OTHERPPLPROGRAMS} (v3.1 or above) by
  141.       Mark Thomas. It is distributed with the archive.
  142.     @{b}o@{ub} An internal clock, if you intend to use the logging-features of
  143.       Misc.
  144. @endnode
  145. @remark //
  146. @remark // Installation
  147. @remark ********************************************************************************************
  148. @node INSTALLATION "Misc.guide/Installation"
  149. @next USAGE
  150. @prev REQUIREMENTS                                                 
  151.     @{fg fill}@{b}  _ _  __ _______
  152.      / V \\/  \\ __> __>
  153.     /  @{fg text}INSTALLATION@{fg fill}__
  154.     \\_\\_/_/_/<___/___>@{ub}@{fg text}
  155. To install Misc, just double-click on the "Install-Misc"-icon. If this for
  156. some reason fails, you can do it by hand through following the steps below.
  157.     @{b}1.@{ub} Copy the Misc-Executable to the desired location.
  158.     @{b}2.@{ub} Copy the Documentation for Misc to the desired location.
  159.     @{b}3.@{ub} Copy the preferred icons from the "Icons" directory.
  160.     @{b}4.@{ub} Copy the @{"Textfield.gadget" link OTHERPPLPROGRAMS} to sys:classes/gadgets.
  161.     @{b}5.@{ub} Delete the original files. Unless you want to keep them.
  162. @endnode
  163. @remark //
  164. @remark // Usage
  165. @remark ********************************************************************************************
  166. @node USAGE "Misc.guide/Usage"
  167. @next HINTS
  168. @prev INSTALLATION
  169.     @{fg fill}@{b}  _ _  __ _______
  170.      / V \\/  \\ __> __>
  171.     /     @{fg text}USAGE@{fg fill}_ \\<__
  172.     \\_\\_/_/_/<___/___>@{ub}@{fg text}
  173. Misc is divided into two parts, the @{"Notes" link NOTES} part and the @{"Log" link LOG} part. These
  174. two are quite different, even if they do look a bit similiar. So they are
  175. each explained separately in their own chapters. The menus are the same for
  176. both, though, so they are explained together in @{"Menus" link MENUS}.
  177. The usage section assumes that you know the basics of how to use @{"MUI" link OTHERPPLPROGRAMS}. It
  178. won't go through details with the interface, like how to skip between the
  179. two modes. (You do it using the Register (Cycle) gadget in the top of the
  180. window.) It will explain what the different gadgets do, though.
  181. @{b}Note:@{ub} Bubble help available.
  182.  @{"Notes" link NOTES} The notes-part of Misc.
  183.  @{" Log " link LOG} The logging part of Misc.
  184.  @{"Textfield.gadget" link TEXTFIELD} The Textfield.gadget.
  185.  @{"Settings" link SETTINGS} The settings of Misc.
  186.  @{"Menus" link MENUS} The menus of Misc.
  187. @endnode
  188. @remark //
  189. @remark // Usage/Notes
  190. @remark ********************************************************************************************
  191. @node NOTES "Misc.guide/Usage/Notes"
  192. @next LOG
  193. @prev USAGE
  194. When you enter the notes-mode. (By using the Register/Cycle gadget on top
  195. of the window) You will be presented with a Window looking something like
  196. this:
  197.                 @{b}@{fg fill}.--------------------@{ub}@{fg text} A stringgadget that shows the
  198.                 @{b}@{fg fill}|@{fg text}@{ub}                     name of the current note.
  199.     @{b} ___________@{fg fill}|@{fg text}________________@{ub}
  200.     @{b}|@{fg shine}.------------------------..-.@{fg text}| @{ub}
  201.     @{b}|@{fg shine}:========================:| |@{fg text}| @{ub}
  202.     @{b}|@{fg shine}|                        || |@{fg text}|
  203.     |@{fg shine}|                        |@{fg fill}-------@{fg text}@{ub} The @{"Textfield.gadget" link OTHERPPLPROGRAMS}, where you
  204.     @{b}|@{fg shine}|                        || |@{fg text}|@{ub}    edit/view your notes
  205.     @{b}|@{fg shine}|                        || |@{fg text}|
  206.     |@{fg shine}|                        || |@{fg fill}----@{fg text}@{ub} A prop-slider gadget to move around
  207.     @{b}|@{fg shine}|                        || |@{fg text}|@{ub}    in the note with
  208.     @{b}|@{fg shine}|                        ||-|@{fg text}|
  209.     |@{fg shine}|                        ||-|@{fg text}|
  210.     |@{fg shine}`------------------------'`-'@{fg text}|
  211.     |@{"    Next     " beep 0}@{"     Prev     " beep 0}|
  212.     `-------@{fg fill}|@{fg text}-------------@{fg fill}|@{fg text}-------'
  213.             @{fg fill}|             `--------------@{fg text}@{ub} Jumps to previous note
  214.             @{b}@{fg fill}|
  215.             `----------------------------@{fg text}@{ub} Jumps to next note
  216. The note handling has changed a bit since earlier versions of Misc. The
  217. notes don't have numbers anymore, instead they have titles. This brings up
  218. many good features, first, the obvious thing; clarity, a title is much more
  219. descriptive than `Note 3 of 6'. Secondly, it allows much faster
  220. note-handling.
  221. By clicking on the popup to the right of the note-title. You come to the
  222. note-database window. Here you can add notes, delete notes, and move them
  223. up and down, etc.
  224. Short description of gadgets:
  225.     @{b}New --@{ub} Adds a new note called 
  226.  Unnamed 
  227.  to the end of the
  228.           note list.
  229.     @{b}Kill -@{ub} Removes the current note.
  230.     @{b}Sort -@{ub} Sorts the notes in alphabetical order.
  231. We assume that we don't have to tell you how to change notes? Just click on
  232. the note you want in the listview. Note entries can also be dragged, using
  233. MUI's drag & drop features.
  234. The notes are typed in to the big empty area, the big double-bevel-box. If
  235. you want to edit an existing note, just activate the @{"Textfield.gadget" link OTHERPPLPROGRAMS} (by
  236. clicking on it with the mouse-pointer) and edit. Actually, the usage of the
  237. gadgets should be quite self-evident from the "picture".
  238. @{b}See also:@{ub} @{"Note Settings" link NOTE_SETTINGS}, @{"Notes menu" link NOTES_MENU} and @{"Hints & Tips" link HINTS}.
  239. @endnode
  240. @remark //
  241. @remark // Usage/Log
  242. @remark ********************************************************************************************
  243. @node LOG "Misc.guide/Usage/Log"
  244. @prev NOTE_SETTINGS
  245. @next LOG_SETTINGS
  246. The log window looks something like this:
  247.                 @{b}@{fg fill}.--------------------@{ub}@{fg text} A Popup-gadget with which you can
  248.                 @{b}@{fg fill}|@{fg text}@{ub}                     choose logfile.
  249.     @{b} ___________@{fg fill}|@{fg text}________________
  250.     |@{fg shine}.------------------------..-.@{fg text}|
  251.     |@{fg shine}:========================:| |@{fg text}|
  252.     |@{fg shine}|                        |@{fg fill}--------@{fg text}@{ub} The @{"Textfield.gadget" link OTHERPPLPROGRAMS}, where you
  253.     @{b}|@{fg shine}|                        || |@{fg text}|@{ub}     edit/view your log.
  254.     @{b}|@{fg shine}|                        || |@{fg text}|
  255.     |@{fg shine}|                        || |@{fg fill}----@{fg text}@{ub} A prop-slider gadget to move around
  256.     @{b}|@{fg shine}|                        || |@{fg text}|@{ub}    in the text with
  257.     @{b}|@{fg shine}|                        ||-|@{fg text}|
  258.     |@{fg shine}|                        ||-|@{fg text}|
  259.     |@{fg shine}`------------------------'`-'@{fg text}|
  260.     |@{"    Enter    " beep 0}@{"     Edit     " beep 0}|
  261.     `-------@{fg fill}|@{fg text}-------------@{fg fill}|@{fg text}-------'
  262.             @{fg fill}|             `--------------@{fg text}@{ub} Edits the Current log.
  263.             @{b}@{fg fill}|
  264.             `----------------------------@{fg text}@{ub} Creates a new log entry
  265. You might have noticed that using the Log-part slightly differs from using
  266. the notes-part. When you read your log, it's in one full text. This means
  267. that you can't flip between the different log entries with a "Next" or a
  268. "Prev" gadget as in the notes-part. All your log entries follow each other,
  269. only separated with an @{"Entry Separator" link LOG_SETTINGS}.
  270.   There are some priviledges with this though. E.g. if you want to include
  271. the version history you have written into the distribution package of your
  272. program, it would be an frustrating task to combine all entries. Note that
  273. Misc doesn't insert any <CR>s at the end of each line, (They are only
  274. inserted when you press <Return>.) so you have to edit the file yourself so
  275. that you won't have too long lines.
  276. When editing new entry or current log, the two buttons change into `Ok' and
  277. `Cancel'. Pressing `Ok' inserts the changes into the log, and `Cancel'
  278. returns without changing anything.
  279.   Also, when editing current log, you are put to edit directly into the
  280. full file, and you will have to find the correct entry for yourself.
  281. (Sorry, we might implement a "Find"-function if necessary...)
  282. @{b}See also:@{ub} @{"Log Settings" link LOG_SETTINGS}, @{"Log menu" link LOG_MENU} and @{"Hints & Tips" link HINTS}.
  283. @endnode
  284. @remark //
  285. @remark // Usage/Textfield.gadget
  286. @remark ********************************************************************************************
  287. @node TEXTFIELD "Misc.guide/Usage/Textfield.gadget"
  288.     @{"Textfield.gadget information" link OTHERPPLPROGRAMS}
  289.         @{b}@{u}DOCS FOR USERS@{ub}@{uu}
  290.         You can mark text for cutting, copying, and erasing by simply
  291.         clicking and dragging.  Hitting alphanumeric keys replaces the text
  292.         that is highlighted.  Hitting cursor keys moves you to the front or
  293.         end of the highlighted text.
  294.         While you drag to scroll, the farther away from the gadget your
  295.         mouse pointer is, the faster the gadget will scroll.
  296.         @{b}@{u}Key Sequence              Function                                      @{uu}@{ub}
  297.                TAB                Activate next gadget
  298.          SHIFT TAB                Activate previous gadget
  299.          SHIFT CURSOR UP          Move to the top line in the current page,
  300.                                   or scroll up one page if cursor is on top line
  301.          SHIFT CURSOR DOWN        Move to the bottom line in the current
  302.                                   page, or scroll down one page if cursor
  303.                                   is on top line
  304.           CTRL or
  305.          SHIFT CURSOR RIGHT       Move to the right end of the current line
  306.           CTRL or
  307.          SHIFT CURSOR LEFT        Move to the left end of the current line
  308.          SHIFT BACKSPACE          Delete all text to the left of cursor on
  309.                                   the current line
  310.          SHIFT DELETE             Delete all text to the right of the
  311.                                   cursor on the current line (in block
  312.                                   cursor mode this also includes the
  313.                                   highlighted character)
  314.           CTRL CURSOR UP          Move to the top line of the text
  315.           CTRL CURSOR DOWN        Move to the bottom line of the text
  316.            ALT CURSOR RIGHT       Move to the next word
  317.            ALT CURSOR LEFT        Move to the previous word
  318.            ALT CURSOR UP          Move to first character in gadget
  319.            ALT CURSOR DOWN        Move to last character in gadget
  320.            ALT BACKSPACE          Deletes the word to the left of the
  321.                                   cursor starting at the current cursor
  322.                                   position
  323.           CTRL X                  Deletes the whole line that the cursor
  324.                                    is on
  325.         RAMIGA [                  Switch to left justification
  326.         RAMIGA \ or
  327.         RAMIGA =                  Switch to center justification
  328.         RAMIGA ]                  Switch to right justification
  329.         RAMIGA E                  Erase all text in gadget (saved in undo
  330.                                   buffer) (no read-only)
  331.         RAMIGA V                  Paste text from clipboard to current
  332.                                   cursor position (no read-only)
  333.         RAMIGA A                  Mark all text
  334.         RAMIGA U                  Undeletes (pastes) the last block of text
  335.                                   marked, or recover from RAMIGA E
  336.                                   (no read-only)
  337.         When text is highlighted the following keys have functions:
  338.                BACKSPACE          Erase marked text (saved in undo buffer)
  339.                DEL                Erase marked text (saved in undo buffer)
  340.         RAMIGA X                  Cut marked text to clipboard (no
  341.                                   read-only)
  342.         RAMIGA C                  Copy marked text to clipboard
  343.         RAMIGA V                  Replace marked text with text from
  344.                                   clipboard (save marked text in undo
  345.                                   buffer) (no read-only)
  346.                (any text key)     Replace marked text with that character
  347. @{i}@{b}NOTE:@{ub} Some of the most important shortcuts are listed in the Bubble
  348. help!@{ui}
  349. @endnode
  350. @remark //
  351. @remark // Usage/Menus
  352. @remark ********************************************************************************************
  353. @node MENUS "Misc.guide/Usage/Menus"
  354. @next PROJECT_MENU
  355. @prev USAGE
  356. @{"Project" link PROJECT_MENU} @{"Notes" link NOTES_MENU} @{"Log" link LOG_MENU} @{"Settings" link SETTINGS_MENU}
  357.     Pick a menutopic from above.
  358. Back to @{"Usage" link USAGE}.
  359. @endnode
  360. @remark //
  361. @remark // Usage/Menus/Project
  362. @remark ********************************************************************************************
  363. @node PROJECT_MENU "Misc.guide/Usage/Menus/Project"
  364. @next NOTES_MENU
  365. @prev USAGE
  366. Project @{"Notes" link NOTES_MENU} @{"Log" link LOG_MENU} @{"Settings" link SETTINGS_MENU}
  367.     @{b}About  -@{ub} Shows a little information on Misc and its creators.
  368.     @{b}Quit   -@{ub} Quits Misc and saves all changes to notes & log.
  369. Back to @{"Usage" link USAGE}.
  370. @endnode
  371. @remark //
  372. @remark // Usage/Menus/Notes
  373. @remark ********************************************************************************************
  374. @node NOTES_MENU "Misc.guide/Usage/Menus/Notes"
  375. @next LOG_MENU
  376. @prev PROJECT_MENU
  377. @{"Project" link PROJECT_MENU} Notes @{"Log" link LOG_MENU} @{"Settings" link SETTINGS_MENU}
  378.     @{b}New note      -@{ub} Adds a new note at the end of the file.
  379.     @{b}Kill note     -@{ub} Deletes the current note.
  380.     @{b}Sort notes    -@{ub} Sorts the notes in alphabetical order.
  381.     @{b}Save note as  -@{ub} Exports the current note as an ASCII file.
  382.     @{b}Include file  -@{ub} Inserts an ASCII file at current cursor position.
  383.     @{b}Print note    -@{ub} Prints the current note.
  384.     @{b}Save notes    -@{ub} Saves the notefile.
  385. Back to @{"Usage" link USAGE}.
  386. @endnode
  387. @remark //
  388. @remark // Usage/Menus/Log
  389. @remark ********************************************************************************************
  390. @node LOG_MENU "Misc.guide/Usage/Menus/Log"
  391. @prev NOTES_MENU
  392. @next SETTINGS_MENU
  393. @{"Project" link PROJECT_MENU} @{"Notes" link NOTES_MENU} Log @{"Settings" link SETTINGS_MENU}
  394.     @{b}Search log  -@{ub} Searches for a string in the logfile.
  395.     @{b}Print       -@{ub} Prints the log.
  396. Back to @{"Usage" link USAGE}.
  397. @endnode
  398. @remark //
  399. @remark // Usage/Menus/Settings
  400. @remark ********************************************************************************************
  401. @node SETTINGS_MENU "Misc.guide/Usage/Menus/Settings"
  402. @next USAGE
  403. @prev LOG_MENU
  404. @{"Project" link PROJECT_MENU} @{"Notes" link NOTES_MENU} @{"Log" link LOG_MENU} Settings
  405.     @{b}Note       -@{ub} Opens the @{"Settings" link NOTE_SETTINGS} window in Notes-mode.
  406.     @{b}Log        -@{ub} Opens the @{"Settings" link LOG_SETTINGS} window in Log-mode.
  407.     @{b}Textfield  -@{ub} Opens the @{"Settings" link TEXTFIELD_SETTINGS} window in Textfield-mode.
  408.     @{b}MUI        -@{ub} Opens the MUI-Prefs for this program.
  409.     @{b}Save       -@{ub} Saves the current settings, which are:
  410.                           @{b}o@{ub} The note Settings
  411.                           @{b}o@{ub} The log Settings
  412.                           @{b}o@{ub} The textfield.gadget settings
  413.                           @{b}o@{ub} The current mode (Note/Log).
  414.                           @{b}o@{ub} The settings for @{"Textfield.gadget" link OTHERPPLPROGRAMS}
  415. Back to @{"Usage" link USAGE}.
  416. @endnode
  417. @remark //
  418. @remark // Usage/Settings
  419. @remark ********************************************************************************************
  420. @node SETTINGS "Misc.guide/Usage/Settings"
  421. @prev USAGE
  422. @next USAGE
  423. @{"Notes" link NOTE_SETTINGS} @{"Log" link LOG_SETTINGS} @{"Textfield" link TEXTFIELD_SETTINGS}
  424. The settings window is divided into three parts; @{"Notes" link NOTE_SETTINGS}, @{"Log" link LOG_SETTINGS} and
  425. @{"Textfield" link TEXTFIELD_SETTINGS}. These control the settings of the respective parts, of course.
  426. In the program, all settings are accessed via the menus. Pick your topic
  427. above.
  428. Back to @{"Usage" link USAGE}.
  429. @endnode
  430. @remark //
  431. @remark // Usage/Settings/Notes
  432. @remark ********************************************************************************************
  433. @node NOTE_SETTINGS "Misc.guide/Usage/Settings/Notes"
  434. @next LOG
  435. @prev NOTE
  436. @{b}@{u}Note file@{ub}@{uu}
  437.     Selects the filename for the notes.
  438. @{b}===== Options ================================================================================@{ub}
  439. @{b}@{u}Save notes after every change@{uu}@{ub}
  440.     Saves the notes after every change, otherwise the notes are only saved
  441.     on exit.
  442. @{b}@{u}Save current note@{uu}@{ub}
  443.     Remembers what note was open on exit, and opens that note when Misc is
  444.     started the next time.
  445. Back to @{"Usage" link USAGE}.
  446. @endnode
  447. @remark //
  448. @remark // Usage/Settings/Log
  449. @remark ********************************************************************************************
  450. @node LOG_SETTINGS "Misc.guide/Usage/Settings/Log"
  451. @next USAGE
  452. @prev LOG
  453. @{u}@{b}Date Format@{ub}@{uu}
  454.     With the Dateformat stringgadget you specify what format the Date
  455.     beginning each new Entry should look like. All years, dates, seconds,
  456.     other variables are preceeded with a `%'-sign, and followed by a
  457.     @{"Conversion Specifier" link CONVERSION_SPECIFIER}. This conversion specifier will be replaced with
  458.     the appropriate string. All other characters are shown just as in the
  459.     stringgadget. To get a `%'-sign, use `%%'. A preview of what it will
  460.     look like is shown in the gadget  below, labeled "@{b}Preview:@{ub}"
  461.     @{b}Example:@{ub}
  462.             The %d dogs ate the %m beefs!
  463.         Would be shown as;
  464.             The 26 dogs ate the 11 beefs!
  465.         If entered on November the 26th.
  466.     @{b}Default:@{ub}    %A %d.%m.%y, %H:%M
  467.     See @{"Conversion Specifiers" link CONVERSION_SPECIFIER} for a full list of them.
  468. @{u}                                                                                                @{uu}
  469. @{u}@{b}Entry Separator@{ub}@{uu}
  470.     This is just a string of characters that separates each entry.
  471.     @{b}Default:@{ub}    ======================
  472. @endnode
  473. @remark //
  474. @remark // Usage/Settings/Log/Conversion Specifiers
  475. @remark ********************************************************************************************
  476. @node CONVERSION_SPECIFIER "Misc.guide/Usage/Settings/Log/Conversion Specifiers"
  477. @next LOG_SETTINGS
  478. @prev LOG_SETTINGS
  479. These are the Conversion Specifiers you can use with Misc.
  480.         @{b}Conversion
  481.         @{u}Specifier   Replaced with . . .                                 @{uu}@{ub}
  482.            %a       the locale's abbreviated weekday name
  483.            %A       the locale's full weekday name
  484.            %b       the locale's abbreviated month name
  485.            %B       the locale's full month name
  486.            %c       the locale's appropriate date and time representation
  487.            %d       the day of the month as a decimal number (01-31)
  488.            %H       the hour (24-hour clock) as a decimal number (00-23)
  489.            %I       the hour (12-hour clock) as a decimal number (00-12)
  490.            %j       the day of the year as a decimal number (001-366)
  491.            %m       the month as a decimal number (01-12)
  492.            %M       the minute as a decimal number (00-59)
  493.            %p       the locale's equivalent of the AM and PM designations
  494.                     associated with a 12-hour clock
  495.            %S       the second as a decimal number (00-61)
  496.            %U       the week number of the year (the first Sunday as the
  497.                     first day of week 1) as a decimal number (00-53)
  498.            %w       the weekday as a decimal number (0-6),where Sunday is 0
  499.            %W       the week number of the year (the first Monday as the
  500.                     first day of week 1) as a decimal number (00-53)
  501.            %x       the locale's appropriate date representation
  502.            %X       the locale's appropriate time representation
  503.            %y       the year without the century as a decimal number
  504.                     (00-99)
  505.            %Y       the year with the century as a decimal number
  506.            %Z       the time zone name or abbreviation; no characters
  507.                     indicates the time zone is not determinable
  508.            %%       a percent sign.
  509. @endnode
  510. @remark //
  511. @remark // Usage/Settings/Textfield.gadget
  512. @remark ********************************************************************************************
  513. @node TEXTFIELD_SETTINGS "Misc.guide/Usage/Settings/Textfield.gadget"
  514. Since it is not possible to set the looks of the Textfield.gadget via MUI,
  515. we included some configuration abilities on our own. These are:
  516. @{b}===== Cursor =================================================================================@{ub}
  517. @{u}@{b}Block@{ub}@{uu}
  518.     If checked, the cursor will be in "Block"-mode, which means it will
  519.     have the shape of a square that fills the character, rather than a
  520.     vertical line.
  521.     @{b}Default:@{ub} Off
  522. @{u}@{b}Flashing@{ub}@{uu}
  523.     If checked, the cursor will flash.
  524.     @{b}Default:@{ub} Off
  525. @{b}===== Sizes ==================================================================================@{ub}
  526. @{u}@{b}Tab Length@{ub}@{uu}
  527.     Sets the length of a TAB.
  528.     @{b}Default:@{ub} 4
  529. @{u}@{b}Line Spacing@{ub}@{uu}
  530.     Sets the amount of (pixel) lines between each (text) line.
  531.     @{b}Default:@{ub} 0
  532. @{b}==============================================================================================@{ub}
  533. @{u}@{b}Font@{ub}@{uu}
  534.     Sets the font to be used withing the Textfield.gadget. (The Editing
  535.     Area).
  536.     @{b}Default:@{ub} Screen Text
  537. @endnode
  538. @remark //
  539. @remark // Hints & Tips
  540. @remark ********************************************************************************************
  541. @node HINTS "Misc.guide/Hints & Tips"
  542. @next HISTORY
  543. @prev USAGE
  544.     @{fg fill}@{b}  _ _  __ _______
  545.      / V \\/  \\ __> __>
  546.     /  @{fg text}HINTS & TIPS@{fg fill}__
  547.     \\_\\_/_/_/<___/___>@{ub}@{fg text}
  548.     @{b}o@{ub} If you are using MagicMenu, you should run SafeGIRPort, other-
  549.       wise you will encounter problems.
  550.     @{b}o@{ub} "Leave Out" (With the Workbench menu function "Icons/Leave Out")
  551.        the Misc-icon on your WB, this way it's easy to access it and type
  552.        in notes without having to fool around in the drawers.
  553.     @{b}o@{ub} Put Misc in your @{"ToolManager" link OTHERPPLPROGRAMS}, (Or another program that you can
  554.       use for giving other programs hotkeys.) you don't even have to give
  555.       it an Icon, you might just as well only give it a Hotkey, which will
  556.       make it even easier to access Misc.
  557.     @{b}o@{ub} You can access the buttons by using holding down the Right-Amiga-key
  558.       and pressing the underlined character in the button.
  559.     @{b}o@{ub} Instead of writing the entire path to the program when specifying
  560.       note/log files, you can use `PROGDIR:' to signify the path to the
  561.       program. (E.g. `PROGDIR:My_Log.log' as a logfile would use a logfile
  562.       named `My_Log.log' that is in the same path as the executable.)
  563.     @{b}o@{ub} There is no undo function in Misc, so if you screw something
  564.       up when editing notes, (e.g. accidentally delete a page) start a
  565.       shell, and make a backup of your note-file.
  566.     @{b}o@{ub} A nice way to insert an empty line between log entries is to make
  567.       an empty entry-separator in the @{"log settings" link LOG_SETTINGS}.
  568.     @{b}o@{ub} To scroll the Log-file with the cursor-keys, you have to activate
  569.       the gadget, do this by pressing <TAB> repeatedly, until a frame is
  570.       drawn around the slider.
  571.     @{b}o@{ub} If you happen to screw up editing the notes, and it can't be
  572.       un-done with undo, (see @{"Textfield.gadget" link TEXTFIELD} usage) you can restore
  573.       the old notefile with the note-settings. When in note-settings,
  574.       load a new notefile, a requester will now pop-up, asking if you want
  575.       to save the old notefile before proceeding, click on `Discard'.
  576.       Now you can load the old notefile.
  577.     @{b}o@{ub} Check out our homepage at "http://www.abo.fi/~jbeijar/circle.html"!
  578.     @{b}o@{ub} Look out for a game called @{b}@{bg shine}3DTanxX@{bg background}@{ub}!
  579.       Mail @{"us" link CONTACTS} for more info! Or check out our @{"Homepage" link CONTACTS}!
  580.     @{b}o@{ub} Send bugreports and suggestions to @{"us" link CONTACTS}!
  581.     @{b}o@{ub} Get yourself MagicWB!
  582.     @{b}o@{ub} Buy an accelerator, you @{b}won't@{ub} regret it!
  583.     @{b}o@{ub} Support the Amiga!
  584.     @{b}o@{ub} Buy Alien Breed 3D 2, or Alien Breed 3D! They are Doom-
  585.       clones, but good ones!
  586. @endnode
  587. @remark //
  588. @remark // History
  589. @remark ********************************************************************************************
  590. @node HISTORY "Misc.guide/History"
  591. @next BUGS
  592. @prev HINTS
  593.     @{fg fill}@{b}  _ _  __ _______
  594.      / V \\/  \\ __> __>
  595.     /    @{fg text}HISTORY@{fg fill} \\<__
  596.     \\_\\_/_/_/<___/___>@{ub}@{fg text}
  597. v1.11 - 9.7.1996
  598.     @{b}o@{ub} Misc gave Enforcer hits when no font was selected in the
  599.       Textfield.gadget's prefs, it's fixed.
  600. v1.1  - 28.6.1996
  601.     @{b}o@{ub} Total rewrite of note system, much better note handling, also
  602.       featuring note titles.
  603.     @{b}o@{ub} Fixed a bug with textfield.gadget settings. (Some options weren't
  604.       adjustable)
  605.     @{b}o@{ub} Help-bubble removed from textfield.gadget, it was annoying!
  606.     @{b}o@{ub} `Sort notes' implemented
  607.     @{b}o@{ub} ASCII-export implemented
  608.     @{b}o@{ub} `Include File' function implemented in the `Notes' menu
  609.     @{b}o@{ub} Printing abilities.
  610.     @{b}o@{ub} Lots of small additions/fixes, no use to keep v1.0!
  611. v1.0  - 4.12.1995
  612.     @{b}o@{ub} First public release, all features are new.
  613. @endnode
  614. @remark //
  615. @remark // Bugs
  616. @remark ********************************************************************************************
  617. @node BUGS "Misc.guide/Bugs"
  618. @next TODO
  619. @prev HISTORY
  620.     @{fg fill}@{b}  _ _  __ _______
  621.      / V \\/  \\ __> __>
  622.     /      @{fg text}BUGS@{fg fill}_ \\<__
  623.     \\_\\_/_/_/<___/___>@{ub}@{fg text}
  624.     @{b}o@{ub} Popping up MUI-Prefs from the PopUp-gadget in the window-
  625.       border might fail for some, if the pointer is right above the
  626.       Textfield.gadget. If MUI-Prefs won't pop up, try again, and see
  627.       to it that you don't have the pointer above the textfield.gadget.
  628.       This is obviously not a fault of Misc, but of MUI.
  629. @endnode
  630. @remark //
  631. @remark // ToDo
  632. @remark ********************************************************************************************
  633. @node TODO "Misc.guide/ToDo"
  634. @next CONTACT
  635. @prev BUGS
  636.     @{fg fill}@{b}  _ _  __ _______
  637.      / V \\/  \\ __> __>
  638.     /      @{fg text}TODO@{fg fill}_ \\<__
  639.     \\_\\_/_/_/<___/___>@{ub}@{fg text}
  640. Things we have thought of for future versions of Misc.
  641.     @{b}o@{ub} Calendar functions. I don't know what they are, I'm just a
  642.       docwriter! ;) It will be a surprise! (I think no-one really knows
  643.       what those features are, but they are still kewl!)
  644.     @{b}o@{ub} Find-function.
  645.     @{b}o@{ub} You make 'em up and send them to @{"us" link CONTACTS}!
  646. @endnode
  647. @remark //
  648. @remark // Contacts
  649. @remark ********************************************************************************************
  650. @node CONTACTS "Misc.guide/Contacts"
  651. @next OUTRO
  652. @prev TODO
  653.     @{fg fill}@{b}  _ _  __ _______
  654.      / V \\/  \\ __> __>
  655.     /    @{fg text}CONTACTS@{fg fill}\\<__
  656.     \\_\\_/_/_/<___/___>@{ub}@{fg text}
  657. Mail bugreports, suggestions and other stuff to Dag "Dag" 
  658. gren at:
  659.         E-mail:
  660.           dagren@walli.uwasa.fi
  661.           (This address is soon about to change, to something like
  662.           dagren@abo.fi )
  663.         Snail-mail:
  664.           Dag 
  665.           V
  666. sterbacksv
  667. gen 37
  668.           FIN-66200 Korsn
  669.           (Europe)
  670. And if nothing happens, try contacting Markus "Manne" Mannevaara at:
  671.         mamannev@bilbo.abo.fi
  672. And don't forget to check out our homepage at:
  673.         http://www.abo.fi/~jbeijar/circle.html
  674. @endnode
  675. @remark //
  676. @remark // Da End
  677. @remark ********************************************************************************************
  678. @node OUTRO "That's the End... Seee ya!"
  679. @prev HINTS
  680.     @{fg fill}@{b}  _ _  __ _______
  681.      / V \\/  \\ __> __>
  682.     /    @{fg text}GOODBYE@{fg fill} \\<__
  683.     \\_\\_/_/_/<___/___>@{ub}@{fg text}
  684. Before we quit. We would like to do some greetings and credits & stuff.
  685. We would like to greet (and thank):
  686.         @{b}o@{ub} VISCorp and Amiga Technologies, hope they can achieve some-
  687.                   thing else than just selling it again!
  688.         @{b}o@{ub} Stefan Stuntz for MUI
  689.         @{b}o@{ub} Mark Thomas for Textfield.gadget
  690.         @{b}o@{ub} Martin Huttenloher for MagicWB.
  691.         @{b}o@{ub} Tom Oszczepalski & Paul Henrik for SmallBench.
  692.         @{b}o@{ub} To all the users of Pandora (BBS), the Kingdom of Peik
  693.           Il Sung.
  694.         @{b}o@{ub} The Farm, for the absolutely @{b}superb@{ub} game Roketz!
  695.         @{b}o@{ub} Pasi Ristioja for DreamTerm
  696.         @{b}o@{ub} Sami Takala , who was SysOp for Cowhouse BBS.
  697.         @{b}o@{ub} Juliet & Case for perhaps the best demos ever!
  698.         @{b}o@{ub} Rolf Smeds & Thomas Byholm for being dedicated members
  699.           of Circle.
  700.         @{b}o@{ub} All the people on channel #Amiga and all Amiga-users.
  701.         @{b}o@{ub} Everyone we forgot, for everything we forgot!
  702. People we like to greet just for being who they are:
  703.         @{b}o@{ub} Staffan Nystr
  704.         @{b}o@{ub} Disa H
  705.         @{b}o@{ub} Mikael J
  706. nisoja
  707.         @{b}o@{ub} Ulrica 
  708. sterblad
  709.         @{b}o@{ub} Andreas 
  710. Yes, that's it for today. See you next time.
  711. @endnode
  712. @remark //
  713. @remark // OtherPPLPrograms
  714. @remark ********************************************************************************************
  715. @node OTHERPPLPROGRAMS "Misc.guide/Other People's Programs"
  716. @next OTHERPPLPROGRAMS
  717. @prev OTHERPPLPROGRAMS
  718. Textfield.gadget is copyright  
  719.  1995 Mark Thomas (mthomas@zilker.net)
  720. It can be found on AmiNet in `dev/gui/textfield.lha'.
  721. @{u}                                                                                              @{uu}
  722. MUI is copyright  
  723.  1992-1995 Stefan Stuntz (stuntz@informatik.tu-muenchen.de)
  724. It can be found on AmiNet in `dev/gui/MUIXXUSR.lha'. (XX stands for two
  725. numbers, which stand for the version.)
  726. See @{"ReadMe.mui" link ReadMe.mui/Main} for more information on MUI. (This is only
  727. accessible if ReadMe.mui is in the same directory.)
  728. @{u}                                                                                              @{uu}
  729. ToolManager is copyright  
  730. 1990-93 Stefan Becker (?@?)
  731. It can be found on AmiNet in `util/boot/ToolManagerXXY.lha'. (Where XX
  732. stands for two numbers, the version (21 is the latest until now), and
  733. Y stands for either g (graphics), s (sources) or b (binaries).)
  734. @{u}                                                                                              @{uu}
  735. MagicWB is copyright  
  736. ???? Martin Huttenloher (xen@magic.in-ulm.de)
  737. We don't know where it can be found on AmiNet, we don't even know if it
  738. can be found on AmiNet.
  739. @{u}                                                                                              @{uu}
  740. SmallBench is copyright  
  741. ???? Tom Oszczepalski & Paul Henrik
  742. It can be found on AmiNet in `pix/mwb/SmallBenchXX.lha'. (Where XX
  743. stands for the version. (11 is the latest when releasing Misc.)).
  744. @endnode
  745. @remark //
  746. @remark // Other Products
  747. @remark ********************************************************************************************
  748. @node PRODUCTS "Misc.guide/Other Products"
  749. @prev CIRCLESOFT
  750. @{b}3DTanxX@{ub}
  751.     3DTanxX is the basic artillery-duel type game, with a whole new
  752.     dimension of fun! To all of you who haven't played an artillery-duel
  753.     type game, here is the idea: You are assigned a tank, armed with a wide
  754.     range of more or less devastating weapons. Your tank is placed at an
  755.     apparently random location in a world with several other tanks, all
  756.     enemies. Now - by aiming, adjusting power, and selecting a good fatal
  757.     weapon - you try and hit your enemy. The last one alive is the winner.
  758.     Screenshots available at our homepage:
  759.     (http://www.abo.fi/~mamannev/3DTanxX.html)
  760. @{u}                                                                                      @{uu}
  761. @{b}Maggot@{ub}
  762.     In Maggot you are in control of a Maggot (or Worm, or whatever). Your
  763.     location is a field (A window actually, but anyway.), with food popping
  764.     up here and there, your task is to eat it. Your obstacle is everything
  765.     else but the food, and eating it will kill your worm. So you have to
  766.     control your worm so that it doesn't eat anything else than food.
  767.     (Worms are stupid, and can't judge for themselves whether to eat
  768.     something or not.) Yes, it's the classic worm game, but there is
  769.     something new with it, it has got free steering. (A'la Pizzaworm
  770.     on PC and the little known SuperWorm on Amiga.) No more
  771.     up-down-left-right steering, you can freely move your worm in any
  772.     direction you like. Beta available on our homepage:
  773.     (http://www.abo.fi/~mamannev/Maggot.html)
  774. @{u}                                                                                      @{uu}
  775. @{b}WBCLI@{ub}
  776.     WBCLI is our idea of a better execute-command function. It's a one-line
  777.     shell, that is always open in a window on your WB. It's designed to be
  778.     small, so that it won't be in the way for anything else, like a normal
  779.     shell would be. It opens an output window if needed, exactly like
  780.     execute-command. Useful for doing short tasks like displaying a
  781.     directory listing, without having to start a shell. Alpha/Beta
  782.     available on our homepage: (http://www.abo.fi/~mamannev/WBCLI.html)
  783. @{u}                                                                                      @{uu}
  784. @{b}LED@{ub}
  785.     LED stands for LittleED, and it's exactly what the name refers to, A
  786.     little editor. It uses textfield.gadget, which guarantees excellent
  787.     editing functions (even if they are a bit slow). It has a nice
  788.     buttonbar, with user-definable images. Ah, well, what can you really
  789.     say about an editor? It's a basic editor, made nice and easy to use.
  790.     Beta/Full version available on our homepage:
  791.     (http://www.abo.fi/~mamannev/LED.html)
  792. More information available on our homepage:
  793.     http://www.abo.fi/~jbeijar/circle.html
  794. @endnode
  795. @remark //
  796. @remark // CircleSoft
  797. @remark ********************************************************************************************
  798. @node CIRCLESOFT "We! The People!"
  799. @next PRODUCTS
  800. @prev CONTACTS
  801. CircleSoft... What can you say? We are a group of Amiga-fanatics, who have
  802. decided to do something about their situation. We live in Finland, it's a
  803. country, faaar up north... It's the place where you can see Ice-bears
  804. walking on the streets. NOT! No really, if you don't know where finland
  805. is, buy a map. Or watch the .guide icon very closely.. ;)
  806.   For the moment we consist of five (5) persons, who are, in
  807. alphabetical order of their nicks: Andreas (Anden) Blomqvist, Dag (Dag)
  808. gren, Joakim (Jocke) Beijar, Markus (Manne (me!)) Mannevaara, and Vilgot
  809. (Vigge) Str
  810. msholm. Some of us have known some of the other of us for long,
  811. but the great unity happened in a local BBS called Pandora, in a
  812. private message area called Circle. Thereof the name; CircleSoft.
  813.   But that's not what you want to know, right? We have some more or less
  814. interesting projects going on, you can read more about them in
  815. @{"Other Products" link PRODUCTS}, and even more on our @{"homepage" link CONTACTS}. We are trying to be very
  816. quality aware (that's why we use the Amiga!) when making our software, so
  817. if you have anything to comment, please, do so! We are also trying to keep
  818. our software very cheap, if not free. No-one wants to pay huge amounts of
  819. money for small programs. We know that, we even respect that...
  820.   We haven't released much yet, (Misc v1.0 was our first release.) but we
  821. are trying to get more stuff out on the market as soon as this one is out.
  822. The projects that are most likely to come out in the near future are the
  823. ones listed in Other Products. But believe us, we have some nifty ideas
  824. hidden somewhere.
  825. Our homepage is seriously delayed, as most other WWW-pages are...
  826. See @{"Contact" link CONTACTS} for more info on how to contact us.
  827. @endnode
  828. @remark //
  829.