-----BEGIN PGP SIGNED MESSAGE----- **************************************************************************** ** ExtraPkg - Newton Package Extractor for Windows ** ** Copyright 1995 by Rafal L Lukawiecki ** ** (a guide) ** **************************************************************************** What is ExtraPkg? ================= ExtraPkg is an application for users of PCs running Windows, who have access to Newton Connection Kit, or a similar software. This application reads files produced by NCK, and allows you to extract from them Newton software packages, in order to store them in separate files for a future download back to your Newton. Why would you do it? Well, there are many scenarios, but the most common is the following one: you have a package installed on your Newton (internally or on the card), and you want to remove it from the Newton temporarily. Or maybe you want to install this package on another Newton. Maybe you want to revert to a package you accidentally deleted. All in all, what you have to do is the following: 1. Run NCK to synchronise your Newton with the PC. 2. Run ExtraPkg on the PC to create installable package files. 3. Do whatever you want with your Newton. 4. Now you can install the package using NCK or a package downloader, because you have extracted it into an installable package. There is one additional use for ExtraPkg, which was kindly pointed out to me by a friend of mine. Have you ever downloaded a package which does not want to install on your Newton, giving you Invalid Package messages? Well, try treating such a file with ExtraPkg (choosing the file in the Open Archive operation). You may be lucky, and create a proper installable file. Why? Sometimes packages which you have downloaded contain Mac resource fork. Unstuff normally gets rid of them, but what if the package was compressed using Mac ZIP before the fork was removed? ExtraPkg will ignore the fork, and extract just what you need on a PC: the package itself. ExtraPkg is pledgeware (see later on). How to Install ExtraPkg? ======================== You need to have a total of 4 files on your PC. The chances are that you already have 3 of them, as they are common to many Windows application: - extrapkg.exe (My application, no you wouldnāt have it before!) - vbrun300.dll (You may already have it in WINDOWS\SYSTEM) - commdlg.dll (I am certain you should have it in WINDOWS\SYSTEM) - cmdialog.vbx (You may have it in WINDOWS\SYSTEM) I have uploaded two zips of ExtraPkg (I wonder which one have you downloaded!): - extrap2a.zip (Contains ONLY extrapkg.exe and readmes; small in size) - extrap2l.zip (Contains extrapkg.exe, readmes, and the other 3 files, in case you didnāt have them; larger in size) Download the one you need, depending on whether you have the other 3 files or not. Alternatively, download the smaller one, and ftp the other 3 files from common sites (such as CICA, or Microsoft). At the end of the day, you ought to put all the 4 files in one directory, OR, put the 3 system files in WINDOWS\SYSTEM (or any other directory which is in your PATH), leaving extrapkg.exe anywhere else you wish. Finally you may want to create an icon in program manager for the Newton Package Extractor. Thatās all! Now you can run my application. Steps to Extract Packages ========================= This is very simple: 1. After you have synchronised your Newton using NCK (or similar software), you should have a number of files ending with extensions *.nwt (newer ones) or *.nb (a bit older ones). Ignore the ones ending *.nar. If you use something else than Appleās Connection Kit, you may find that the extensions would differ. The connection kit synchronises not only your data, but also most of the packages which have installed on your Newton. This means, that they are somewhere in your *.nwt and *.nb files. Unfortunately, there is no way to re-install them selectively, without loosing some data on your Newton (i.e. by doing a Restore), unless you use ExtraPkg. Please note, that there are some applications (older versions of Notion are an example), which do *not* get copied while you perform a synchronisation. 2. Start extrapkg.exe. 3. Click on the Open Archive button, and select the synchronisation file created in step 1 that you wish to extract packages from. If your package is installed on the card, select the card file (typically called CARD.NWT). Otherwise select the *.nwt file called after your own name (as in Personal Preference on your Newton). You can extract packages from backup files (*.nb), and any other files that contain embedded packages. 4. After a short while, the list should fill up with the names and copyright information for all the packages that were found in the file you selected. If there were no packages, a message would tell you this. 5. Double-click on the package which you want to extract. You will be prompted for confirmation and the name of the file in which you want to store the package. Give it a name that would have a meaning to you, and, if possible, the *.pkg extension. PLEASE NOTE THAT ExtraPkg WILL *NOT* MODIFY YOUR ORIGINAL SYNCHRONISATION FILE. It will ONLY COPY the package out of the synchronisation file into the file of your choice. In other words, I should really call it Package Copier, as it does not actually damage your synchronisation files... 6. You can repeat step 5 as many times as you want. Clicking on Exit will quit ExtraPkg. How Much Does it Cost? ====================== Nothing. ExtraPkg is pledgeware, which means that it is freeware, but you are politely requested to make a donation of your choice towards its future development, and to stimulate the authors creativity. Who knows? Maybe Iāll write the software of your dreams at some stage... If you would like to contribute some money, please send it to the address below, in one of the following forms: - a cheque drawn on a UK branch (itās not a typo, UK, not US!) - an International Money Order (also known as Bankers Draft) - a money transfer - notes in a thick brown envelope - a credit card (please ask first; fax it, or encrypt with PGP, but do NOT send your card numbers by normal e-mail, please) UK Pound Sterling is the preferred currency, but US Dollars and any other major currency are acceptable. Please note, that a copyright and a license agreement apply (printed below), which basically mean that: - you cannot sell or modify this software etc. without my knowledge - if you are a corporate user, you *have* to contact me to purchase a suitable license for your use (itās very, very cheap) - you agree to the license (at the end of this file) immediately when you start using the software Contacting the Author (Addresses) ================================= Reach me by e-mail on: raf@rough.demon.co.uk More urgent mail can be sent to: rafal@eworld.com (yes I use the Newton to read it, so no attachments, please!). Post me at: Rafal L Lukawiecki 3 OVER 1 Design Unit 236 62 Tritton Road LONDON SE21 8DE UK If you wish to encrypt the contents of your posting (for instance when sending a credit card number), please obtain my public PGP 2.6.2 key, which is available from public key servers (for example by mailing pgp-public- keys@demon.co.uk putting in the subject line GET raf@rough.demon.co.uk). Please check that the keyās fingerprint agrees with the following one: Key 771/FEBFB541: A9 15 AD 15 D4 97 CB 9B 0B 9C 57 78 5A BE 15 C0 Known Bugs and Other Things... ============================== Well, so far I only can tell that ExtraPkg cannot properly extract Appleās Modem Enabler. The funny thing is that it will tell you that you have it installed, even if you have deleted it... Oh well. Apart from that I think it does not have any major bugs. Please let me know otherwise! PGP Signatures ============== If you are a PGP freak, or just want to ensure that no viruses have entered my application, you can check the signature of the executable file using PGP. Here is the signature for the executable (extrapkg.exe) in its current version (see the version history file, below): - -----BEGIN PGP MESSAGE----- Version: 2.6 iQB2AgUAL3HkLx115kb+v7VBAQFlNwMCAuADMvewXgpUdJGasRYVEhvQGX1OurCH Qu8GDb+XKZSM8f/sWGu+rJN23915csJd2M0LCsHS8OPuxPZ9bTeflXkoC8ZdY2w1 s8Q2/cAgihtNfLaDuHhZ7Uz0bIAZWcFImw== =XXRI - -----END PGP MESSAGE----- This readme file should bear my PGP signature at its end. Obviously, check that one before checking the executable file! Version History =============== 1.1 (23 March 1995) Added error handling to Open Archive and Extract Package routines. 1.0 (18 March 1995) Original Release! License Agreement ================= 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 Rafal Lukawiecki. You own the media on which the Software and fonts are recorded but Rafal Lukawiecki and/or Rafal Lukawieckiā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 computer, and make one copy of the Software and fonts in machine-readable form for backup purposes only. You must reproduce on such copy Rafal Lukawieckiā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. You are also allowed, and encouraged to distribute the Software in its original form, together with all copyright and license notices, to other parties, provided you do not charge anyone for the Software, and provided that such parties agree to the terms 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 version of ExtraPkg as long as it is accompanied by this documentation. If you are a corporate user (including but not limiting to Public Law Companies, Companies with Limited Liability, Incorporated Companies, Partnerships, Associations, Sole Traders, Self-Employed Persons) you are must not use this software before you have purchased a suitable license from Rafal Lukawiecki for a nominal fee available on request, as this license forbids you to use the Software. Employees and contractors of such companies acting on their employers behalf (or on behalf of their own business in case of self-employed persons) are treated for the purpose of this License as corporate users. 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 Rafal Lukawiecki 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 Rafal Lukawiecki, nor the direct product thereof, will be exported outside the country where you acquired the software except as authorised and as permitted by the laws and regulations of the that country. 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 Rafal Lukawiecki, 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 Rafal Lukawiecki and Rafal Lukawieckiās Licensor(s) (for the purposes of provisions 6 and 7, Rafal Lukawiecki and Rafal Lukawieckiās Licensor(s) shall be collectively referred to as "Rafal Lukawiecki") EXPRESSLY DISCLAIM ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. RAFAL LUKAWIECKI 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, RAFAL LUKAWIECKI 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 RAFAL LUKAWIECKI OR AN AUTHORISED REPRESENTATIVE OF RAFAL LUKAWIECKI SHALL CREATE A WARRANTY OR IN ANY WAY INCREASE THE SCOPE OF THIS WARRANTY. SHOULD THE SOFTWARE PROVE DEFECTIVE, YOU (AND NOT RAFAL LUKAWIECKI OR AN AUTHORISED REPRESENTATIVE OF RAFAL LUKAWIECKI) 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 RAFAL LUKAWIECKI 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 RAFAL LUKAWIECKI OR AN AUTHORISED REPRESENTATIVE OF RAFAL LUKAWIECKI 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 Rafal Lukawieckiā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 English Law (United Kingdom) and laws of the United States. 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 authorised representative of Rafal Lukawiecki. ============= 23 March 1995 ============= -----BEGIN PGP SIGNATURE----- Version: 2.6 iQB2AgUBL3IKph115kb+v7VBAQHSXAMCA2bsQsP3hY7s7YL0NZR46d0hCu5ns4X9 ZQfs4cpUnR56EJwu+g4wgVRLEhDQByuHMh5ACCa0c/ZSglZ3oDQEVR1qPtif1E4B GH8ZXsfzs503MncGKE3GY1DTnobb7veD7A== =F7D3 -----END PGP SIGNATURE-----