home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: InfoMgt / InfoMgt.zip / pmn132.zip / pmndoc.INF (.txt) < prev    next >
OS/2 Help File  |  1998-07-13  |  32KB  |  491 lines

  1.  
  2. ΓòÉΓòÉΓòÉ 1. Introduction ΓòÉΓòÉΓòÉ
  3.  
  4.  
  5.                                   Version 1.32
  6.  
  7.                     Copyright (C) 1997-1998 by Jeffrey Habets
  8.  
  9. For a long time I've been using the paper PostIt notes to help me remind me of 
  10. important things that I didn't want to forget. Problem with these notes was 
  11. that they didn't stick very well to the edge of my monitor. 
  12.  
  13. So I searched for an electronic equivalent of the sticky notes. I tried several 
  14. programs, but they all had either way to much functionality I did not need, or 
  15. they were to simple to be paying a lot of money for. So I decided to write my 
  16. own. PmNotes is the result of this effort, I hope you like it. 
  17.  
  18.  
  19. ΓòÉΓòÉΓòÉ 2. The main window ΓòÉΓòÉΓòÉ
  20.  
  21. Main window menu options 
  22.  
  23. All functions callable from the main window are accessed through te popup menu. 
  24. Apart from calling the menu by clicking MB2 on the main window, you can also 
  25. call it using the F10 key if the main PmNotes window is active. So a quick 
  26. keyboard navigation to this menu from anywhere in the system would be 
  27. CTRL-SHIFT-P (to acticate main window) followed by F10. 
  28.  
  29.  
  30.  Option                  Accelerator     Description
  31.  
  32.  Hide                                    Hides the main window. You can show it again using
  33.                                          the defined hotkey combination for the main window
  34.                                          or by double clicking the PmNotes entry in the
  35.                                          OS/2 tasklist.
  36.  
  37.  Options...                              Pops up the Options window to configure various
  38.                                          program settings.
  39.  
  40.  Export notes to                         Opens a dialog where you can select one or more
  41.  textfile...                             notes from a list and write the contents to a
  42.                                          textfile.
  43.  
  44.  Show note...            Alt+S           Popup a window that let's you select a note to
  45.                                          bring to the foreground. Very usefull to find
  46.                                          hidden notes or notes that are behind a pile of
  47.                                          other windows. PmNotes by default doesn't put the
  48.                                          individual notes in the OS/2 Window List to
  49.                                          prevent clutter of your Window List.
  50.  
  51.  Show all notes                          Restores all hidden notes and brings all notes to
  52.                                          top of Z-order.
  53.  
  54.  Hide all notes                          Hides all notes.
  55.  
  56.  New note                Alt-N           Creates an empty note.
  57.  
  58.                                          Note: You can also create a new note by "pulling"
  59.                                          it from the main window using MB1 or MB2
  60.                                          (depending on your selection in the main window
  61.                                          options).
  62.  
  63.  Paste to new note       Alt+P           Creates a new note and pastes the clipboard's
  64.                                          contents (if it is text) to it.
  65.  
  66.  About PmNotes...        Alt-A           Displays a program information dialogbox. If
  67.                                          PmNotes is unregistered this will also give you
  68.                                          access to the registration dialog.
  69.  
  70.  
  71. ΓòÉΓòÉΓòÉ 3. Notes ΓòÉΓòÉΓòÉ
  72.  
  73. Note menu options 
  74.  
  75. All operations concerning a note are accessible from the note popup menu except 
  76. for one: 
  77. You can 'stamp' the active note with current date and time by hitting Ctrl-T. 
  78. This will insert current date and time at the cursor position in the notetext. 
  79.  
  80. The options available in the note popup-menu are strongly dependend on possible 
  81. text selections in the notetext. All possible options are presented here. Apart 
  82. from calling the menu by clicking MB2 on the note window, you can also call it 
  83. using the F10 key if the note window is active. 
  84.  
  85.  
  86.  Option                  Accelerator     Description
  87.  
  88.  Hide note               Alt-H           Hides the current note. You can show it again by
  89.                                          using the Show note option.
  90.  
  91.  Delete note             Alt-D           Deletes the current note.
  92.  
  93.  Set alarm...                            Displays a dialog in which you can set or unset an
  94.                                          alarm for the note. If this menuitem is checked,
  95.                                          it means an alarm time and date is currently set
  96.                                          for this note. When the time for which the alarm
  97.                                          was set is reached, a beep will sound and the note
  98.                                          forces it self to the foreground, even if it is
  99.                                          hidden.
  100.  
  101.  Note options                            Submenu containing several individual note
  102.                                          options. These are all on/off toggles, if a
  103.                                          particular function is active, the menuitem will
  104.                                          be checked.
  105.  
  106.      Titlebar            Alt-T           Toggles the titlebar on or off.
  107.  
  108.      Scrollbar           Alt-S           Toggles the vertical scrollbar on or off.
  109.  
  110.      Show in windowlist                  Toggles whether or not the note should appear in
  111.                                          the OS/2 windowlist. If it is on, the first 50
  112.                                          characters of the note will be used as text for
  113.                                          the windowlist entry.
  114.  
  115.      Float on top                        Like the main window, you can also let notes float
  116.                                          on top of all other PM windows.
  117.  
  118.  Create URL object                       (Only available if a valid Internet URL is
  119.                                          selected in the note text.) Pops up a dialog that
  120.                                          let's you choose a title and destination for the
  121.                                          URL object to be created. Destination can be any
  122.                                          folder on the desktop or the desktop itself. The
  123.                                          same operation can be achived by simply dragging
  124.                                          the URL from the note to the desired destination
  125.                                          folder.
  126.  
  127.  Clear                   Delete          (Only available if text is selected.) Deletes the
  128.                                          currently selected text.
  129.  
  130.  Cut                     Shift-Delete    (Only available if text is selected.) Cuts the
  131.                                          currently selected text to the clipboard.
  132.  
  133.  Copy                    Ctrl-Insert     (Only available if text is selected.) Copies the
  134.                                          currently selected text to the clipboard.
  135.  
  136.  Paste                   Shift-Insert    (Only available if there is text available on the
  137.                                          clipboard.) Pastes clipboards contents to note.
  138.  
  139.  Undo                    Alt-U           (Only available if there was an action performed
  140.                                          that can be undone.) Reverts the last
  141.                                          Clear/Copy/Cut/Paste/typing action.
  142.  
  143. Note: 
  144. If you are running NPSWPS or a similar utility that provides a extra popup-menu 
  145. for (Multiline) Entryfields, it is possible that you see this menu appearing 
  146. instead of PmNotes' own menu. Try holding your MB2 a little bit longer then 
  147. you're used to for invoking popup menus. You should now get the PmNotes popup 
  148. menu correctly. 
  149.  
  150.  
  151. ΓòÉΓòÉΓòÉ 4. Options window ΓòÉΓòÉΓòÉ
  152.  
  153. PmNotes configuration 
  154.  
  155. The options notebook contains three pages. You'll find a page to configure 
  156. various aspects for the main window, one for the notes and one for the hotkey 
  157. configuration. 
  158.  
  159. Main window tab 
  160.  
  161.      If Float on top is checked, the PmNotes main window will float on top  of 
  162.       all windows. 
  163.  
  164.      If Time display is checked, alternating Time and Date will be displayed 
  165.       in the main window. 
  166.  
  167.      If Animate on mouseover is checked, a stack of notes will be displayed in 
  168.       the main window while the mouse is moved over it, indicating that you can 
  169.       tear off a note. 
  170.  
  171.      Mouse button drag action. Select whether you want to use mousebutton 1 to 
  172.       move the main window and mousebutton 2 to drag-create new notes or vise 
  173.       versa. 
  174.  
  175.      The Window height and Window width fields specify the main window's 
  176.       dimensions. They can be anything between 32 and 200 pixels. If you have 
  177.       the Time display enabled, the width of the window will be scaled up if 
  178.       the width value is to small to fit the time/date text. 
  179.  
  180.      In the Colors section, you will see three boxes: Active background, 
  181.       Inactive background and Date/Time display. You can drop colors from the 
  182.       OS/2 color palette on these boxes to customize the main window look. 
  183.  
  184.  Note windows tab 
  185.  
  186.      If Titlebar on new notes is checked, newly created notes will by default 
  187.       have a titlebar with creation date and time. 
  188.  
  189.      If  Scrollbar on new notes is checked, newly created notes will by 
  190.       default have a vertical scrollbar. 
  191.  
  192.      If New notes appear in windowlist is checked, newly created notes will by 
  193.       default appear in the OS/2 windowlist. 
  194.  
  195.      If 3D-look notes is checked, the notes will have sort of a 3D-ish look. 
  196.       (Registered version only) 
  197.  
  198.      If Confirm on delete is checked, PmNotes asks for a confirmation on 
  199.       deletion of notes. 
  200.  
  201.      Check New notes at: and one of the four radio buttons to make new notes 
  202.       always popup in the corresponding corner of the screen. 
  203.  
  204.      Use titlebar to display. Select an option from the listbox to display 
  205.       note creation date, note last modified date, first 50 characters of 
  206.       notetext or alarm time (if set) in the titlebar. 
  207.  
  208.       Note that if you select the creation or last modified date option while 
  209.       there are existing notes, the date and time for those notes will be set 
  210.       to current date and time. 
  211.  
  212.  Alarm tab 
  213.  
  214.      You can configure the Alarm type to be a simple bleep from your PC 
  215.       speaker or you can let PmNotes play a wave audio file for you. If you 
  216.       choose the latter, you can enter the complete path to the wave file in 
  217.       the Alarm sound file section. 
  218.  
  219.      Like your clockradio, PmNotes can repeat an alarm every 1-59 minutes for 
  220.       you. You can set this in the Snooze time section. If set to a positive 
  221.       value an alarm note will popup every number of minutes specified here, 
  222.       after the initial alarm time set for that particular note was reached. 
  223.       This continues until the alarm is un-set (from the note popup menu) or 
  224.       the note is deleted. If set to 0, the note will popup and sound only 
  225.       once. 
  226.  
  227.  Hotkeys (Registered version only) 
  228.  
  229.      Here you can setup the hotkey combination to use for activating the main 
  230.       window and the Show note dialog. 
  231.  
  232.  Note: You can reset these options to default by running the ResetIni.cmd REXX 
  233.  script. The script will ask for confirmation before each deletion. 
  234.  
  235.  
  236. ΓòÉΓòÉΓòÉ 5. The Note selection window ΓòÉΓòÉΓòÉ
  237.  
  238. Finding your notes 
  239.  
  240. To prevent cluttering your windowlist, PmNotes has it's own 'tasklist' for 
  241. notes. You can popup the window by hitting the defined hotkey (default: 
  242. Ctrl-tab) while you're working in any other PM application or by selecting 
  243. "Show note..." from the main window popup menu. 
  244.  
  245. The window contains a dropdown listbox containing the first few characters of 
  246. each note (not counting empty lines) as the listbox items. The currently 
  247. selected note will be displayed (in part) in the section below the listbox. You 
  248. can browse through the notes using the up and down cursor keys or simply select 
  249. an item from the list. A third possibility would be to start typing the first 
  250. characters of a note (if you remember them, ofcourse) while the dropdown combo 
  251. has focus. Hitting Enter or clicking the Show button will dismiss the window 
  252. and bring the selected note to the foreground. Also, you can hold the Ctrl-key 
  253. while selecting an item from the list to immediately dismiss the window and 
  254. show the selected note. 
  255.  
  256. From the popup menu in this window you have the option to copy selected text 
  257. from the note-section to the clipboard, delete the currently selected note or 
  258. to reverse the order of the notes shown in the dropdown list. 
  259.  
  260.  
  261. ΓòÉΓòÉΓòÉ 6. Dragging windows and URL's ΓòÉΓòÉΓòÉ
  262.  
  263. Drag and Drop capabilities 
  264.  
  265. Since the notes don't necessarily have titlebars and the main window hasn't got 
  266. one at all, you have several other ways of moving these windows: 
  267.  
  268.      The main PmNotes window can be moved by dragging with MB1 or MB2 
  269.       (depending on your selection in the main window options) down. 
  270.  
  271.      The notewindows can be moved by dragging with MB2 pressed. There's one 
  272.       exception where this will NOT work, if the currenty selected text in the 
  273.       note is a valid URL and you are running Warp 4, a URL drag operation will 
  274.       be initiated by dragging with MB2. 
  275.  
  276.      If Date and time (titlebar) is being displayed in a note, you can also 
  277.       move the note by dragging (mouse pointer on Date / time display) with 
  278.       either MB1 or MB2 down. 
  279.  
  280.      You can drag a URL object from your desktop or from your browser and drop 
  281.       it on a note to insert the URL at the cursor position in the note text. 
  282.       Any selected text will be overwritten. 
  283.  
  284.  
  285. ΓòÉΓòÉΓòÉ 7. Colors, fonts and sizing ΓòÉΓòÉΓòÉ
  286.  
  287. More Drag and Drop capabilities 
  288.  
  289. You can drop colors on the following note sections by drag and dropping from 
  290. the OS/2 color pallette: 
  291.  
  292.      Border (both active and inactive state) 
  293.  
  294.      Text section (MLE) background 
  295.  
  296.      Text section (MLE) foreground (hold CTRL while dropping color) 
  297.  
  298.      Date/time header background (both active and inactive state) 
  299.  
  300.      Date/time header foreground (hold CTRL while dropping color) 
  301.  
  302.  You can drag and drop a (different) font from the OS/2 font pallette on both 
  303.  the text (MLE) section and the Date/time section. 
  304.  
  305.  To make the colors or font for a certain note area default for all newly 
  306.  created notes, hold SHIFT while dropping. Note that new defaults are set per 
  307.  note area (MLE, titlebar or frame). So if you e.g. drop a font on the MLE 
  308.  while holding SHIFT, the colors of this MLE will also be read as the new 
  309.  defaults. 
  310.  
  311.  The default colors and font for notes will also be used in the Show note 
  312.  window. 
  313.  The best way to adjust default note appearance is to simply drag a note of the 
  314.  main window and change what you want to change holding SHIFT while dropping. 
  315.  
  316.  Sizing notes is pretty basic and the same as you are used to for all PM 
  317.  windows. You can change the default note size for new notes however by holding 
  318.  SHIFT while resizing a note. 
  319.  
  320.  Tip: As a font, try " 10. Tms Rmn  " with a blue color and the default note 
  321.  colors. 
  322.  
  323.  
  324. ΓòÉΓòÉΓòÉ 8. System-wide hot-key support ΓòÉΓòÉΓòÉ
  325.  
  326. Hotkeys for fast access 
  327.  
  328. For fast access to your notes or the main PmNotes window, even if your desktop 
  329. is totally covered with windows, there are two hotkey combinations defined. If 
  330. the defaults don't suit you and you registered PmNotes, you can configure other 
  331. combinations as your hotkeys on the Hotkeys page of the Options notebook. 
  332.  
  333.  
  334.  CTRL-SHIFT-P         activates the main PmNotes window.
  335.  
  336.  CTRL-TAB             activates the Show note window from where you can
  337.                       select a note to bring to the foreground.
  338.  
  339. If you don't need or want the hotkey-support, simply delete or rename 
  340. PMN_HOOK.DLL in your PmNotes directory. 
  341.  
  342. Note: If you are running more that one instance of PmNotes, the hotkeys will 
  343. activate the instance that was first started. 
  344.  
  345.  
  346. ΓòÉΓòÉΓòÉ 9. Licence ΓòÉΓòÉΓòÉ
  347.  
  348. Licence information 
  349.  
  350. First of all, PmNotes is not free software. It is distributed as shareware. 
  351.  
  352. As a nonregistered user you are granted a limited licence to use PmNotes on a 
  353. 30 day trial basis to determine whether or not PmNotes is the program you're 
  354. looking for. Use of PmNotes after this period requires registration. 
  355.  
  356. Registration grants you the right to use PmNotes on one computer. You may use 
  357. it on more than one computer, but not at the same time. Furthermore, 
  358. registration enables you to: 
  359.  
  360.      Use more than a maximum of 5 notes (up to 200) 
  361.  
  362.      Configure the system wide hotkeys 
  363.  
  364.      Give your notes a more 3D-ish look 
  365.  
  366.  It is not allowed to modify PmNotes in any way. This includes any possible way 
  367.  of reverse engineering the executable code. The PmNotes distribution archive 
  368.  may be altered to add additional files (e.g. BBS info or translations of 
  369.  documentation) provided all PmNotes files are kept in the archive in their 
  370.  original state. 
  371.  
  372.  Subject to the above, PmNotes may be freely redistributed to others for trial 
  373.  use of the program, taking in account the following terms: 
  374.  
  375.      No money may be charged, except for a very small fee to cover 
  376.       distribution expenses (like e.g. disks or CD-ROMs). 
  377.  
  378.      PmNotes may not be redistributed in conjunction with any kind of software 
  379.       or hardware without the authors written permission. 
  380.  
  381.  PmNotes comes without any kind of warranty. The only thing guaranteed is that 
  382.  the program uses harddisk space, RAM and CPU-time. The author assumes no 
  383.  responsibility for any damage or loss of data arising from the use or 
  384.  inability to use this program. 
  385.  
  386.  BY USE OF THIS PROGRAM YOU AGREE TO THE TERMS OF THIS LICENSE. 
  387.  
  388.  
  389. ΓòÉΓòÉΓòÉ 10. Contacting the author ΓòÉΓòÉΓòÉ
  390.  
  391. Contacting the author 
  392.  
  393. For bugreports, suggestions etc. concerning PmNotes, you can reach the author 
  394. in several ways. 
  395.  
  396. Snail-mail: 
  397. Jeffrey Habets 
  398. Generaal Eisenhowerstraat 41 
  399. 6224 XH  MAASTRICHT 
  400. The Netherlands 
  401.  
  402. Internet e-mail: pmnotes@bmtmicro.com 
  403. Fidonet mail: 2:284/312.3 
  404.  
  405. Web-site: http://www.xs4all.nl/~jeffh 
  406.  
  407.  
  408. ΓòÉΓòÉΓòÉ 11. Registration ΓòÉΓòÉΓòÉ
  409.  
  410. Registration procedure 
  411.  
  412. When unregistered, the program is fully functional except for the following: 
  413.  
  414.      You can have only a maximum of 5 notes open at any time. 
  415.  
  416.      Hotkey configuration is disabled, you can only use the default hotkeys. 
  417.  
  418.      The 3D-look for notes is disabled. 
  419.  
  420.  To enable these features: 
  421.  
  422.      Pay the author to get a unique key to unlock the features. (See the file 
  423.       REGISTER.TXT for details.) 
  424.  
  425.      From the main PmNotes window popup menu, choose "About PmNotes...". 
  426.  
  427.      In the About dialog click the "Register..." button. 
  428.  
  429.      Enter your name and key exactly as you received it (case sensitive!) 
  430.  
  431.      Click "Ok". 
  432.  
  433.  The program will tell you if the registration went Ok and if not, why it 
  434.  failed. 
  435.  
  436.  
  437. ΓòÉΓòÉΓòÉ 12. Usage hints ΓòÉΓòÉΓòÉ
  438.  
  439. Hints 'n Tips 
  440.  
  441. Here are some hints on using PmNotes to make life easier. 
  442.  
  443.      Do a lot of off-line newsreading? Bet you often bump into an URL you 
  444.       would like to visit sometime. 
  445.  
  446.         -  Select the URL in your newsreader and Copy it to the OS/2 clipboard. 
  447.  
  448.         -  From the PmNotes window (CTRL-SHIFT-P if you can't find it) pop-up 
  449.            menu select "Paste to new note" or pop-up on an existing note and 
  450.            "Paste". The URL will be inserted in the note. 
  451.  
  452.         -  Next time you are online, double-click the URL in the note to select 
  453.            it and drag it to your browser, et voila! You can also drag the URL 
  454.            to any folder you would like to keep it in and a standard OS/2 URL 
  455.            object will be created. See, a sort of temporary bookmark-list is 
  456.            born.. 
  457.  
  458.      Use PmNotes as a clipboard extension for text. I found myself doing this 
  459.       very often to copy a number of non-continuous phrases of text from one 
  460.       application to another. 
  461.  
  462.      Just as on the real life notes, write important things you must not 
  463.       forget on them. As soon as you click outside the notewindow, the text is 
  464.       written to disk. So you don't lose your recently created notes when 
  465.       system crashes or whatever occur. 
  466.  
  467.      Use the hide function for notes to prevent clutter of notes all over your 
  468.       desktop. But ofcourse don't use it on notes that function as a reminder. 
  469.  
  470.      If you use Stardock's Object Desktop (Pro), Open the Control Center 
  471.       properties. On page 2 of the Virtual Desktop tab, add PmNotes to the list 
  472.       of locked windows. The PmNotes main window will now show up on all your 
  473.       virtual desktops. (If you wish, you can do the same with notes that have 
  474.       a titlebar. You can identify them by the date and time.) 
  475.  
  476.      Adjust the main window size so the height is the same as WarpCenter and 
  477.       activate the float on top feature. Position the window over an empty spot 
  478.       on the WarpCenter to make it look as if PmNotes were part of the 
  479.       WarpCenter. 
  480.  
  481.  
  482. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  483.  
  484. MB1: Mouse Button 1 
  485. In a standard OS/2 setup this will be your left mousebutton. 
  486.  
  487.  
  488. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  489.  
  490. MB2: Mouse Button 2 
  491. In a standard OS/2 setup this will be your right mousebutton.