User Interface

The Newt's Cape user interface can be quite confusing due to its dual purposes: for creating/viewing books (applications), and browsing web pages. Before delving too deeply into details, you may want to look at two sample scenarios, which highlight typical commands and preferences.

Newt's Cape appears initially as a 2-line floating "control panel" at bottom of the screen (over the book control bar area): a single-line URL and a row of command buttons. Interface elements appear below, more or less in left-to-right and top-to-bottom order. Note: The location/appearance of interface items depends on MessagePad model, screen size/orientation, installed functionality, and book status. Commands that are not relevant to the current context or system configuration are surrounded by parentheses, e.g., (Open Newtworks); if selected, they should do nothing. Tap on this book's overview button to navigate interface items.

Drag Button

move Newt's Cape by dragging the dot at top center. Instead of moving it, you can also hide Newt's Cape temporarily, and redisplay it later from the Newt's Cape icon in book control bar or from Extras.

top triangle button

This triangle button expands the single URL line to 3 lines; toggling it again collapses back to a single line.


Enter a URL in this area. A caret should automatically appear. Drag&drop text, or use handwriting or a keyboard to enter a location. You can also highlight a URL in Notes (or NewtWorks), and select Newt's Cape:getURL from the Notes action menu (Newt's Cape from the NewtWorks Tool menu). You can select items from Bookmarks. During processing, the area displays the current document id (URL or ISBN). Typical values:

