home *** CD-ROM | disk | FTP | other *** search
/ Amiga Computing 66 / ac066a.adf / StickIt.doc / StickIt.doc
Text File  |  1993-08-30  |  12KB  |  346 lines
  1. StickIt - Version 1.01 (written 12th April '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.01.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. Recently NoteIt! written by Ryan J. Bruner has appeared which has 
  63. prompted me to actually finish the documentation and release StickIt.
  64.  
  65. How Do I Use StickIt ?
  66. ~~~~~~~~~~~~~~~~~~~~~~
  67.     Just double-click on the icon!
  68.  
  69.     The program will always needs a note file to run, and by default 
  70. this is called "StickIt.notes" and is located in the current 
  71. directory. Use the tooltypes in the program icon to configure the 
  72. program for your use.
  73.  
  74. Theory of Operation
  75. ~~~~~~~~~~~~~~~~~~~
  76.     StickIt has 2 modes of operation. EITHER it is showing the notes 
  77. on the screen OR it is showing the edit window to allow the user to 
  78. alter the information kept in the notes.
  79.  
  80. Showing the Notes
  81. -----------------
  82.     When the notes are being displayed, the user may position each 
  83. note by dragging the note with the drag bar. The position of the note 
  84. will be stored when the note file is saved.
  85.  
  86.     A note can be temporarily hidden from view by double-clicking on 
  87. the note (not on the drag bar). The note will remain hidden for the 
  88. current session, unless the user makes the note visable again by using 
  89. "Show" in the edit window (see later). This information is not saved, 
  90. as all notes are shown when StickIt is run.
  91.  
  92.     The edit window can be brought up to edit the notes by clicking 
  93. with the right mouse button on the active note. This note will be the 
  94. current note in the edit window.
  95.  
  96.     All actions to do with the saving of the note file, quitting of 
  97. the program, adding and deleting notes must be done from the edit 
  98. window.
  99.  
  100. The Edit Window
  101. ---------------
  102.     The window is brought up by clicking with the right mouse button 
  103. on the active note. It is also brought up if an attempt is made to 
  104. make all the current notes hidden, or the StickIt is run with the 
  105. STARTEDIT=YES tooltype, or there are no notes in the note file.
  106.  
  107.     Adding a new note:
  108.  
  109.     This is done by clicking on the "Add" gadget or pressing "a". The 
  110. "Note " and "Title" fields are cleared and your cursor is placed in 
  111. the "Title" field. The "Title" field contains the text that will 
  112. appear in the note's drag bar. Pressing <TAB> will move your cursor to 
  113. the "Note" field. Here you can type the main text that will appear in 
  114. the body of the note. Pressing <TAB> will move your cursor back to the 
  115. "Title" field.
  116.  
  117.     When you are happy with the text, click on the "Add" gadget again 
  118. and the note will be added to the list. The new note will be added to 
  119. the front of the list and will be drawn last, and so will be infront 
  120. if any notes overlap it.
  121.  
  122.     Deleting the current note:
  123.  
  124.     The current note is that one which is currently on display in the 
  125. edit window. Selecting "Delete" from the "Edit" menu (keyboard 
  126. shortcut = RIGHT AMIGA + B) will remove this note from the list.
  127.  
  128.     Cut, copy, paste:
  129.  
  130.     You may cut (keyboard shortcut = RIGHT AMIGA + X), copy (keyboard 
  131. shortcut = RIGHT AMIGA + C) and paste (keyboard shortcut = RIGHT AMIGA 
  132. + V) notes using the "Edit" menu. This is useful to re-arrange the 
  133. order in which notes are drawn or create multiple similar notes from 
  134. one existing note. StickIt uses its own internal clipboard, not the 
  135. Amiga's. You can't cut/copy/paste information between applications 
  136. (sorry!).
  137.  
  138.     Editing the current note:
  139.  
  140.     To change the information in the current note, simply alter the 
  141. text in the "Title" and "Note" text fields. Instead of just clicking 
  142. in the text gadgets, keyboard shortcuts "t" and "n" have been 
  143. provided.
  144.  
  145.     Hiding the current note:
  146.  
  147.     All notes by default are visable when StickIt is run. By clicking 
  148. on the "Show" gadget (keyboard shortcut = "s"), the note can be hidden 
  149. from view - useful to stop notes that you've acknowledged from 
  150. cluttering up your screen.
  151.  
  152.     Changing the current note:
  153.  
  154.     The current note can be changed by using the back and forth 
  155. gadgets at the bottom of the edit window (keyboard shortcuts = "<" or 
  156. "," and ">" or "."). The front and back of the list can also be 
  157. reached with the "Front" and "Back" gadgets (keyboard shortcuts = "f" 
  158. and "b").
  159.  
  160.     Showing all notes:
  161.  
  162.     You can see the effects of your edits by selecting "Show 
  163. notes..." (keyboard shortcut = RIGHT AMIGA + N) from the "Edit" 
  164. window. Return to the edit window by clicking right mouse button on an 
  165. active note.
  166.  
  167.     Saving the current note file:
  168.  
  169.     Choose "Save" (keyboard shortcut = RIGHT AMIGA + S) from the 
  170. "Project" menu to save the current notes to the note file.
  171.  
  172.     Opening the current note file:
  173.  
  174.     Choose "Open" (keyboard shortcut = RIGHT AMIGA + O) from the 
  175. "Project" menu to open the current note file, replacing the current 
  176. notes with those of the note file. You will be warned if the current 
  177. notes have been changed.
  178.  
  179. Other menu items...
  180. -------------------
  181.     About
  182.  
  183.      Cute about window. Click on the window to make it go away.
  184.  
  185.     Quit
  186.  
  187.     Will quit the program. Will warn you if the notes have been 
  188. changed.
  189.  
  190.  
  191. Configuring StickIt
  192. ~~~~~~~~~~~~~~~~~~~
  193.     StickIt is entirely configured from the icon's tooltypes. Any 
  194. tooltype enclosed in parenthesis is commented out, causing the default 
  195. value to be used.
  196.  
  197. NOTEFILE=<filename>        Default:StickIt.notes
  198.  
  199.     This gives the filename of the file that will used to store the 
  200. note information. The default file is "StickIt.notes" in the current 
  201. directory. Other possibilities could be:
  202.  
  203.     NOTEFILE=s:StickIt.notes
  204.     NOTEFILE=ENVARC:StickIt.notes
  205.  
  206. FONTNAME=<fontname>.font        Default:Helvetica
  207.  
  208.     This is the name of the font used to write the text in the notes. 
  209. If no font name is given, StickIt tries to open Times font. Failing 
  210. that, the default screen font is used. My personal favourite font is 
  211. "junod" given away with Commodore's "AmigaGuide" distribution (if you 
  212. don't have AmigaGuide - WHY NOT!?!). Failing that, a nice handwriting 
  213. font may look good, anyway I digress...
  214.  
  215. Note: You must always put a ".font" postfix after the name of the 
  216. font, otherwise StickIt will not find the font (eg `Times.font' or 
  217. `junod.font').
  218.  
  219. FONTSIZE=<number>        Default:12
  220.  
  221.     This is the size in points of the font.
  222.  
  223. NOTEHEIGHT=<number>        Default:70
  224.  
  225.     The height of each note in pixels.
  226.  
  227. NOTEWIDTH=<number>        Default:150
  228.  
  229.     The width of each note in pixels.
  230.  
  231. TEXTCOLOUR=<number>        Default:1 (Black)
  232.  
  233.     The number of the colour of the pen used to print the main text 
  234. of the note. Note the English spelling of "colour".
  235.  
  236. BACKCOLOUR=<number>        Default:0 (Grey)
  237.  
  238.     The number of the colour of the pen used as the background of the 
  239. note. Users with >4 colours may wish to make this value that of a 
  240. pastel yellow, to give the "look and feel" of a real PostIt note. Note 
  241. the English spelling of "colour".
  242.  
  243. DELAY=<number>            Default:0
  244.  
  245.     This is a delay in seconds before the note file is loaded. This 
  246. is useful if StickIt is placed in the WBStartup drawer with other 
  247. applications loaded at startup. If this value is set to a few seconds, 
  248. then StickIt will not be competing for the drive at the same time as 
  249. Workbench is loading applictions.
  250.  
  251. STARTEDIT=<YES> or <NO>        Default:NO
  252.  
  253.     Normally StickIt will start by displaying all notes present in 
  254. the note file. If no notes are present, the edit window is opened 
  255. instead. By setting STARTEDIT to YES, you can force StickIt to open 
  256. the edit window even if there notes in the notefile.
  257.  
  258. DONOTWAIT
  259.  
  260.     Standard WBStartup command to tell Workbench not to wait for 
  261. StickIt to finish executing before continuing with the startup.
  262.  
  263. Creating An Empty Note File
  264. ~~~~~~~~~~~~~~~~~~~~~~~~~~~
  265.  
  266.     StickIt requires a note file to operate; StickIt will terminate 
  267. with an error if the note file can't be found. In order to create a 
  268. blank file, I have provided an ARexx utility to do this. If you wish 
  269. to create a blank file called "s:StickIt.note" then simply 
  270. double-click on the "CreateEmptyFile.rexx" icon and type 
  271. "s:StickIt.note" as the filename. Then change the tooltypes of StickIt 
  272. to read "NOTEFILE=s:StickIt.notes".
  273.  
  274.     Note that you need ARexx running for this to work.
  275.  
  276. Thanks...
  277. ~~~~~~~~~
  278.  
  279.     o Commodore for the Amiga. More programming utilities and 
  280. information is needed from C=. AmigaGuide and the ROM Kernal Reference 
  281. manuals are a start, but can we also have a window designer, the 3.0 
  282. includes and information about new system routines. Wishful thinking?
  283.     o Fred Fish for his EXCELLENT library, I just hope that he can 
  284. continue to get the support in order to run the library.
  285.     o The organisers of Aminet. Thanks for a well organised service 
  286. for us lucky souls with anonymous ftp access.
  287.     o All the shareware / public domain / freeware authors for tons 
  288. of excellent software.
  289.  
  290. Tested On...
  291. ~~~~~~~~~~~~
  292.  
  293.     StickIt has been tested on:
  294.  
  295.     o Amiga 500 with
  296.         1M Chip RAM
  297.         2M Fast RAM
  298.         Workbench 2.04
  299.         Commodore A590 hard drive, 85M Connor SCSI drive
  300.         Microbotics VXL30 accellerator
  301.  
  302.     o Amiga 1200 with
  303.         2M Chip RAM
  304.         60M internal hard drive
  305.         External floppy
  306.  
  307.  
  308. Limitations
  309. ~~~~~~~~~~~
  310.     o    All data is stored in a linked list and so there is no limit 
  311. to the number of notes available for use.
  312.     o    29 characters can be used in the `Title' field.
  313.     o    255 characters can be used in the `Note' field.
  314.  
  315. Improvements
  316. ~~~~~~~~~~~~
  317.     I have no real intention to continue improving the program, I 
  318. have been using the program myself for over 2 months now and can find 
  319. no bugs in it and it does the job for which it was intended. Besides, 
  320. inbetween writing StickIt I have a PhD to be getting on with :) , 
  321. HOWEVER if you do find a nasty bug then let me know and I'll do my 
  322. best...
  323.  
  324. My Address...
  325. ~~~~~~~~~~~~~
  326.  
  327.     Andy Dean
  328.     Electronic Engineering Dept.
  329.     University College London
  330.     Torrington Place
  331.     London
  332.     WC1E 7JE
  333.     England
  334.  
  335.     Email: adean@uk.ac.ucl.eleceng
  336.  
  337. And finally...
  338. ~~~~~~~~~~~~~~
  339.  
  340.     If you use and enjoy this software then send me a postcard to 
  341. tell me how far StickIt has reached. Go on, it'll only take a few 
  342. minutes...
  343.  
  344.  
  345.     Ta very much,    Andy Dean
  346.