15 The optional Programming-Tools word set

15.1 Introduction

This optional word set contains words most often used during the development of applications.

15.2 Additional terms and notation

None.

15.3 Additional usage requirements

15.3.1 Data types

A name token is a single-cell value that identifies a named word.

Append table 15.1 to table 3.1.

Table 15.1: Data types


Symbol	Data type	Size on stack

nt	name token	1 cell

See: A.15.3.1 Name tokens.

15.3.2 The Forth dictionary

A program using the words CODE or ;CODE associated with assembler code has an environmental dependency on that particular instruction set and assembler notation.

Programs using the words EDITOR or ASSEMBLER require the Search Order word set or an equivalent implementation-defined capability.

See: 3.3 The Forth dictionary.

15.4 Additional documentation requirements

15.4.1 System documentation

15.4.1.1 Implementation-defined options

ending sequence for input following 15.6.2.0470 ;CODE and 15.6.2.0930 CODE;
manner of processing input following 15.6.2.0470 ;CODE and 15.6.2.0930 CODE;
search-order capability for 15.6.2.1300 EDITOR and 15.6.2.0740 ASSEMBLER (15.3.2 The Forth dictionary);
source and format of display by 15.6.1.2194 SEE.

15.4.1.2 Ambiguous conditions

deleting the compilation word-list (15.6.2.1580 FORGET);
fewer than u+1 items on control-flow stack (15.6.2.1015 CS-PICK, 15.6.2.1020 CS-ROLL);
name can't be found (15.6.2.1580 FORGET, 15.6.2.2264 SYNONYM);
name not defined via 6.1.1000 CREATE (15.6.2.0470 ;CODE);
6.1.2033 POSTPONE applied to 15.6.2.2532 [IF];
reaching the end of the input source before matching 15.6.2.2531 [ELSE] or 15.6.2.2533 [THEN] (15.6.2.2532 [IF]);
removing a needed definition (15.6.2.1580 FORGET);
6.1.1710 IMMEDIATE is applied to a word defined by 15.6.2.2264 SYNONYM;
15.6.2.1940 NR> is used with data not stored by 15.6.2.1908 N>R;
adding to or deleting from the wordlist during the execution of 15.6.2.2297 TRAVERSE-WORDLIST

15.4.1.3 Other system documentation

no additional requirements.

15.4.2 Program documentation

15.4.2.1 Environmental dependencies

using the words 15.6.2.0470 ;CODE or 15.6.2.0930 CODE.

15.4.2.2 Other program documentation

no additional requirements.

15.5 Compliance and labeling

15.5.1 Forth-2012 systems

The phrase "Providing the Programming-Tools word set" shall be appended to the label of any Standard System that provides all of the Programming-Tools word set.

The phrase "Providing name(s) from the Programming-Tools Extensions word set" shall be appended to the label of any Standard System that provides portions of the Programming-Tools Extensions word set.

The phrase "Providing the Programming-Tools Extensions word set" shall be appended to the label of any Standard System that provides all of the Programming-Tools and Programming-Tools Extensions word sets.

15.5.2 Forth-2012 programs

The phrase "Requiring the Programming-Tools word set" shall be appended to the label of Standard Programs that require the system to provide the Programming-Tools word set.

The phrase "Requiring name(s) from the Programming-Tools Extensions word set" shall be appended to the label of Standard Programs that require the system to provide portions of the Programming-Tools Extensions word set.

The phrase "Requiring the Programming-Tools Extensions word set" shall be appended to the label of Standard Programs that require the system to provide all of the Programming-Tools and Programming-Tools Extensions word sets.