ISSUE 617

Number 617
Category errata
Synopsis word "parameter" should be "argument"
State lrmdraft
Class errata-simple
Arrival-DateAug 11 2004
Originator Shalom.Bresticker@freescale.com
Release 2001b
Description
I got this from Geoffrey Coram.
I agree with him almost completely.
I forward his mail with a few additional comments.

Shalom


On Fri, 6 Aug 2004, Geoffrey.Coram wrote:

> Hi, Shalom -
> Looking through the 1364-2005 draft, I see the following in Section
> 17.9.2:
>
>
> For each system function, the seed parameter is an in-out parameter;
> that is, a value is passed to the function and a different value is
> returned.
>
>
> I think "parameter" should be replaced with "argument," since parameters
> are supposed
> to be constant in Verilog.
>
>
> There are other places in this section (17) that use parameter; in some
> cases (eg, $finish), it is a constant argument, so maybe parameter is a
> valid word choice. In other cases, it is not correct.
>
>
> I propose that parameter be replaced with argument in the following
> locations:
>
>
> 17.1.1
> A $write task supplied without parameters prints nothing at all.
>
>
> 17.1.1.7
> For each %s specification that appears in a string, a corresponding
> parameter shall follow the string in the argument list.
>
>
> 17.2.2
> The first parameter shall be either a multi channel descriptor or a file
> descriptor,
>
>
> The messages variable can then be used as the first parameter in a file
> output task to direct output to all three channels at once.
>
>
> 17.2.3
> The first parameter to $swrite shall be a reg variable to which the
> resulting string shall be written,
>
>
> 17.2.8
> If both start and finish addresses are specified as parameters to the
> task,
>
>
> When addressing information is specified both in the system task and in
> the data file, the addresses in the data file shall be within the
> address range specified by the system task parameters;
>
>
> 17.4.1
> Table 77 (column heading) "Parameter value"
>
>
> 17.6.1
> The q_id parameter is an integer input that shall uniquely identify the
> new queue. The q_type parameter is an integer input. The value of the
> q_type parameter specifies the type of the queue as shown in Table 79.
>
>
> The maximum length parameter is an integer input that specifies the
> maximum number of entries allowed on the queue.

For consistency, change "maximum length" to "max_length" in Courier font.
Similar cases below.


> 17.6.2
> The q_id parameter is an integer input that indicates to which queue to
> add the entry. The job_id parameter is an integer input that identifies
> the job.
> The inform_id parameter is an integer input that is associated with the
> queue entry. Its meaning is user-defined. For example, inform_id
> parameter can represent execution time for an entry in a CPU model. The
> status parameter reports on the success of the operation or error
> conditions as described in Table 81.

Change "For example, inform_id parameter"
to "For example, the inform_id parameter"

Change "status" to Courier font.


> 17.6.3
> The q_id parameter is an integer input that indicates from which queue
> to remove. The job_id parameter is an integer output that identifies the
> entry being removed. The inform_id parameter is an integer output that
> the queue manager stored during $q_add. Its meaning is user-defined. The
> status parameter reports on the success of the operation or error
> conditions as described in Table 81.

Change "status" to Courier font.


> 17.6.5
> Table 80 (title) "Parameter values for $q_exam system task"

For 17.6.6, see below.


> 17.9.1
> The seed parameter controls the numbers that $random returns such that
> different seeds generate different random streams. The seed parameter
> shall be either a reg, an integer, or a time variable.
>
>
> 17.9.2
> All parameters to the system functions are integer values. For the
> exponential, poisson, chisquare, t, and erlang functions, the parameters
> mean, degree of freedom, and k_stage shall be greater than 0.

Change "mean, degree of freedom, "
to "mean, degree_of_freedom, " in Courier font.


> That is, $dist_uniform returns random numbers uniformly distributed in
> the interval specified by its parameters.
>
>
> For each system function, the seed parameter is an in-out parameter; ...

Change "seed" to Courier font.


