hpover

		     Data Files Formatting Notes

The files are in pure ASCII, 78 characters per line max.  Tab
characters (9 decimal) are used for formatting; 8 column tab stops are
assumed.  The files are intended to be readily machine parsable.  In
particular, lines fit into one of four types:

- A line starting with a form feed character, it ends a product
record.

Otherwise, the first token on the line is used to determine what to
do.  Tokens are delimited by one or more Space or Tab characters.

- If the first token ends with a single colon (:), it is a labelled
data line.  The data consists of the remainder of the line, with
leading and trailing Space and Tab characters removed.

- If the first token ends with a double colon (::), it is a "block
data" line.  The rest of the current line is skipped.  All following
lines until the next line with a token that ends in a double colon or
the end of the record are accumulated into a single text block.
(Lines whose first token ends with a colon are not significant.)
Leading and trailing -- but not embedded -- blank lines are dropped.

- If the first token ends in anything else, it is a "continuation"
line for the preceeding labelled data (single colon) line.  Leading
and trailing Space and Tab characters should be dropped.

In general, most other cases are "administratively prohibited."  I.e.,
they won't be typed in.

Special characters and keywords used:

- A number of characters are indicated by various approximations.  See
the CHARS file for a complete list.

- A data value of "?" means that the correct value is not known.

- A data value of "none" or "-" implies that it is known that there is
no correct answer.  (For example, if a product does not have an
internal code name.)

In some cases, a device which is a minor variation on another device
is listed as such.  In this case, the model number field will include
the string "<model number>, differences from <base model>".  Only
those fields with different values will be listed.  In general, you
will need to examine the data for both the base model and the other
model in order to understand the device.

============================================================
			  Field Definitions

Model:	<model number>

General:			<no data, heading only>
	Name:			<device name>
	Code-Name:		<internal code name>
	Family:			<internal family name>
	Logic:			<RPN, algebraic, etc.>
	Features:		<general description / listing of major
				features, does not duplicate anything
				mentioned in firsts>
	Firsts:			<any significant firsts>
	Introduction:		<no data, heading only>
		Date:		<YYYY-MM-DD of US introduction>
		Price:		<list price in US$ at introduction>
	Discontinuation:	<no data, heading only>
		Date:		<YYYY-MM-DD of US termination>
		Price:		<list price in US$ at termination>
	Production-Run:		<number of units produced/sold>

Display:			<no data, heading only>
	Type:			<type of technology and pattern>>
	Size:			<sizeo of display>
	Number-Formats:		<ways that numbers or data can be displayed>
	Annunciators:		<special annunciators>

Data:				<no data, heading only>
	User-Visible:		<no data, heading only>
		Smallest:	<smallest non-zero positive number>
		Largest:	<largest non-zero positive number>
		Signif.-Digits:	<number of>
	Internal:		<no data, heading only>
		Smallest:	<as user-visible, but for internal numbers>
		Largest:	<as user-visible, but for internal numbers>
		Signif.-Digits:	<as user-visible, but for internal numbers>
	Data-Types-and-Sizes:	real, 7 bytes

Memory:				<no data, heading only>
	Named-Registers:	<nameable registers>
	Flags:			<flags>
	Register-Usage:		<special-purpose register usage>
	Numbered-Registers:	<number of them, often in max->min form>
	Program-Steps:		<number of them, often in max->min form>
	Program-Editing:	<insert or replace>
	Program-Display:	<keycode or alpha>
	User-RAM-Bytes:		<user-visible RAM>
	Total-RAM-Bytes:	<total system RAM>
	ROM-Bytes:		<size of ROM chips>
	Machine-State:		<any state information retained>
	File-Types:		<special file types>

Physical:			<no data, heading only>
	Technology-Used:	<type>
	Processor:		<model>
	Chip-Count:		<number>
	Power-Source:		<battery or other types>
	Continuous-Memory:	<yes/no>
	Expansion-Ports:	<number and type>
	I/O-Ports:		<number and type>
	Clock:			<clock or timer>

	Length:			<size, official unless otherwise noted>
	Width:			<size, official unless otherwise noted>
	Height:			<size, official unless otherwise noted>
	Weight:			<weight, official unless otherwise noted>
	Temperature-Range:	<no data, heading only>
		Operating:	<range>
		Charging:	<range>
		Storage:	<range>
		<other:>	<other, where applicable>

Keyboard:			<no data, heading only>
	Switches:		<number and meanings>
	Shift-Keys:		<tuples: name, color, position>
	User-Defined-Keys:	<list>

Key-Arrangement::

<an array of * and space/tab characters that give an overall feel for
how the keys are laid out.>

Key-Labels-Base-Keyboard::

<The key labels for the base keyboard.  Keys marked [] are blank.  Key
names in []s are applications keys (solid background).>

Key-Labels-<name>-<color>-<position>::

<for each shift key listed above, the key labels>

Programmable-Operations::

<a listing of the programmable operations that can be performed on the
product>

Non-Programmable-Operations::

<a listing of the non-programmable operations that can be performed on
the product>

Menus::

<a description of the menus>

Bugs/ROM-Versions::

<any known bugs and ROM version changes/fixes>

Notes::

<any miscellaneous notes>