home *** CD-ROM | disk | FTP | other *** search
/ InterCD 2000 May / may_2000.iso / Palm-Pilot / Applications / calcdemo / Manuals / SCNotes.txt < prev    next >
Encoding:
Text File  |  1999-03-11  |  17.5 KB  |  383 lines

  1. SynCalc for Palm OS 
  2. Release Notes and Instructions
  3. 3/11/1999
  4. SynCalc Release Version 1.59.
  5. ⌐1997-98 Synergy Solutions, Inc. All Rights Reserved.
  6.  
  7. If you are having trouble using the Manuals included in this archive, 
  8. you may want to try viewing them online at the SynCalc homepage:
  9.  
  10. http://www.synsolutions.com/products/syncalc/
  11.  
  12. SynCalc is a valuable addition to your PalmOS device. This version has
  13. passed the Platinum Certification Test for PalmOS.  Please visit the
  14. SynCalc homepage to learn about the  product and download useful
  15. Shortcuts and plugins.
  16.  
  17. SynCalc's manuals are in HTML and are included with this distribution.
  18. To get to these manuals, open the README.HTML file in any web browser.
  19. These manuals are also available online at the above web site.
  20.  
  21. Other ways to contact Synergy Solutions, Inc.
  22.  
  23. Web:  http://www.synsolutions.com
  24. email:  info@synsolutions.com
  25. Phone: 1-800-210-5293
  26.  
  27. System Requirements:
  28. PalmOS 2.x or greater (yes, SynCalc works perfectly on a Palm III, IIIx, and V).
  29. Sorry, but no 1.x version will be made, as Plugins REQUIRE OS 2.x or
  30. greater. SynCalc requires 71k of memory for a minimal install (no
  31. plugins).
  32.  
  33. To use SynCalc, you should install the following files onto your
  34. PalmOS device:
  35.  
  36. - SynCalc.prc (required) - this is the SynCalc application for PalmOS 2.x
  37. - MathPlugin.prc (optional) - this plugin contains trig, log, and
  38.     other useful math functions. This math plugin is based on MathLib
  39.     by Rick Huebner, which is covered by the GPL (Gnu Public License).
  40.     Full source code is available at
  41.     http://www.synsolutions.com/products/syncalc/plugins.html
  42. - BaseConvertor.prc (optional) - this plugin contains conversions
  43.     for Hex, Octal, and Binary numbers.
  44. - LogicPlugin.prc (optional) - contains logic function if() and
  45.     iftext() for conditional testing.
  46.  
  47. If you need help installing this application onto your PalmOS device,
  48. read our installation instructions at:
  49.  
  50. http://www.synsolutions.com/support/install.html
  51.  
  52. A web page on the SynCalc web site, at
  53. http://www.synsolutions.com/products/syncalc/shortcuthowto.html,
  54. explains by example and in detail how to write great shortcuts for
  55. SynCalc. It's good reading, and will certainly make you a better person,
  56. or at least a better SynCalc user.
  57.  
  58. INTERNATIONAL USER NOTICE
  59. SynCalc's default shortcuts use US-English number formatting, meaning 
  60. they may not work properly with your preferred numeric formatting.  This 
  61. is also true of many of the shortcuts on our web site, as they are generally 
  62. US-English formatted.  You can correct the problem by 'translating' the 
  63. necessary characters to your local format.
  64.  
  65. For support or more information, please visit our web site at
  66. http://www.synsolutions.com. The SynCalc pages are at
  67. http://www.synsolutions.com/products/syncalc/syncalcextras.html
  68.  
  69. Sincerely,
  70.  
  71. Alan Pinstein
  72. Synergy Solutions, Inc.
  73.  
  74. Version History:
  75. Version 1.59
  76. - Fixed several underflow bugs which caused intermittent crashes when double-tapping, triple-tapping, or deleting characters in the main expression field with the delete button.
  77. - Added a factorial function to the MathPlugin.
  78.  
  79. Version 1.58
  80. - Fixes a parsing bug involving parenthesis and exponents.
  81. - Parenthesis parsing no longer requires closing parentheses; any unmatched 
  82.         open parentheses will be automatically closed out at the end of the expression.
  83.  
  84. Version 1.57
  85. - Fixes a bug which affected number formatting in the following case: the 'sci' 
  86.         method is NOT selected, but the size of the number forced it to report as scientific.
  87. - Improvements in memory handling improves performance on PalmPilot Personal 
  88.         Edition organizers.
  89.  
  90. Version 1.56
  91. - Fixed a bug in which a crash would occur if the cursor was in a non-empty
  92.     text memory location at the time of execting the 'Clear Everything' command.
  93. - Fixed a parsing bug affecting parentheses parsing. Everyone should upgrade!
  94.  
  95. Version 1.55
  96. - Version certified by Quality Partners, Inc. for Palm OS, Platinum Level.
  97. - Fixed a number of bugs relating to low memory conditions.
  98. - Fixed a bug which would cause SynCalc to crash upon choosing a shortcut.
  99. - Improved memory handling.
  100.  
  101. Second Release version:
  102. - v1.54, 5/25/98. Final Candidate for submission to Platinum Certification by Quality Partners, Inc.
  103. - Many bugs relating to low memory conditions in the data heap have been fixed.
  104. - Fixed some localization bugs involving drag and drop of the answer.
  105. - Added scroll bars to Add and Edit shortcut views.
  106. - Added the ability to save the current view and return to it across launches.
  107.  
  108. First Release version:
  109. - v1.53, 5/4/1998
  110. - Fixed localization problems caused by PalmOS bug... Added support for
  111. localized number formats which changes SynCalc's buttons to localized
  112. separators.
  113. - Changed Parser Error Dialog to only show error # if it is an UNKNOWN
  114. error.
  115. - Decreased stack usage of Parser Error Dialog which could cause a crash
  116. under the following condition: in an input query dialog with a parser
  117. error dialog displayed while an alarm goes off.
  118.  
  119. New Features in 1.5b15:
  120. - The operators in the "2nd" button panel now correctly add "Ans" as the
  121. main operators do.
  122.  
  123. Bug Fixes in 1.5b15:
  124. - Fixed a few UI bugs and very rare error conditions which can cause
  125. crashes. 
  126.  
  127. New Features in 1.5b14:
  128. - Added a new button in the "2nd" panel for x^-1
  129. - Re-wrote the part of the parser which turns numbers into floating
  130. point type to avoid using the Palm OS call FlpAToF() which supports only
  131. 8 digits of precision and exponents of +/-99. SynCalc now uses 14 digits
  132. of precision with an exponent of +/-308.
  133.  
  134. Bug Fixes in 1.5b14:
  135. - Fixed a rare error (not so rare on Palm III) that would cause certain
  136. text strings to not behave properly. One symptom of this was the failure
  137. of plugin functions to work on Palm III.
  138. - Rearranged the method for doing the Input Query which was causing
  139. crashes on PalmPilotPersonal editions. Should be more stable and
  140. reliable than ever. 
  141.  
  142. New Features in 1.5b13:
  143. - Changed the Rotate Buttons motif into the 2nd button motif. I think
  144. it's a little more intuitive, and frankly I needed the room for the next
  145. new feature:
  146. - Added operators for logic comparisons , bitwise operations, and
  147. equality/inequality comparisons. These are useful for conditional
  148. results, which can now be implemented with the if() and iftext()
  149. functions of the LogicPlugin.
  150.  
  151. Bug Fixes in 1.5b13:
  152. - Multiple arguments for plugins would evaluate right-to-left in b12.
  153. This has been fixed. 
  154.  
  155. New Features in 1.5b12:
  156. - Greatly improved memory management and re-written evaluation code now
  157. allows for an UNLIMITED number of nested function calls. Unlimited
  158. nested parentheses were previously allowed. This enhancement also allows
  159. SynCalc to be fully functional on a PalmPilot Personal. Previously,
  160. SynCalc would run out of memory and sometimes crash on a PalmPilot
  161. Personal.
  162.  
  163. Bug Fixes in 1.5b12:
  164. - Fixed a parsing bug in which the store operator, if used multiple
  165. times in succession, would not cause an error.
  166.     Ex: 1@@@c should be an error, but SynCalc would evaluate it
  167. anyway.
  168. - Improved the accuracy of the highlighting/cursor position when a
  169. syntax error occuered.
  170. - Fixed a UI bug in the drag-n-drop which allow text dragged from the
  171. input field to be dropped within the selection (at the location of the
  172. next to last character of the selection).
  173. - Added checks for low memory conditions which could sometimes cause a
  174. crash.
  175.  
  176. New Features in 1.5b11:
  177. - Revised the import functionality to use standard .pdb files for
  178. improved ease-of-use. Simply installing shortcut DB's onto your PalmOS
  179. device and choosing "Import Shortcuts" from the menu will automatically
  180. install them in SynCalc.
  181. - Added the ability to export shortcuts from within SynCalc. The "Export
  182. Shortcuts" menu choice will allow you to choose a name for the export
  183. database and select up to 50 shortcuts for export. The export DB's will
  184. automatically be copied to the desktop during the next HotSync.
  185. - Added a few new functions to the MathPlugin:
  186.     round()
  187.     ceil()
  188.     floor()
  189.     Descriptions can be found in the Function Browser
  190. - Added a feature to Macros: you can force the expression field to Clear
  191. before starting a macro by making the first character of the
  192. macro/shortcut a capital 'C'.
  193. - Various speed improvements in the Plugin Manager which have improved
  194. launch time of SynCalc.
  195.  
  196. Bug Fixes in 1.5b11:
  197. - Complete testing has been done. SynCalc is now free of memory leaks,
  198. corruption, etc., which could occur in some circumstances in earlier
  199. versions.
  200. - Fixed a bug in which out() with no arguments would cause a crash.
  201. - Fixed all UI bugs in the DragAndDrop routines.
  202.  
  203. New Features in 1.5b10:
  204. - Added the ability to import shortcuts. SynCalc will import shortcuts
  205. which have been copied to the clipboard from an application such as
  206. MemoPad. They should follow this format: <nevermind>
  207.  
  208. - Added a text console. Use the out() function to add text to the
  209. console.
  210. out(text, argument 1, argument 2, ... )
  211.  
  212. It takes in a minimum of _1_ argument, the string to output.
  213. out(Hello world)
  214.  
  215. Adds the text "Hello world" to the console.
  216.  
  217. The rest of the arguments, above labelled argument 1, argument 2,
  218. etc.... are for outputting NUMERICAL VALUES.  SynCalc will evaluate each
  219. argument and output the answer.
  220.  
  221. Since the out() function doesn't know automatically where to write out
  222. the number, we use the marker '%n' to signify where the number should go
  223. in the string.
  224. - Let's assume a = 3.5
  225. out(The value of a is: %n, a)
  226.  
  227. would write "The value of a is: 3.5" in the console.
  228.  
  229. You can have as many arguments as you like. They are output in order
  230. from left to right:
  231. -Let's assume b = 10
  232. out(A is: %n and B is: %n, a, b)
  233. would write "A is: 3.5 and B is: 10" in the console.
  234.  
  235. There are a couple of more features:
  236. 1) You can format the output of numbers as any of the Four display types
  237. that SynCalc supports:
  238. n = normal
  239. s = scientific
  240. f = fixed
  241. h = hexadecimal.
  242. 2) To make for pretty formatting, I've enabled \t for tab and \n for
  243. carriage return.
  244.  
  245. The end-all be-all of examples:
  246. Assume a=8.123
  247. out(A in normal:\t%n\nA in fix:\t%f\nA in sci:\t%s\nA in hex:\t%h\n, a,
  248. a, a, a)
  249.  
  250. Would add this to the console:
  251. A in normal:    8.123
  252. A in fix:        8.123000
  253. A in sci:        8.1230000e00
  254. A in hex:        00000008    
  255.  
  256.  
  257. Bug fixes in 1.5b10:
  258. -Fixed a few major memory problems that could have been troublesome in
  259. certain situations.
  260.  
  261. New Features in 1.5b8: - Drag and Drop has been
  262. completely re-written. It's actually quite cool now, if I do say so
  263. myself! Previously, to perform a drag, you needed to hold the pen down
  264. within the bounds of the field very steady for a second or so so SynCalc
  265. would know you wanted to drag something.  Now, it works just like your
  266. desktop computer! You must make a selection, then start the drag by
  267. placing the pen within the highlighted area. Then you may drag the
  268. selection wherever you like, to a button, to another spot in the same
  269. field, etc. When the pen is over a field, whether dragging from a button
  270. location or from the field itself, a small indicator shows where the
  271. text will be dropped.  I've written this with the intention of creating
  272. a HACK out of it to enable text dragging throughout the OS. If you're
  273. interested in this capability, please let me know! - The SynCalc Plugin
  274. API will be published this week. Anyone interested in writing plugins?
  275.  
  276. Bug fixes in 1.5b8: - Fixed the width of the memory table in the memory
  277. view to fit on screen. - Clear all menu choices in the memory view works
  278. properly now.
  279.  
  280. New Features in 1.5b7 - Added  support for the input() function, which
  281. will prompt the user for input along specified places in the expression.
  282. Great for common calculations! Example: Make a shortcut with the value
  283. "input(Cost of Meal)*0.15=" When invoked, this will prompt you to enter
  284. a value, then compute the rest of the expression and display the answer.
  285. This input form can also handle EXPRESSION input, with the full suite of
  286. error reporting. Try it, I promise you'll love it! - Added the ability
  287. to display variable values in the view memory screen. - Improved memory
  288. management dramatically.
  289.  
  290. New Features in 1.5b6: - Answers separated by commas are now localized
  291. according to the System Prefs. - Added a SynCalc guided tour under the
  292. SynCalc button. I'd recommend that everyone try it- it goes over all of
  293. SynCalc's features. - As an addition to the below feature, SynCalc now
  294. supports an '=' ANYWHERE in memory expressions, shortcuts, etc, as a way
  295. to toggle evaluation.  This adds some scriptability to SynCalc, albeit
  296. limited. <snip> An important addition is the ability to append an '=' as
  297. the last character of a shortcut (or memory location, for that matter)
  298. to have the expression evaluate immediately. See the built-in shortcuts
  299. for examples (if you don't delete the old SynCalc first, you won't have
  300. the new default samples). </snip> - Added a menu to the calculation log.
  301. Supports 'Copy All' to aid in exporting calculation history to another
  302. application. - MAJOR CHANGE: The hard scroll buttons now scroll through
  303. historical calculations. This allows all calculations in the log to
  304. easily be browsed from the main interface. - I've changed the way that
  305. plugin functions are called to be more memory efficient. As opposed to
  306. the old limit of 1 recursion, the limit is now memory-based, and works
  307. up to about 8 recursions, which I think will be plenty for nearly
  308. everyone.
  309.  
  310. Bug Fixes in 1.5b6: - SynCalc now recognizes a know bug in the PalmOS
  311. floating code and corrects for it. This bug occurred when the mantissa
  312. of the number was 99999999, but would get rounded to 100000000, which is
  313. a 9-digit mantissa. This would cause SynCalc (and does cause some other
  314. PalmPilot calculators) to be off by a power of ten in this case. - Fixed
  315. a bug which caused a fatal exception when dragging a blank memory
  316. location to the expression field.
  317.  
  318. New Features in 1.5b5: - Added the ability to comma-separate numbers in
  319. the answer display. Will localize in the next version. - Added help
  320. strings for PluginSample functions. - Added support for radians/degrees.
  321. - Removed hyperbolic functions from plugin to conserve space. They'll be
  322. issued in a separate plugin. - Constants are now Shortcuts. They can be
  323. used as constants, macros, or text expression storage, up to 30
  324. characters each. An important addition is the ability to append a '=' as
  325. the last character of a shortcut (or memory location, for that matter)
  326. to have the expression evaluate immediately. See the built-in shortcuts
  327. for examples (if you don't delete the old SynCalc first, you won't have
  328. the new default samples).
  329.  
  330. Bug fixes for 1.5b5: - Fixed a parsing bug with the MINUS operator due
  331. to a typo- sorry if it affected any of you adversely.
  332.  
  333. New Features for version 1.5b4: - Completely redesigned UI to optimize
  334. space for plugin functions. - Added a comma button for separating
  335. arguments for functions. - PluginSample.prc implements 20 trig and
  336. math functions. - Support for the power operator '^' *NOTE: power
  337. associates from left to right: 1^3^3 = 1 - Implemented PalmOS 2.0 scroll
  338. bars for the expression field.
  339.  
  340. Bug fixes for version 1.5b4: - The GUI bug in the prefs screen is
  341. ACTUALLY fixed this time. - Fixed a variety of errors with the Plugin
  342. browser and printer tape code. Improper clean-up was occuring if one
  343. switched apps while either of these forms were on screen, resulting in a
  344. crash.
  345.  
  346. New Features for 1.5b3: - Addition of on-line help to the Plugin API. -
  347. Addition of a printer tape window for logging historical transactions. -
  348. Both of the new functions can be accessed via the menu or the 'SynCalc!'
  349. button. - Other tweaks.
  350.  
  351. Bug Fixes for 1.5b2: - Fixed a memory leak in certain types of errors. A
  352. symptom of this was for the screen to go mostly blank. - Fixed Pi to
  353. have more significant digits.  You must delete the old SynCalc DB and
  354. re-install SynCalc to get the new Pi. - Fixed a problem which prevented
  355. the use of more than 1 alpha in an equation, although it should be
  356. allowed. ex-> Sqrt(2) + Sqrt(2) is legal, but beta 1 would throw an
  357. error. - SynCalc now properly detects overflow, underflow, or div/0
  358. problems. This fixed a bug in which a number such as "--177732973475056"
  359. would be displayed as an answer. - Fixed all rounding errors. - Fixed a
  360. UI glitch in the Prefs screen which left a few pixels when switching
  361. from 7 digits fixed to a smaller number in some cases.
  362.  
  363. New Features in v1.5b1: -Support for a plugin architecture. This allows
  364. addition of an unlimited number of functions for SynCalc.  This
  365. architecture supports multiple argument passing, as well as expression
  366. evaluation within these arguments: Average(2,5,6,7+1*5). -SynCalc now
  367. supports 26 user-defined variables. They are lowercase 'a'-'z'. To store
  368. a number in a variable, use the store operator('@'): 155.123@a stores
  369. 155.123 in 'a'. You may also store expressions in variables, as well as
  370. continue with an expression: 1+2@a+5@b will store 3 in 'a' and 8 in 'b'.
  371. -SynCalc's parser has been updated to correct a few bugs. There are no
  372. known bugs with the parser at this time. --> A check has been added for
  373. loss of precision: PalmOS only supports 8 digits of precision at this
  374. time. --> Error handling has been vastly improved: the location of the
  375. error is now highlited in the expression field and the cursor is moved
  376. to a relevant position.
  377.  
  378. -A function browser has been added, although the 'About' is not yet
  379. implemented. -The UI has been generally improved: the answer has moved
  380. to the bottom of the expression area. This allows more room for
  381. displaying answers. -A HEX output mode has been added; it only supports
  382. 4 byte numbers at this time.
  383.