home *** CD-ROM | disk | FTP | other *** search
/ Freelog 42 / Freelog042.iso / Palm / Millikey / Xmaster / xmaster-readme.txt < prev   
Text File  |  2002-09-15  |  13KB  |  329 lines
  1. X-Master 1.5
  2.  
  3. X-Master manages PalmOS system extensions (aka hacks)
  4.  
  5. X-Master is a free, stable, easy-to-use hack/extension management
  6. program.
  7.  
  8. At A Glance
  9.  
  10. - Fully compatible with HackMaster, all existing hacks are supported
  11. - Freeware by LinkeSOFT
  12. - Protects active extensions
  13. - Safe (and complete) removal of active/inactive system extensions
  14. - Information about patched Palm OS functions
  15. - Support for switching "sets" of active extensions
  16.  
  17. You can find a wide variety of hacks for X-Master on the big Palm software 
  18. sites.
  19.  
  20. X-Master is a free 100% compatible successor to Edward Keyes' original
  21. HackMaster which fixes several bugs and offers various improvements,
  22. both technical and in the user interface. A light version of X-Master
  23. with reduced memory footprint (no patch info and no sets) is
  24. available.
  25.  
  26. Installation/Upgrade
  27.  
  28. X-Master runs on all currently available Palm Powered (R) handhelds
  29. with at least Palm OS 2.0.
  30.  
  31. X-Master is a regular Palm OS application. After starting X-Master,
  32. the list of system extensions (hacks) found on your handheld is
  33. displayed. Active extensions have a checkmark to the left.
  34.  
  35. X-Master will recognize if you have HackMaster running and will take
  36. over the set of active hacks from HackMaster. Because it makes no
  37. sense to have two utilities with the same functionality, it will then
  38. remove HackMaster from your handheld.
  39.  
  40. If you've used another extension management application like
  41. EVPlugbase or TealMaster and want to use X-Master, you should first
  42. deactivate all extensions in the other program. Note that using
  43. multiple extension managers at the same time may lead to unpredictable
  44. results. You should eventually delete the other application.
  45.  
  46. You can install newer versions of X-Master over the old version
  47. without problems. Deinstallation or deactivation of hacks is not
  48. necessary
  49.  
  50. To remove X-Master from your handheld, first deactivate all
  51. extensions, then delete X-Master just like any other program in the
  52. launcher.
  53.  
  54. Note that the upcoming Palm OS 5.0 will no longer support hacks, hence
  55. X-Master and other hack managers can no longer be used on Palm OS 5
  56. and later.
  57.  
  58. Details
  59.  
  60. The Details dialog shows version, status (active/inactive), and the
  61. Palm OS functions that the currently selected extension patches.
  62.  
  63. Tapping on Configure will take you to the extension's configuration
  64. dialog (if available).
  65.  
  66. To get general information about a particular system extension, tap on
  67. the (i) in the upper right corner of the Details dialog.
  68.  
  69. If you tap on Delete, the system extension will be deactivated and
  70. removed from your handheld. This includes all data and the
  71. preferences.
  72.  
  73. Reset
  74.  
  75. All system extensions are automatically deactivated after a reset by
  76. the operating system. X-Master will pop up a dialog asking you whether
  77. you want to re-activate your formerly active collection of system
  78. extensions. When you check the corresponding preference option, this
  79. popup will automatically be confirmed after 5 seconds.
  80.  
  81. Sets
  82.  
  83. If you have many system extensions installed, chances are you do not
  84. want to have all of them activated at the same time. X-Master provides
  85. support for easy switching between multiple sets of active extensions.
  86.  
  87. To store the currently active set of system extensions tap on the menu
  88. Extensions->Create Set. Once you have sets defined, a popup trigger in
  89. the upper right corner will appear that lets you select or edit your
  90. sets.
  91.  
  92. You can define up to 30 sets. Note that the activation order of
  93. extensions within a set matters, i.e. you can have two sets that
  94. contain the same extensions but in different order.
  95.  
  96. To update a set to the currently active extensions, tap on Edit
  97. Sets..., select the set you want to update and tap on Refresh.
  98.  
  99. To switch between sets with a simple stroke in any application,
  100. install our XMSwitchSet extension.
  101.  
  102. Extension patch chain
  103.  
  104. The extension patch chain dialog, available through menu
  105. Extensions->List All Active, lists all applications that alter system
  106. functions. The first called extension comes first. Note that this list
  107. may include applications that are not X-Master compatible (i.e. do
  108. their own trap patching). These applications will not appear in the
  109. main X-Master extension list.
  110.  
  111. Preferences
  112.  
  113. In the preferences, you can select whether you want the original
  114. HackMaster style layout (with little (i) and (...) buttons next to the
  115. extension name, or the default layout with Configure and Info buttons
  116. at the bottom.
  117.  
  118. By default, X-Master sorts active and inactive extensions
  119. alphabetically with all active extensions coming first. When you
  120. select Strict Alpha, all extensions will be sorted alphabetically,
  121. regardless of their activation state. When you select Activation, the
  122. list order will mirror the activation order with the most recently
  123. activated extension coming first.
  124.  
  125. The option Disable during HotSync is available on Palm OS 3.5 and
  126. later. If this option is set, all extensions will be automatically
  127. deactivated when a HotSync begins and activated again when HotSync
  128. ends. This way you can install a new version of an extension without
  129. having to manually deactivate the extension first in X-Master.
  130.  
  131. Note: A few hacks that expect to work during HotSync may not be
  132. compatible with this option.
  133.  
  134. Order of activated extensions
  135.  
  136. Sometimes, the order in which extensions are activated matters. Some
  137. extensions may not work if a different extension is activated first.
  138.  
  139. For technical reasons, for any patched system function, the last
  140. activated extension will be called first.
  141.  
  142. X-Master retains the order in which you activate the extensions after
  143. resets and in sets. To find out the current order in which extensions
  144. are called, view the extension patch chain or select the preference
  145. option to display activation order.
  146.  
  147. Compatibility
  148.  
  149. X-Master runs on all Palm OS devices with at least Palm OS 2.0.
  150.  
  151. X-Master is fully compatible with HackMaster. It uses the same
  152. protocol and the same activation procedure as the original HackMaster.
  153. All hacks written for HackMaster should work.
  154.  
  155. X-Master fixes many shortcomings of the original HackMaster program.
  156. It therefore makes obsolete various third-party hacks and applications
  157. that have been specifically written to fix such HackMaster faults. If
  158. X-Master finds such an application, it will display an alert. You
  159. should disable and remove these hacks and applications.
  160.  
  161. X-Master is compatible with LeftHack. X-Master can be moved to Flash
  162. ROM.
  163.  
  164. You should not move X-Master to an expansion card, because
  165. applications on cards do not receive reset or HotSync notifications.
  166.  
  167. Troubleshooting
  168.  
  169. Because system extensions call deeply into the operating system
  170. sometimes subtle problems occur if several extensions interfere with
  171. each other, or if the extension was not written for the current
  172. operating system.
  173.  
  174. Things to check if a system extension is not working properly or if
  175. your handheld is unstable after activating a certain system extension:
  176. - Is the extension (Hack) compatible with your Palm OS version and
  177.   hardware?
  178. - Is it working if  all other extensions are disabled?
  179. - Perform a soft reset.
  180.  
  181. Sometimes, applications that patch system functions without adhering
  182. to the hack standards can interfere with X-Master. You can try Daniel
  183. Seiferts Hackfinder to find applications that may perform hack-like
  184. activities.
  185.  
  186. If a simple soft reset does not work, i.e. you're stuck in a reset
  187. loop, try a reset without notification of applications
  188.  
  189. - Press the scroll-up key (the upper arrow key)
  190. - While keeping the scroll-up key pressed, enter pin into reset hole
  191.   at back
  192. - Release reset pin
  193. - Release scroll-up key
  194.  
  195. Freeware
  196.  
  197. X-Master is freeware. You can freely use it and distribute it to
  198. others as long as the program is not altered in any way. If you like
  199. the program, you can donate a small amount of money to our PayPal
  200. account.
  201.  
  202. Version history
  203.  
  204. Version 1.5 (22-Jul-2002
  205.  
  206. - Improved interoperability with locking apps like OnlyMe
  207. - More compatibility fixes
  208.  
  209. Version 1.4.1 (03-Mar-2002)
  210. - Minor compatibility fix
  211.  
  212. Version 1.4 (25-Nov-2001)
  213. - Option to disable all extensions during HotSync (useful for
  214.   installing new versions of an extension w/o manual prior
  215.   deactivation)
  216. - Menu entries to quickly activate/add to current set and
  217.   deactivate/remove from currentset
  218. - Faster switching of sets that only add/remove a few extensions
  219.   (useful for e.g. XMSwitchSet)
  220. - Support for activation/deactivation notification of Hacks (useful
  221.   for developers)
  222.  
  223. Version 1.3 (09-May-2001)
  224. - More compatibility enhancements
  225. - Include new Palm OS 4.0 patch names
  226. - X-Master will no longer try to activate a patch if this patch is not
  227.   available on the current OS
  228. - Reversed patch chain list to be consistent with main list (first
  229.   called extension comes first)
  230. - Supports direct calling from Launcher III
  231. - Support for JackFlash
  232. - Support for Handera 330
  233. - Support for XMSwitchSet extensionmore compatibility enhancements
  234.  
  235. Version 1.2 (11-Feb-2001)
  236. - Fixed bug with garbled function names
  237. - Fixed various sets bugs
  238. - Improved sets handling
  239. - Added set refresh functionality
  240. - Reduced space between lines so that 11 extensions fit on one page
  241. - Added light version with smaller memory footprint (no patch info and
  242.   no sets)
  243.  
  244. Version 1.1 (5-Feb-2001)
  245. - Fixed Visor incompatibilities (our sincere apologies to all Visor
  246.   users who suffered crashes with 1.0!)
  247. - Many other bug fixes
  248. - Added beaming
  249.  
  250. Version 1.0
  251. - Initial public release
  252.  
  253. Thanks to Mike McCollister for valuable suggestions. Special thanks to
  254. Takanori Nakane for the Japanese translation. Thanks to Daniel Bergman
  255. for the Swedish translation. Thanks to Antonio Delgado for the Spanish
  256. translation. Thanks to Stanley Wu for the Chinese translation.
  257. Copyright (c) 1998-2002 LinkeSOFT GmbH, Berlin, Germany
  258.  
  259. License
  260. -------
  261.  
  262. This license agreement settles the relation between LinkeSOFT GmbH and the 
  263. user concerning the use of the enclosed software product ("program") of
  264. LinkeSOFT in its shareware version and its registered version.
  265.  
  266. º 1
  267. The user obtains through this license by LinkeSOFT the non-exclusive 
  268. right to install and use this program on his PalmPilot.
  269. The program remains the sole property of LinkeSOFT.
  270. The user further obtains the right to make a back-up copy by means of 
  271. the HotSync feature.
  272.  
  273. º 2
  274. The user may distribute the shareware version of this program or copies 
  275. thereof. The shareware version may be published on the Inter- or 
  276. Intranet or on software collections (on CDs etc.).
  277. Each distribution must contain these provisions and the above copyright
  278. notice. Except for publishing on software collections the distribution 
  279. of this program has to be free of charge.
  280. The program name or the name of LinkeSOFT shall not be used for
  281. promotional purposes without prior written consent of LinkeSOFT.
  282. The program may not be modified or tampered with in any way.
  283.  
  284. º 3 THIS SOFTWARE IS PROVIDED BY LINKESOFT GMBH ''AS IS'' AND ANY 
  285. EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 
  286. IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR 
  287. PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL LinkeSOFT BE LIABLE FOR ANY 
  288. DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 
  289. DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 
  290. OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 
  291. HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, 
  292. STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN 
  293. ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE 
  294. POSSIBILITY OF SUCH DAMAGE.
  295.  
  296. º 4 For regular use the program has to be registered according to the 
  297. general rules about shareware. Registration is made by payment of the 
  298. registration fee according to the program and web site instructions. 
  299. After registration the user receives a key that entitles him or her to 
  300. unrestricted use of the program according to this license. Registration 
  301. further entitles the user to get support by LinkeSOFT via email and free 
  302. upgrades of this program.
  303.  
  304. º 5
  305. The user shall in no way make copies of the registered version of this
  306. program, except such as coming under º 1. The user shall in no way 
  307. resell or lend the registered program or copies thereof to third persons.
  308. The registered program may not be made available to third persons.
  309.  
  310. º 6
  311. In the event that any provision of this Agreement should be or become 
  312. invalid or if there is a gap in the Agreement, the validity of the other 
  313. provisions shall not be affected. In lieu of the invalid provision or in 
  314. order to complete the Agreement, a reasonable provision shall be 
  315. effective approaching to what parties would have agreed upon if they had 
  316. considered that issue.
  317.  
  318. º 7 This Agreement shall be governed and construed in accordance with 
  319. German law as it applies to German citizens and corporations and the 
  320. parties hereby agree to submit to the exclusive jurisdiction of the 
  321. courts of Germany. The place of proceeding will be Berlin.
  322.  
  323. º 8
  324. This software program is protected by international copyright law.
  325.  
  326. Palm, the Palm logo and Graffiti are registered trademarks,
  327. and HotSync, PalmPilot, Palm OS and the PalmPilot logo are trademarks of
  328. Palm, Inc.
  329.