-----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 wouldnt 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 didnt 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.

Thats 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 Apples 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 
Ill 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 (its 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 (its 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 keys 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 Apples 
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 Lukawieckis 
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 Lukawieckis 
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 Lukawieckis Licensor(s) (for the 
purposes of provisions 6 and 7, Rafal Lukawiecki and Rafal Lukawieckis 
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 Lukawieckis 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-----
