ARGUMENTS-UNDERSPECIFIED

[chapman%aitg.DEC@decwrl.dec.com]

Issue:        ARGUMENTS-UNDERSPECIFIED
References:   LOGBITP (p 224), MAKE-DISPATCH-MACRO-CHARACTER (p 363), 
	      MAKE-HASH-TABLE (p 283), MAKE-SEQUENCE (p 249), READ (p 375)
     	      MAKE-STRING (p 302), NTHCDR (p 267), PARSE-INTEGER (p 381),
	      SET (p 92)
Category:     CLARIFICATION
Edit history: 26-Aug-88, Version 1 by Chapman


Problem Description:

The descriptions of LOGBITP, MAKE-DISPATCH-MACRO-CHARACTER, READ, SET,
MAKE-HASH-TABLE, MAKE-SEQUENCE, MAKE-STRING, NTHCDR, and PARSE-INTEGER 
are not clear about the types of the arguments supplied to these 
constructs.

Proposal (ARGUMENTS-UNDERSPECIFIED:SPECIFY)

Clarify that the arguments for the listed constructs are as follows:

Construct			Argument	Type
LOGBITP 			index		non-negative integer
MAKE-DISPATCH-MACRO-CHARACTER 	char		character
MAKE-HASH-TABLE			size	 	non-negative integer
MAKE-SEQUENCE	     		size		non-negative integer
MAKE-SEQUENCE	     		type		type specifier
MAKE-STRING			size            non-negative integer
MAKE-STRING			initial-element	string-char
NTHCDR 				n		non-negative integer
PARSE-INTEGER 			start,end       non-negative integers
PARSE-INTEGER 			start,end       non-negative integers
SET-SYNTAX-FROM-CHAR		to-char,from-char
						characters
READ and others			eof-value	T
SET				value		T

Rationale:

This clarification allows predictible results to occur when 
arguments are supplied to these constructs.

Current Practice:


Adoption Cost:


Benefits:

This clarification will assist users in writing portable code.

Conversion Cost:


Aesthetics:

None.

Discussion: