Standard Info for Registered NewtDevEnv Users

This information is for registered NewtDevEnv users. It contains the standard, "stable" versions of NewtDevEnv, docs and related tools. If there are new features or bug fixes that you would like access to, or you don't mind helping with testing, there will be references to beta versions on the main regnewt page. If you have changed your (preferred) email address recently, please let me know so that I can keep you informed. (I often remove an address when it bounces with unknown user or host).

Many external links may be obsolete -- if you have updates, please send. There may be problems with .pkg files (esp. for Mac OS X); it may be safest to use .zip archives.

To help me resolve problems with NewtDevEnv most quickly, I would appreciate the following information:

Note: you might also check first if this is a known problem (sometimes reported at top of regnewt page, or on main newtdev page), or if it's something already fixed in a newer beta.

Downloading

As an experiment in software distribution, additional Newt-related documentation, Questions&Answers, examples and other packages and plug-ins are available via this page, in the /regnewt directory.

The .zip archives are password protected. Check with me if you have lost/forgotten it.

Please do not redistribute files, password, page.

To test transfer and make sure you can unzip and open a password protected archive, try these smaller files first. If you transfer files via http, you may need to configure your browser so that large files get Saved rather than opened in a text view. For .zip files, make sure you transfer as binary; also use a relatively recent version of PKUNZIP (users have experienced problems with Norton utility; or I can use a different compression option for slightly larger files)

Test

.zip

Terminology

NOTE: I will use the following terms:

1.x/2.x-compatible
works with either 1.x or NOS 2.x systems. The default.
2.x-only
works on 2.x systems but not 1.x systems. These packages are usually smaller than the 1.x/2.x compatible versions. Packages created with any 2.x-only tools become 2.x-only (both in method and object format). File usually has a "-2" suffix.
1.x-only
works or intended only for 1.x systems. Plugins like DontAsk, some examples (to be identified). Older (pre 3.2) versions of Newt, NewtPack. Some ftp sites use 1.x-savvy.
Native
contains some RISC code. This generally makes the package/plugin faster but also somewhat larger. Could be used with 1.x/2.x-compatible or 2.x-only versions. Since NOS 2.x code is executed more efficiently, I may not provide native 2.x-only versions. File usually has a "N" suffix.
plugin
usually an autopart that provides definitions for constants or protos
library
an autopart containing source code (usually with .lib extension)
localized versions
there may be versions of NewtDevEnv provided for different languages, for example, German and Japanese. File suffix: "~G", "~J", etc. If there is enough interest and someone is willing to provide translations of commands, labels and prompts, I can provide separate versions of Newt (2.x only?) for additional countries.

Versions

In order to support different user preferences/configurations (and tradeoffs for package size vs. speed), there are usually several versions of tools available, e.g., 1.x/2.x-compatible or 2.x-only; there could be Native versions of each. If you want to create packages that are compatible for 1.x, you should use a 1.x/2.x-compatible version even on NOS 2.x since a package often borrows code from Newt, NewtPack or constants.

If you have NOS 2.x, and plan to use 2.x-specific protos or functions, create packages only for your own use, or distribute your package only to 2.x users, you have the option of using 2.x-only versions of Newt, NewtPack and PlatFnc2. The advantage is that the development tools and your resulting packages will be (~5-10%) smaller; the disadvantage is that your packages will be incompatible with 1.x (2.x method and object formats are different).

Since this can be a confusing choice for 2.x developers, I hope that the following table makes the 1.x/2.x vs. 2.x-only options somewhat clearer:

1.x/2.x-compatible vs. 2.x-only
VersionDevelop, Save App onUse Saved Package on
Newt, NewtPack1.x2.x1.x2.x
1.x/2.xyesyes(1)yes(1)yes
1.x/2.x + protNOS2 + PlatFnc2no(2)yesno(2,3)yes
2.x-only(4) + PlatFnc2noyesno(5)yes(6)

Notes:

  1. assumes 2.x development in Newt 3.4/NewtPack 3.4 or later
  2. in some special situations, it's possible to build an app and save a package on 1.x containing 2.x-specific protos/behavior (but not really test)
  3. resulting package 1.x compatible (physically); may have install or run-time problems
  4. Newt34 includes protNOS2
  5. resulting package 2.x-only; physically incompatible, will not install
  6. 2.x-only package is 5-10% smaller