> The argument for the seed parameter should be an integer variable that
> is initialized by the user and only updated by the system function.

Change "seed" to Courier font.


> In the $dist_uniform function, the start and end parameters are integer
> inputs that bound the values returned.

Change "start" and "end" to Courier font, also a 2nd time in this paragraph.


> The mean parameter, used by $dist_normal, $dist_exponential,
> $dist_poisson, and $dist_erlang, ...

Change "mean" to Courier font.


> The standard deviation parameter used with the $dist_normal function is
> an integer input that helps determine the shape of the density function.

Change "standard deviation"
to "standard_deviation" in Courier font twice in this paragraph.


> The degree of freedom parameter used with the $dist_chi_square and
> $dist_t functions is an integer input
> that helps determine the shape of the density function.

Change "degree of freedom"
to "degree_of_freedom" in Courier font.


> In 17.6.6, parameter should be replaced with code.
>
>
> 17.6.6
> All of the queue management tasks and functions return an output status
> parameter. The status parameter
> values and corresponding information are described in Table 81.
>
>
> Table 81 (title, column heading) Status parameter value

The term "status parameter" appears in 17.6.2 and 17.6.3 also, above.
I think "code" should be used there also.

The sentence ending 17.6.2 and 17.6.3,
"The status parameter reports on the success of the operation or error
conditions as described in Table 81.",
should be added to 17.6.4 and 17.6.5 also.

> I think this covers Section 17.

>
> -Geoffrey


I looked for other places where 'parameter' is used imprecisely and
found the following:

5.6.7, para. 1: "Task and function parameter passing is by value".
Change to "argument".

