Nutshell PRO is the command-line version of Nutshell. It does not have a graphical user interface. For more detailed information on Nutshell features consult Using Nutshell and Advanced Features.
Installing/Running Nutshell PRO
Installing/Running on Windows
Unzip "Nutshell_Pro.exe" and the "libs" directory to the same location. Run Nutshell_Pro.exe from the Windows command line or a batch file.
Installing/Running on Mac OS X
Mount the "Nutshell_PRO_Mac.dmg" disk image. Copy "Nutshell PRO" and the "libs" folder to the same location. Run "./Nutshell_Pro from the Terminal application.
Installing/Running on UNIX/Linux
Unpack the "Nutshell_PRO_Linux.tar.gz" file. Copy the "Nutshell_Pro" program and the "libs" directory to the same location. Run "./Nutshell_Pro".
Nutshell Options and Flags
All Nutshell options are specified using command line arguments and flags.
The arguments below link to the Using Nutshell chapter, which a provides more detailed explanation of each option.
usage: Nutshell_Pro [ -BRDUPQAISHONWXYZLCT ] [-s icon name] [-l database name]
[-d description] [-v minimum palm os] [-r version] [-c category]
[-i creator id] [-j uninstaller creator id]
[-m message file] [-x [F][I][G][S][P][0]]]
[-b OK | OC | AD ] ] [-o installer output file] [-g resource file]
[-u uninstaller output file] [-f inventory file ... ]
[-z card inventory file ]
[-p preflight lib ] [-t template path] [-n .nutshell file]
name [ ... ]
Arguments:
-s icon name Name to be used as icon name for installer.
Max 31 characters.
-l database name Name to be used as database name for installer.
Max 31 characters.
-d description File containing description to be shown while install
is taking place.
-v minimum palm os Minimum Palm OS version for installation.
-i creator id Creator ID to be used for installer.
Must be 4 characters.
-j uninstaller creator id Creator ID to be used for uninstaller.
-r version Installer's version
-c category Installer's destination category
-m message File containing a message to be shown before
installation. (optional) For languages other than English,
Nutshell will check for the existance of [message]_X where
X is a language abbreviation as described in the next option.
-x language Specify languages other than English to be included
in installer. F=French I=Italian G=German
S=Spanish P=Portuguese
-b [ OK | OC | AD ] Button choice to display below install message.
OK = "OK" (default)
OC = "OK/Cancel"
AD = "Accept/Decline"
-f inventory file(s) Files listing files to be added to installer.
-z card inventory file File containing files or paths to be copied to
expansion card.
-p preflight lib Specify a shared library to run before install.
See README for details.
-o installer output Specify name of installer being created.
Defaults is "untitled.prc".
-u uninstaller output Specify name of uninstaller being created.
Defaults is to prepend "uninstall_" to
installer name.
-t template path Specify a path to the libs if different from
the default of ./libs
(Example: -t /Dev/Tools/Nutshell/libs )
-g resource file A PRC resource database which will be merged on
top of the final installer.
-n nutshell file Specify a saved .nutshell config file generated
by saving settings in the GUI version of Nutshell.
All other flags are ignored except
for -g, -o, -t, -p and -u.
Flags:
-B Archive can't be beamed.
-R Ask before replacing databases.
-D Don't auto-delete installer after installation.
-U Create uninstaller.
-P Prevent installation on Palm OS 5 or higher.
-Q Prevent installation on Palm OS 6 or higher.
-A Auto-launch after install.
Auto-launch will use the first executable file encountered.
-I Inherit icon from auto-launch application.
-S Won't print output unless a warning or an error occurs.
-H Print this usage information.
-O Only install overlay databases for device locale.
-N Auto-run installer after HotSync
-C Require scroll to bottom of license agreement.
-L Don't use internal storage when installing card files.
-W Send custom sublaunch to apps before replacing/deleting.
-X Uninstaller warns if different version installed.
-Y Uninstaller removes all files with included creator IDs.
-Z Use compression.
-K Use first line of description text for install screen title.
-G Create single-segment installer.
Using an Inventory File
Files for the installer can be listed on the command-line or specified via an
inventory file using -f. An inventory file is a text file listing one file
per line. The file must use Unix or Windows line endings. More than
one inventory file can be specified after the -f flag.
Specifying a Template Path
The "libs" directory contains important template data files that Nutshell PRO needs to function. Nutshell PRO expects the "libs" directory to be located at "./libs". Use the -t option to specify an alternate path to the libs directory of necessary. An absolute path is required.
Using a .nutshell File
Instead of specifying options using command-line arguments and flags, you may find it useful to use a .nutshell file created with the Nutshell desktop or Palm tool. Specify a .nutshell file using the -n flag. When using this, all other flags are ignored except for -g, -o, -t, -p and -u.
Resource Merge
Since you may want to customize your installer, Nutshell PRO provides the ability to merge an existing resource database into your installer after it has been created. Provide a PRC file using the -g flag. Resources in this file will replace resources in the Nutshell installer. Possible uses include adding a custom icon or changing the wording in an alert message.
Installer Scripting
Nutshell PRO provides an advanced mechanism for performing pre-installation logic and actions before and during installation. For example, your installer may need to check the Palm system for certain files, perform deletions, close libraries, etc. before an installation, or decide not to installer certain files. Additionally, the installer may want to bail out if certain conditions are not met. This is all made possible by creating a scripting shared library. Specify your scripting shared library using the -p flag. Instructions for creating a scripting shared library are found in the Advanced Features chapter.
Installing Files To An Expansion Card
Nutshell PRO adds the ability to install files and directories to an expansion card. Provide an inventory file name containing directories and/or file names that should be copied to the expansion card. Nutshell will include all directories and files included within the specified directories, and reproduce the directory structure on the expansion card. If no expansion card is present, the expansion card installation phase will be skipped. On devices with internal storage such as the LifeDrive or T5, the internal card will be used for installation. Provide the -L flag to ignore internal storage and require a removeable card.
Compatibility/System Requirements
General Requirements
The Nutshell installer is compatible with Palm OS 3.0 or later. This includes Palm OS 5 and 6.
Nutshell installer is incompatible with !pZip v1.1. This may be corrected in later versions of !pZip.
Windows Requirements
Nutshell PRO for Windows requires Windows 95 or higher.
Mac OS X Requirements
Nutshell PRO for Mac OS X is compatible with Mac OS 10.3.9 or higher.
UNIX/Linux Requirements
Nutshell PRO for UNIX/Linux requires an x86 UNIX/Linux-based system. Ecamm Network may be able to create a version for other processor types if necessary.