When you report a problem with Newt, please let me know versions of installed plugins (you can do this by tapping the Version button in the Prefs panel) -- often very old plugins (e.g., ExprKbd, LifeCnst; very old folderLibs) will interfere with Newt (or other apps I've written), especially if they install first -- often removing/re-installing these can fix the problem.

Newt 3.4

Newt 3.4-2 (.zip)

NewtPack (3.4)

Standard releases (regular and Native) are 2.x-compatible, i.e., work on both 1.x and 2.x systems. The -2 version works only on NOS 2.x, and creates packages that will run only on 2.x.

If you distribute applications created with NewtDevEnv, I would appreciate that you mention (in your Readme or documentation) something like:

This application created using <A HREF="http://http://communicrossings.com/html/newton/index.htm">Newt Development Environment</A>

Also let me know the URLs of your web site or ftp archives so I can include in the list of NewtDevEnv applications

NewtPack 3.5 (beta)

NewtPack 3.4 (.zip)

Plug-Ins (3.4)

The standard release contains: NewtPack, NewtDrw1, DontAsk, applic0.lib, applic2.lib. [note: DontAsk is 1.x-only]

Plugins 3.? (beta) [none currently]

These correspond to versions (of NTK Platform Functions):

  1. 1.x: "MessagePad (1.5d2)"
  2. 2.x: "Newton 2.1 (1.2b2)"

These definitions are used at development-time for your application, see the documentation about how to use constants at run-time (inside methods).

CommCns1, CommCns2
protoEndPoint and communication constants. To produce code that is 1.x&2.x compatible, use CommCons1. For 2.x-only apps, you should use CommCns2 (more constants; although you can use protoEndPoint, you should probably use protoBasicEndPoint instead)
ProtErr1
a basic set of protos that work on all platforms; other (undocumented) 1.x protos are listed in MiscCns1. ProtErr1 is built-in to Newt 3.4, so should not be installed separately if you are using Newt. (It is provided separately in case you want to use it with Newt's Cape or VisualNewt). For 2.x-only development, you should start to avoid the "deprecated" expando protos.
ProtNOS2
~150 additional NOS 2.x protos, currently indexed in the latest NTK docs (doc page numbers included); other (undocumented) protos are listed in MiscCns2. Please let me know if there are misnamed or missing protos (that are in the docs or examples). ProtNOS2 is built-in to Newt 3.4-2, so should not be installed separately for that version; you can install it if you want to access the protos from Newt (non-2 version on NOS 2.x), or from Newt's Cape or VisualNewt.
MiscCns1, MiscCns2
Lists all of the named/known ROM constants based on the latest Defs files. If you want to maintain compatibility between 1.x and 2.x systems, be sure to use only constants that are defined the same in both versions. For 1.x&2.x compatible apps, use MiscCnst; for 2.x-only apps, use MiscCns2.
NewtDrw1, NewtDrw2
turtle graphics functionality. NewtDrw2 (2.x only) version is somewhat smaller.
PlatFnc1, PlatFnc2
for 1.x&2.x compatible apps, use PlatFnc1; for 2.x-only apps, use PlatFnc2 (take special note of "deprecated" platform functions -- there may be built-in functions that you should use instead).
ErrCns1, ErrCns2
many more error messages

Plug-ins 3.4 (.zip)

Examples

newest examples: voicetoy, moounit,...

These examples should generally be 2.x-compatible (though they do not support Rotate yet). I will gradually be updating these examples to conform to current DTS versions. For a complete list, see examples.htm. Note: 3.4-2 (2.x only) examples may require ProtNOS2 (or -2 version of Newt), a few may require PlatFnc2 plugins.

Generally, if you already have the "3.3" versions of examples, plus "xnew34a", you do not need to re-download the 3.4 versions of the examples. In addition to copyright notices and changes to "Sloup", the following changes were made:

Known problems:

Examples (.zip)

Some user examples:

Newt Manual and Release Notes

Here are first new docs (7 Mar 97) in HTML format and Newton books (and maybe later in PDF or PostScript if there's enough demand). I'd appreciate your feedback! To use the books, install Newt's Cape regular or Lite.

.zip

Newt 3.0 Manual (.zip)

NTK Docs

NTK documentation from Apple is now available for free in both Acrobat(PDF) and DocViewer (and some QuickView) formats; DocViewer&QuickView are Mac only. Make sure you have enough disk space! Rather than specific URLs (which tend to change), here are the main places/directories to get started and which documents to look for.

Apple Newton Development pages
Newton development UNNA;
.sit.hqx, .zip
/articles (directory)
articles in text, RTF, PDF formats (many appeared in Newton Technical Journal or PDA Developers)
/docs
documentation in Acrobat, DocViewer and/or QuickView formats
more technical info (browse or search Newton)
Using proto templates on the Newton by Harry Chesley
localizing apps
search: Newton

Paper

APDA and Addison-Wesley are selling paper manuals, separately from NTK:

Tutorials

NewtATut

NewtATut 1.5 (current public book, HTML, PDF) -- application tutorial shows how to use protoInfoButton, protoAboutText and add help book. works with Newt 3.4 (and greater).

NewtTurT

NewtTurT 1.5 (current public book, HTML, PDF) -- turtle tutorial. works with Newt 3.4 (and greater).

NewtPFB 1.1

NewtPFB (Newt Pico Fermi Bagels tutorial) -- Newton book and PDF versions. These correspond to a previous version of PFB (the current example PFB 1.3 is NOS 2.x compatible). I will update an HTML version and book eventually...

.zip

Miscellaneous

See also: comp.sys.newton.programmer newsgroup; NewtDevEnv discussion list

InspecTerm Printomania article (PDF) [somewhat out of date -- if there's enough interest, I'll revise as HTML and Newton book]

Q&A (question&answer) digests -- I will eventually merge this info into the main manuals.

.zip