home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 3 / PDCD_3.iso / pocketbk / utilsm / notepad / diary2 / DIARY20.TXT < prev    next >
Encoding:
Text File  |  1993-09-22  |  18.5 KB  |  455 lines

  1. Diary V 2.0
  2.  
  3. Time Manager - Application for Notepad
  4. (c) WOS
  5.  
  6. written by:
  7.  
  8. Wolfgang Schirmer
  9. Manshardtstrasse 13 a
  10. 22119 Hamburg
  11. Germany
  12.  
  13. Phone 49 - 40 - 655 39 56
  14.  
  15. 100022,1371, Cserve
  16.  
  17.  
  18. 22.09.93
  19.  
  20.  
  21. First of all I will say many thanks to Mark D Esposito, because 
  22. without his tips and information this program won't have been 
  23. possible. And also for his patience with me.
  24. Thank you Mark !
  25.  
  26. Also many thanks to John Hind for his great work creating 
  27. FRAMELIB. I used this library writing the program.
  28. Thank you John !
  29.  
  30. What's new in V2.0
  31.  
  32. ***** Note *****
  33.  
  34. I changed the handling of variable/fixed holidays, so your old Diary files 
  35. will be reorganized the first time you use them with Diary 2.0. Also for 
  36. each file I create a file which contains the information for repeated 
  37. entries.
  38. The reorganizing procedure worked well with my files, but PLEASE MAKE A 
  39. BACKUP OF YOUR OLD FILES BEFORE RUNNING DIARY 2.0 THE FIRST TIME.
  40.  
  41. ****************
  42.  
  43. New features:
  44.  
  45. Now diary works also as a standalone application, although you can't use 
  46. Notepad files when it isn't started from Notepad.
  47.  
  48.  
  49. Diary now has repeated entries with these options:
  50.  
  51.   1. Monthly by date
  52.   2. Monthly by day (e.g. third monday of every month)
  53.   3. Monthly last day
  54.   4. Weekly
  55.   5. Daily
  56.   6. Workday
  57.   7. Restday
  58.   8. Every (x) days
  59.  
  60. These are nearly the options that gives you the new Alarm Server from Mark 
  61. Esposito. I only left the options repeated 'yearly' and 'every (x) hours' 
  62. which makes no sence for Diary.
  63.  
  64. Of course you can assign a repeated alarm to the repeated entries.
  65.  
  66.  
  67. Pressing <esc> now toggles between the actual day and the last day used, 
  68. like in Agenda.
  69.  
  70.  
  71. Now you can select between the weekline or a daily timeline at the bottom 
  72. of the screen by pressing <psion>w.
  73.  
  74.  
  75. The three month calendar and the weekline now takes care of the configured 
  76. first day of the week.
  77.  
  78.  
  79. Now you can configure the message length for every single Diary file from 
  80. 20 to 235 characters.
  81.  
  82.  
  83. For entries that doesn't fit into one line now there is a full screen note 
  84. view with word wrapping.
  85.  
  86.  
  87. Now you can enter/delete your own fixed holidays like birthdays, wedding 
  88. days. These information is valid for all files and all years. You don't 
  89. have to enter the information again for every new year.
  90.  
  91.  
  92.  
  93.  
  94. 1 General Information
  95.  
  96. 1-1 What do Diary do ?
  97.         I wrote Diary, because I missed the possibility to link an 
  98.         entry from Agenda to a Notepad file. I often have to prepare 
  99.         meetings or take notes in a meeting and wished to have a 
  100.         possibility like this
  101.  
  102.         9:00 - 10:00 * meeting room 1
  103.         =>linked to a Notepad file which holds the         
  104.         information necessary for this meeting.
  105.  
  106.         I know that Diary don't cover all the possibilities you have 
  107.         with Agenda, but I hope to make it better step by step.
  108.         For this, if you're interested in help me, please send all 
  109.         your suggestions and bugs to me. (Cserve 100022,1371)
  110.         Thank you !
  111.  
  112. 1-2 Install Diary
  113.  
  114.         The following files are provided:
  115.     
  116.         Diary.txt         This file.
  117.         Diary.wrd         The help file in Word format.
  118.         Diary.opa         The main program.
  119.         Diary2.opo        Routines used by Diary
  120.         Diary3.opo        
  121.         Dplug.plg         The Notepad - PlugIn you need to start Diary and 
  122.                           link it to Notepad.
  123.  
  124.         Diary.fon         Two fonts used by Diary.
  125.         Digt.fon
  126.         Holidayd.dbf      Generic file for german fixed holidays.
  127.         Holidaye.dbf      Generic holidays file for the other countries       
  128.         Framelib.opo      John Hints great utility.
  129.         Asdriver.opo      Marks application to access the ASERVER Server.
  130.  
  131.         Installation
  132.  
  133.         Create a directory \Diary\
  134.         Create a directory \Diary\fon\
  135.  
  136.         Copy the *.fon files into the \diary\fon\ directory.
  137.         Copy the appropriate holiday file into the \diary\fon\ directory.             
  138.         Copy the Diary.opa into any \app\ directory and install it as 
  139.         an application on the system screen.
  140.         Copy the Diary2.opo and Diary3.opo files into any \opo\ directory.
  141.         Copy the Dplug.plg into any \note\plug\ directory and install it 
  142.         with the PlugIns like any PlugIn for Notepad.
  143. ******* If you have already installed Dplug as A PlugIn, you only need
  144.         to copy the Dplug.plg into your \note\plug\ directory.
  145.         Copy the Diary.wrd file into any \wrd\ directory.
  146.         Copy the Framelib.opo and the Asdriver.opo to any \opo\ directory.
  147.  
  148.         To run Diary start it from Notepad using the DPLUG PlugIn, 
  149.         pressing <Psion> k and then the appropriate key.
  150.         You also can start Diary like any other application from the system 
  151.         screen, but you loose most of the features to comunicate with 
  152.         Notepad
  153.  
  154. 1-3 Starting
  155.     
  156.         The first time you start Diary or Dplug you will be asked for the 
  157.         the drive where you will put the datafiles by default,
  158.         the default duration time and the default before time for
  159.         alarms. Also you can decide if you will set alarms by default
  160.         when entering a new item.
  161.         If Diary found no file you will be asked for the name of a new 
  162.         file to create, otherwise you will be asked for a file to 
  163.         open.
  164.         If you press <esc> at this time you will be asked for a new 
  165.         file to create.
  166.         
  167.  
  168. 1-4 The database
  169.  
  170.         I use a database of my own design, which contains records with 
  171.         fixed length.
  172.         The database is divedid into two parts. The first part 
  173.         consists of a word, which is a pointer to the next free record 
  174.         ($FFFF if the next record is appended to the end of file), a 
  175.         word, which contains the year and an array of 366 words, one 
  176.         entry for each day of the year. This fields contains a pointer 
  177.         to the first record for each day.
  178.         The second part are the records, which contains the 
  179.         information for every entry. They have a configurable length of 
  180.         20 - 235 bytes each. These records are pointered backward and 
  181.         forward.
  182.         If you delete an entry, the place will be occupied by the next 
  183.         new entry.
  184.  
  185. 1-5 Limitations
  186.  
  187.         Diary can not handle entries for more than one year.
  188.  
  189.         If you started Diary from Notepad, Notepad is locked.
  190.  
  191. 1-6 The screen
  192.  
  193.         The screen consists of three parts:
  194.         First     At the left the actual time and date
  195.                   in the middle the date of the entries 
  196.                   and at the right the day of year and the calendar week 
  197.                   of the entry-date .
  198.         Second    The appointments
  199.         Third     Either
  200.                   Two weeks beginning with the configure start of week day.
  201.                   The day of the appointments is indicated by the bold 
  202.                   number and a black point beside Am or PM indicates, 
  203.                   that there is an appointment.
  204.                   Or
  205.                   A daily timeline which shows the spreading of the 
  206.                   appointments by a beam.
  207.  
  208. 1-7 Terms
  209.  
  210.         Disclaimer:
  211.         I take no reponsability for any lost dataor hardware failure 
  212.         of any kind, due to the use of this software.
  213.  
  214.         Diary is provided as shareware although it is free of charge. 
  215.  
  216.  
  217.  
  218. 2   Functions
  219.  
  220. 2-1 Moving through the entries
  221.  
  222.     <up>                  one entry up
  223.     <down>                one entry down
  224.     <page up>             four entries up
  225.     <page down>           four entries down
  226.     <home>                first entry of the day
  227.     <end>                 last entry of the day
  228.  
  229. 2-2 Moving through the year
  230.  
  231.     <left>                one day later
  232.  
  233.     <right>               one day earlier
  234.  
  235.     <ctrl><up>            first day of the year
  236.  
  237.     <ctrl><down>          last day of the year
  238.  
  239.     <ctrl><left>          one week later
  240.  
  241.     <ctrl><right>         one week earlier
  242.  
  243.     <ctrl><psion><up>     first day of the month
  244.  
  245.     <ctrl><psion><down>   last day of the month
  246.  
  247.     <ctrl><psion><left>   one month later
  248.  
  249.     <ctrl><psion><right>  on month earlier
  250.  
  251.     <esc>                 toggles between the actual day and the last day 
  252.                           used
  253.  
  254. 2-3 Functions
  255.  
  256.     <psion> o             opens a Diary file
  257.  
  258.     <psion> n             creates a new file
  259.  
  260.     <psion> e             inserts a new entry
  261.  
  262.     <psion> u             updates an existing entry
  263.                           *** Repeated entries can be modified only in all.
  264.  
  265.     <psion> d             deletes an entry
  266.                           If there is an link to a Notepad file
  267.                           you will be asked if you want to delete 
  268.                           the file also. 
  269.                           If there is an alarm for this entry it 
  270.                           will !! not !! be canceled.
  271.                           *** Repeated entries can be deleted only in all.
  272.  
  273.     <del>                 deletes also an entry
  274.                           *** Deleted entries are written to the M:\NPBUF31 
  275.                               file and can be pasted therefore.
  276.  
  277.     <psion> s             sets an alarm to an entry
  278.                           To set an Alarm you must have started
  279.                           the ASERVER.OPO coming with Notepad.
  280.                           An alarm is indicated by the alarm
  281.                           character.
  282.                           You can't set another alarm to an entry.
  283.                           Alarms can be repeated by the following options:
  284.                 
  285.                            1. Monthly by date
  286.                            2. Monthly by day
  287.                            3. Monthly las day
  288.                            4. Weekly
  289.                            5. Daily
  290.                            6. Workday
  291.                            7. Restday
  292.                            8. Every (x) days
  293.  
  294.     <psion> c             cancels an alarm
  295.  
  296.     <psion> y             changes an alarm
  297.  
  298.     <psion> j             jumps to a certain date
  299.  
  300.     <psion> h             pops up a window where you can select if
  301.                           you want to see variable or fixed holidays.
  302.                           *** Variable holidays are those which change the 
  303.                               date every year like Easter or Whitsun. These 
  304.                               dates are calculated in the program and can't  
  305.                               be modified.
  306.                           *** Fixed holidays are all holidays with the same 
  307.                               date every year like birthdays, weddings days 
  308.                               etc. You can enter your own holidays by 
  309.                               pressing <enter> on the fixed holiday view 
  310.                               screen. 
  311.                               !!!! Don't worry about the year 1900. It 
  312.                                    isn't a bug. I need the day of the year
  313.                                    to fix the problem with leap years.
  314.                               After entering a new date the database will 
  315.                               be sorted.
  316.                               You can walk through the entries using the 
  317.                               following cursor keys.
  318.                               <up>         one entry up
  319.                               <down>       one entry down
  320.                               <page up>    one screen up
  321.                               <page down>  on screen down
  322.                               <home>       first entry
  323.                               <end>        last entry
  324.                               You can delete entries pressing <del>.
  325.                           *** Note: All menu functions are disabled except 
  326.                                     <psion> x.
  327.                           Pressing <esc> leaves the window.
  328.  
  329.     <psion> k             pops up a three month calendar with the actual 
  330.                           month in the middle.
  331.                           The weeks are preceeded by the calendar week and 
  332.                           the week begins with the configured first day of
  333.                           week.
  334.                           You can move arround the calendar with the same 
  335.                           keystrokes as moving through the entries.
  336.                           Pressing <enter> will jump to the selected day.
  337.                           If you left the actual year, you will be asked 
  338.                           for a filename for the new year.
  339.                           If the file exists it will be opened, otherwise 
  340.                           it will be created.
  341.                           Pressing <tab> leaves the calendar.
  342.                           *** Note: All menu function are disabled except
  343.                              <psion>j, <psion>h and <psion>x.
  344.  
  345.     <psion> l             deletes a Diary file
  346.                           *** Note This option deletes both the main file 
  347.                               and the repeat file.
  348.  
  349.     <psion> r             renames a Diary file
  350.                           *** Note Since both the main file and the repeat 
  351.                               file must be renamed, you can't give a new
  352.                               extension to the files.
  353.  
  354.     <psion> t             exports the entries to a .txt file.
  355.                           You will be asked for a filename and the drive 
  356.                           and if you will export all dates (Option 'Yes') 
  357.                           or only dates with an appointment (Option 'No').  
  358.                           Also you will be asked for the dates to begin and 
  359.                           end.
  360.                           If you have the S3-Link attached you can write 
  361.                           the file directly to a PC.
  362.  
  363.     <psion> p             copies and pastes entries.
  364.                           The copy option writes the entry into the
  365.                           m:\npbuf31 file and paste reads from this file. 
  366.                           So you can paste an  entry several times.
  367.                           Also deleted entries (<psion>d or <del>) are 
  368.                           written into this file and can be pasted.
  369.  
  370.     <psion> b             searches an entry.
  371.                           You will be asked for the string to search (it's 
  372.                           not case sensitive) and if you will search bottom 
  373.                           (from actual date till Dec,31) or up (from actual 
  374.                           date till Jan,1)
  375.                           Pressing <ctrl>c searches for the next entry.
  376.  
  377.     <psion> w             toggles between the weekline and the timeline at 
  378.                           the bottom of the screen.
  379.                           The weekline shows the actual and the next week, 
  380.                           beginning with the configured first day of week.
  381.                           The actual day is indicated by the bold number.
  382.                           A black box beside AM or PM indicates that there 
  383.                           is an appointment.
  384.                           The timeline shows the spreading of the 
  385.                           appointments for the actual day.
  386.  
  387.     <psion> i             shows some information for the actual file.
  388.                           You can leave the screen pressing either <enter> 
  389.                           or <esc>
  390.                           *** Note: All menu functions are disabled except 
  391.                               <psion>x.
  392.  
  393.     <psion> z             changes the default settings.
  394.  
  395.     <psion> a             shows Informations about Diary.
  396.  
  397.     <psion> x             exits the program and returns to Notepad, if it 
  398.                           was started from there.
  399.  
  400.     <tab>                 links a Notepad file to the current entry, if 
  401.                           Diary was started from Notepad.
  402.                           If there is no actual link, Diary asks 
  403.                           you for a filename and if you will create 
  404.                           a file in the \note\expand\ directory (.exp)
  405.                           or in the \note\ directory (.pad), which will
  406.                           be shown on the system screen. If the file
  407.                           exists Diary opens the file, otherwise 
  408.                           Diary creates it.
  409.                           If there is yet a link Diary opens this 
  410.                           file.
  411.  
  412.     <shift><tab>          removes the link to the Notepad file, if Diary 
  413.                           was started from Notepad and asks you if you wish 
  414.                           to delete the Notepad file.
  415.  
  416.     <psion><tab>          jumps directly to Notepad, if it is running 
  417.                           without opening a specified file
  418.  
  419.     <ctrl><tab>           jumps to Notepad, if Diary was started from 
  420.                           Notepad and creates and/or opens a file called 
  421.                           TODO#DIA as a ToDo file for notes, which doesn't 
  422.                           have an entry in Diary. This file will be sorted 
  423.                           by the project date and for every new date a 
  424.                           special line like this
  425.                           ->     *** Sep 22, 1993
  426.                           is inserted
  427.  
  428.     <help>                jumps to the Word-Application and opens the       
  429.                           Diary.wrd file.
  430.                           I decided in favor of this solution, because in 
  431.                           this way you can add any information you
  432.                           needed and I didn't put to the help file
  433.                           (And also you can correct my errors)
  434.                           ***  Press <ctrl><menu> to get the whole screen.    
  435.                           ***  Press the Word Icon to get the headlines. 
  436.  
  437.     <enter>               is a toggle to view messages that won't
  438.                           fit totally into one line. The notes are shown
  439.                           in a whole screen view mode with word wrapping.
  440.  
  441.     <psion><enter>        Prints the name of the holiday when the 
  442.                           date shows a slashed O at the right.
  443.  
  444.     <space>               is a toggle to mark entries as done.
  445.                           If there is an alarm attached to the entry   
  446.                           it will be canceled.  
  447.                           The marked as done items are preceeded by a 
  448.                           mark.  
  449.  
  450.  
  451. I hope someone else like this program and find it useful.
  452.  
  453.  
  454. Wolfgang
  455.