home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 2 / FFMCD02.bin / new / os20 / util / stickit / stickit.doc < prev    next >
Encoding:
Text File  |  1993-12-21  |  12.2 KB  |  350 lines
  1. StickIt - Version 1.03 (written 15th November '93)
  2. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  3. Copyright 1993 Andy Dean, all rights reserved
  4. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  5.    Permission is granted to make and distribute verbatim copies of 
  6. this manual provided the copyright notice and this permission notice 
  7. are preserved on all copies.
  8.  
  9.    No guarantee of any kind is given that the programs described in 
  10. this document are 100% reliable. You are using this material at your 
  11. own risk. The author *can not* be made responsible for any damage 
  12. which is caused by using these programs.
  13.  
  14.    This package is freely distributable, but still copyright by Andy 
  15. Dean. This means that you can copy it freely as long as you don't ask 
  16. for a more than nominal copying fee.
  17.  
  18.    Permission is granted to include this package in Public-Domain 
  19. collections, especially in the excellent Fred Fish Amiga Disk Library 
  20. (including CD ROM versions of it). The distribution file may be 
  21. uploaded to Bulletin Board Systems or FTP servers. If you want to 
  22. distribute this program you must use the original distribution archive 
  23. "StickIt-1.03.lha".
  24.  
  25.    None of the programs nor the source code (nor parts of it) may be
  26. included or used in commercial programs unless by written permission
  27. from the author.
  28.  
  29. Requirements
  30. ~~~~~~~~~~~~
  31.     o    AmigaDos 2.04+
  32.  
  33. What Is StickIt ?
  34. ~~~~~~~~~~~~~~~~~
  35.     StickIt is a computer replacement for the ol' Post-It note. It 
  36. allows you to stick notes onto your screen which will be displayed 
  37. every time you re-boot; useful to remind you of things to do.
  38.  
  39. Features
  40. ~~~~~~~~
  41.     o    Unlimited number of notes on screen.
  42.     o    The notes remember where you left them.
  43.     o    User-defined font name/size.
  44.     o    User-defined note size.
  45.     o    User-defined text/background colour (yep, they can be yellow
  46.         if you want !)
  47.     o    User-defined delay at startup to avoid disk thrashing.
  48.     o    User-defined filename for note information.
  49.     o    Standard Workbench 2 interface, with keyboard shortcuts. 
  50.         Designed with the wonderful "GadToolsBox" by Jan van den
  51.          Baard.
  52.  
  53.  
  54. Why Did I Write StickIt ?
  55. ~~~~~~~~~~~~~~~~~~~~~~~~~
  56.     StickIt was written with a job to do... to replace all the bits 
  57. of paper I used to leave around to remind me to do something. I have 
  58. tried to write a program to do that with the minimum of fuss and with 
  59. a nice clean Workbench 2 interface. I have tried to make the program 
  60. configurable enough for each user's needs, without over-doing it. 
  61. There was no such utility available in the Public Domain at the time. 
  62.  
  63. How Do I Use StickIt ?
  64. ~~~~~~~~~~~~~~~~~~~~~~
  65.     Just double-click on the icon!
  66.  
  67.     The program will always needs a note file to run, and by default 
  68. this is called "StickIt.notes" and is located in the current 
  69. directory. Use the tooltypes in the program icon to configure the 
  70. program for your use.
  71.  
  72. Theory of Operation
  73. ~~~~~~~~~~~~~~~~~~~
  74.     StickIt has 2 modes of operation. EITHER it is showing the notes 
  75. on the screen OR it is showing the edit window to allow the user to 
  76. alter the information kept in the notes.
  77.  
  78. Showing the Notes
  79. -----------------
  80.     When the notes are being displayed, the user may position each 
  81. note by dragging the note with the drag bar. The position of the note 
  82. will be stored when the note file is saved.
  83.  
  84.     A note can be temporarily hidden from view by double-clicking on 
  85. the note (not on the drag bar) or typing "h" while the note is active.
  86. The note will remain hidden for the current session, unless the user
  87. makes the note visable again by using "Show" in the edit window (see
  88. later). This information is not saved, as all notes are shown when
  89. StickIt is run.
  90.  
  91.     The edit window can be brought up to edit the notes by clicking 
  92. with the right mouse button or typing "e" on the active note. This note
  93. will be the current note in the edit window.
  94.  
  95.     The current note can be pushed behind other windows by either
  96. using the depth gadget, or typing "b". The current note can be
  97. brought infront of other windows by either using the depth gadget,
  98. or typing "f".
  99.  
  100.     All actions to do with the saving of the note file, quitting of 
  101. the program, adding and deleting notes must be done from the edit 
  102. window.
  103.  
  104. The Edit Window
  105. ---------------
  106.     The window is brought up by clicking with the right mouse button 
  107. on the active note. It is also brought up if an attempt is made to 
  108. make all the current notes hidden, or the StickIt is run with the 
  109. STARTEDIT=YES tooltype, or there are no notes in the note file.
  110.  
  111.     Adding a new note:
  112.  
  113.     This is done by clicking on the "Add" gadget or pressing "a". The 
  114. "Note " and "Title" fields are cleared and your cursor is placed in 
  115. the "Title" field. The "Title" field contains the text that will 
  116. appear in the note's drag bar. Pressing <TAB> will move your cursor to 
  117. the "Note" field. Here you can type the main text that will appear in 
  118. the body of the note. Pressing <TAB> will move your cursor back to the 
  119. "Title" field. As with version 1.02, <RETURN> will also cycle between the
  120. "Note" and "Title" fields.
  121.  
  122.     When you are happy with the text, click on the "Add" gadget again 
  123. and the note will be added to the list. The new note will be added to 
  124. the front of the list and will be drawn last, and so will be infront 
  125. if any notes overlap it.
  126.  
  127.     Deleting the current note:
  128.  
  129.     The current note is that one which is currently on display in the 
  130. edit window. Selecting "Delete" from the "Edit" menu (keyboard 
  131. shortcut = RIGHT AMIGA + B) will remove this note from the list.
  132.  
  133.     Cut, copy, paste:
  134.  
  135.     You may cut (keyboard shortcut = RIGHT AMIGA + X), copy (keyboard 
  136. shortcut = RIGHT AMIGA + C) and paste (keyboard shortcut = RIGHT AMIGA 
  137. + V) notes using the "Edit" menu. This is useful to re-arrange the 
  138. order in which notes are drawn or create multiple similar notes from 
  139. one existing note. StickIt uses its own internal clipboard, not the 
  140. Amiga's. You can't cut/copy/paste information between applications 
  141. (sorry!).
  142.  
  143.     Editing the current note:
  144.  
  145.     To change the information in the current note, simply alter the 
  146. text in the "Title" and "Note" text fields. Instead of just clicking 
  147. in the text gadgets, keyboard shortcuts "t" and "n" have been 
  148. provided.
  149.  
  150.     Hiding the current note:
  151.  
  152.     All notes by default are visable when StickIt is run. By clicking 
  153. on the "Show" gadget (keyboard shortcut = "s"), the note can be hidden 
  154. from view - useful to stop notes that you've acknowledged from 
  155. cluttering up your screen.
  156.  
  157.     Changing the current note:
  158.  
  159.     The current note can be changed by using the back and forth 
  160. gadgets at the bottom of the edit window (keyboard shortcuts = "<" or 
  161. "," and ">" or "."). The front and back of the list can also be 
  162. reached with the "Front" and "Back" gadgets (keyboard shortcuts = "f" 
  163. and "b").
  164.  
  165.     Showing all notes:
  166.  
  167.     You can see the effects of your edits by selecting "Show 
  168. notes..." (keyboard shortcut = RIGHT AMIGA + N) from the "Edit" 
  169. window. Return to the edit window by clicking right mouse button on an 
  170. active note. Alternatively press click on the "Notes..." gadget in the edit window.
  171.  
  172.     Saving the current note file:
  173.  
  174.     Choose "Save" (keyboard shortcut = RIGHT AMIGA + S) from the 
  175. "Project" menu to save the current notes to the note file.
  176.  
  177.     Opening the current note file:
  178.  
  179.     Choose "Open" (keyboard shortcut = RIGHT AMIGA + O) from the 
  180. "Project" menu to open the current note file, replacing the current 
  181. notes with those of the note file. You will be warned if the current 
  182. notes have been changed.
  183.  
  184. Other menu items...
  185. -------------------
  186.     About
  187.  
  188.      Cute about window. Click on the window to make it go away.
  189.  
  190.     Quit
  191.  
  192.     Will quit the program. Will warn you if the notes have been 
  193. changed.
  194.  
  195.  
  196. Configuring StickIt
  197. ~~~~~~~~~~~~~~~~~~~
  198.     StickIt is entirely configured from the icon's tooltypes. Any 
  199. tooltype enclosed in parenthesis is commented out, causing the default 
  200. value to be used.
  201.  
  202. NOTEFILE=<filename>        Default:StickIt.notes
  203.  
  204.     This gives the filename of the file that will used to store the 
  205. note information. The default file is "StickIt.notes" in the current 
  206. directory. Other possibilities could be:
  207.  
  208.     NOTEFILE=s:StickIt.notes
  209.     NOTEFILE=ENVARC:StickIt.notes
  210.  
  211. FONTNAME=<fontname>.font        Default:Helvetica
  212.  
  213.     This is the name of the font used to write the text in the notes. 
  214. If no font name is given, StickIt tries to open Times font. Failing 
  215. that, the default screen font is used. My personal favourite font is 
  216. "junod" given away with Commodore's "AmigaGuide" distribution (if you 
  217. don't have AmigaGuide - WHY NOT!?!). Failing that, a nice handwriting 
  218. font may look good, anyway I digress...
  219.  
  220. Note: You must always put a ".font" postfix after the name of the 
  221. font, otherwise StickIt will not find the font (eg `Times.font' or 
  222. `junod.font').
  223.  
  224. FONTSIZE=<number>        Default:12
  225.  
  226.     This is the size in points of the font.
  227.  
  228. NOTEHEIGHT=<number>        Default:70
  229.  
  230.     The height of each note in pixels.
  231.  
  232. NOTEWIDTH=<number>        Default:150
  233.  
  234.     The width of each note in pixels.
  235.  
  236. TEXTCOLOUR=<number>        Default:1 (Black)
  237.  
  238.     The number of the colour of the pen used to print the main text 
  239. of the note. Note the English spelling of "colour".
  240.  
  241. BACKCOLOUR=<number>        Default:0 (Grey)
  242.  
  243.     The number of the colour of the pen used as the background of the 
  244. note. Users with >4 colours may wish to make this value that of a 
  245. pastel yellow, to give the "look and feel" of a real PostIt note. Note 
  246. the English spelling of "colour".
  247.  
  248. DELAY=<number>            Default:0
  249.  
  250.     This is a delay in seconds before the note file is loaded. This 
  251. is useful if StickIt is placed in the WBStartup drawer with other 
  252. applications loaded at startup. If this value is set to a few seconds, 
  253. then StickIt will not be competing for the drive at the same time as 
  254. Workbench is loading applictions.
  255.  
  256. STARTEDIT=<YES> or <NO>        Default:NO
  257.  
  258.     Normally StickIt will start by displaying all notes present in 
  259. the note file. If no notes are present, the edit window is opened 
  260. instead. By setting STARTEDIT to YES, you can force StickIt to open 
  261. the edit window even if there notes in the notefile.
  262.  
  263. DONOTWAIT
  264.  
  265.     Standard WBStartup command to tell Workbench not to wait for 
  266. StickIt to finish executing before continuing with the startup.
  267.  
  268. Creating An Empty Note File
  269. ~~~~~~~~~~~~~~~~~~~~~~~~~~~
  270.  
  271.     StickIt requires a note file to operate; StickIt will terminate 
  272. with an error if the note file can't be found. In order to create a 
  273. blank file, I have provided an ARexx utility to do this. If you wish 
  274. to create a blank file called "s:StickIt.note" then simply 
  275. double-click on the "CreateEmptyFile.rexx" icon and type 
  276. "s:StickIt.note" as the filename. Then change the tooltypes of StickIt 
  277. to read "NOTEFILE=s:StickIt.notes".
  278.  
  279.     Note that you need ARexx running for this to work.
  280.  
  281. Thanks...
  282. ~~~~~~~~~
  283.  
  284.     o Commodore for the Amiga. More programming utilities and 
  285. information are needed from C=. AmigaGuide and the ROM Kernal Reference 
  286. manuals are a start, but can we also have a window designer, the 3.0 
  287. includes and information about new system routines. Wishful thinking?
  288.     o Fred Fish for his EXCELLENT library.
  289.     o The organisers of Aminet. Thanks for a well organised service 
  290. for us lucky souls with anonymous ftp access.
  291.     o All the shareware / public domain / freeware authors for tons 
  292. of excellent software.
  293.  
  294. Tested On...
  295. ~~~~~~~~~~~~
  296.  
  297.     StickIt has been tested on:
  298.  
  299.     o Amiga 500 with
  300.         1M Chip RAM
  301.         2M Fast RAM
  302.         Workbench 2.04
  303.         Commodore A590 hard drive, 85M Connor SCSI drive
  304.         Microbotics VXL30 accellerator
  305.  
  306.     o Amiga 1200 with
  307.         2M Chip RAM
  308.         60M internal hard drive
  309.         External floppy
  310.  
  311.  
  312. Limitations
  313. ~~~~~~~~~~~
  314.     o    All data is stored in a linked list and so there is no limit 
  315. to the number of notes available for use.
  316.     o    29 characters can be used in the `Title' field.
  317.     o    255 characters can be used in the `Note' field.
  318.  
  319. Improvements
  320. ~~~~~~~~~~~~
  321.     I have no real intention to continue improving the program, I 
  322. have been using the program myself for a while now and can find 
  323. no bugs in it and it does the job for which it was intended. Besides, 
  324. inbetween writing StickIt I have a PhD to be getting on with :) , 
  325. HOWEVER if you do find a nasty bug then let me know and I'll do my 
  326. best...
  327.  
  328. My Address...
  329. ~~~~~~~~~~~~~
  330.  
  331.     Andy Dean
  332.     Electronic Engineering Dept.
  333.     University College London
  334.     Torrington Place
  335.     London
  336.     WC1E 7JE
  337.     England
  338.  
  339.     Email: adean@eleceng.ucl.ac.uk
  340.  
  341. And finally...
  342. ~~~~~~~~~~~~~~
  343.  
  344.     If you use and enjoy this software then send me a postcard to 
  345. tell me how far StickIt has reached. Go on, it'll only take a few 
  346. minutes...
  347.  
  348.  
  349.     Ta very much,    Andy Dean
  350.