In the new 19.7 (`line), from issue #16, once in para. 4 and 3 times in
para. 6 according to the paragraph division that I made in editing.
I am not sure that "argument" is the best choice here, however.

C.1, para. 2 once, para. 3 twice.

Table C-1 twice.

C.2, para. 2

C.4, last para.

C.5, para. 1 twice

C.6, para. 2

C.7, para. 2

C.8, para. 2 and 3

C.10

C.11, three times

C.12

Shalom

Fix
CHANGE "parameter" TO "argument" in the following locations,
except as noted otherwise:


* 5.6.7, para. 1:
"Task and function parameter passing is by value".


* 17.1.1:
"A $write task supplied without parameters prints nothing at all."


* 17.1.1.7:
"For each %s specification that appears in a string, a corresponding
parameter shall follow the string in the argument list."


* 17.2.2:
"The first parameter shall be either a multi channel descriptor or a file
descriptor,"

"The messages variable can then be used as the first parameter in a file
output task to direct output to all three channels at once."


* 17.2.3:
"The first parameter to $swrite shall be a reg variable to which the
resulting string shall be written,"


* 17.2.8:
"If both start and finish addresses are specified as parameters to the
task,"

"When addressing information is specified both in the system task and in
the data file, the addresses in the data file shall be within the
address range specified by the system task parameters;"


* 17.4.1:
Table 77 (column heading) "Parameter value"


* 17.6.1:
"The q_id parameter is an integer input that shall uniquely identify the
new queue. The q_type parameter is an integer input. The value of the
q_type parameter specifies the type of the queue as shown in Table 17-14."

"The maximum length parameter is an integer input that specifies the
maximum number of entries allowed on the queue."

CHANGE "maximum length" to "max_length" in Courier font.


* 17.6.2:
"The q_id parameter is an integer input that indicates to which queue to
add the entry. The job_id parameter is an integer input that identifies
the job.
The inform_id parameter is an integer input that is associated with the
queue entry. Its meaning is user-defined. For example, inform_id
parameter can represent execution time for an entry in a CPU model. The
status parameter reports on the success of the operation or error
conditions as described in Table 17-16."

Change "For example, inform_id parameter"
to "For example, the inform_id parameter"

Change "status" to Courier font.
Change "status parameter" to "status code".


* 17.6.3:
"The q_id parameter is an integer input that indicates from which queue
to remove. The job_id parameter is an integer output that identifies the
entry being removed. The inform_id parameter is an integer output that
the queue manager stored during $q_add. Its meaning is user-defined. The
status parameter reports on the success of the operation or error
conditions as described in Table 17-16. "

Change "status" to Courier font.
Change "status parameter" to "status code".


* 17.6.4: ADD to the end,
"The status code reports on the success of the operation or error
conditions as described in Table 17-16." ("status" in Courier font.)


* 17.6.5:
Table 17-15 (title) "Parameter values for $q_exam system task"


* 17.6.5: ADD to the end,
"The status code reports on the success of the operation or error
conditions as described in Table 17-16." ("status" in Courier font.)


* 17.6.6:
"All of the queue management tasks and functions return an output status
parameter. The status parameter
values and corresponding information are described in Table 17-16."

Change "status parameter" to "status code".


* Table 17-16 (title, column heading) "Status parameter value"

Change "status parameter" to "status code".


* 17.9.1:
"The seed parameter controls the numbers that $random returns such that
different seeds generate different random streams. The seed parameter
shall be either a reg, an integer, or a time variable."


* 17.9.2:
"All parameters to the system functions are integer values. For the
exponential, poisson, chisquare, t, and erlang functions, the parameters
mean, degree of freedom, and k_stage shall be greater than 0.

Change "mean, degree of freedom, "
to "mean, degree_of_freedom, " in Courier font.


"That is, $dist_uniform returns random numbers uniformly distributed in
the interval specified by its parameters.


"For each system function, the seed parameter is an inout parameter; ...

Change "seed" to Courier font.


"The argument for the seed parameter should be an integer variable that
is initialized by the user and only updated by the system function.

Change "The argument for the seed parameter" to "The seed argument".
Change "seed" to Courier font.


"In the $dist_uniform function, the start and end parameters are integer
inputs that bound the values returned.

Change "start" and "end" to Courier font, also a 2nd time in this paragraph.


"The mean parameter, used by $dist_normal, $dist_exponential,
$dist_poisson, and $dist_erlang, ...

Change "mean" to Courier font.


"The standard deviation parameter used with the $dist_normal function is
an integer input that helps determine the shape of the density function.

Change "standard deviation"
to "standard_deviation" in Courier font twice in this paragraph.


"The degree of freedom parameter used with the $dist_chi_square and
$dist_t functions is an integer input
that helps determine the shape of the density function.

Change "degree of freedom"
to "degree_of_freedom" in Courier font.


* The new 19.7 (`line), from issue #16, contains "parameter" once in para. 4
and 3 times in para. 6 according to the paragraph division that I made in
editing:
"All parameters in the `line directive are required."
"The number parameter shall be a positive integer ...
The filename parameter shall be a string constant ...
The level parameter shall be 0, 1, or 2."

However, "argument" does not sound natural here, so leave "parameter".


* C.1, para. 2 once, para. 3 twice:
"The number of parameters to the system function may vary according to how much information is desired."
"If additional parameters are supplied to the $countdrivers function, each parameter returns the information described in Table C-1."


* Table C-1 title "Parameter return value for $countdriver function", twice.


* C.2, para. 2:
"the parameter to the system function is a memory element reference".


* C.4, last para:
"An optional file name parameter for $key causes ..."


* C.5, para. 1 twice:
"When invoked without a parameter, $list produces ..."
"If an optional parameter is supplied, it shall refer ..."


* C.6, para. 2:
"An optional file name parameter for $log causes ..."


* C.7, para. 2:
"The $reset_value system function returns the value specified by the the
reset_value parameter argument to the $reset system task."

Delete "parameter".


* C.8, para. 2 and 3:
"All three system tasks take a file name as a parameter."
"The $save system task saves the complete state into the host operating
system file specified as a parameter."

Delete the words "host operating sysem".
Change "a parameter" to "an argument".


