What'sUp 1.2 docs Intro What'sUp is a small app that provides a week's overview of the contents of Newt's calendar and to-do list. Shareware, US$15. Version 1.2 is an upgrade which works only under Newton OS 2.0. The upgrade is free to registered users. ------------------------------------------------------------- Contents Introduction Contents Legal stuff Using What'sUp Price and registering Support Known problems and limitations Plans for the future Revision history of the program Revision history of the docs Acknowledgments ------------------------------------------------------------- Legal stuff What'sUp (the software that this documentation describes) and this documentation are all Copyright 1994-1996 Matthew Dixon Cowles and his licensors. All rights reserved. Apple and Newton are trademarks of Apple Computer, Inc., registered in the United States and other countries. NewtonMail and MessagePad are trademarks of Apple Computer, Inc. Here is the software license that Apple Computer, Inc. requires that Newton software written with the Newton Toolkit carry. It isn't exciting reading and it exhibits lawyers' curious use of capitalization, but I advise you to read it since it does apply to all users of What'sUp. 1. License. The application, demonstration, system and other software accompanying this License, whether on disk, in read only memory, or by any other media (the "Software"), the related documentation and fonts are licensed to you by Matthew Dixon Cowles. You own the media on which the Software and fonts are recorded but Matthew Dixon Cowles and/or Matthew Dixon Cowles's Licensor(s) retain title to the Software, related documentation and fonts. This License allows you to use the Software and fonts on a single Newton Product (which, for the purposes of this License, shall mean a product bearing Apple's Newton logo), and make one copy of the Software and fonts in machine-readable form for backup purposes only. You must reproduce on such copy Matthew Dixon Cowles's copyright notice and any other proprietary legends that were on the original copy of the Software and fonts. You may also transfer all your license rights in the Software and fonts, the backup copy of the Software and fonts, the related documentation and a copy of this License to another party, provided the other party reads and agrees to accept the terms and conditions of this License. 2. Restrictions. The Software contains copyrighted material, trade secrets and other proprietary material and in order to protect them you may not decompile, reverse engineer, disassemble or otherwise reduce the Software to a human-perceivable form (does not apply to users with source code licenses for What'sUp). You may not modify, network, rent, lease, loan, distribute or create derivative works based upon the Software in whole or in part. You may distribute What'sUp for a nominal download or duplication charge at most. Except for that exception, you may not electronically transmit the Software from one device to another or over a network. 3. Termination. This License is effective until terminated. You may terminate this License at any time by destroying the Software and related documentation and fonts. This License will terminate immediately without notice from Matthew Dixon Cowles if you fail to comply with any provision of this License. Upon termination you must destroy the Software, related documentation and fonts. 4. Export Law Assurances. You agree and certify that neither the Software nor any other technical data received from Matthew Dixon Cowles, nor the direct product thereof, will be exported outside the United States except as authorized and as permitted by the laws and regulations of the United States. If the software has been rightfully obtained by you outside of the United States, you agree that you will not re-export the Software nor any other technical data received from Matthew Dixon Cowles, nor the direct product thereof, except as permitted by the laws and regulations of the United States and the laws and regulations of the jurisdiction in which you obtained the Software. 5. Government End Users. If you are acquiring the Software and fonts on behalf of any unit or agency of the United States Government, the following provisions apply. The Government agrees: (i) if the Software and fonts are supplied to the Department of Defense (DoD), the Software and fonts are classified as "Commercial Computer Software" and the Government is acquiring only "restricted rights" in the Software, its documentation and fonts as that term is defined in Clause 252.227-7013(c)(1) of the DFARS; and (ii) if the software and fonts are supplied to any unit or agency of the United States Government other than the DoD, the Government's rights in the Software, its documentation and fonts will be as defined in Clause 52.227-19(c)(2) of the FAR or, in the case of NASA, in Clause 18-52.227-86(d) of the NASA Supplement to the FAR. 6. Disclaimer of Warranty on Software. You expressly acknowledge and agree that use of the Software and fonts is at your sole risk. The Software, related documentation and fonts are provided "AS IS" and without warranty of any kind and Matthew Dixon Cowles and Matthew Dixon Cowles's Licensor(s) (for the purposes of provisions 6 and 7, Matthew Dixon Cowles and Matthew Dixon Cowles's Licensor(s) shall be collectively referred to as "Matthew Dixon Cowles") EXPRESSLY DISCLAIM ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. MATTHEW DIXON COWLES DOES NOT WARRANT THAT THE FUNCTIONS CONTAINED IN THE SOFTWARE WILL MEET YOUR REQUIREMENTS, OR THAT THE OPERATION OF THE SOFTWARE WILL BE UNINTERRUPTED OR ERROR-FREE, OR THAT DEFECTS IN THE SOFTWARE AND THE FONTS WILL BE CORRECTED. FURTHERMORE, MATTHEW DIXON COWLES DOES NOT WARRANT OR MAKE ANY REPRESENTATIONS REGARDING THE USE OR THE RESULTS OF THE USE OF THE SOFTWARE AND FONTS OR RELATED DOCUMENTATION IN TERMS OF THEIR CORRECTNESS, ACCURACY, RELIABILITY, OR OTHERWISE. NO ORAL OR WRITTEN INFORMATION OR ADVICE GIVEN BY MATTHEW DIXON COWLES OR AN AUTHORIZED REPRESENTATIVE OF MATTHEW DIXON COWLES SHALL CREATE A WARRANTY OR IN ANY WAY INCREASE THE SCOPE OF THIS WARRANTY. SHOULD THE SOFTWARE PROVE DEFECTIVE, YOU (AND NOT MATTHEW DIXON COWLES OR AN AUTHORIZED REPRESENTATIVE OF MATTHEW DIXON COWLES) ASSUME THE ENTIRE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION. SOME JURISDICTIONS DO NOT ALLOW THE EXCLUSION IF IMPLIED WARRANTIES, SO THE ABOVE EXCLUSION MAY NOT APPLY TO YOU. 7. Limitation of liability. UNDER NO CIRCUMSTANCES INCLUDING NEGLIGENCE, SHALL MATTHEW DIXON COWLES BE LIABLE FOR ANY INCIDENTAL, SPECIAL OR CONSEQUENTIAL DAMAGES THAT RESULT FROM THE USE OR INABILITY TO USE THE SOFTWARE OR RELATED DOCUMENTATION, EVEN IF MATTHEW DIXON COWLES OR AN AUTHORIZED REPRESENTATIVE OF MATTHEW DIXON COWLES HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. SOME JURISDICTIONS DO NOT ALLOW THE LIMITATION OR EXCLUSION OF LIABILITY FOR INCIDENTAL OR CONSEQUENTIAL DAMAGES SO THE ABOVE LIMITATION OR EXCLUSION MAY NOT APPLY TO YOU. In no event shall Matthew Dixon Cowles's total liability to you for all damages, losses, and causes of action (whether in contract, tort (including negligence) or otherwise) exceed the amount paid by you for the Software and fonts. 8. Controlling Law and Severability. This License shall be governed by and construed in accordance with the laws of the United States and the State of California, as applied to agreements entered into and to be performed entirely within California between California residents. If for any reason a court of competent jurisdiction finds any provision of this License, or portion thereof, to be unenforceable, that provision of the License shall be enforced to the maximum extent permissible so as to effect the intent of the parties, and the remainder of this License shall continue in full force and effect. 9. Complete Agreement. This License constitutes the entire agreement between the parties with respect to the use of the Software, related documentation and fonts, and supersedes all prior or conterporaneous understandings or agreements, written or oral, regarding such subject matter. No amendment to or modification of this License will be binding unless in writing and signed by a duly authorized representative of Matthew Dixon Cowles. ------------------------------------------------------------- Using What'sUp -- Installation -- Use -- Deleting the registration data -- Installation Install What'sUp just as you would any Newton package. Use Newton Backup Utility or any of the other programs that will send packages to your Newton. (Check the documentation that came with the program you use for details.) Once you have installed the app, you will see a new icon, a calendar, in your extras drawer. Tap it to open What'sUp. -- Use Using What'sUp is extrmely simple since there's not much you can do. When it opens, What'sUp displays an overview of the upcoming week. Within each day, notes are shown at the top, then appointments, then to-do items. If there's more than will fit on the screen, you can scroll using Newt's scroll arrows to see the remainder. In the top-most day, which is always today, a little triangular arrow appears of there are any appointments scheduled. It points to where the time that What'sUp was opened falls in the list of appointments. To-do items' checkboxes work just about as you'd expect them to but nothing else is interactive. You'll have to open the Dates app to change things. You can open the calendar to a particular day by tapping on the day's header. The only other controls are the app's closebox and the info button. The only thing that might be unexpected in the way What'sUp works is that to-do items that have been checked off don't appear. In Dates, if you check off a to-do item, it will keep appearing until the next day. -- Entering your registration code When you receive your registration code, enter it in the field in the annoying the beg screen that appears what you start What'sUp (you'll have to wait until the app has finished opening in the background before you start writing) and tap the button that says Accept registration key. What'sUp will thank you politely and you won't have to look at the beg screen any longer. You'll also know that you did the right thing. -- Deleting What'sUp If, for some reason, you want to get rid of What'sUp completely, use the button in the about box to delete its registration data (you get a chance to change your mind). Do that even if you haven't registered, since What'sUp stores the fact that you haven't registered. Once you've deleted the registration data, delete What'sUp and it will leave no trace in your Newt. Of course, deleteting What'sUp's data won't affect the data that belongs to the internal apps, which What'sUp merely reads. ------------------------------------------------------------- Price and registering What'sUp is shareware. If you use What'sUp beyond a reasonable trial period of 30 days or so, either register it or delete it. To register, send a check (money order, bank draft) for US$15, drawn on a US bank to Matthew Dixon Cowles 4501 Park Glen Road, no. 345 St Louis Park, MN 55416 USA Please include an e-mail address and a snail-mail address and let me know what version you are using. If there's a more recent version, I'll send it along. People who have registered their copies will generally be kept up do date about known bugs and new versions of What'sUp. When I receive your payment, I'll send you a registration code by e-mail or by snail-mail (if you haven't sent an e-mail address). Instructions about entering it are in the previous section "Use", but it's really pretty obvious. Source code for What'sUp is available in case you'd like to see just how bad a programmer I am. Source code is available to registered users for US$25. (That's a total of US$40 for source if you haven't previously registered your binary copy.) Note that a source code license allows you to modify your own copy and to use the code for general inspiration, but it does not allow you to distribute derivative works. ------------------------------------------------------------- Support I am always interested in getting feedback from users. I would be delighted to hear comments, thoughts and suggestions about the documentation, feature requests, bug reports, expressions of praise, funny stories, and lucrative job offers. If you are reporting a bug, please try to be as specific as possible about the actions that lead up to it. If you are expressing praise or making a job offer, please try to be as generous as possible. I can't promise to implement all features that are requested, but I will keep track of them and will be more likely to implement those that are requested most often. Many of the best features in my apps have been suggested by users. Support for What'sUp is only available by mail, preferably e-mail. My e-mail address is: Matt@MondoInfo.com If you don't have an e-mail account, please send a note by the postal service to: Matthew Dixon Cowles 4501 Park Glen Road, no. 345 St Louis Park, MN 55416 USA ------------------------------------------------------------- Known problems and limitations I don't know of any bugs or arbitrary limitiations in What'sUp. It does take advantage of some few of Newt's undocumented internals. (It couldn't do what it does otherwise.) For that reason, it may break under future OS revisions. ------------------------------------------------------------- Plans for the future I don't plan to hack Newt's internal apps so that What'sUp gets its teeth into them any deeper. It's better as an independent app. I plan to try really, really hard to keep What'sUp little. It's intended to be an overview, not a comprehensive way of manipulating the information that it shows you. All of What'sUp is byte-code and I don't plan to distribute a version that includes native ARM code. I've tried to speed up What'sUp by compiling appropriate functions into native ARM code, but since What'sUp spends most of its time walking Newt's soups it doesn't benefit much from doing that. The best I was able to do was about a 10% speed increase at the cost of about 22K of size. ------------------------------------------------------------- Revision history of the program April 13, 1996 1.2 New version released for OS 2.0. No new functionality. October 19, 1995 1.1b2 Fixed a bug in the code that opens the calendar that caused the Calendar/To Do List button to get out of sync with what was being displayed if the calendar had last been open to the to-do list. September, 1995 1.1b1 Added code to open the calendar to the appropriate day if the user taps on the day's header. September 14, 1995 Fixed a bug that could cause an error (-48402) if there were any "calendar annotations" (items in the calendar without vertical meeting bars). Now they're just ignored. August 21, 1995 Release 1.0. August 2, 1995 Initial beta version. ------------------------------------------------------------- Revision history of documentation April 13, 1996 Minor tweaks for version 1.2. September 14, 1995 Added shareware price to intro, documented bug fix. August 21, 1995 Tweaks for release. July 2, 1995 Initial cut at docs. ------------------------------------------------------------- Acknowledgments My thanks go to: Bob Wander for lots of good advice and, as usual, the kind and patient folks at Newton DTS.