Time of the MonthFrom Burr Oak SoftwareVersion 1.1.1© 1995 Wendy Stevenson, All Rights ReservedAboutTime of the Month allows the Newton user to produce a paper calendar, containing days that the user has added drawings or writing to.  TotM is great for use by teachers, Scout leaders or anyone who needs to distribute a real month-at-a-time event type calendar to others.New in Version 1.1.1- fix bug which caused problems trying to use TotM v1.0 calendars with v1.1New in Version 1.1- fixed locale problems for locales other than Canada/US- reduced chance of FAX timeout- added the ability to mark certain days as important- added the ability to import and export calendar information- For registered users, import and export calendar information on a per month basisInstallationFollow the directions in the Newton Package Installer for Macintosh or Windows, available on most online services.AcknowledgmentsTime of the Month uses the protoRegisterFloater sample code from Hardy Macia - a nice neat way of doing shareware registration.Thanks to those whoÕve sent mail with suggestions, and bugs!Suggestion credits:	edable@aol.com		- day note support	KIwatate@eWorld.com	- the ability to mark days as important	Stephen Richards 	- import of regular calendar dataBug credits:	Pokeymail@eWorld.com - locale problems	pierre-yves.debliquy@ArthurAndersen.com - locale problems	RegistrationThe first time you use Time of the Month (and until you register it), you will be presented with Time of the MonthÕs Registration screen.   If you are simply evaluating Time of the Month and have not registered yet, tap the Not Yet button and continue into the program.  After you register, you will be sent a registration code to "unlock" your copy of Time of the Month.  Time of the Month is not crippled in any way except for the Registration screen appearing each time you run it, and a small shareware notice on each calendar you print.  After you unlock your copy, shareware notices will no longer be displayed, or printed.Although Time of the Month is not crippled, certain ÒbonusÓ features may be added for registered users.  After your copy is unlocked, you will have access to these features.If you have registered, enter your registration code on the Registration screen.  Enter the code exactly as it appears on your registration notice.  When your code is entered correctly, press the Register button.  The registration code is purely numeric (does not contain any characters).To register Time of the Month  you must send $15.00 U.S. (or $20 Canadian) in cash, check or money order to:		Burr Oak Software		P.O. Box 1700		Oxford Station, Ontario CANADA  K0G 1T0You may also register using Newton Register, which is included in the shareware distribution of Time of the Month.How to edit a calendarGeneralTime of the Month always presents a view of a month in a Òpaper calendarÓ format.  Tapping on a particular day brings up an edit window in which you may draw, or enter text.  When the edit window is closed, the user-entered input is saved for that day, and the day is shaded to indicate that there is information associated with it.An arrow button on each side of the month allows you to go forward (the right arrow) to the next month or backwards (the left arrow) to the previous month.  Tapping on the month name itself will present you with a pickable list of months, 6 months before the current one, and 6 months after.  Tapping on one of the months in that list will take you to it.The drawing boardUnderneath the day edit window is a larger editing window, called the Òdrawing boardÓ.  Contents of the drawing board are saved between uses of TotM, and between days.  It is used to give a larger area to work in (especially for handwriting recognition).When text or drawings are entered onto the drawing board, they may be selected and copied or dragged into the day edit window.The drawing board is also useful for scaling drawings, to fit in the day edit window.  Please consult your MessagePad handbook for information on selecting, copying dragging, etc.Recognition when editingRecognition during day-editing may be controlled by the typical Newton buttons on the status bar - letter-by-letter, handwriting recognition on/off and shape recognition on/off.Editing ButtonsThree buttons are displayed on the editing window - ÒClearÓ, ÒStylesÓ and ÒCopyÓ.  Clear removes any input currently entered for the day.  It does not clear the drawing board.  Styles invokes the Newton styles palette in order to change text size, font, etc or pen width.  Note that if you have a drawing (or text) selected, you can use the styles palette to change the width of lines, or text size/font of the selected drawing or text.Copy allows you to copy the contents of a day into another day.  Note that this is a destructive copy - that is, any existing contents of the target day will be overwritten.  Copy displays a ÒCopy Day ToÓ window with a picker for the months, and an input line for the day.  To copy, select the proper month, enter the proper day, and tap the copy button.  You may make multiple copies simply by changing the day/month and tapping copy again.Copy will copy imported calendar data, but that data will not be associated with the calendar - i.e. Time of the Month will not know if the data contains repeating day notes, etc, and will allow all of the data to be exported as calendar day notes.Import/Export ButtonsThese buttons allow the importing of data from the built-in Newton calendar into Time of the Month, and the exporting of text to the built-in calendar as day notes.When data is imported, Time of the Month keeps track of its origin - for example a day note or repeating meeting.  When day notes are imported, their text may be modified within Time of the Month, and when exported, the text of the corresponding day note in the built-in calendar will be changed.  Also, a day note imported into Time of the Month will be deleted from the built in calendar, if it is deleted from Time of the Month and then an export performed.Tapping the Import button  (the button to the left of the day) will import any built-in-calendar information into the current day.Calendar information is always inserted at the same point in the day - approximately 1/8Ó below the numeric day.Import follows these rules:- up to 6 ÒmeetingsÓ or day notes will be imported- the first two can take up up to two lines in the day (if they would wrap).  In this case, only 4 meetings or notes in total can be imported- the next ones will take up one line (and if they wrap will end in Ò...Ó- calendar day notes are imported first, followed by repeating day notes, regular meetings and repeat meetings- the font for imported day notes is ÒfancyÓ (New York).  The font for other imported calendar data is ÒsimpleÓ (Geneva)Imported calendar information will overwrite any existing text or graphics currently in the day.  Tapping ÒundoÓ after import will cause the imported text to be removed if it is found to collide with existing input.Calendar information is imported in 9pt text.Tapping the Export button (the button to the right of the day) will cause any text currently in the day to be exported as day notes to the built-in calendar.Performing an export will remove any existing day notes in the built-in calendar for that day, if they do not exist in the Time of the Month day being exported.Repeating day notes are not exported.Regular calendar meetings and repeat meetings are not exported.Marking days as importantTapping the Òmark this day as importantÓ checkbox will cause the day to be highlighted both when displayed and when printed.  Highlighting consists of a shaded box enclosing the numeric date for the day.  Days in the month view will also be shaded slightly darker when marked as important.Days may only be marked as important once they contain text or drawings.Drawing outside the day boundsWhen drawing in a day in the editing window, it is possible to extend the drawing outside of the bounds of the day.  This will be carried over to the printed version of the calendar and allows for some interesting results.The Action ButtonPrint MonthThis allows you to print the calendar.  The calendar is printed in the typical Òprinted calendarÓ format in much the same way as youÕd get from your insurance company or mechanic.The printed output may be previewed before printing by tapping the Preview button in the print dialog.  Be warned that this consumes a fair amount of Newton heap memory, and you may be presented with the dreaded Ònot enough memoryÓ dialog box.  In this case, you may need to reset your Newton and try again.  You may also find that exiting Time of the Month (while the print dialog is still displayed) will give you enough memory to see the preview.FaxThis is similar to Print Month, but instead faxes the printed calendar.Import(Available only to registered users)Selecting Import imports all built-in calendar information from the built-in calendar into the appropriate days for the month currently being viewed.For further information regarding import rules, see the section in this guide entitled Import/Export Buttons.Note that import can take 1 or slightly more seconds per day in the month, so be patient while a full import is taking place.  This is due in part to the large number of calculations done when importing repeating day notes and repeating meetings.Export(Available only to registered users)Selecting Export exports all text in days belonging to the current month to the built-in calendar as day notes.Performing an export will remove any existing day notes in the built-in calendar for that day, if they do not exist in the Time of the Month day being exported.DeleteThis deletes the month currently displayed.  All user-entered data for the month which is filed in the current folder is removed.  For information on folders, see ÒFilingÓ later in this document.AboutDisplays the Time of the Month about page.RegisterDisplays a registration dialog if you havenÕt already registered.  If you have registered, a notification is given telling you so.FilingOne (and only one) calendar for each month may be filed in each of the files which you have set up.  For example, it is possible to have one ÒPersonalÓ calendar in the Personal file, and one ÒBusinessÓ calendar in the Business file.  Filing is performed through standard Newton operations.Changing the calendar viewedTo display a calendar from a different file, tap the folder tab at the top of the screen (by default, upon entry into Time of the Month, the file viewed is ÒUnfiled MonthÓ.  When this is tapped, a list of file folder names will be displayed.  Tapping a file folder name will cause Time of the Month to retrieve and display the calendar for that file in for the currently displayed month.When the file folder is changed, all new user input to the calendar is saved in the calendar in that folder.Filing the calendarTo file the calendar for the currently displayed month in a different folder, tap the ÒFolderÓ button on the Newton status bar.  The ÒFile this month in...Ó dialog box will appear, allowing you to select the folder in which to file this month.  Tapping the appropriate radio button, and then the File button will cause the month to be filed appropriately.Only one calendar allowed per file.Since only one calendar per month is allowed in each folder, filing a month in a folder will remove any existing month in that folder.  When filing is performed, a dialog box will warn you of this if there is existing information for the current month, and allow you to cancel the operation.  Other NotesTime of the Month was tested on both a MessagePad 100, and a MessagePad 120, both running system 1.3.  Printers tested were the Personal LaserWriter 300, and HP LaserJet.FuturesIf there is sufficient interest in Time of the Month (i.e. sufficient registrations!), we will consider adding the following features:¥ a fast way to enter a line of text¥ a zoomable day editing window¥ built in clip art¥ text notes on a per-month basis, on the calendar¥ landscape mode (NewtOS 2.0?)Disclaimer & LicenseTime of the Month and this documentation are all Copyright ©1995 by Wendy Stevenson.  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.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 Wendy Stevenson. You own the media on which the Software and fonts are recorded but Wendy Stevenson and/or Wendy Stevenson'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 Wendy Stevensons'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. 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 for a nominal download or duplication charge the unregistered Shareware version of Time of the Month as long as it is accompanied by this documentation. 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 Wendy Stevenson 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 Wendy Stevenson, 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 Wendy Stevenson, 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 Wendy Stevenson and Wendy Stevenson's Licensor(s) (for the purposes of provisions 6 and 7, Wendy Stevenson and Wendy Stevenson's Licensor(s) shall be collectively referred to as "Wendy Stevenson") EXPRESSLY DISCLAIM ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. WENDY STEVENSON 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, WENDY STEVENSON 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 WENDY STEVENSON OR AN AUTHORIZED REPRESENTATIVE OF WENDY STEVENSON SHALL CREATE A WARRANTY OR IN ANY WAY INCREASE THE SCOPE OF THIS WARRANTY. SHOULD THE SOFTWARE PROVE DEFECTIVE, YOU (AND NOT WENDY STEVENSON OR AN AUTHORIZED REPRESENTATIVE OF WENDY STEVENSON) 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 WENDY STEVENSON 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 WENDY STEVENSON OR AN AUTHORIZED REPRESENTATIVE OF WENDY STEVENSON 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 Wendy Stevenson'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 Wendy Stevenson.