* C.10:
"This task accepts a single parameter argument that shall be the ..".

Delete "parameter".


* C.11, three times:
"An optional integer parameter can be given to $showscopes.
A non-zero parameter value causes ...
No parameter or a zero value results in ..."


* C.12:
"When invoked without parameters, $showvars displays the status ..."

Audit-Trail
From: Steven Sharp <sharp@cadence.com>
To: etf-bugs@boyd.com, Shalom.Bresticker@freescale.com
Cc:
Subject: Re: errata/617: word "parameter" should be "argument"
Date: Thu, 12 Aug 2004 13:04:49 -0400 (EDT)

Agreed.

Steven Sharp
sharp@cadence.com

From: Shalom.Bresticker@freescale.com
To: etf-bugs@boyd.com
Cc:
Subject: Re: errata/617: PROPOSAL - word "parameter" should be "argument"
Date: Fri, 12 Nov 2004 11:14:54 +0200 (IST)

CHANGE "parameter" TO "argument" in the following locations,
except as noted otherwise:


* 5.6.7, para. 1:
"Task and function parameter passing is by value".


* 17.1.1:
"A $write task supplied without parameters prints nothing at all."


* 17.1.1.7:
"For each %s specification that appears in a string, a corresponding
parameter shall follow the string in the argument list."


* 17.2.2:
"The first parameter shall be either a multi channel descriptor or a file
descriptor,"

"The messages variable can then be used as the first parameter in a file
output task to direct output to all three channels at once."


* 17.2.3:
"The first parameter to $swrite shall be a reg variable to which the
resulting string shall be written,"


* 17.2.8:
"If both start and finish addresses are specified as parameters to the
task,"

"When addressing information is specified both in the system task and in
the data file, the addresses in the data file shall be within the
address range specified by the system task parameters;"


* 17.4.1:
Table 77 (column heading) "Parameter value"


* 17.6.1:
"The q_id parameter is an integer input that shall uniquely identify the
new queue. The q_type parameter is an integer input. The value of the
q_type parameter specifies the type of the queue as shown in Table 17-14."

"The maximum length parameter is an integer input that specifies the
maximum number of entries allowed on the queue."

CHANGE "maximum length" to "max_length" in Courier font.


* 17.6.2:
"The q_id parameter is an integer input that indicates to which queue to
add the entry. The job_id parameter is an integer input that identifies
the job.
The inform_id parameter is an integer input that is associated with the
queue entry. Its meaning is user-defined. For example, inform_id
parameter can represent execution time for an entry in a CPU model. The
status parameter reports on the success of the operation or error
conditions as described in Table 17-16."

Change "For example, inform_id parameter"
to "For example, the inform_id parameter"

Change "status" to Courier font.
Change "status parameter" to "status code".


* 17.6.3:
"The q_id parameter is an integer input that indicates from which queue
to remove. The job_id parameter is an integer output that identifies the
entry being removed. The inform_id parameter is an integer output that
the queue manager stored during $q_add. Its meaning is user-defined. The
status parameter reports on the success of the operation or error
conditions as described in Table 17-16. "

Change "status" to Courier font.
Change "status parameter" to "status code".


* 17.6.4: ADD to the end,
"The status code reports on the success of the operation or error
conditions as described in Table 17-16." ("status" in Courier font.)


* 17.6.5:
Table 17-15 (title) "Parameter values for $q_exam system task"


* 17.6.5: ADD to the end,
"The status code reports on the success of the operation or error
conditions as described in Table 17-16." ("status" in Courier font.)


* 17.6.6:
"All of the queue management tasks and functions return an output status
parameter. The status parameter
values and corresponding information are described in Table 17-16."

Change "status parameter" to "status code".


* Table 17-16 (title, column heading) "Status parameter value"

Change "status parameter" to "status code".


* 17.9.1:
"The seed parameter controls the numbers that $random returns such that
different seeds generate different random streams. The seed parameter
shall be either a reg, an integer, or a time variable."


