MPG User Manual Preface Even though some people never look at documentation a few of you expressed an interest in documentation so I* wrote it. If you donÕt read all the documentation make sure you read the Legal Stuff section. Thank-you to Steve Nygard, Allan Marcus, and Stefan Vorkoetter. Thank you all for taking the time to look at my product. This manual is written assuming U.S. distance and volume measure, but U.K., Canadian, and metric users can just replace the mpg, mph, distance, and $ with your own countryÕs units in the manual. L/100km is the metric standard, mpg(UK/Imperial) is the UK and Canadian preference both are supported. Contact Information Hardy Macia P.O. Box 8276 Essex VT 05451, USA (802) 872-2847 eWorld/NewtonMail : HardyMacia internet : HardyMacia@eWorld.com aol: HardyMacia compuserve : 74372,1262 Legal stuff MPG (the software that this documentation describes), the related software that is included with MPG, and this documentation are all Copyright ©1994 Hardy Macia and Hardy Macia's Licensor(s). MPGª is a trademark of Hardy Macia. 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 but I advise you to read it since it does apply to all users of MPG and the related software that accompanies it. 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 Hardy Macia. You own the media on which the Software and forts are recorded but Hardy Macia and/or Hardy Macia'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 Hardy Macia'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 MPG 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 Hardy Macia 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 Hardy Macia, 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 Hardy Macia, 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 Hardy Macia and Hardy Macia's Licensor(s) (for the purposes of provisions 6 and 7, Hardy Macia and Hardy Macia's Licensor(s) shall be collectively referred to as "Hardy Macia") EXPRESSLY DISCLAIM ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. HARDY MACIA 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, HARDY MACIA 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 HARDY MACIA OR AN AUTHORIZED REPRESENTATIVE OF HARDY MACIA SHALL CREATE A WARRANTY OR IN ANY WAY INCREASE THE SCOPE OF THIS WARRANTY. SHOULD THE SOFTWARE PROVE DEFECTIVE, YOU (AND NOT HARDY MACIA OR AN AUTHORIZED REPRESENTATIVE OF HARDY MACIA) 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 HARDY MACIA 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 HARDY MACIA OR AN AUTHORIZED REPRESENTATIVE OF HARDY MACIA 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 Hardy Macia'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 Hardy Macia. About Have you ever wondered if that expensive gas works better in your car? How many times have you looked down at your odometer just to discover that it has been 20,000 miles since your last oil change? Do you need to keep track of the milage you put on your personal car for business/tax purposes? These are some of the reasons I started writing MPG. MPG is a log book for your car. It lets you keeps track of fuel, oil changes, tune-ups, inspections, tire rotations, windshield wipers, car washes trips, and other miscellaneous expenses for your car. It gives status such as average miles per gallons, total cost of gas, and average price of gas. Fuel economy is calculated for the fuel entries. Time, distance and time per distance are calculated for trips. MPG will keep track of everything you use your car/cars for. ThatÕs right cars. If you are in charge of maintance of your companyÕs fleet of cars and trucks MPG will keep track of it all for you. Installation MPG is shipped as a Newton package, which is a Newton program file. To install the MPG package onto your Newton you will need either the Newton Connection Kit, the Newton Package Downloader, or the equivalent. Refer to the instructions that came with one of these applications to determine how you need to proceed. Requirements MPG takes up 112k when installed. When not opened MPG uses about 1.5k of system heap. This is to keep track of the last entry you were at. Opening MPG on the Newton Once you have installed MPG onto your Newton, you can proceed to track your car more effectively! To access MPG, simply tap the Extras button, then tap the icon labeled MPG. Supporting Programs ScrollingDoPopup - will allow you to enter an unlimited number of vehicles, locations, categories, and purposes. PocketMoney - will allow you to post MPG transactions to it myLocale - will allow you to set the currency format if your Newton is not localized to your country. Registration Screen The first time you use MPG (and until you register it), you will be presented with MPGÕs Registration screen. If you are simply evaluating MPG and have not registered yet, simply press the Not Yet button and continue into MPG. After you register, you will be sent a registration code to "unlock" your copy of MPG. MPG is not crippled in any way except for the Registration screen appearing each time you run MPG. 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. Remember, all letters in your registration code are in lower case, so any 0's are the number zero. To register MPG you must send $20.00 to: Hardy Macia P.O. Box 8276 Essex VT 05451, USA I will accept the registration fee in cash, check, or money order. If you live outside the US then I will accept foreign currency that is equivalent to $20 US dollars or I will accept a foreign check for the equivalent of $40 US dollars. The additional $20 is to cover my bankÕs processing fee. You might also try emailing me and I might be able to give you a name of someone in your country that is on compuserve who will be able to accept payment from you and register the software via compuserve. Canadian residents can send a check payable in Candian funds, but make sure you have the current exchange rate + 2% included. It is currently about 32%. Compuserve members have can register online GO: SWREG and look for ID: 2695. The charge for online registration on CompuServe is $24. If you can send NewtonMail then sending your name card to ÒHardyMaciaÓ would also be appreciated because it will save me the hassle of writing/typing in all of your information. Creating New Entries After you pass the Registration screen you will be in the Overview screen because you have not entered any data yet. To enter data tap the new button. A popup of three choices will appears. Fuel Keeps track of your fuel consumption, economy, and costs. Trip Keeps track of your trip information. You can keep track of business trips in your personal vehicle, you can use it to measure distance and time of getting from home to work by different routes, and you can use it to enter precise directions for later recall. Misc Keeps track of maintances and other expenses to your vehicle. Maintances include oil changes, inspections, brakes. You can setup customized reminders to change your oil every 3000 miles or 3 months. Setting Up Vehicles Initially you will not have your vehicles in MPG. You will need to add your vehicle to the vehicle popup. LetÕs setup my new Porsche. IÕm saving up my shareware payments for it as I write. Tap the [i] button and select vehicle. This will open up the vehicle preference screen. Here you can enter a few things about your vehicle. You should modify the Vehicle popup to add your vehicle to it. Tap on the black diamond, select edit, tap remove to remove ÒHonda CRX-HFÓ from the default popup list, scrub (erase) ÒHonda CRX-HFÓ from the Edit Me lin, enter your own vehicle on the Edit Me line, and tap Add. Close the Vehicle Editor and tap the black diamond again and select your vehicle. Starting Milage is a reference for you only. I would enter the number of miles on the car when you bought it. A new car would be 0 and an used car might be 32,328. MPG does not use Starting Mileage for any computations. VIN - stands for Vehicle Identification Number. License Plate, Engine Size, and Tire Size are all for your reference. These are some of the things that I never remember when I need to. Set Alarm/Reminder for: tapping this label popups your list of misc. categories. By selecting one of these you can then enter the Alarm Days and Alarm Miles. For example, the recommended oil change for your car is every 7500 miles or 3 months. Select oil change from the Set Alarm/Reminder popup, select 3 months from the Alarm Days popup (notice this is translated into days), and select 7500 from the Alarm Miles popup. These alarm settings are used in the Overdue Statistics screen. The only gotcha is that you must have an oil change service entered into MPG before it can tell you when your next oil change will be overdue or upcoming. You can back date an old oil change entry. This might give you unaccurate results for some of the other statistics though. A future version of MPG will use the starting milage as a reference point for alarms that do not have a previous service item entered. Filling in the Entry Screen The entry screen is where the majority of your editing will take place. The field descriptions for the entry screen are: Vehicle These are the vehicles that you have created and are tracking. (see Appendix A for using the list editor) Payment This is the method of payment that you use to pay for a service. (see Appendix A for using the list editor) If the ÒUse PocketMoney AccountsÓ is checked in the preferences then you will see your list of PocketMoney accounts. This list is not editable from within MPG you must edit the list from PocketMoney. The advantage of using the PocketMoney accounts is that you can post your service transactions to PocketMoney and the transaction will show up in PocketMoney as a withdraw. No more double entry!!!!!! Location The location that you had the service performed on your car at, or in the case of trips it would be the start or stop of your trip. (see Appendix A for using the list editor) Odometer An odometer is the distance gauge on your carÕs dashboard. The odometer entry accepts a number for input. Odometer Checkbox (Quick Odometer) When the checkbox is not checked whatever number you write into the odometer field is entered. When the checkbox is checked then an Quick Odometer algorithm is used to allow speedier entry. Quick Odometer algorithm allows you to enter the last few digits of the odometer reading and it figures out the beginning digits for you. Quick Odometer Samples ---------------------- <> I'm not sure if you can consider it a bug. I do not have a good way to implement rolling over large milestones like 40,000 or 50,000 miles. The way that the quick odometer works is: Last Odometer You enter You get ------------- --------- -------- 32,550 60 32,560 32,550 600 32,600 32,550 200 33,200 (550 > 200 so flip thousands) (now for the problem numbers) Last Odometer You enter You want ------------- --------- -------- 39,820 ???? 40,050 ???? = if you follow the pattern you think you should enter "050", but Newton only understands "050" as "50" so Newton gives you 39,850. So, you could give it a bigger number, but the next biggest number that doesn't have leading zeros is 40,050 so you should enter 40,050 (you do Not need to deselect the box to enter 40050). Cost The cost of the service performed. For example $10 worth of gas or a $500 insurance bill. Trips do not usually have a cost assosiated with them, but occasionally I will put the enter I spent on tolls. Notes Just a general area for adding additional notes. Folder The folder that the current entry is filed in. Service Type The type of the service (Fuel, Trip, Misc) Fuel - $/gal Price per gallon is the amount for 1 gallon of gas. Fuel - Gallons The number of gallons pumped into your car during the fillup. Gallons or $/gal will be computed for you automatically is you have cost and one other field entered. Fuel - Gas Can The Gas Can button allows you to specify that you did not fill the gas tank up all of the way. If you only put a couple dollars worth of gas into the tank, but have the Gas Can showing a full tank then the mpg calculations will be off. The gas can will toggle between full tank (all black) and not full tank (half black). When MPG calculates mpg, if it sees that you did not fill up your tank completely then it will go back until it does find an entry that you filled up completely and use the sum of all of the entries to compute your mpg. Fuel - Octane The octane of the gas. The U.S. uses numbers 87,93,... Other countries use Red, Green, and Black. The statistics will break down your fuel economy based on the different octane fillups. These statistics arenÕt super accurate if you donÕt let your tank get close to empty and completely fill before you enter the different octane of gas, but the stats are interesting. Fuel - mpg or L/100km Is the fuel economy calculation based on the prior tank of gas. Fuel - Distance Similar to the trip odometer found in some cars, it shows you how far you drove between fillups. Trip - Purpose Used for the statistics to generate how many miles you used your vehicle for a specific purpose. The main use for this field is to allow you to categorize trips for tax purposes. Trip - Trip Point Trip PointÕs popup is based upon the last trip entry. Depending on what your last trip entry was the popup will change accordingly. Start Trip When you start a trip you set trip point to Start Trip. Pause Trip This allows you to take breaks in a trip. It can be used for pit stops or meetings with clients. Time and distance are ignored for mph and distance calculations during a pause/resume trip entries. Resume Trip The companion of Pause Trip is resume. When you start traveling again enter a new Resume trip entry. Distance Marker Distance Markers are used for measuring out directions. It gives you a good way to enter landmarks if you are giving directions. If IÕm using MPG to record directions I would start trip, distance marker (turn right), distance marker (turn left at 3rd light), ..., end trip. I plan on adding an option in a future version to compile these directions so that you could then fax, print, or beam them to a friend or associate. End Trip When you end a trip you set trip point to End Trip. Trip - Time The time elapsed since the start of the trip. (Does not include the time wasted in the Pause/Resume pit stops.) Trip - Distance Similar to the trip odometer found in some cars, it shows you how far you drove since the start of the trip. (Does not include the distance wasted in the Pause/Resume pit stops.) Trip - mph If you drive long distances and you like to see what your average mpg is it. Just pull out your Newton the next time a cop pulls you over and show the officer that you have only been averaging 65 miles per hour since mile marker 23 which was 15 miles back. I havenÕt had to try this yet, but if MPG gets anyone out of a ticket because of this I would like to know about it and possibly receive a big Christmas present for the money that MPG just saved you. ;-) Misc - Category A category for service reminders or any other miscellanous item that Fuel or Trip entries do not cover. For example Parking fees are not covered. You can setup reminders to check your Brake Fluid Level or your Tire Pressure every 2 weeks. You need to goto the [i]-vehicle preferences to set these alarms. Trip View Trip Example <<3. Maybe it's just me, but I can't seem to figure out how the Trip screen works. Do you create one for the start and one for the end? What info goes into the cost? Could you give me an example so I might understand it. >> You need to create one entry for the start of the trip and one for the end of the trip. The majority of the time you will not enter anything into the cost field, but I left the cost field there because once in a while I will enter the amount I pay for tolls in the trip section. An example would be (I'm at home, go to work and return home): 1. I'm still at home and I get into my car. While I'm waiting for my car to warm up I add a new trip item. Tap new-> tap trip. a. it defaults to start trip - unless you have a start trip entered without a coresponding end trip in which case it will default to end trip. b. the payment method will be blank - most of the time you will not be entering a cost, hence no payment method. c. enter "Home" for the location. You can either write it into the location field or if it is a common starting or end point then you can add it to the popup list. (tip: if you enter many different locations and you find yourself constantly scrubbing out the default value then you might find it easier to add a blank item to the location popup and set this to the default. This way it will always be blank on new entries and you will not need to scrub.) d. enter the odometer. If the check box is checked next to the odometer for intelligent entry then I will just enter the tens place of the odometer "14.3". This will be converted to "66314.3". If you don't have the box checked then you must enter the whole odometer number "66314.3". e. if I know the route to work I will be taking I enter the route into the notes field. Most of the time I leave this blank until I am actually taking the route I think I will be taking. I also enter weather conditions and traffic conditions. (rain/heavy traffic/accident) 2. When I arrive at work I enter the end trip. Tap new-> tap trip. a. it should default to end trip - because start trip was the last trip item I entered. b. enter "Work" for the location. c. enter the odometer. "26" converts to "66326.0" 3. I'm current at work or a job site and now I must enter a new trip to continue on. The easiest way to do this so that you do not need to re-enter a lot of data is to choose "Duplicate" from the action envelope button. a. it should default to start trip becuase end trip was the last trip I entered. b. the location will still be "Work" c. the odometer will still be the same d. I change the time to the current time for you Misc View Not anything tricky in the Misc View yet. You must select a choice out of the Other Item popup menu. In version 2.0 you will be able to set alarms or reminders for each Other Item item. Overview Screen The overview screen gives you a quick look at your data, a fast way to get to a specific entry, and a way to clear a large number of entries quickly. overview screen graphics To try to fit as much usefull information as possible Vehicle and Service columns truncate the data display. Tap the scroll up and down arrows to see more data. To see all of the data for one entry tap on the entry. You can go to a specific date by tapping below the date and choosing the date you wish to go to. Status Bar Buttons - The info button popup has a list of choices that show additional info. About - About will display a screen with the version of MPG that you are using and my address and technical support phone number. Prefs - Opens the prefs screen. (See Setting Preferences for more info) Vehicle - Opens the vehicle prefs screen. You can set up alarms in here. Statistics - Calculates a lot of interesting statistics. Use the up and down scroll arrows to see data that might extend off the screen. (See Statistics for more info) New - (see Creating New Entries section) Filter - (see Using Filters) Keyboard - Like in the Notepad tapping this icon will display the built-in keyboards in sequence (numeric, alpha-numeric, date, telephone). Filing Folder - MPG supports standard Newton filing. To file an item, display it in the Entry View, then press the button and file the item. See the Newton MessagePad User Guide for more information about Filing. Action Envelope - Goto First Entry - Moves you to the first entry. Goto Date - Opens the date picker so that you can select the date you wish to goto. Tapping the set button will bring you to that date or the next date found if your selected date wasnÕt found. Goto Last Entry - Moves you to the last entry. Beam - Will beam an item to another Newton. Post To PocketMoney - Will enter the current transaction into PocketMoney so that you donÕt have to!! Delete - Will delete the current item. Duplicate - Will duplicate the current item. Move to/from card - Will move an item to or from the memory card. [X] - Quits MPG. (Little [x] just closes a window) ScrollUp and Down Arrows - Will move to the next or previous entry when in the entry view. When in the overview then it will scroll a half screen of entries if possible. If it is not possible to scroll any further in either direction then a beep will sound. The filter or the balance screen are closed if you scroll when they are open in the overview. Overview dot - Toggles the screen between the overview mode and the entry view. Undo - Undo up to 2 items. When you scroll to a new item in the single entry view the Undo buffer is cleared. Find- Will allow you to search for any text in the MPG soup. The only items you can not find are costs. Costs are stored as real numbers and can not be searched on. See your Newton documentation for more information on Find. Assist - See the Assist section Statistics There are probably more statistics than you care about, but all can be interestingly useful. All statistics are only as good as the data that was used to compute it. There are 5 screens of stats. General, Fuel, Trip, Last Service, and Overdue Service. Most of the statistics assume that you have the filter set for only one vehicle. This is up to you to make sure your filter is set correctly. One time that you would probably not want the filter set for a specific vehicle is if you want the Total Vehicle Costs for all vehicles. If you get figures for Maximum Miles per Gallon or Minimum Miles per Gallon that are really high or really low you should check your data and make sure that you are not missing any fuel entries. The Save To NotePad button will save a copy of the Stats to your notepad. Use the up and down scroll arrows to see data that might extend off the screen. Overdue and Upcoming Service Statistics are based on the alarm settings in the vehicle prefs. Overdue services are any services that are overdue by either date or by mileage. Upcoming services are all services that have an entry in the Last Service Statistic that have an alarm set for them that is not already in an alarm state. Setting Preferences The preferences allow you to change the default behavior of some items. Defaults for New Entries - Changing the Payment, Vehicle, Fuel&Misc Location, Location, Purpose, Octane, and Category pick list will change the default behavior of New. Fillup Decimal Places - different countries use a different number of decimal places. The default is 3 in the U.S. Units - Default will use the extras->prefs->locale setting. For most users this is fine. I added Metric, U.S., and British if you want your locale different than what you are using in MPG. Compute for Fillups - you can either have gallons or the price per gallon computed for you when the cost field is changed. This is how you set it. The default is gallons. When IÕm filling up my tank I enter the odometer, price per gallon while IÕm waiting for the tank to fill. When the tank is full I then enter the cost as I walk up to pay for the gas. [ Ã ] Automatically Close Date Editor - will close the date editor when you tap Set Date if this is check. If it is unchecked then the date editor will stay open until you close it. [ Ã ] Scroll full page in the overview - the overview will scroll a full page of entries minus one when this is checked. If unchecked it scrolls an half page of entries at a time. [ Ã ] Use PocketMoney Accounts - will use the accounts that are setup in PocketMoney if you have PocketMoney installed. Delete List Deletes all of the items from the current filter. Because it deletes many items this is NOT UNDOABLE so be certain this is what you wish to do. Using Delete List. Set the filter to select the items you wish to rollup and the choose Delete List. The found items will be counted. You will be prompted if you wish to delete x number of items. Tap ok. You will be reminded that this is NOT UNDOABLE and if you wish to continue. If you wish to delete all of the items then tap ok. Using Filters Filters allow you a powerful way to display subsets of entries. You can set the filter to show you only the fuel entries between Dec. 21 and March 21 to see your fuel economy for winter driving and then you can set the dates to be from March 21 to June 21 to see how your spring fuel economy compares to your winter fuel economy. MPG dynamically updates the views every time the Newton redraws the screen. This means that if you change a value that does not conform to the current filter, the items will not appear in the Overview or Entry View after you scroll. Using the filters is very easy. You just pick which conditions you would like displayed and tap Set Filter. Tapping the close box will leave the filter unchanged. The Dates From and Dates To filters are inclusive. If you want to see all dates both Dates From and Dates To must be blank. Clear Filter was added which will turn off all filters. Filters are also saved accross reboots. After setting the Vehicle, Service, Location, Dates Fro, Dates To, Category, and Purpose options you have 2 choices. You can either Save the current settings by tapping save. This will prompt you for a filter name which will be added to the popup list of filters. Or, you can tap Set. Tapping set will close the filter window and set the filter to options that you have selected. Remove will popup the list of saved filters allowing you to delete one. I do not prompt you if you really want to delete the filter because it is simple enough to enter it again. Clear will reset the filter to show all entries. Dragging Windows You can drag all windows by tapping within 10 pixels of the boarder of the window and dragging the window to where you want it. Looking at the above graphic of the Filter window you would tap not on the grey or black of the border, but in the white space right next to the grey. The window position will be remembered until the next time you reboot the Newton. Appendexes It didnÕt make much sense to keep the title to the appendexes A,B,... in the table of contents for the Newton Book so IÕm just going to mark the start of the appendexes with the ÒAppendixÓ item. Appendix A Editable Popup lists The editable popup list is one of the outstanding features of PocketMoney and MPG. These popup lists are completely user definable using a fairly simple interface. Picking Edit out of the popup list will bring up the list editor so that we my add, change or remove list items. Above (starting at top left -> top right -> bottom left -> bottom right) is a sequence of steps that was used to change ÒFirst Fidelity SavingsÓ to ÒSavingsÓ. This example is from PocketMoney, but the same sequence applies to MPG. On the Edit Me line you can either write in or select from the popup the item you wish to add, change, or remove. If your entry is in the popup list then the soup is searched and returns the number of items found. If no items were found, but your entry appears in the popup list then the button will change to Remove allowing you to remove it from the list. If your entry does not appear in the list then the button will change to Add allowing you to add it to the list. If items were found then the Change To appears as in the above graphic. You can then write in or pick from the list an item to change it to. If the item written in is not in the list then a new item will be added to the list when you tap the Change button. The latest version of the Array Editor allows you to change or remove an item if it finds matches in the soup. This allows you to keep your lists small if you have a lot of closed accounts, but still have your data stored in the soup. Appendix B Using The Date Editor The interface should be familiar. It almost the same as in the Date and Time preference in the Newton Preferences so I will be short on explanations. Left Arrow Moves the calendar to the previous month. Right Arrow Moves the calendar to the next month. Numeric Day Tapping a day on the calendar will hilite the new day. Big Hand (Outer clock circle) Changes the minutes on the clock. Little Hand (Inner clock circle) Changes the hours on the clock. AM and PM buttons Toggles between am and pm. Today/Now button Sets the calendar and clock to the current day and time. Set Date Enters into the date field the date and time you have set in the date editor. Depending on the preferences set this button might also close the date editor. X Closes the date editor. Date Editor Preferences In the preferences for PocketMoney is a preference for the Date Editor. [ Ã ] Automatically Close Date Editor - will close the date editor when you tap Set Date. [ ] Automatically Close Date Editor - tapping Set Date will not close the editor. Allowing you to scroll through the entries making mass changes to the dates. Appendix C Newton Connection Kit Support If you sync with the NCK you will see MPG as an soup that you can export and edit. Due to the limitations of the current NCK you can only edit the common fields of Misc, Fuel, and Trip entries which means that you canÕt enter gallons or trip point or category. But, you can import and export all of the fields. Please refer to the NCK documentation for creating import and export templates. Appendix D Programmer Stuff If you wish to add stuff to the MPG soup you are welcome to. Just follow the guidelines and all should be well. DonÕt forget to call BroadCastSoupChanged. The soup MPG uses is ÒMPG:VtHickÓ. Soup Entry Structure The basic fields of a MPG entry are: Label : used by filing system - system defined ServiceType : Ôsymbol : ÔFuel, ÔTrip, ÔMisc Date : Ôint : the transaction date Vehicle : Ôstring : the vehicle name/make/model PaymentMethod : Ôstring : the type of payment used Location : Ôstring : the location of the service or location of the trip point Odometer : Ôreal : odometer of the vehicle Cost : Ôreal : cost of the service Description : Ôtext : memo field for lengthy descriptions For Fuel entries these additional fields are required. Note $/gal is not included becauseit is calculated from Gallons and Cost: Gallons : Ôreal : the volume of fuel entered into vehicle Octane : Ôstring : the octane of the fuel entered For Trip entries these additional fields are required: TripPoint : symbol: ÔStart Trip, ÔEnd Trip, ÔPause Trip, ÔResume Trip, ÔDistance Marker. Purpose:Õstring : the user can use this for what they want. For Misc entries these additional fields are required: Category : Ôstring : a category for misc items Appendix Z Uninstalling MPG Hopefully everyone will think MPG is the most useful package ever written and no one will ever need to uninstall MPG, but for those of you who must uninstall MPG I will give you instructions. You will need to install an utility such as RemoveIt!, StewPot or Souper. I recommend RemoveIt! 1. Run RemoveIt! 2. Set the display to packages, select MPG:VtHick and tap remove item. 3. Set the display to soups, select MPG:VtHick (internal) and (the Card), and tap remove item(s). 4. Set the display to system soup, select MPG:VtHick and tap remove item. 5. The next Synchronization you do with the Newton Connect Kit you need create a fresh backup. You make a fresh backup by renaming the folder (ÒHardy MaciaÕs NewtonÓ) to Òold synchÓ and then run the sychronization. The above instructions will remove every trace of MPG from your Newton. If you delete only the MPG package your data will be preserved. This means the MessagePad Classic and MessagePad 100 users who only have 150k of ram and no memory card can swap out packages without worrying about losing the data.