home *** CD-ROM | disk | FTP | other *** search
/ Peanuts NeXT Software Archives / Peanuts-3.iso / Database / apps / RZToDoList.1.1.README < prev    next >
Encoding:
Text File  |  1995-05-28  |  4.9 KB  |  109 lines
  1. Here is a list of the major changes in this release:
  2.  
  3. v1.1        5/15/95
  4.  
  5. - fixed bug with "Really Delete?" panel
  6. - fixed drag/drop bug where files wouldn't be added 
  7.   unless there was an insertion point
  8. - made adding an attachment file dirty the to-do list
  9. - restored missing IB connection between the SplitView and 
  10.   ToDoController (this corrects some resize problems)
  11. - fixed bug where Command-n (or new item) would forget edits in progress
  12. - added service to add items from other programs (e.g., Mail)
  13. - selections provided as service (e.g., Mail Selection)
  14. - added timestamp (Command-T) operation (and cool new icon from DM!)
  15. - single-click no longer selects the "Subject" line (this is 
  16.   to allow services to export the selected item).  It now 
  17.   requires a double-click to select the "Subject" line.
  18.  
  19. And, in case you missed it, here's a note from the original release:
  20.  
  21. RZToDoList
  22.  
  23. This is a simple to-do list application with various types of items that  
  24. can be added: appointments, low-high priority items.  The application has a  
  25. simple heuristic built in for sorting items (item raise in the list as  
  26. deadlines draw near).
  27.  
  28. This application started as a test-bed for a custom NXBrowserCell I  
  29. developed called RZBrowserCell.  RZBrowserCell (and its associates) are  
  30. found in the RZBrowserCell subproject of this application.
  31.  
  32. Enjoy,
  33. Z
  34.  
  35. Ralph Zazula 
  36. NeXT Computer, Inc.
  37. Ralph_Zazula@next.com
  38. (415) 780-2893
  39.  
  40. RZToDoList
  41.  
  42. Ralph Zazula
  43. zazula@next.com
  44. Released to Public Domain - 4/4/95
  45.  
  46. This application started as a test-bed for a custom NXBrowserCell I developed called RZBrowserCell.  This object (and its associates) are found in the RZBrowserCell subproject of this application.
  47.  
  48. RZBrowserCell
  49.  
  50. This NXBrowserCell subclass provides a simple way to develop browser-based interfaces similar to that found in Mail.app (and RZToDoList!).  An RZBrowserCell can display tab-aligned icons and text in multiple fonts and colors.
  51.  
  52. To configure a RZBrowserCell, you specify the location of tab-stops and the contents of the cell at each stop.  For example:
  53.  
  54.     id prototypeCell = [[RZBrowserCell alloc] init];
  55.     [prototypeCell addFixedTab:4];
  56.     [prototypeCell addFixedTab:24];        
  57.     [prototypeCell addFixedTab:-85];
  58.     [browser setCellPrototype:prototypeCell];
  59.  
  60. This configures the browser's prototype Cell to be a RZBrowserCell with fixed tab stops at 4 & 24 pixels from the left edge and 85 pixels from the right edge.
  61.  
  62. When filling the browser (through the standard delegate method) you set the contents of the cell by specifying an icon or text string (with optional font and color attributes) and a tab location, e.g.,:
  63.  
  64.     ...
  65.     [theCell setImageNamed:"MyIcon" at:0];
  66.     [theCell setText:"MyString" at:1];
  67.     [theCell setText:"%d items" at:2, [self numItems]];
  68.     ... 
  69.     
  70. RZToDoList
  71.  
  72. This is a simple to-do list application with various types of items that can be added: appointments, low-high priority items.  The application has a simple heuristic built in for sorting items (item raise in the list as deadlines draw near).
  73.  
  74. Files can be dragged into the text at the bottom of the panel and associated with each to-do item.
  75.  
  76. There is also a distributed-objects API (ToDoServer.h) that can be used to add items from another program (the infrastructure for sending notifications to applications is in place but not implemented).
  77.  
  78. This application is fairly robust but not what I would call a commercial-quality product.  It is mainly intended to show an example of how the RZBrowserCell could be used.
  79.  
  80.  
  81. The files
  82.  
  83. I don't use indent.  It's evil.  I set tabs and indent to "3" in edit.  If a file looks funny to you, try this:
  84.  
  85.     - select all
  86.     - Command-Shift-| <yes, vertical bar>
  87.     - expand -3
  88.  
  89. Unfortunately, most of this code is lacking voluminous comments.  I didn't originally intend on releasing this code and it'd never happen if I had to go back and re-comment things.
  90.  
  91. There is some trickery in the RZBrowserCell in order to share lists of text and tab tokens across multiple cells in the browser.  The thing to remember is that a NXBrowser may go off freeing cells when you do a [browser loadColumnZero], so I had to make sure that the -free method of RZBrowserCell didn't nuke stuff in another instance - thus, the reason for all the reference counting.
  92.  
  93. The code for dealing with in-line images in Text is pretty old but works (although there is a bug in that you have to make a selection first before dragging in a file).
  94.  
  95. Julie Zelenski's ObjectError class comes to the rescue of a few errant objc_msgSends() that I haven't bothered to track down.  So, don't be alarmed if you see console messages like:
  96.  
  97.     RZToDoList[9251]: SuperText: does not 
  98.         recognize selector -nextText
  99.  
  100. Feel free to compile debug and figure out what's happening.  At least with OE in there, the app keeps cruising along after the bogus message is sent...
  101.  
  102. I hope you find this code useful.  
  103.  
  104. Thanks go to Dan Marusich for, as always, great artwork!
  105.  
  106. Ralph Zazula
  107. NeXT Computer
  108. Spring '95
  109.