* 17.9.2:
"All parameters to the system functions are integer values. For the
exponential, poisson, chisquare, t, and erlang functions, the parameters
mean, degree of freedom, and k_stage shall be greater than 0.

Change "mean, degree of freedom, "
to "mean, degree_of_freedom, " in Courier font.


"That is, $dist_uniform returns random numbers uniformly distributed in
the interval specified by its parameters.


"For each system function, the seed parameter is an inout parameter; ...

Change "seed" to Courier font.


"The argument for the seed parameter should be an integer variable that
is initialized by the user and only updated by the system function.

Change "The argument for the seed parameter" to "The seed argument".
Change "seed" to Courier font.


"In the $dist_uniform function, the start and end parameters are integer
inputs that bound the values returned.

Change "start" and "end" to Courier font, also a 2nd time in this paragraph.


"The mean parameter, used by $dist_normal, $dist_exponential,
$dist_poisson, and $dist_erlang, ...

Change "mean" to Courier font.


"The standard deviation parameter used with the $dist_normal function is
an integer input that helps determine the shape of the density function.

Change "standard deviation"
to "standard_deviation" in Courier font twice in this paragraph.


"The degree of freedom parameter used with the $dist_chi_square and
$dist_t functions is an integer input
that helps determine the shape of the density function.

Change "degree of freedom"
to "degree_of_freedom" in Courier font.