http: URL (or relative to BASE of current document); <http://...> and <URL:http://...> ok
Newt's Cape parses and views the HTML document via NIE or WebMail (text-only); you can also specify localhost or if you are using NPDS (local Newton web server). Newt's Cape also displays plain text and GIF files directly, and installs packages (.pkg) after confirmation. If JPEG plugin is installed, Newt's Cape caches result but does not display via URL; however, it will appear if referenced by a document, or you can view via File:Open Image Cache. other MIME types. After Newt's Cape checks its own cache, it checks NetHopper's cache for any unconverted HTML source or GIFs stored there by WebXPress.
mailto: URL
Newt's Cape posts a message to Outbox using the default mail transport (SimpleMail, Eudora, EnRoute,...)
news: URL
Newt's Cape passes URL to Newt's Paper news reader, if installed, or another news reader if registered with URLcop.
ftp: URL
ignored currently unless an ftp client is registered with URLcop
opens the book, e.g., introtoc.htm (Newt's Cape: Introduction)
opens(toggles) an application, e.g., stylePalette (Styles)

Keyboard Icon

Tap keyboard icon to pop up a keyboard. 2.x: Newt's Cape adds default (http://, www., .com, .edu, .net, .htm, .html) or user defined keys to top row of keyboard -- for standard system keyboard, . for easier replace, it does Select All of current text view

If you hit Return key (on soft or hard kbd) in Newt's Cape's URL field, this is same as File:Open Location (slight delay); automatically closes soft keyboard

If you have a hard keyboard attached, there are several keyboard equivalents available:

Newt's Cape icon

Tap the Newt's Cape icon in order to open the current URL. This is same as File:Open Location. While Newt's Cape is transferring or processing a document, the icon changes to a Stop icon (up-raised hand) -- tap to stop the current operation. (If numerous operations are queued, e.g., autoloading images, you can tap Stop multiple times, or use File:Reset HTTP).

This button can be customized via i:General:Other Options:Newt's Cape button to open Bookmarks or HTML cache. In the book bar, the same icon redisplays Newt's Cape if hidden.

bottom triangle button

This triangle button expands/collapses status line, error line and Stop button under the row of command buttons.

Info "i" Button


display Newt's Cape version and short description in HTML, and automatically convert this into a book. This also appears automatically when you start Newt's Cape if you haven't registered and paid yet.


Open the Newt's Cape Introduction/TOC book, if installed; or another book if a custom helpISBN specified.


If the Newton Register application is installed, opens a registration screen. This is a convenient and reasonably safe way to register with a credit card via email. Newton, Mac, Windows, web versions of Register After you've paid, be sure to turn on the I paid checkbox to disable the automatic About box.


Preferences (General, Appearance, Encoding, Process, etc.) appear directly in the i menu -- these are covered a little later


This button and remaining command buttons are intended to mimic the commands/menus you might find in a typical desktop web browser.

Open Location

It's probably more convenient to use the Newt's Cape icon button to open the current URL. You can also use the Return key on keyboard.

Open Notes

Newt's Cape scans Notes(Notepad) for text entries that begin with <HTML> -- this may take a few seconds the first time. Newt's Cape pops up a list of TITLEs (or "untitled" if no TITLE tag) of possible documents for you to select. Newt's Cape ignores anything before <HTML> (or <!DOCTYPE) and anything after </HTML>. In the Notes application, you can select Newt's Cape:Open from the action menu.

Note: The popup menus for Notes, Inbox, Paperback and Save as Text to Desktop do not scroll on 1.x (unless you use a third party utility). File:Open Notes, Inbox, Paperback, WabumiUni(~J) may not indicate initially whether items are available; however, after selecting the command (and scanning for items), cached results are used the next time to "disable" menu item (if no items are available) or speedup selection for subsequent picks.

Open Inbox

Pops up a menu of Inbox (via email, beam) entries that contain HTML documents (like those described for Notes); if you use EETransfer or newtFTP, you can include HTML documents, GIF and JPEG files, or files handled like helperApps like PilotDOC and ModSaver. If a large HTML document was split into multiple messages, Newt's Cape displays the title from the initial message, and combines the rest (tested with Aloha). Alternatively, you can Put Away items from the Inbox to the Notepad, and then edit/process from there, or you can select Newt's Cape:Open from the Inbox action menu.

Open Paperback

Pops up a menu of Paperback "books" that contain HTML source documents. This can be a convenient way to transfer and access large, static HTML documents and not clutter up Notes, heap or cache. In addition to containing an <HTML> tag, the text should not contain any null (0x0) characters -- otherwise, a Paperback may not appear in the popup menu.

Open WabumiUni

2.x, Japanese(~J) version only. WabumiUni is a Paperback-like application especially for Japanese-encoded characters. It should be available on a UniFEP CD-ROM (that comes with the Japanese Newton) from Enfour.

Open NewtWorks

2.1 only. If NewtWorks is available, pops up a menu of documents that contain <HTML>. The NewtWorks titles are listed (these may or may not be the same as the HTML source TITLE). Note: this interface relies on undocumented APIs, so is not guaranteed to work. HTML source is processed like Notes. See NewtWorks HTML via Summary preference.

Open HTML Cache

2.x only, if cache on. display an "overview" dialog that contains checkboxes, URLs and other info for current HTML documents, and filing and routing buttons. the view is less than full screen for NOS 2.1 when NIE is connected to avoid system hangs. Note: the following description (with some exceptions) also applies to File:Open Image Cache, Bookmarks:Browse/Schedule, View:Load with Images, View:Load Frames, View:Load Links

title (upper left)
includes information about current objects, e.g., HTML Cache [≤ 250]: 10/49
folder tab (upper right)
used to change current folder/store (caches, bookmarks)
item checkboxes
tap to select/deselect an item
2 line item description
URL and title; plus for caches/bookmarks
  1. alarm icon (if part of a Schedule set)
  2. caches: lock icon (if locked); entry size (in K); entry modification date/time (cache entries are ordered newest at top to oldest); (automatic expiration date/time, if any)
  3. "All" folder only: (store:folder) names appended
Cached URLs appear in Bookmarks and View overviews with a bullet prefix. If you tap on an item to right of its checkbox, it will Open the item (or Load for View:Load with Images) immediately -- if no other items were selected (this is like popup menu behavior); otherwise, it just checks the item.
All button (lower left)
toggles all items on/off
filing button (lower right) [except View:Load with Images]
used to change folder and/or store of selected item(s). button contains triangle if all items are on a card
action/routing button (lower right)
command menu to apply to selected item(s)
Load: for View:Load with Images, Load Frames, Load Links
load selected image file(s), frame(s), link(s). default action when tapping single item
check/load item(s) in current folder into cache. another view pops up.
# items
displays number of selected items to have in set for this folder
Start Date
date and time for first update
repeat frequency
no scheduling or loading occurs (when you close schedule view)
[default] updates selected items one time (now) without delay Any future scheduled event remains.
updates selected items later, one time only
updates selected items every 60 minutes
every 12 hours
once per day
daily (except weekend)
same as daily, but skips Saturday and Sunday
once per week (same day)
this is every 31 days; if this gradually creates an unacceptable delay, you can reschedule (I'd rather not add month-specific checking)
a picker with choices: None, 1 level, 2, 3; If non-zero level, Newt's Cape scans the scheduled docs for links to load; it skips links of pages already cached; To cut down on some of the "extraneous links", you can include a list of substrings (e.g., host name, file extension, URL fragment) in AutoLink Exceptions. If 2 levels is selected, it should autoload links for all pages that were autoloaded from the original set (excluding items matching Autolink exceptions); 3 levels even more. WARNING: since the number of pages returned can expand quickly, be sure to increase your cache size, pre-inspect pages for links to add to exceptions list, increment the level slowly, and be sure to monitor progress the first few times to avoid surprises. Because Newt's Cape is not checking its "global pending request queue" (a messy fix to add), some pages may be fetched more than once.
NIE Setup
the NIE Setup (ISP) to be used for the connection. Select "default" to use setting at time of connection; otherwise, it is set explicitly before making each connection.
allows you to set user name and passwords for any hosts. description of dialog: i:General:Authenticate
schedule selected items (assuming Frequency is not none)
close box
cancel without making changes. Notes: If items have changed (based on modification date) or are not in cache, they should be updated/loaded; "Doc Done" sound plays after items completed. If Newt's Cape is closed (not just hidden) when update occurs, it should automatically connect/disconnect. Due to limitations in the Newton's alarm system, the folder name (Unfiled, Business, etc.) must be unique in the first 20 characters; All items/bookmarks view indicates scheduled items, though you can't change scheduling there -- only in an individual folder. Moving scheduled items adds to existing set in new folder, or creates a new set based on old settings. Due to the erratic nature of communications, and Newton's limited memory, there may be problems with Newt's Cape not updating an entire set of URLs or cleaning up properly; this area needs more tuning/testing; in the meanwhile, you should not assume that unattended updates are completely reliable.
Cancel Schedule
cancel all pending scheduled items in folder
opens (1st) selected URL -- faster than: Display URL, followed by File:Open Location. default action when tapping single cache/bookmark item
popup appears with subset of regular Process options: Save as Package, Save to NewtWorks; notes: items must already be present, i.e., cached; status line displays number of remaining items; Save as Package automatically replaces (i.e., w/o confirmation) any package with same ISBN; there are some intentional delays because of the way saving is implemented; this batch Process is an experimental feature: if it's too buggy or inadequate, I may remove rather than try to fix
Display URL
displays (1st) selected URL in status area (for editing, File:Open Location, View:Reload)
Save as Outline
copies items to a Notes outline. You can select a URL there and use Newt's Cape:getURL; or edit the list and then re-import via Newt's Cape:Add Bookmarks (if you have HTMList installed).
Add Bookmark (except Bookmarks overview)
add selected URLs and titles to bookmarks
preliminary lock/unlock cache support. Locked items are not removed when Newt's Cape quits -- though expired or temporary items will be removed anyway, along with other old items over the limit; Remove from Cache, Delete, Reload do not check lock currently.
unlock selected item(s)
deletes item(s) (after confirmation)
close box
close overview with no action

Open Image Cache

2.x only, if cache on. opens overview of current image (GIF,JPEG) URLs, similar to HTML Cache. Note: occasionally (depending on command/context), if a file doesn't have appropriate file extension, its cached entry might not be found.

Open NetHopper Cache

2.x only, if NetHopper installed. pops up a menu of URLs of current, unconverted HTML and GIF source files, typically stored in its cache by WebXPress. Note: once you view a cached HTML source with NetHopper, it is converted to a different internal format, so source is no longer available; converted GIFs should still work, though "scale to fit?" may not work correctly (and animated GIFs would not work). Note: you should be able to access a URL (for document stored in NetHopper cache) directly via File:Open Location and via links from other documents.

Open Desktop

If you have a cable connected to your Newton, and Sloup 2.2a (or greater) installed, you can access HTML documents via serial or AppleTalk directly from your desktop computer and a terminal program. Select a serial or ADSP option from the popup menu. Once you have opened a connection, this item changes to Close Desktop. You can transfer HTML documents separately via Sloup and access from Notes or Newtworks; or HTML/GIF via EE Transfer and access from Inbox.

Transfer an HTML file via your terminal emulator using a "Send Text" command. For 1.x, Newt's Cape parses each line immediately. For 2.x, Newt's Cape collects all of the lines before parsing, and if you have desktop? cache option selected and a BASE HREF (URL) in document, source is stored in HTML cache; you can also send non-HTML text files if you include header info.

Newt's Cape automatically disconnects after encountering a complete line with "</HTML>" or usually if it detects "Out of Heap". Otherwise, select Close Desktop after the transfer is complete. You might also open a connection to log error messages while processing documents from another source, e.g., Notes or to support the HTMList Save as HTML to Desktop command.


Many terminal programs will work for serial, such as ZTerm on Macintosh or Terminal on Windows. You should configure it as follows:

Note: Newt's Cape can handle Macintosh, DOS and Unix end-of-line characters. To avoid overwhelming Newt's Cape and losing text, make sure that your terminal emulator sends one line at a time and supports XON/XOFF; you may also wish to turn off line wrapping. For further details about configurations, see the the usage scenario and Sloup documentation.


Once you have serial working at 9600, you may wish to try 57600 -- this will be somewhat faster, but HTML processing (on 1.x) will likely be a bottleneck, especially if Display Item Process option is selected.


For ADSP (AppleTalk protocol), your desktop system will need an application such as ClarisTerm that supports ADSP ("CommToolBox-aware"). Select "Wait For Connection" in your terminal program, then select Newt's Cape's ADSP option -- you will then be offered a chooser to select a network location. Last ADSP zone and host saved as preference; confirms as default for next connect. Note: ADSP may not be too reliable on older Newtons.

Close Desktop

The connection is normally closed automatically when </HTML> is encountered (there must be a final line-end character also). Select this (or exit Newt's Cape) to close an open connection explicitly.

Save as Package

If there is a non-empty book and NewtPack is installed. The current Newt's Cape book resides in heap and is installed only temporarily as a book. This temporary book disappears if you quit Newt's Cape, reboot your Newton, tap Remove Current Book, or process another document.

If a book with the same ISBN already exists, Newt's Cape prompts you to replace it. NewtPack starts to save the book as a package and displays progress in Newt's Cape status area (Older versions of NewtPack display a "barber pole" and Stop button for NOS 2.x in a separate progress box). The Save Package Process option allows creation of somewhat larger books for 1.x; also see Size Constraints.

During Save, Newt's Cape removes the book to recycle space, but may still run out of heap. If you are using an Original MessagePad (OMP with pre-1.3 ROMs), you should be able to save small packages (~30-40K). If you are planning to use books with Newt's Cape (regular or Lite) present (e.g., these books) or book that make use of explicit http links, each book package will be smaller if you uncheck the Standalone book pkg? preference. A book can also be stored compressed on the Newton to save further space. To create 1.x compatible books with a 2.x Newton, use b&w rather than gray graphics, use portrait rather than full Page Size, use standard (built-in) fonts unless you plan to distribute fonts with your book, and use special 1.x-compatible versions of Newt's Cape and NewtPack (ALIGN on paragraphs with links, and 2.x protos in VALUE_TYPEs should be ignored).

If NewtPack completes successful (you'll hear a sound; otherwise, you'll see an error message; or a close box will appear in old 1.x progress box), you can access the book from the Extras drawer and remove it later as you would any package. If you would like to distribute the book as a package to other users, you can move it to a Mac or Windows desktop using Extract Package (1.x) or PackageBuddy (2.x).

Save HTML to Notes

2.x only, if cache on. save current HTML cache entry to Notepad as text. Newt's Cape adds comment with filename as first line of Note. For HTML, it adds BASE before TITLE; very long text source may cause an error

Save Image to Notes

2.x only, if cache on. save current Image cache entry to Notepad as a graphic.

Save HTML to NewtWorks

2.1 only, if cache on. save current HTML cache entry to NewtWorks as text.

Save Image to NewtWorks

2.1 only, if cache on. save current Image cache entry to NewtWorks as a graphic.

Save as Text to Desktop

This feature has been removed from Newt's Cape 2.0, but is accessible via HTMList plugin.

Save Book to NewtWorks

2.1 only. Select a book (from popup) to copy styled text and graphics from entire Newton book (including current book) to a NewtWorks document. In this initial version, any formatting/layout info (e.g., indent, spacing, tables) is lost, form objects are omitted, links don't work. You can also select Save to NewtWorks in book's routing menu if HTMList is installed (which supports page ranges, paragraph justification).

Remove Current Book

remove the current Newt's Cape book. This should not normally be necessary since the book is removed when you process another document, save a book or exit Newt's Cape. But you can reprocess the same URL, or free up heap sooner by using this.

Remove from Cache

discard current entry from HTML or Image cache

Reset HTTP

2.x only. If an error leaves Newt's Cape in a strange state, or a transfer appears hung, or you would like to disconnect NIE without quitting Newt's Cape, you can select this command instead of closing/reopening Newt's Cape -- it may continue with queued requests, i.e., for Load Images. This releases NIE connection and removes any passwords (via authentication). If no other NIE applications are active, depending on your NIE Preferences, you will either immediately disconnect or see a flashing star at top center.


Current Book

Display the current book. If a book with the same ISBN already exists, Newt's Cape will not display the book -- instead, a Confirmation box will (eventually) appear, prompting you to replace the existing book/package. After removing it, you should be able to view the new book. If book has been removed but URL is visible, this is same as File:Open Location.


retrieves URL, and replaces existing source (if any) in cache, only if successful

Load with Images

If Image Cache is enabled, Newt's Cape scans current cached document for IMG and INPUT TYPE=IMAGE (and META ICON) URLs in current cached document; opens overview of image (GIF,JPEG) URLs, similar to HTML Cache. Tap on a URL to load just a single image; otherwise, select items with checkboxes and select "Load" from action menu to load selected images. After fetching image(s), Newt's Cape reprocesses document to show image(s) embedded. If some images do not load due to server timeout, just do Load with Images again; if some GIF or JPEG images still don't load, send me the document and image URLs so I can test. If the images are large or you get GIF conversion errors (e.g., 50K @ 16-grays), you might try using a lower resolution and check that you have enough space available on your specified Image store.

Load Links

allows selection of links in current document to load to the cache. (Ideally, this could be done via a special autoload preference and Schedule, but since there are potentially many links in a document, this is a manual experimental option for now). It should includes all http: URLs, but it does not check in advance for helperApps; it could include ftp: URLs if NewtFTP supported getURL API.

Load Frames

If current document is a FRAMESET document, View:Load Frames lists any individual frames that can be loaded.

Document Source

display (cached) HTML source for an .htm/.html document via Newt's Cape book viewer as PRE text (default). You can also use Save HTML to NewtWorks, or Save HTML to Notes if source is not too large, or specify a different helper app to view "text/plain". After viewing source, you will need to remove the current book in order to browse/parse the HTML for this URL.

View Helpers

2.x only. creates a book with a table listing currently installed MIME types (sorted alphabetically), application symbols and built-in items, and specific file extensions (if any).



return to the previous link location (in history list). same as the Back arrow button in the book control bar.


return to the next link location (in history list) -- after a Back. same as the Forward arrow button in the book control bar.


goes to Other Options:Startup URL, if specified.

Newer HTML Cache Item

processes "next" newer item (URL of item above in HTML Cache overview)

Set HTML Cache Item

sets starting item in HTML Cache to current URL, if any; otherwise, oldest item in cache; it then does "Newer Item"

Newer Image Cache Item

processes "next" newer item (URL of item above in Image Cache overview)

Set Image Cache Item

sets starting item in Image Cache to current URL, if any; otherwise, oldest item in cache; it then does "Newer Item"

Clear History

clears history list

(History items)

a list of up to 20 most recent link locations (most recent at bottom). select an item to go there directly.


2.x only. Newt's Cape obtains the current URL first from the URL area -- if the text begins with http:. You can drag/copy the current URL from the URL area to Notes or to a 3rd party bookmark manager; or add a HyperLink to HyperNewt from the book.


opens overview of current bookmarks, similar to HTML Cache.

Add Bookmark

adds URL or title to user bookmark soup; if bookmark with same URL already exists, it updates the title and places in Unfiled. bookmark appears in Bookmarks menu and/or overview. You can also add a bookmark from a book link or HTMList.

Remove Bookmark

removes URL from current menu and bookmark soup. also see overview Delete command.

Newt's Cape Example Page

annotated collection of examples: text, form, graphics, package, NewtonScript.

(user bookmarks)

folders for bookmarks in current user bookmark soup; select folder for submenu of individual bookmarks. Unfiled folder normally appears; if Unfiled bookmarks in menu preference is on, Unfiled items appear in initial menu (instead of Unfiled folder).


We now return to covering the many preference settings available in Newt's Cape.


Specify Newt's Cape settings, especially NIE-related. For 1.x, only Doc Done Sound, Page Size, Scale Images to Fit?, Pkg, NewtonScript, and Startup/Proxy URL appear.


2.x only. If you have a number selected (i.e., not "no cache"), Newt's Cape saves any source obtained via NIE (or serial optionally) in a soup called HTMLCache:NewtsCape. You can remove individual entries using the overview File:Open HTML Cache or Remove from Cache.

no cache
empty cache (immediately) and disable
10-500 maximum items (default: 50)
number of regular cache entries to keep when quitting Newt's Cape -- this is after removing any expired or temporary, unlocked entries; Newt's Cape then discards oldest entries. it defines a "temporary entry" as one whose URL contains "?" or one obtained via a POST query. Note: during a session, this limit can be exceeded by temporary and regular entries. If you plan to fetch many, large documents you may wish to set this lower, depending on how much memory you have available (or exit/re-enter Newt's Cape to remove a few entries; or set to "no cache" (to clear), then to a number).
trust cache?
if on (or for a temporary entry)
already connected
do not ask server to check for more recent version
not connected
use cached entry directly without asking to connect
if off (default)
already connected
ask server to check for more recent version
not connected
ask user to connect; if user closes without connecting, use cache entry
recommended setting: on for HTML (unless you expect frequent changes or don't want to Reload manually)
Store (popup) preference to specify a specific store for new cache items. if this is not set or not available, new items appear in the default store (main Newton setting) as in earlier versions.
ignore expiration?
if on, Newt's Cape ignores expiration date of cache items; to remove, manually Reload or Delete items (or turn off preference before quitting Newt's Cape)
empty upon quit?
automatically discards all items from cache when you quit; opens new cache when you start
show items in overview
if on, View:Load with Images,Links,Frames show all (not just uncached) items in overview -- cached items prefixed with bullet (Bookmarks overview also indicates cached items)
autoload Frames?
load individual FRAME documents automatically (View:Load Frames)
merge Frame source?
merges actual frame source into original main (FRAMESET) document in cache; include Frames? and autoload Frames? must both be on also; the resulting book should look basically the same as just include Frames?, but heading does not link to individual frame doc, and redisplaying the single cached item should be faster and View:Load with Images, Load Links should work; (disadvantages: more storage space if large individual frames used in multiple main documents); generally, you should be comfortable using the include and autoload options with your frame sites before enabling this option; if certain frame sites don't merge, please send me the URLs (it's possible the HTML is degenerate (missing HEAD or BODY tags) and/or there are still bugs in Newt's Cape)
remove? <!--...-->
removes HTML comments (including JavaScript) from documents, to shrink cached size and increase processing speed somewhat. default: on. (if comments removed, "Parsing length" may be less than original transfer size)
if on, and source transferred via serial or ADSP and contains a BASE HREF beginning with http:, Newt's Cape adds/replaces the source in the cache
store text files (whose MIME type is text/plain) in HTML Cache to view later or process with a different helperApp.
Fix ISO Chars?
this preference may be removed in future versions if the Encoding plugins do a sufficient or better job. this provides an interim fix for users who are outside US or read pages with embedded accented characters (e.g., German, French). Generally, the page author should have used "character entities" such as &Uuml; for Ü rather than embedding the character code, even though technically, these extended 8-bit characters are part of the ISO-8859-1 standard. The problem is that the Newton low-level communication code applies a default encoding table ("MacRoman") which maps these to other characters. For now, if the Fix ISO Chars? option is on (and you do not have the Encoding and ISO-8859-1 plugins installed), Newt's Cape re-substitutes ~60 characters -- this will slow down transfer somewhat. If some characters still don't translate, send me a specific URL (and also how the character should appear in browser),and I'll see if I can fix this (or following table), assuming the Newton has the character in its font. Eventually, I may provide an encoding module (like for Japanese, Chinese), but this may be overkill and does not appear trivial to do.


2.x only. Newt's Cape saves any image (GIF only currently) obtained via NIE in a soup called ImageCache:NewtsCape.

no cache
empty cache and disable
10-500 items (default: 50)
same behavior as for HTML cache.
trust cache?
same behavior as for HTML cache. recommended setting: on for Images (unless you expect graphics to change frequently on server)
auto load?
if selected (default: "none"), Newt's Cape scans subsequent document source for occurrences of graphics (i.e., IMG and INPUT TYPE=IMAGE tags), retrieves the graphics into the Image Cache, and then reprocesses the document to display the graphics inline. You can also load only the first 1 (2, etc.) images on a page by selecting a number. You can also select All to load all images. To avoid accidental transfer of many/large images, we would recommend, however, that you leave this set to none (or a small number), and reprocess a single document using the Load with Images command in the View menu. (Note: Newt's Cape does a quick text scan/pattern match, not a full parse, so it's possible that it may miss some syntactic permutations or be confused by pseudo-images in FRAME or BODY attributes).
original (unconverted)?
if selected (and usually Cache Only Process option is selected), cache original GIF image rather than convert immediately into Newton format; this should generally be turned off, especially for JPEG; image will be converted each time it is accessed (although slower, this may be useful for experimenting with different numbers of grays, or threshold level).
if on, converts animated GIFs as sequence of frames (otherwise, first frame only). If you have many/fast animations on a book page, you may want to use Process:Display All to prevent display from interfering with parsing.
scale to fit?
if enabled (default: off), a graphic/animation that is too large for screen/page/table cell is scaled locally to fit (rather than scrolled); any client (AREA) regions are also scaled down; server map coordinates are scaled up.

scale to fit?

1.x only checkbox: same as 2.x Images option (above); note: PICTs are not scaled.

Res. (Resolution)

2.x only. sets the graphic resolution for GIF conversion.

B&W(threshold) (default)
black and white (1-bit resolution). specify an optional threshold value between 1-254 (default: 128) in field to right; GIF converter "rounds" values above this to black; it rounds values below to white
2.1 only. 4 gray levels (2-bit resolution). threshold field hides.
2.1 only. 16 graylevels (4-bit resolution). this usually looks the best, but also uses the most storage.


2.x only. Cookies are small amounts of state information provided by certain servers.

skip all cookies (default) -- Newt's Cape does not save cookies, nor does it send cookies; this also removes any earlier cookies.
(default) confirm whether to keep/send cookies for each host
keep/send cookies (without asking)

If a server suggests that Newt's Cape is not capable of handling cookies, it is probably discriminating on the User-Agent field. One solution is to contact the site administrator and ask them to recognize "User-Agent: Newt's Cape/...". It might also be possible to add a User Agent Prefix, e.g., "Mozilla/2.0 [en]" to try to trick the server into thinking you're using a suitable version of Netscape, for example.

Doc Done

built-in sound to play when document finishes processing (default: none). 2.x includes any additional registered sounds, e.g.,

Page Size

select page size to use -- 1.x default: portrait; 2.x default: full

help book
240x320 portrait size only
320x240 landscape size only (2.x)
Full (2.x)
full screen -- on smaller MessagePads, this is portrait or landscape size, depending on orientation; on MP2K and eMate300, this could be 480x320 or 320x480)
Full-NIE (2.1)
preferred to other "Full" sizes for online browsing (i.e., while NIE connected) to avoid system freezes when closing full-screen views on eMate and non-upgraded MP2K.
Full-4 (2.1)
full screen (but shift 4 pixels to right) -- if full screen books are shifted off left edge of screen, use this option to work around bug on MP2K and eMate300 with old ROMs

Notes: Actual vertical size is 2 pixels less. A portrait book on landscape 2.1 may not update page number properly until it's saved as a package. You can also specify your own page sizes directly via Book Page Width/Height preferences.

Help books have a smaller screen size (and different viewer), and are best suited for small pages with headings. Links to help sections display just the corresponding heading in the Topics list (not the content page directly). You should set Above for Hx tags to 'Top. Too many headings may not scroll. Since help books differ slightly in underlying implementation from regular books (and 1.x vs. 2.x), there may be other problems (reports and feedback appreciated). Help books can be saved as separate packages or as part of a NewtDevEnv application.


if NewtPack is installed, this picker appears. Note: the settings before processing the document are used (changing just prior to saving does not apply to current book).

label: Pkg(1.x) or Pkg(2.x)
if both Newt's Cape and NewtPack are 1.x compatible (i.e., non-"-2") versions, 1.x indicates that book package will be 1.x compatible; otherwise, 2.x appears
if checked, Newt's Cape or Newt's Cape Lite will not be required to support basic navigation and back/forward book buttons; otherwise, each saved package will be (~25K) smaller and "Lite" appears. To open or follow http: entries, you would need full Newt's Cape installed in either case.
if checked, package is stored compressed -- this eliminates the need for package.compressed META attribute.

Bookmarks (2.x only)

pick a bookmark soup: none, Bookmarks:NewtsCape (default), or a compatible 3rd party bookmark soups:
set default store for bookmarks
Unfiled bookmarks in menu
Unfiled items appear in initial menu (instead of Unfiled folder)


Although we are not aware of any actual situations, it is possible that a web page could contain a malicious fragment of NewtonScript. When set to none (default), Newt's Cape ignores any NewtonScript embedded in HTML documents. If you create your own pages, download trusted pages (e.g., examples.htm) or examine the source yourself, you may want to change the setting to Compile to allow Newt's Cape to evaluate expressions and compile methods while processing those documents in order to provide richer appearance and functionality.

Auto hide?

if on, automatically hides Newt's Cape when it's finished processing a document; you can reshow Newt's Cape via flashing star at top(2.x), or Newt's Cape button in book control bar


If a proxy or host requires "basic" authentication, it will prompt for user name and password as needed; after completing, tap Authenticate to reload the page. This information is supplied automatically for subsequent requests to the same proxy or host. There may be situations where you want to provide authentication in advance, e.g., you've turned off "trust" on caches and are about to Reload a page or Load with Images and are going through a proxy server that requires authentication or to a host that requires authentication. You may also want to preserve authentication information across multiple sessions. To prevent multiple password prompts from appearing, you can proactively login in advance -- just tap this button, fill in the host (without http://), user name and password. You can also Authenticate in advance for a set of scheduled pages.

list of potential host names -- picking one sets Host
from server prompt
just the name of the current host
from overview:Schedule
list of hosts for selected items (you can set different names and passwords)
from i:General
all persistent and current temporary hosts
these are in 3 groups
temporary for current session (discarded after quitting Newt's Cape or Reset HTTP)
None (for overview:Schedule)
no password stored
current host; this can also be a list of host names, separated by semi-colons
user name (if known) for current host; first host for list
password (if known) for current host; if this is via a server prompt, it's most likely wrong and should be corrected
if checked, make the Name & Password 'persistent' -- until next Reset All -- this is similar in behavior to Cookies:Keep; otherwise, it's temporary for the current "session" -- discarded after Newt's Cape quits or any Reset HTTP
if Name or Password is empty, removes any Keep or Temp. entry; otherwise, sets Name and Password for all hosts in Host -- persistently, if Keep is checked. If this was a server prompt, this exits and retries the URL (as before); otherwise, list of Hosts is updated

Other Options

This picker contains many miscellaneous options. Items with non-default values are prefixed with a dot. The 3-line input field below is used to display/enter the value. For some items, any non-empty string specifies "true".

Startup URL

After Newt's Cape starts up (or Go:Home), :getURL is called with this URL (this can also be a local URL such as "Notes/foo.htm").

Proxy URL

On 1.x, this appears as Proxy Host. In order to access the net through firewalls, you can supply a proxy host and port, e.g., For 2.x, it should begin with http://; the port number is optional (default: 80).

You can use a mailto: proxy to send URL requests to a mail server, especially for 1.x, or for 2.x, even if NIE is installed. Since is no longer available, try one of the following free web-mail servers below (if you find others, please let me know). Since these may differ in command syntax, the mailto: proxy can include subject (the examples below are empty) and body fields (the body field is a pattern expression with the document URL substituted as a parameter). Examples for some currently known servers:

Note: SpeedyLink requires pre-registration (free) and returns text-only pages; link navigation via special commands.

Proxy Only

2.x only. Even if you have specified an http proxy, you can specify that it be used only for certain hosts. Include any domains, separated by semicolons, e.g.,;

Proxy Exceptions

2.x only. Even if you have specified an http proxy, you can still access certain hosts directly. Include any domain exceptions, separated by semicolons, e.g.,;


2.x only. You can create a Find options frame for your favorite search engine; the current default is AltaVista(Text). This allows you to highlight a phrase in Notes or NewtWorks, and tap Newt's Cape:Find. There are several fields to supply (best obtained by looking at the HTML form that you use for the search engine): Find.Title, Find.URL, Find.Method, Find.Data (and Find:CheckData to "compile" the frame).

Find.Title appears in Notes menu when a phrase (not URL or HTML source) is selected. e.g., AltaVista would appear as Newt's Cape:Find (AltaVista Text). If this is empty, Notes will not display a :Find command; if Newt's Cape is closed and it's unclear if there is a Find pref, it will display :Find?


URL for a search engine, e.g., This would typically be the ACTION of a search form.

To set Hemlock for Find, set Find.Title to Hemlock, so that Newt's Cape:Find(Hemlock) appears (if Newt's Cape is open); no need to change Find.Method or Find.Data. Change Find.URL to Hemlock following by a list of search engine names (as they appear exactly in Hemlock; assuming they've been added/initialized), separated by semicolons; for example,

no search engines; just open Hemlock, copying the search phrase; you manually select engine(s) and tap Find
search using Yahoo! and HotBot
use all search engines in Hemlock's current list
use all search engines in current list (but you can easily use your old list by erasing _all)

GET or POST -- corresponds to the METHOD of a search form; must be uppercase. e.g., GET for AltaVista.


NewtonScript source for an array of alternating data slots and values e.g., for AltaVista Text: ["q","","text","yes","pg","q","what","web"]. You would typically obtain these by looking at a FORM and its INPUT, SELECT and TEXTAREA objects in a search page. Note: first slot in the array must be the "query" slot -- Newt's Cape sets this slot with the selected phrase from Notes or NewtWorks. Slots correspond to case-sensitive NAME attributes. Values are strings for default and hidden VALUE attributes; for checkboxes, enclose the value(s) for same name in an array, e.g., ["checked"].

In case of very long data definitions (since this is only a 3-line text field), enter last fields first, and then add other items before these to keep most recent visible; select CheckData several times to catch any errors early (since you won't be able to edit the last items conveniently). If you add this for your favorite search engine, let me know the parameters you used, and I'll summarize for other users.


compiles and checks the data frame definition -- you must do this after editing Data. Possible responses:

Agent Prefix

2.x only. default: none. primarily for advanced users/testing. some servers may use the User-Agent request header attribute to route you to different pages, or to assume (incorrectly) certain capabilities, e.g., cookies; this allows you to add a prefix to the usual "Newt's Cape..." label. e.g., "Lynx Newt's Cape...".

Agent Size&Res

2.x only. default: none. some experimental web/proxy servers might generate different pages and/or graphics based on browser/screen size and resolution. If non-empty, includes fields in request header:

based on Page Size preference and possibly screen orientation
based on Res. preference

Accept-Language and Accept are for customizing the HTTP header request so that certain servers might return a different version of a page. If you specified fr; q=1.0, en; q=0.5, for example, and if server recognized this, server would return a French version of a page; otherwise, English.


Newt's Cape normally sends */*; if you specified text/html-newton; q=1.0, text/html; q=0.9, */*, and if server recognized this, it would return a Newton version of a HTML page; otherwise, regular HTML or other MIME type.

Auto Login

non-empty value means login automatically (without confirmation) using default link setup

Reset HTTP

This releases Newt's Cape's NIE connection after interactive transfers, allowing NIE to disconnect after usual timeout. (Connection is normally released automatically after quitting Newt's Cape or finishing Schedule, or a manual File:Reset HTTP)


isbn (default: introtoc.htm) of a local book to follow when selecting i:Help

Don't Show Newt's Cape

if on, generally keeps Newt's Cape invisible -- primarily intended when Newt's Cape is accessed from other applications. A safer preference to try is Auto hide? option.

Don't Close Book

if on, keeps current book open until the next document begins to display. Advantage: keeps content on screen as long as possible; disadvantage: ties up heap.

Ignore META Refresh

if on, prevents automatic redirection via META REFRESH tag; hopefully page provides a manual link. Note: this does not prevent server-based redirection

Ignore Tables

if on, ignores table tags. If certain pages do not display correctly due to hardcoded table layout (e.g., width) information, differing numbers of columns, or table nesting, you may want to try turning on this option and reprocessing document.

Include Frames

If off, Newt's Cape includes only links from main document to individual frames. If on, it temporarily appends content of individual frames into main document (for a more complete merge, see Merge Source)

map FRAME to tag

lets you specify a different tag (and thus appearance) to display "frame heading" (default: H1, so it appears in TOC); when frame is included, frame TITLE or filename is surrounded by parentheses


if non-empty does not use user installed fonts for FONT tag, but always maps to built-in(Simple,Fancy) and PRE fonts.


specifies text to use if missing IMG (with no ALT attribute); if empty (default), "?" icon appears

Display unknown <tags>

(if non-empty) displays unknown tags (handy for XML or mutant HTML); otherwise omitted (default)

Newt's Cape button

this is used to customize the behavior of the Newt's Cape (icon) button. if the preference is empty or not recognized, it performs File:Open Location. If the value partially matches Bookmarks, this is the same as if you had selected Bookmarks:Browse/Schedule; if the value partially matches Open Location, Notes, Inbox, Paperback, WabumiUni, NewtWorks, HTML Cache, Image Cache, or Nethopper, the appropriate File command menu appears. It also matches Newer HTML(Image) Cache Item for Go menu. Note: available items depend on your version and language -- see what commands appears when you tap the File button. e.g., Works would match NewtWorks; HTML would match HTML Cache; Eingang would match "Inbox" (in German version). You could still open an occasional URL in status area by tapping File:Open Location.

Overview not floating

if on, displays full screen overviews underneath other floating views, such as Button Bar Plus; since it would float underneath main Newt's Cape view also, you would move or hide/reshow Newt's Cape to see bottom-most overview items and file/action buttons

Change keyboard keys

allows you to customize the top row of added keys; the preference value is a list of comma-separated labels which replace corresponding keys: http://,www.,.com,.edu,.net,.htm,.html. You can include a space (or end list prematurely) to skip existing keys; erase value to return to original defaults. Does not allow modification of key widths, so widest keys should be first or second; last key is slightly wider than middle keys. You'll have to manually close old keyboard in order to open new one.

NewtWorks HTML via Summary

File:Open NewtWorks should provide a complete list of documents that contain <HTML>; if this is too slow and/or the Newton runs out of heap when you select File:Open NewtWorks, you can try turning on this option (non-empty value); if on, Newt's Cape checks only the "summary" slot of the document without actually doing a full text search; however, this apparently can miss some documents -- either that don't have <HTML> in first 80 characters, or that don't have a summary slot at all, e.g., transferred via NCU?; or, you might try making "missing documents" visible by selecting entire content and copying to a new NewtWorks document (or just turn off the preference)


specifies the body text to appear in an email message when you tap a mailto: link. set this to something non-empty like "hi"; if empty, no message is generated/placed in your OutBox; default for new users or after resetting Main Pref Set: "hi, I saw this cool document in Newt's Cape".

AutoLink Exceptions

a list of substrings (host, file extension, URL fragment) to filter out URLs when scanning for links to automatically load in scheduled documents. e.g.,;; .sit, .zip. Note: all scheduled sets use this preference in current PrefSet.

Book Parameters

There are several options you can set before processing a documents into a book -- be sure to reset manually later (ideally, these would be edited via a book's About dialog, after creation of a single book):

Book Page Width and Book Page Height
integers to override dimension(s) of current Page Size setting; be sure to check that the book reader behaves properly, e.g., updating page numbers
for documents from Notes, NewtWorks, Inbox, desktop, you might want to set full absolute address (http://...). so that relative links and image references are resolved properly; this is overridden by BASE tag if any, or by URL from a cache item
unique 14 character string to identify a book; overridden by META NAME=ISBN, if any. prefix with A!: to identify a book with a picture for Avi's Backdrop
Book ShortTitle
appears as book title in Extras (usually no more than ~18 characters for 2.x); overridden by META NAME=SHORTTITLE, if any
Book Title
appears at top of each book page; overridden by document TITLE tag, if any

I Paid

After you register, you can check this to prevent the About box from automatically appearing when you start Newt's Cape.

NIE Setup


You can switch between sets of preferences ("Pref Sets") in the main i menu-- this is somewhat like the Macintosh Extension Manager. You can manipulate Pref Sets via the action button. A Pref Set could be useful when using different fonts for a particular language Encoding, or switching to "dumber" settings for problem web sites, e.g., Ignore Tables, don't Include Frames, etc.; all preference-related info, including cookies and authentication, is stored with current Pref Set. Pref Sets appear under "i" menu, with only Main Pref Set initially. When you select a different Pref Set, Newt's Cape does some reinitialization; selecting same set opens General preferences. On the action button in i:General:

displays PrefSet name in editing area
renames current PrefSet to new name from editing area (if non-empty and not already used); you can rename Main Pref Set to something else if you like, e.g., "My Defaults"
copies current PrefSet, using a name of current PrefSet plus "_copy" (if unused). Use this to create a new PrefSet, then Rename.
deletes (after confirm) current PrefSet (except Main Pref Set), and returns to Main Pref Set
Reset All
resets all settings (after confirm) in current ref Set to Main Pref Set (this assumes Main Pref Set contains your usual defaults); for Main Pref Set, this resets to system defaults


Customize properties of different tags, e.g., font, indent, etc. These prefs are saved across sessions as System preferences. (Note: individual documents can override these Prefs via META -- this is discussed in an advanced NewtonScript document).

Hx, P, PRE, etc. Modified tags appear with a bullet prefix and display Defaults button. Note: PRE will also affect CODE, KBD, SAMP and TT phrase tags. Form objects support font, and Above/Below; TEXT_LABEL and SELECT_LABEL refer to label part of fields; SELECT_MENU (2.x only) refers to popup menu; PASSWORD font same as TEXT (and TEXT_LABEL); RESET font same as SUBMIT. TITLE can be used to specify a different font (and Align for 2.x) for the title which appears at top of each page; this should be especially useful in ~J,~C versions; there may be a refresh delay for non-default settings.
for Hx, text pattern for missing levels. default: "". If you specify a pattern, e.g., "{missing ^0}", ^0 is placeholder for Hx tag.
if any modified, button appears; tap to return to built-in default values for this tag (this also removes any preference entry)
indent (in pixels) above this object. 'Top means start object at top of book page (this might be useful for H1). Other sample values provided.
indent left of object
indent below object
what to do when object does not fit on remaining page
split using same tag for remaining object
don't split (keep together, starting new page if necessary). recommended for Hx
'P (or other tag)
split but use this object tag for continuation, e.g., for LI
alignment of text (this is overridden by any ALIGN attribute): Left (default), Right, Center, Justify ("full" justification -- not great on short lines)
name of font (depending on system):
an integer, typically between 8-24. note: sizes for H6-H1 tags define FONT SIZE=1-6; H4 corresponds to BASEFONT SIZE=3
Plain, Bold, Italic, BoldItalic, Underline (this may be redone as checkboxes for more combinations)
example using current Family, Size, Face, Align
System Family, Size
2.x only. default: System. primarily intended for users who have Japanese/Chinese Newtons, or install Japanese/Chinese fonts on English Newtons, and do not have a system-level patch to make these default. For example, select Kanji14 in System Family. Fonts in the Newt's Cape interface change to use the new font as default. You still need to choose HTML tag fonts separately in i:Appearance. System Size (default=9) is used for labels and buttons; you can choose 10 (if 9 is not readable and items fit). Data, menu and status values use 10 point (if Size=9) or 12 (Size=10); user editable entries use 12 point (in either case). There is some extra initialization that is required and some (slow) redisplay, especially for menus.


2.x. If Encoding plugin is installed, along with Japanese or Chinese encodings. select a NewtonTextEncoding for exchanging data between desktop or http server and Newton (default: 'sjis = ShiftJIS). Thanks to Shinobu Yamada; for cool, funny, useful applets or information for Newton users in Japan, see MarbleDevelopment. Thanks also to "GNUE" (aka Makoto Nukui) for the NewtonTextEncoding(NTE) development tool.

Main Pref Set

You can switch between sets of preferences ("Pref Sets") in the "i" menu -- learn more about creating, renaming, deleting Pref Sets.


Under i. Process displays current processing options (including htmlApps). Note: for NOS 2.x, the current screen orientation (via system Rotate button) can be used to create the book in portrait or landscape (see Page Size).

Display Item

As Newt's Cape adds a content item to the book, it immediately displays and updates the same book page (unless the book already exists -- see Display). At the end of the document, Newt's Cape positions the book to page 1, # link destination or page from History menu, and optionally plays a sound.

Display Page

The default. Newt's Cape displays each consecutive finished book page (while the next page is processed). This is much faster than Display Item (especially on NOS 2.x).

Display Page1

Similar to Display Page, except that it does not scroll automatically to subsequent pages during processing.

Display All

Newt's Cape displays the book only when it is entirely finished. For documents that contain many animated graphics, especially on slow or heap-challenged MessagePads, this option may be best.

Cache Only

For NOS 2.x and NIE, this can fetch an HTML, GIF or JPEG document into cache, but without parsing and displaying it. You can process it later, e.g., when logged out to save time or maximize heap. This is also handy if you want to experiment with the Gray Levels or B&W threshold for unconvertedGIFs.

Save Package

if NewtPack is installed. It is similar to Display All, followed by selecting Save as Package (under File). However, with this option, Newt's Cape can create a much larger book (especially on 1.x) -- since it does not have to actually display the book, it can store some objects (text and graphics) in a separate temporary area on your default store rather than in limited heap.

Save NewtWorks

2.1: creates a Newtworks document directly from HTML, rather than create a book first and then use File:Save Book to NewtWorks. This is much faster; however, it has the same problems as Save Book to NewtWorks: long lines not wrapped (horizontal scrolling needed), horizontal layout (e.g., tables) not supported, links inactive, and form objects not included. URL appears at end of document.

Other Process Plugins

Other applications can install process options. For example, an application might collect bulleted items into bookmarks or into a Notes outline. see installHTMLApp API and htmlApp example.

Status Line

if bottom triangle expanded. The status line (below commands) displays information for NIE*/serial connection and transfer progress, parsing (number of tags/current tag), installing a package, and saving a book (NewtPack). It replaces various progress boxes in earlier versions. Status information is refreshed as time permits. since this is based on lines currently, really l-o-n-g (many K) lines, e.g., query results with few line breaks, may appear to hang (after completing)-- just wait awhile for line to finish parsing. Status gauge may appear on right side (above Stop) to indicate transfer, parsing or installation progress.

*If you do not have an active NIE connection, the NIE connection box appears the first time you attempt to access a URL that's not in the cache. This document assumes that you already know how to configure and establish your connection. If you close the connection box (rather than tap Connect), or tap Stop during the connection process, Newt's Cape should stop accessing the current URL (and also flush any other pending requests, e.g., graphics). If a site requires a name and password, an authentatication dialog appears.

Error Line

if bottom triangle expanded. The error line (below status) displays error messages from transfer or parsing. If you are using a serial or ADSP connection, error messages may be printed to your terminal emulator.

Hide button

Sometimes you may want to get Newt's Cape out of the way without dragging, or a more time-consuming close/reopen. To hide Newt's Cape, tap the small star(2.x)/gray close box(1.x) to the left of the close box. You can also set Auto hide preference so that Newt's Cape automatically hides after processing current book. You can reshow it quickly from the flashing star at top center of screen (2.x), book bar(Newt's Cape icon) or Extras.

Newt's Cape Close box

When Newt's Cape quits, it releases any open connection (NIE or serial), removes current temporary book, restores heap, and cleans up the 2.x caches (checks/removes any temporary or old entries to maintain number of items specified for HTML and Images caches. it also discards any authentication information). If you just want to hide the Newt's Cape window temporarily, use the star to its left.

If you are using a "freeze manager", you can minimize problems by manually Closing any open serial connections and doing Reset HTTP (any NIE connection) and waiting a few seconds before quitting. (Ideally, freezing managers would allow a few seconds for asynchronous closing of communications)

Apparently, the 2.1 book reader maintains a large number of entries for "offline book" entries (for annotation and bookmark info); Newt's Cape now removes all except the most 20 recent offline entries (rather than let this grow indefinitely).

In The Book

The book consists of several areas:

  1. title: 1 or more lines at top; corresponds to TITLE tag
  2. content area: your document
  3. control bar (bottom)
  4. system commands: Rotate, Find, overview, scroll up, scroll down

During processing (if Display Item or Display Page is selected), or after selecting View:Current Book in Newt's Cape or tapping the book's icon in the Extras Drawer, you should find yourself in the current Newton book.

While the current document is still processing, you should not follow links until the document is finished. If there are a lot of animated graphics on a page, you may want to try to scroll to a different page to minimize contention (or use Process:Display All). If you need to abort the current document (e.g., too large or strange), you can try the Stop button. A document might be truncated if a server disconnects prematurely, or sends extremely long lines which overflow buffers.

Content Area

You have some control over the appearance of your document: fonts, page breaks, etc. (i:Appearance).

If a ? icon appears for missing graphics, you can load graphics for current document by using a line gesture, or selecting View:Load with Images. If a graphic appears with a 2-D scroller at its lower-left corner, you can re-parse the document after changing scale to fit. Underlined text, outlined graphics usually indicates a hypertext link or image map. In addition to tapping a link, you can use several gestures.

hold down to select then double-tap selection to copy/drag text
line gesture (horizontal is easiest)
brings up a menu
Go: ...
follow link URL (same as just tapping on link)
Display URL
display full (resolved) link URL in status area (copy it, etc.)
Cache Only
retrieves link URL into cache but does not process it (like Go)
Add Bookmark
add bookmark for link URL (with highlighted text as title) to Newt's Cape. see Bookmark:Add Bookmark.
Load Image:... (for ALT, graphics with links)
get graphic URL, then re-process current page; same as View:Load with Images with just this graphic

If you're not sure what's behind a link, it's best to use horizontal gesture rather than just tap. A link may appear not to work if there are bold or unusual font changes earlier in the same paragraph. If a URL matches a local object, that application or book opens (for NOS 2.x, if local document is a frozen book or application, it is thawed). If the destination is an absolute URL (begins with http://...) or is relative to the BASE of the current document, Newt's Cape uses NIE (for 2.x) to request the document; for 1.x, it generates a WebMail request (you can delete these from your Outbox if you change your mind).

Book Control Bar

This bottom bar should already be familiar to you (other books, MessagePad manual); Newt's Cape adds Newt's Cape icon, back and forward buttons.

icon next to book close box
expand/collapse book bar. Newt's Cape books open initially with book control bar expanded.
info button
About displays book title, author, publisher, copyright, date; Help displays System help book; Prefs displays page size.
bookmark (pages) button
this can be used to create a list of marked pages within the book. Note: these do not persist for temporary books.
annotate (squiggle) button
this can be used to add notes to pages within the book. Note: these do not persist for temporary books.
Newt's Cape icon
(to the left of the page number on NOS 2.x; on right on 1.x) tap Newt's Cape icon to reshow Newt's Cape. note: if Newt's Cape is not installed and book is standalone, this should appear as a large overview dot -- tap to popup list of 20 most recent link locations, or to Clear History (similar to Go button).
current page number
tap this to jump to a different page (use scroll arrows for moving to previous/next page)
Back button (a "left" arrow)
adds "current" book to history list; go back to an earlier link location. This is also available under the Go button in Newt's Cape. Note: if you are returning to a form, the earlier data is not restored (unless it was a saved book).
Forward button (a "right" arrow)
return to a link location (before Back); forward in the history list (similar to desktop browser). If button is not applicable to current history, it appears with a gray border.
action/routing (envelope) button
you can Print/Fax all or a range of book pages; this uses the built-in book reader format, which arranges several book pages per paper page. Print Later only works with saved (package) books; for temporary books, use Print Now. If HyperNewt is installed, you can select "HyperLink" to save a link/bookmark to the current document (URL, isbn and page number). If RouteBook 2.x plugin is installed, tapping routing button (again) offers other commands: Beam, Mail, Speak. If HTMList plugin is installed, routing button includes: Save to NewtWorks, Save as HTML to NewtWorks, Save as HTML to Desktop.
close box
book closes. you can redisplay book with View:Current Book

System Commands

These are usually found on the silkscreen or floating menu bar.

Find button
Find will not usually find text in 2.x temporary books (due to the way that objects are stored); Find should work properly with saved books.
overview button
popup Table of Contents (TOC) headings, based on contiguous H1-H6 HTML tags. Note: you can customize the text for missing levels. You close the overview from Newt's Cape (rather than moving or hiding it).
scroll arrows
previous/next book page
2.x (in Extras menu). Rotate keeps current book if it's a help book, or portrait/landscape on 2.1. Subsequent books will be created by default in the current orientation (either portrait or landscape; perhaps both in the future; see Page Size).

Notepad and NewtWorks

You can do three things from NewtWorks (2.1 only) or Notepad documents:

  1. select and follow URL(s)
  2. process an HTML source document
  3. 2.x: Find a highlighted phrase using a search engine

In NewtWorks, select text in a Paper (not Drawing) document; or, in Notes on any MessagePad. If no selection, entire document is used (except 2.x Outline/Checklist). Note: if Newt's Cape does not appear in Tools menu, you should make sure that NewtWorks installs before Newt's Cape, perhaps by storing NewtWorks on Internal; or, you can freeze/thaw Newt's Cape to force it to register with NewtWorks manually. Here is how each action is recognized/performed:

  1. select URL beginning with http: (or mailto:, news:); or a list of http: URLs, on separate lines
  2. select Tools:Newt's Cape (or type cmd-H -- for "HTML") in NewtWorks, or select Newt's Cape:getURL in Notes menu
  3. Newt's Cape goes to that URL. for multiple lines, Newt's Cape updates the set (same as Schedule "immediately"). auto load images is temporarily disabled (presumably, you're offline and don't want to keep dismissing NIE connection dialog)
HTML source
  1. select text containing <HTML> (or no selection for entire document)
  2. select Tools:Newt's Cape (or cmd-H) in NewtWorks, or select Newt's Cape:Open in Notes menu
  3. Newt's Cape processes the HTML source
any other text (upto 100 characters)
  1. select text to be used as a query (default: all)
  2. select Tools:Newt's Cape (or cmd-H) in NewtWorks, or select Newt's Cape:Find in Notes menu
  3. sends query to a search engine directly (to specify a different search engine, see i:General:Other Options: Find.Title, .URL, .Method, .Data Prefs)

Save as HTML command also appears if HTMList is installed.


Similar to Notepad and NewtWorks, you can process a list of URLs (:getURL), or process an HTML source document (:Open) in the Inbox.


Similar to Notepad and NewtWorks, you can process a URL (:getURL) that is in a custom "URL" field, or in the Notes field of Names (it ignores any <!-- HTML comments --> in Notes), or process an HTML source document (:Open) in Notes.

For More Info

This document (in all its formats) is © 1995-2007. Steve Weyer, Greg Simon. All Rights Reserved Worldwide

Version 2.1. Last updated: Dec 2000