home *** CD-ROM | disk | FTP | other *** search
/ Usenet 1994 January / usenetsourcesnewsgroupsinfomagicjanuary1994.iso / sources / x / volume21 / notes / part01 / .notes next >
Encoding:
Text File  |  1993-10-20  |  5.8 KB  |  181 lines
  1. 295 181 410 106 About NOTES
  2.  
  3.     Notes v1.0.2 by Bob Smith
  4.  
  5.     Send gripes or suggestions to ...
  6.  
  7.     bob@snuffy.dracut.ma.us (Bob Smith)
  8. 205 183 500 594 CHANGES
  9. CHANGES to Notes for v1.0.2
  10.  
  11. o    Changed the 'chains' on the buttons that are part
  12.     of the notes list so that they don't get mucked up
  13.     when the window is resized.
  14.  
  15. o    Added a 'Select' button to the note display to allow
  16.     selecting the entire note easily.
  17.  
  18. o    Changed filler_buttons to filler_boxes... Just makes
  19.     more sense.
  20.  
  21. o    Made a change in the dialog message when creating a new
  22.     note.
  23.  
  24. o    Put the whole mess under SCCS control ... even
  25.     though I have no real experience at using sccs...
  26.     as good a time as any to learn...
  27.  
  28. CHANGES to Notes for v1.0.1
  29.  
  30. o    Added a Button 2 translation to the `Dismiss' button
  31.     of the Notes list that causes everything (any displayed
  32.     notes and the note list) to be dismissed in one action.
  33.  
  34. o    Added a Button 2 translation to the `Save' button
  35.     of the Notes list that causes a save operation to be
  36.     performed and everything dismissed.
  37.  
  38. o    Added a Button 2 translation to the Notes list widget
  39.     that will dismiss the associated note.
  40.  
  41. o    Did away with the quitAction function in main.c
  42.     as it was unneeded.
  43.  
  44. o    Corrected read_notefile so that it wouldn't core
  45.     dump in the absence of a HOME variable in the
  46.     environment.
  47.  
  48. o    Put some speedup hacks into read_notefile,
  49.     the entire file is now read in one pass instead of
  50.     a line at a time.  Loads up appreciably faster!
  51.  
  52. o    Added some error checking around malloc's and realloc's,
  53.     doesn't do anything graceful!  Just checks and dies
  54.     if a problem is encountered.
  55.  
  56. o    Added a die() function, a quick way out for error
  57.     conditions.
  58.  
  59. o    Added an AddCallback definition, just an easier way
  60.     to do XtAddCallback...
  61.  
  62. o    Consolidated some code with the addition of the function
  63.     destroy_widget() in callbacks.c
  64.  
  65. o    added desensitize_all and resensitize_all -- an effort
  66.     in keeping the user from getting the thing in an odd
  67.     state...  maybe
  68.  
  69. o    made more things work via callbacks
  70.  
  71. o    added H_OFFSET and H_OFFSET definitions in Imakefile
  72.     for use by write_notefile() in main.c -- the purpose
  73.     is to correct out the offsets injected by my window
  74.     manager (twm) while a note is mapped to prevent the
  75.     windows from 'creeping' when they are saved...  if
  76.     someone knows a way to detect these offsets at run
  77.     time I'd appreciate a better idea...
  78.  
  79. o    added a Button 3 translation to the startup_button
  80.     to bring up a `quit' dialog box
  81.  
  82. o    ...and otherwise damn near rewrote the whole thing
  83. 207 181 500 551 INSTALL
  84. INSTALL notes for Notes v1.0.2
  85.  
  86. In theory all you should have to do is:
  87.  
  88.     xmkmf            to create the Makefile
  89.     make                to build notes
  90.     make install        to install notes in BINDIR
  91.                 and notes.xbm in BITMAPDIR
  92.     make install.man    to install notes.man in MANDIR
  93.  
  94. Things that may cause problems:
  95.  
  96. strdup()
  97.  
  98.     Notes uses a strdup() function that SunOS3.5 is
  99.     missing.  A replacement is included in main.c with
  100.     a feeble attempt made to properly 'ifdef' it in the
  101.     Imakefile.  If you need it and the Makefile is
  102.     generated without defining NEED_STRDUP, check and
  103.     fix the Imakefile.
  104.  
  105. H_OFS / V_OFS
  106.  
  107.     Various window managers do weird things to a windows
  108.     x and y values when they are mapped.  This prompted the
  109.     inclusion of settable parameters V_OFS and H_OFS in
  110.     the Imakefile, which ultimately effects the definitions
  111.     of V_OFFSET and H_OFFSET in main.c ...  You may have to
  112.     experiment a bit by saving your .notes files
  113.     repeatedly with notes mapped and checking the values
  114.     in .notes to get it exactly right on your system.
  115. 204 185 500 300 MANIFEST
  116.    File Name        Archive #   Description
  117. -----------------------------------------------------------
  118.  .notes                     1   A sample notes files
  119.  CHANGES                    1   A history of changes
  120.  INSTALL                    1   Installation instructions
  121.  Imakefile                  1   an Imake makefile
  122.  MANIFEST                   1   This shipping list
  123.  Makefile                   1   an Imake generated makefile
  124.  README                     1   Miscellaneous comments
  125.  TODO                       1    Stuff that should be fixed one day
  126.  callbacks.c                1   source
  127.  main.c                     1   source
  128.  notes.h                    1   source
  129.  notes.man                  1   Manual page for notes
  130.  notes.xbm                  1   Bitmap for notes
  131.  patchlevel.h               1   source
  132. 204 185 500 328 README
  133. README for Notes v1.0.2
  134.  
  135. Notes is an X11R5 note pad based on the Athena Widget set.
  136. It was developed on a Sun3 running SunOS3.5 and X11R5 using
  137. twm as the window manager.  As yet it has not been tested on
  138. anything else.  I would appreciate reports from anyone
  139. running it elsewhere.
  140.  
  141. There's really nothing fancy about this program, it merely keeps
  142. a collection of notes in popups and saves them to a file
  143. called .notes in your home directory.  This .notes file not only
  144. saves the contents of each note, but also the geometry of each
  145. note.
  146.  
  147. Theorectically there should be no limit to the number of notes
  148. that you could have, but in practice - the list widget will run
  149. off the bottom of your screen at some point...
  150.  
  151. bob@snuffy.dracut.ma.us (Bob Smith)
  152. 205 184 500 550 TODO
  153. TODO list for Notes
  154.  
  155. o    improve the man page
  156.  
  157. o    improve the state of comments in the source
  158.  
  159. o    Make Save button sensitive based on
  160.     a.    adding a new note
  161.     b.    deleting a note
  162.     c.    changes in note text
  163.     d.    change of note title
  164.     e.    change of note geometry
  165.     thereby allowing a form of feedback to the
  166.     user regarding a need to save changes
  167.  
  168. o    along with being able to recognize and indicate
  169.     when changes are in need of saving, allow
  170.     specifying autosave on exit
  171.  
  172. o    Be able to specify an alternate notes file
  173.  
  174. o    Fix the list widget so that when it's about to
  175.     hang off the screen, switch to multiple columns
  176.     or add a scrollbar (pending a final decision here)
  177.  
  178. o    Find a better way to get a windows geometry while
  179.     it's mapped and eliminate the need for H_OFS and
  180.     V_OFS.
  181.