* The new 19.7 (`line), from issue #16, contains "parameter" once in para. 4
and 3 times in para. 6 according to the paragraph division that I made in
editing:
"All parameters in the `line directive are required."
"The number parameter shall be a positive integer ...
The filename parameter shall be a string constant ...
The level parameter shall be 0, 1, or 2."

However, "argument" does not sound natural here, so leave "parameter".


* C.1, para. 2 once, para. 3 twice.
(I can't find the page right now to quote from it.)


* Table C-1 title "Parameter return value for $countdriver function", twice.


* C.2, para. 2:
"the parameter to the system function is a memory element reference".


* C.4, last para:
"An optional file name parameter for $key causes ..."


* C.5, para. 1 twice:
"When invoked without a parameter, $list produces ..."
"If an optional parameter is supplied, it shall refer ..."


* C.6, para. 2:
"An optional file name parameter for $log causes ..."


* C.7, para. 2:
"The $reset_value system function returns the value specified by the the
reset_value parameter argument to the $reset system task."

Delete "parameter".


* C.8, para. 2 and 3:
"All three system tasks take a file name as a parameter."
"The $save system task saves the complete state into the host operating
system file specified as a parameter."

Delete the words "host operating sysem".
Change "a parameter" to "an arguement".


* C.10:
"This task accepts a single parameter argument that shall be the ..".

Delete "parameter".


* C.11, three times:
"An optional integer parameter can be given to $showscopes.
A non-zero parameter value causes ...
No parameter or a zero value results in ..."


* C.12:
"When invoked without parameters, $showvars displays the status ..."

--
Shalom Bresticker Shalom.Bresticker @freescale.com
Design & Verification Methodology Tel: +972 9 9522268
Freescale Semiconductor Israel, Ltd. Fax: +972 9 9522890
POB 2208, Herzlia 46120, ISRAEL Cell: +972 50 5441478

[ ]Freescale Internal Use Only [ ]Freescale Confidential Proprietary



Fix replaced by Shalom.Bresticker@freescale.com on Sat Nov 13 23:16:05 2004

CHANGE "parameter" TO "argument" in the following locations,
except as noted otherwise:


* 5.6.7, para. 1:
"Task and function parameter passing is by value".


* 17.1.1:
"A $write task supplied without parameters prints nothing at all."


* 17.1.1.7:
"For each %s specification that appears in a string, a corresponding
parameter shall follow the string in the argument list."


* 17.2.2:
"The first parameter shall be either a multi channel descriptor or a file
descriptor,"

"The messages variable can then be used as the first parameter in a file
output task to direct output to all three channels at once."


* 17.2.3:
"The first parameter to $swrite shall be a reg variable to which the
resulting string shall be written,"


* 17.2.8:
"If both start and finish addresses are specified as parameters to the
task,"

"When addressing information is specified both in the system task and in
the data file, the addresses in the data file shall be within the
address range specified by the system task parameters;"


* 17.4.1:
Table 77 (column heading) "Parameter value"


* 17.6.1:
"The q_id parameter is an integer input that shall uniquely identify the
new queue. The q_type parameter is an integer input. The value of the
q_type parameter specifies the type of the queue as shown in Table 17-14."

"The maximum length parameter is an integer input that specifies the
maximum number of entries allowed on the queue."

CHANGE "maximum length" to "max_length" in Courier font.


* 17.6.2:
"The q_id parameter is an integer input that indicates to which queue to
add the entry. The job_id parameter is an integer input that identifies
the job.
The inform_id parameter is an integer input that is associated with the
queue entry. Its meaning is user-defined. For example, inform_id
parameter can represent execution time for an entry in a CPU model. The
status parameter reports on the success of the operation or error
conditions as described in Table 17-16."

Change "For example, inform_id parameter"
to "For example, the inform_id parameter"

Change "status" to Courier font.
Change "status parameter" to "status code".


* 17.6.3:
"The q_id parameter is an integer input that indicates from which queue
to remove. The job_id parameter is an integer output that identifies the
entry being removed. The inform_id parameter is an integer output that
the queue manager stored during $q_add. Its meaning is user-defined. The
status parameter reports on the success of the operation or error
conditions as described in Table 17-16. "

Change "status" to Courier font.
Change "status parameter" to "status code".


* 17.6.4: ADD to the end,
"The status code reports on the success of the operation or error
conditions as described in Table 17-16." ("status" in Courier font.)


* 17.6.5:
Table 17-15 (title) "Parameter values for $q_exam system task"


* 17.6.5: ADD to the end,
"The status code reports on the success of the operation or error
conditions as described in Table 17-16." ("status" in Courier font.)


* 17.6.6:
"All of the queue management tasks and functions return an output status
parameter. The status parameter
values and corresponding information are described in Table 17-16."

Change "status parameter" to "status code".


* Table 17-16 (title, column heading) "Status parameter value"

Change "status parameter" to "status code".


* 17.9.1:
"The seed parameter controls the numbers that $random returns such that
different seeds generate different random streams. The seed parameter
shall be either a reg, an integer, or a time variable."


* 17.9.2:
"All parameters to the system functions are integer values. For the
exponential, poisson, chisquare, t, and erlang functions, the parameters
mean, degree of freedom, and k_stage shall be greater than 0.

Change "mean, degree of freedom, "
to "mean, degree_of_freedom, " in Courier font.


"That is, $dist_uniform returns random numbers uniformly distributed in
the interval specified by its parameters.


"For each system function, the seed parameter is an inout parameter; ...

Change "seed" to Courier font.


"The argument for the seed parameter should be an integer variable that
is initialized by the user and only updated by the system function.

Change "The argument for the seed parameter" to "The seed argument".
Change "seed" to Courier font.


"In the $dist_uniform function, the start and end parameters are integer
inputs that bound the values returned.

Change "start" and "end" to Courier font, also a 2nd time in this paragraph.


"The mean parameter, used by $dist_normal, $dist_exponential,
$dist_poisson, and $dist_erlang, ...

Change "mean" to Courier font.


"The standard deviation parameter used with the $dist_normal function is
an integer input that helps determine the shape of the density function.

Change "standard deviation"
to "standard_deviation" in Courier font twice in this paragraph.


"The degree of freedom parameter used with the $dist_chi_square and
$dist_t functions is an integer input
that helps determine the shape of the density function.

Change "degree of freedom"
to "degree_of_freedom" in Courier font.


* The new 19.7 (`line), from issue #16, contains "parameter" once in para. 4
and 3 times in para. 6 according to the paragraph division that I made in
editing:
"All parameters in the `line directive are required."
"The number parameter shall be a positive integer ...
The filename parameter shall be a string constant ...
The level parameter shall be 0, 1, or 2."

However, "argument" does not sound natural here, so leave "parameter".


* C.1, para. 2 once, para. 3 twice:
"The number of parameters to the system function may vary according to how much information is desired."
"If additional parameters are supplied to the $countdrivers function, each parameter returns the information described in Table C-1."


* Table C-1 title "Parameter return value for $countdriver function", twice.


* C.2, para. 2:
"the parameter to the system function is a memory element reference".


* C.4, last para:
"An optional file name parameter for $key causes ..."


* C.5, para. 1 twice:
"When invoked without a parameter, $list produces ..."
"If an optional parameter is supplied, it shall refer ..."


* C.6, para. 2:
"An optional file name parameter for $log causes ..."


* C.7, para. 2:
"The $reset_value system function returns the value specified by the the
reset_value parameter argument to the $reset system task."

Delete "parameter".


* C.8, para. 2 and 3:
"All three system tasks take a file name as a parameter."
"The $save system task saves the complete state into the host operating
system file specified as a parameter."

Delete the words "host operating sysem".
Change "a parameter" to "an arguement".


* C.10:
"This task accepts a single parameter argument that shall be the ..".

Delete "parameter".


* C.11, three times:
"An optional integer parameter can be given to $showscopes.
A non-zero parameter value causes ...
No parameter or a zero value results in ..."


* C.12:
"When invoked without parameters, $showvars displays the status ..."




Fix replaced by Shalom.Bresticker@freescale.com on Mon Nov 29 09:29:33 2004
CHANGE "parameter" TO "argument" in the following locations,
except as noted otherwise:


* 5.6.7, para. 1:
"Task and function parameter passing is by value".


* 17.1.1:
"A $write task supplied without parameters prints nothing at all."


* 17.1.1.7:
"For each %s specification that appears in a string, a corresponding
parameter shall follow the string in the argument list."


* 17.2.2:
"The first parameter shall be either a multi channel descriptor or a file
descriptor,"

"The messages variable can then be used as the first parameter in a file
output task to direct output to all three channels at once."


* 17.2.3:
"The first parameter to $swrite shall be a reg variable to which the
resulting string shall be written,"


* 17.2.8:
"If both start and finish addresses are specified as parameters to the
task,"

"When addressing information is specified both in the system task and in
the data file, the addresses in the data file shall be within the
address range specified by the system task parameters;"


* 17.4.1:
Table 77 (column heading) "Parameter value"


* 17.6.1:
"The q_id parameter is an integer input that shall uniquely identify the
new queue. The q_type parameter is an integer input. The value of the
q_type parameter specifies the type of the queue as shown in Table 17-14."

"The maximum length parameter is an integer input that specifies the
maximum number of entries allowed on the queue."

CHANGE "maximum length" to "max_length" in Courier font.


* 17.6.2:
"The q_id parameter is an integer input that indicates to which queue to
add the entry. The job_id parameter is an integer input that identifies
the job.
The inform_id parameter is an integer input that is associated with the
queue entry. Its meaning is user-defined. For example, inform_id
parameter can represent execution time for an entry in a CPU model. The
status parameter reports on the success of the operation or error
conditions as described in Table 17-16."

Change "For example, inform_id parameter"
to "For example, the inform_id parameter"

Change "status" to Courier font.
Change "status parameter" to "status code".


* 17.6.3:
"The q_id parameter is an integer input that indicates from which queue
to remove. The job_id parameter is an integer output that identifies the
entry being removed. The inform_id parameter is an integer output that
the queue manager stored during $q_add. Its meaning is user-defined. The
status parameter reports on the success of the operation or error
conditions as described in Table 17-16. "

Change "status" to Courier font.
Change "status parameter" to "status code".


* 17.6.4: ADD to the end,
"The status code reports on the success of the operation or error
conditions as described in Table 17-16." ("status" in Courier font.)


* 17.6.5:
Table 17-15 (title) "Parameter values for $q_exam system task"


* 17.6.5: ADD to the end,
"The status code reports on the success of the operation or error
conditions as described in Table 17-16." ("status" in Courier font.)


* 17.6.6:
"All of the queue management tasks and functions return an output status
parameter. The status parameter
values and corresponding information are described in Table 17-16."

Change "status parameter" to "status code".


* Table 17-16 (title, column heading) "Status parameter value"

Change "status parameter" to "status code".


* 17.9.1:
"The seed parameter controls the numbers that $random returns such that
different seeds generate different random streams. The seed parameter
shall be either a reg, an integer, or a time variable."


* 17.9.2:
"All parameters to the system functions are integer values. For the
exponential, poisson, chisquare, t, and erlang functions, the parameters
mean, degree of freedom, and k_stage shall be greater than 0.

Change "mean, degree of freedom, "
to "mean, degree_of_freedom, " in Courier font.


"That is, $dist_uniform returns random numbers uniformly distributed in
the interval specified by its parameters.


"For each system function, the seed parameter is an inout parameter; ...

Change "seed" to Courier font.


"The argument for the seed parameter should be an integer variable that
is initialized by the user and only updated by the system function.

Change "The argument for the seed parameter" to "The seed argument".
Change "seed" to Courier font.


"In the $dist_uniform function, the start and end parameters are integer
inputs that bound the values returned.

Change "start" and "end" to Courier font, also a 2nd time in this paragraph.


"The mean parameter, used by $dist_normal, $dist_exponential,
$dist_poisson, and $dist_erlang, ...

Change "mean" to Courier font.


"The standard deviation parameter used with the $dist_normal function is
an integer input that helps determine the shape of the density function.

Change "standard deviation"
to "standard_deviation" in Courier font twice in this paragraph.


"The degree of freedom parameter used with the $dist_chi_square and
$dist_t functions is an integer input
that helps determine the shape of the density function.

Change "degree of freedom"
to "degree_of_freedom" in Courier font.


* The new 19.7 (`line), from issue #16, contains "parameter" once in para. 4
and 3 times in para. 6 according to the paragraph division that I made in
editing:
"All parameters in the `line directive are required."
"The number parameter shall be a positive integer ...
The filename parameter shall be a string constant ...
The level parameter shall be 0, 1, or 2."

However, "argument" does not sound natural here, so leave "parameter".


* C.1, para. 2 once, para. 3 twice:
"The number of parameters to the system function may vary according to how much information is desired."
"If additional parameters are supplied to the $countdrivers function, each parameter returns the information described in Table C-1."


* Table C-1 title "Parameter return value for $countdriver function", twice.


* C.2, para. 2:
"the parameter to the system function is a memory element reference".


* C.4, last para:
"An optional file name parameter for $key causes ..."


* C.5, para. 1 twice:
"When invoked without a parameter, $list produces ..."
"If an optional parameter is supplied, it shall refer ..."


* C.6, para. 2:
"An optional file name parameter for $log causes ..."


* C.7, para. 2:
"The $reset_value system function returns the value specified by the the
reset_value parameter argument to the $reset system task."

Delete "parameter".


* C.8, para. 2 and 3:
"All three system tasks take a file name as a parameter."
"The $save system task saves the complete state into the host operating
system file specified as a parameter."

Delete the words "host operating sysem".
Change "a parameter" to "an argument".


* C.10:
"This task accepts a single parameter argument that shall be the ..".

Delete "parameter".


* C.11, three times:
"An optional integer parameter can be given to $showscopes.
A non-zero parameter value causes ...
No parameter or a zero value results in ..."


* C.12:
"When invoked without parameters, $showvars displays the status ..."



Unformatted


Hosted by Boyd Technology