-----------------------------------------------------------------------------
Compendium Errata Report as of 25-Nov-95
-----------------------------------------------------------------------------
This report details errors or omissions to the second printing of the Atari
Compendium. Please report any additional findings to Scott Sanders
([email protected]).
-----------------------
Date Entered 11-Jul-94
Error Type: Grammar
Page Number: 1.14
Error Description: The third paragraph, first sentence, last word is
misspelled.
Error Correction: The correct word should be 'compilers,' not
'compiles'.
-----------------------
Date Entered 11-Jul-94
Error Type: Omission
Page Number: 1.4
Error Description: There is no mention of the fact that the 1040 STe
contains a Blitter chip.
-----------------------
Date Entered 11-Jul-94
Error Type: Content
Page Number: 2.104
Error Description: The binding for Pexec() contains an incorrect
argument.
Error Correction: The "move.w word,-(sp)" statement should be changed
to "move.w mode,-(sp)".
-----------------------
Date Entered 11-Jul-94
Error Type: Content
Page Number: 2.117
Error Description: The binding for Psigaction() pushes its parameters
onto the stack in the reverse order. In addition, the
stack correction method could be more efficient.
Error Correction: The correct binding is:
pea oact
pea act
move.w sig,-(sp)
move.w #$137,-(sp)
trap #1
lea 12(sp),sp
-----------------------
Date Entered 11-Jul-94
Error Type: Content
Page Number: 2.124
Error Description: The argument to Pusrval() is never pushed onto the
stack. Doing so also affects the given stack
correction amount.
Error Correction: Insert the statement "move.l val,-(sp)" at the top
of the binding. The stack correction amount should
then change from 2 to 6.
-----------------------
Date Entered 11-Jul-94
Error Type: Content
Page Number: 2.127
Error Description: The binding to Pwait3() doesn't place the function
opcode on the stack. This change also alters the
stack correction.
Error Correction: The correct binding for Pwait3() should be:
pea rusage
move.w flag,-(sp)
move.w #$11C,-(sp)
trap #1
addq.l #8,sp
-----------------------
Date Entered 11-Jul-94
Error Type: Content
Page Number: 2.127
Error Description: The 'pid' parameter to Pwaitpid() is never pushed
onto the stack. This alters the stack correction
amount.
Error Correction: The correct binding is:
pea rusage
move.w flag,-(sp)
move.w pid,-(sp)
trap #1
lea 10(sp),sp
-----------------------
Date Entered 11-Jul-94
Error Type: Omission
Page Number: 2.35
Error Description: The location of GEMDOS return codes is never
indicated in the Function Calling Procedure.
Error Correction: GEMDOS return values are stored in D0 on function
exit.
-----------------------
Date Entered 11-Jul-94
Error Type: Content
Page Number: 2.45
Error Description: Cconws() is incorrectly defined with a VOID return
value.
Error Correction: Cconws() returns a WORD containing the number of
characters output or 0 if an error occurred.
-----------------------
Date Entered 11-Jul-94
Error Type: Content
Page Number: 2.46
Error Description: The prototype for Cnecin() is incorrect.
Error Correction: Cnecin() returns a LONG value.
-----------------------
Date Entered 11-Jul-94
Error Type: Content
Page Number: 2.55
Error Description: The binding for Dfree() contains an incorrect
parameter name.
Error Correction: The line "pea info" should be replaced by "pea
buf".
-----------------------
Date Entered 11-Jul-94
Error Type: Content
Page Number: 2.56
Error Description: The three parameters to Dgetcwd() are incorrectly
ordered. In addition, the stack correction is less
efficient than it could be.
Error Correction: The parameters to Dgetcwd() should be passed in the
order: size, drv, path. The line "add.l #10,sp"
should be replaced with "lea 10(sp),sp"
-----------------------
Date Entered 11-Jul-94
Error Type: Content
Page Number: 2.57
Error Description: The binding for Dgetpath() does not place the
function opcode on the stack.
Error Correction: Insert a "move.w #$47,-(sp)" instruction between
"pea buf" and "trap #1".
-----------------------
Date Entered 11-Jul-94
Error Type: Content
Page Number: 2.58
Error Description: The parameter "mode" is incorrectly spelled as
"move".
-----------------------
Date Entered 11-Jul-94
Error Type: Content
Page Number: 2.68
Error Description: The Fcntl() "cmd" values for F_GETLK and F_SETLK are
incorrect.
Error Correction: F_GETLK is 'cmd' 0x0004. F_SETLK is 'cmd' 0x0005.
-----------------------
Date Entered 11-Jul-94
Error Type: Content
Page Number: 2.72
Error Description: A structure member of 'struct winsize' is missing
from the explanation of 'cmd' TIOCGWINSZ.
Error Correction: An additional structure member should be added to the
end of the definition as follows:
WORD ws_ypixel;
This represents the height of the window in pixels.
-----------------------
Date Entered 11-Jul-94
Error Type: Content
Page Number: 2.89
Error Description: The binding for Frename() does not put the function
opcode on the stack. When this is added the stack
correction amount also must be changed.
Error Correction: Insert the line "move.w #$56,-(sp)" between the
last argument and the trap statement. The stack
correction amount must be changed from 10 to 12.
-----------------------
Date Entered 11-Jul-94
Error Type: Content
Page Number: 2.95
Error Description: The binding for Fwrite() does not put the function
opcode on the stack. When this is added the stack
correction amount also must be changed.
Error Correction: Insert the line "move.w #$40,-(sp)" between the
last argument and the trap statement. The stack
correction amount must be changed from 10 to 12.
-----------------------
Date Entered 11-Jul-94
Error Type: Design
Page Number: 3.11
Error Description: The last column of the subtable of '_VDO' titled
'Shifter' should be left-aligned.
-----------------------
Date Entered 11-Jul-94
Error Type: Omission
Page Number: 3.22
Error Description: The BIOS Function Calling Procedure does not mention
where the BIOS places return codes.
Error Correction: The BIOS places return codes in D0.
-----------------------
Date Entered 11-Jul-94
Error Type: Content
Page Number: 4.100
Error Description: The header name given to indicate an invalid sync
format from the function Sndstatus() is incorrect.
Error Correction: The name SND_BADSYNC should be used instead of
SND_BADSYC.
-----------------------
Date Entered 11-Jul-94
Error Type: Content
Page Number: 4.102
Error Description: The stack correction for the Soundcmd() binding is
incorrect.
Error Correction: The stack should be corrected by 6, not 2 bytes.
-----------------------
Date Entered 11-Jul-94
Error Type: Omission
Page Number: 4.104
Error Description: The VgetMonitor() call should mention that this
function is also sometimes referred to as mon_type()
by some compilers.
-----------------------
Date Entered 11-Jul-94
Error Type: Content
Page Number: 4.106
Error Description: The parameter names in the binding for VsetMask() are
incorrectly prefixed with a '#'. In addition, the
stack correction method could be more efficient.
Error Correction: Remove the '#' from the first three parameters and
change the line "add.l #12,sp" to "lea
12(sp),sp".
-----------------------
Date Entered 11-Jul-94
Error Type: Content
Page Number: 4.110
Error Description: The stack correction amount for VsetSync() is
incorrect.
Error Correction: The stack correction should be 4 bytes instead of 2.
-----------------------
Date Entered 11-Jul-94
Error Type: Content
Page Number: 4.17
Error Description: The serial port mapping table incorrectly lists "Mega
ST" as the first column header.
Error Correction: The correct header should be "Mega STe".
-----------------------
Date Entered 11-Jul-94
Error Type: Omission
Page Number: 4.19
Error Description: The XBIOS Function Calling Procedure does not mention
where the XBIOS places its return code.
Error Correction: The XBIOS places this value in D0.
-----------------------
Date Entered 11-Jul-94
Error Type: Content
Page Number: 4.24
Error Description: The stack correction for the Bioskeys() binding is
incorrect.
Error Correction: The stack correction amount is 2, not 4.
-----------------------
Date Entered 11-Jul-94
Error Type: Content
Page Number: 4.45
Error Description: The stack correction amount for Dsp_InqrSubrAbility()
is incorrect.
Error Correction: The correct stack correction value should be 4, not
2.
-----------------------
Date Entered 11-Jul-94
Error Type: Content
Page Number: 4.50
Error Description: The stack correction amount for Dsp_MultBlocks() is
incorrect.
Error Correction: The correct amount of stack correction is 18, not 20.
-----------------------
Date Entered 11-Jul-94
Error Type: Content
Page Number: 4.57
Error Description: The first parameter reference in the binding for
Egetpalette() is incorrect.
Error Correction: The parameter name pushed should be paldata, not
palette.
-----------------------
Date Entered 11-Jul-94
Error Type: Content
Page Number: 4.61
Error Description: The first parameter reference in the binding for
EsetPalette() is incorrect.
Error Correction: The parameter name pushed should be paldata, not
palette.
-----------------------
Date Entered 11-Jul-94
Error Type: Content
Page Number: 4.70
Error Description: The header name for Giaccess() register 1 is
incorrect.
Error Correction: The correct name is PSG_APITCHHIGH.
-----------------------
Date Entered 11-Jul-94
Error Type: Content
Page Number: 4.71
Error Description: The 'register' values for PSG_CPITCHLOW and
PSG_CPITCHHIGH are incorrect.
Error Correction: The correct values should be 4 and 5 respectively.
-----------------------
Date Entered 11-Jul-94
Error Type: Content
Page Number: 4.96
Error Description: The function opcode in the binding is incorrect.
Error Correction: The correct function opcode is 21 (hex).
-----------------------
Date Entered 25-Sep-94
Error Type: Content
Page Number: 6.100
Error Description: The intin assignments in the binding for
graf_watchbox() are incorrect.
Error Correction: The correct assignments are intin[0] = 0, intin[1] =
obj, intin[2] = instate, intin[3] = outstate.
-----------------------
Date Entered 25-Sep-94
Error Type: Content
Page Number: 6.104
Error Description: Several caveats were omitted.
Error Correction: The ob_x and ob_y fields of the root menu object
should always be set to 0 prior to making the
menu_attach() call. In addition, under AES 3.40, no
more than one scrolling sub-menu should be contained
in each tree.
-----------------------
Date Entered 25-Sep-94
Error Type: Omission
Page Number: 6.110
Error Description: The header constants for flag are not listed.
Error Correction: The flag value of 0 is MN_INQUIRE and the flag value
of 1 is MN_CHANGE.
-----------------------
Date Entered 25-Sep-94
Error Type: Content
Page Number: 6.128
Error Description: The return values for rsrc_gaddr are swapped.
Error Correction: The correct return value is 0 if an error occurred or
non-zero if addr is valid.
-----------------------
Date Entered 25-Sep-94
Error Type: Content
Page Number: 6.129
Error Description: The return values for rsrc_load are swapped.
Error Correction: rsrc_load() returns 0 if an error occurred or 1
otherwise.
-----------------------
Date Entered 25-Sep-94
Error Type: Content
Page Number: 6.129
Error Description: The return value for rsrc_obfix() is incorrect.
Error Correction: rsrc_obfix() always returns 1.
-----------------------
Date Entered 25-Sep-94
Error Type: Content
Page Number: 6.130
Error Description: The return values for rsrc_rcfix() are swapped.
Error Correction: rsrc_rcfix() returns a 0 if unsuccessful or non-zero
otherwise.
-----------------------
Date Entered 25-Sep-94
Error Type: Content
Page Number: 6.145
Error Description: The name given to bit 0 in the SWM_NEWMSG call is
incorrectly identified as B_UNTOPPABLE.
Error Correction: The correct name for the bit is NM_APTERM.
-----------------------
Date Entered 25-Sep-94
Error Type: Content
Page Number: 6.15
Error Description: The ob_head parameters in the diagram for objects #3
and #4 are incorrect.
Error Correction: Both object's ob_head parameter should be (-1).
-----------------------
Date Entered 25-Sep-94
Error Type: Content
Page Number: 6.151
Error Description: The description for wind_create() incorrectly states
that the AES was limited to only four windows prior
to TOS 1.04.
Error Correction: Only the desktop was limited to four windows. The AES
actually allowed seven windows.
-----------------------
Date Entered 25-Sep-94
Error Type: Content
Page Number: 6.156
Error Description: The contrl[2] assignment at the bottom of the page is
incorrect.
Error Correction: The assignment should be contrl[2] = 5.
-----------------------
Date Entered 25-Sep-94
Error Type: Content
Page Number: 6.158
Error Description: The binding for wind_open is incomplete.
Error Correction: The intin assignments should be intin[0] = handle,
intin[1] = x, intin[2] = y, intin[3] = w, intin[4] =
h.
-----------------------
Date Entered 25-Sep-94
Error Type: Omission
Page Number: 6.16
Error Description: The table correctly lists G_PROGDEF as an object
type.
Error Correction: The name G_USERDEF is also used by some compilers.
-----------------------
Date Entered 25-Sep-94
Error Type: Omission
Page Number: 6.161
Error Description: No version of availablility is given for the
WF_TOOLBAR code.
Error Correction: WF_TOOLBAR is available as of AES 4.10.
-----------------------
Date Entered 25-Sep-94
Error Type: Omission
Page Number: 6.21
Error Description: The te_thickness attribute specifies that values for
it may be positive or negative but do not specify
what difference that makes.
Error Correction: Positive te_thickness values extend the border
towards the center of the object and negative values
extend the border away from the center.
-----------------------
Date Entered 25-Sep-94
Error Type: Content
Page Number: 6.3
Error Description: The maximum number of desk accessories that the AES
can support under TOS 1.0 is incorrect.
Error Correction: The AES can support six desk accessories under all
versions.
-----------------------
Date Entered 25-Sep-94
Error Type: Content
Page Number: 6.33
Error Description: Window Toolbars are incorrectly identified as being
available in AES 4.0.
Error Correction: Window Toolbars are available from AES 4.1 and later.
-----------------------
Date Entered 25-Sep-94
Error Type: Omission
Page Number: 6.36
Error Description: The AE_LANG AES system variable was omitted.
Error Correction: The AE_LANG specifies a valid country code (see
appl_getinfo) for the AES.
-----------------------
Date Entered 25-Sep-94
Error Type: Content
Page Number: 6.39
Error Description: The comment at the start of the code for _crys_if
incorrectly states that no function uses the addrout
array when rsrc_gaddr actually does.
Error Correction: The rsrc_gaddr call must be special cased in a
function library if you want to use the _crys_if
binding to call the AES.
-----------------------
Date Entered 25-Sep-94
Error Type: Content
Page Number: 6.40
Error Description: The entry for appl_search in the table is incorrect.
Error Correction: appl_search should have values of 1,1,3.
-----------------------
Date Entered 25-Sep-94
Error Type: Content
Page Number: 6.42
Error Description: The entry in the table for rsrc_rcfix is incorrect.
Error Correction: The correct values for rsrc_rcfix are 0,1,1
-----------------------
Date Entered 25-Sep-94
Error Type: Content
Page Number: 6.42
Error Description: The entry in the table for wind_new is incorrect.
Error Correction: wind_new should be 0,1,0
-----------------------
Date Entered 25-Sep-94
Error Type: Content
Page Number: 6.53
Error Description: The error return values for appl_getinfo are swapped.
Error Correction: appl_getinfo() returns 0 if an error occurred or
non-zero otherwise.
-----------------------
Date Entered 25-Sep-94
Error Type: Content
Page Number: 6.65
Error Description: The header name for message #33 is incorrect.
Error Correction: The header name for message #33 should be
WM_BOTTOMED.
-----------------------
Date Entered 25-Sep-94
Error Type: Content
Page Number: 6.66
Error Description: In the entry for MN_SELECTED, it incorrectly
indicates that the extra information is not returned
until AES v4.0.
Error Correction: The extra information for MN_SELECTED is returned as
of AES v3.30.
-----------------------
Date Entered 25-Sep-94
Error Type: Content
Page Number: 6.66
Error Description: The entry for WM_TOPPED gives an incorrect sample
usage.
Error Correction: The correct usage for responding to a WM_TOPPED
message is wind_set( msg[3], WF_TOP, 0, 0, 0, 0 ).
-----------------------
Date Entered 25-Sep-94
Error Type: Content
Page Number: 6.67
Error Description: The entries for WM_ARROWED, WM_HSLID, and WM_VSLID
all incorrectly state their parameters.
Error Correction: These messages are sent with the window handle in
msg[3] and the operation code (as described) in
msg[4].
-----------------------
Date Entered 25-Sep-94
Error Type: Content
Page Number: 6.68
Error Description: The header name WM_BOTTOMED is incorrectly listed.
Error Correction: The correct name is WM_BOTTOMED, not WM_BOTTOM.
-----------------------
Date Entered 25-Sep-94
Error Type: Grammar
Page Number: 6.69
Error Description: The word protocol is spelled wrong in the last
paragraph.
Error Correction:
-----------------------
Date Entered 25-Sep-94
Error Type: Content
Page Number: 6.70
Error Description: The header name WM_BOTTOMED is incorrectly listed at
the top of the page.
Error Correction: The name should be WM_BOTTOMED, not WM_BOTTOM.
-----------------------
Date Entered 25-Sep-94
Error Type: Content
Page Number: 6.71
Error Description: The evnt_multi function is missing a value in its
prototype.
Error Correction: The variable mb (which is a pointer to a word) should
be inserted between my and ks.
-----------------------
Date Entered 25-Sep-94
Error Type: Content
Page Number: 6.84
Error Description: The binding has the nextobj and kc values swapped.
Error Correction: intin[1] should be assigned to kc and intin[2] should
be assigned to nextobj.
-----------------------
Date Entered 25-Sep-94
Error Type: Content
Page Number: 7.105
Error Description: The prototype for vqt_cachesize() is wrong.
Error Correction: vqt_cachesize() returns VOID not a WORD.
-----------------------
Date Entered 25-Sep-94
Error Type: Content
Page Number: 7.105
Error Description: The binding for vqt_attributes incorrectly assigns
attr[6-9].
Error Correction: attr[6-9] should be assigned to ptsout[0-3].
-----------------------
Date Entered 25-Sep-94
Error Type: Content
Page Number: 7.106
Error Description: The last line of the binding for vqt_cachesize is
incorrect.
Error Correction: Replace all occurrences of intin with intout on this
line.
-----------------------
Date Entered 25-Sep-94
Error Type: Content
Page Number: 7.108
Error Description: The availability of vqt_f_extent() is wrong.
Error Correction: vqt_f_extent is only available with SpeedoGDOS.
-----------------------
Date Entered 25-Sep-94
Error Type: Content
Page Number: 7.114
Error Description: The prototype for vqt_pairkern does not give a type
for handle.
Error Correction: handle is of type WORD.
-----------------------
Date Entered 25-Sep-94
Error Type: Content
Page Number: 7.115
Error Description: The prototype for vqt_trackkern does not specify a
type for handle.
Error Correction: handle is of type WORD.
-----------------------
Date Entered 25-Sep-94
Error Type: Content
Page Number: 7.129
Error Description: The binding for vsf_color() incorrectly assigns
handle to contrl[0].
Error Correction: contrl[0] should be assigned to 25.
-----------------------
Date Entered 25-Sep-94
Error Type: Content
Page Number: 7.130
Error Description: The binding for vsf_perimeter() is missing two lines.
Error Correction: intin[0] must be assigned to flag prior to calling
vdi(). The binding should end with "return
intout[0]".
-----------------------
Date Entered 25-Sep-94
Error Type: Content
Page Number: 7.131
Error Description: The binding for vsf_style() does not return a value.
Error Correction: Add the line: "return intout[0]" to the end of the
binding.
-----------------------
Date Entered 25-Sep-94
Error Type: Content
Page Number: 7.136
Error Description: The text in the Return Value paragraph is wrong.
Error Correction: The paragraph should read "vsl_type() returns the
newly set line type."
-----------------------
Date Entered 25-Sep-94
Error Type: Content
Page Number: 7.137
Error Description: The binding for vsl_width() is wrong.
Error Correction: The correct binding is: contrl[0] = 16; control[1] =
1; contrl[2] = 0; contrl[3] = 0; contrl[6] = handle;
ptsin[0] = width; ptsin[1] = 0; vdi(); return
ptsout[0];
-----------------------
Date Entered 25-Sep-94
Error Type: Content
Page Number: 7.137
Error Description: The prototype for vsl_width is wrong.
Error Correction: The function returns a WORD, not VOID.
-----------------------
Date Entered 25-Sep-94
Error Type: Content
Page Number: 7.137
Error Description: The Comments paragraph is wrong.
Error Correction: The line should read "You must call vsl_type( handle,
6 ) to actually utilize this style."
-----------------------
Date Entered 25-Sep-94
Error Type: Content
Page Number: 7.138
Error Description: No description of the return value for vsl_width is
given.
Error Correction: vsl_width() returns the actual line width set.
-----------------------
Date Entered 25-Sep-94
Error Type: Content
Page Number: 7.139
Error Description: The binding for vsm_color() is incorrect.
Error Correction: intin[0] should be set to color prior to calling
vdi().
-----------------------
Date Entered 25-Sep-94
Error Type: Content
Page Number: 7.139
Error Description: The binding for vsm_height is incorrect.
Error Correction: 0 should be assigned to ptsin[0] prior to calling
vdi(). size should be assigned to ptsin[1], not
intin[0] prior to calling vdi(). The function should
return the value in ptsout[1], not intout[0].
-----------------------
Date Entered 25-Sep-94
Error Type: Content
Page Number: 7.143
Error Description: The binding for vsm_type() is incorrect.
Error Correction: contrl[3] should be set to 1. The function should end
with "return intout[0]".
-----------------------
Date Entered 25-Sep-94
Error Type: Content
Page Number: 7.155
Error Description: The binding for vst_load_fonts() is incorrect.
Error Correction: The binding should end with the line: "return
intout[0]".
-----------------------
Date Entered 25-Sep-94
Error Type: Content
Page Number: 7.27
Error Description: The order for the points in a bezier segment is
incorrect.
Error Correction: Each set of points should appear in the order
anchor1, control1, control2, anchor2.
-----------------------
Date Entered 25-Sep-94
Error Type: Content
Page Number: 7.27
Error Description: The binding for v_bez() is incorrect.
Error Correction: intin is actually byte packed. The first element of
bezarr should be placed in the high byte of intin[0]
and the second should be placed in the low byte and
so on.
-----------------------
Date Entered 25-Sep-94
Error Type: Content
Page Number: 7.29
Error Description: contrl[1] is incorrectly assigned in v_bez_on.
Error Correction: contrl[1] should be set to 0.
-----------------------
Date Entered 25-Sep-94
Error Type: Content
Page Number: 7.33
Error Description: Two values for ptsin are not present in the binding
for v_circle.
Error Correction: ptsin[4] should be set to radius. ptsin[5] should be
set to 0.
-----------------------
Date Entered 25-Sep-94
Error Type: Content
Page Number: 7.33
Error Description: The index for colarray was omitted in the binding for
v_cellarray.
Error Correction: The line should appear intin[i] = colarray[i]
-----------------------
Date Entered 25-Sep-94
Error Type: Content
Page Number: 7.36
Error Description: The value assigned to contrl[1] and contrl[3] is
incorrect.
Error Correction: The value 1 should be assigned to both.
-----------------------
Date Entered 25-Sep-94
Error Type: Content
Page Number: 7.37
Error Description: The prototype of v_curhome() does not match the
function name.
Error Correction: The prototype should read VOID v_curhome( handle ).
-----------------------
Date Entered 25-Sep-94
Error Type: Content
Page Number: 7.58
Error Description: The variable i is initialized incorrectly.
Error Correction: The first line of the binding should read WORD i = 2;
-----------------------
Date Entered 25-Sep-94
Error Type: Content
Page Number: 7.60
Error Description: The binding for v_loadcache sets contrl[3]
incorrectly.
Error Correction: contrl[3] should be set to i, not --i.
-----------------------
Date Entered 25-Sep-94
Error Type: Content
Page Number: 7.65
Error Description: The structure definition contains a duplicate entry
(WORD maxwchar, maxhchar).
Error Correction: The line should read "WORD maxwchar, maxhchar"
-----------------------
Date Entered 25-Sep-94
Error Type: Content
Page Number: 7.65
Error Description: The prototype for V_Opnvwk is incorrect.
Error Correction: The parameter dev is a pointer to VDI_Workstation
structure.
-----------------------
Date Entered 25-Sep-94
Error Type: Content
Page Number: 7.66
Error Description: The binding for V_Opnvwk incorrectly lists its
parameter.
Error Correction: V_Opnvwk takes a pointer to a VDI_Workstation
structure.
-----------------------
Date Entered 25-Sep-94
Error Type: Content
Page Number: 7.67
Error Description: The "i" in the function binding 'for' loop is
uppercase.
Error Correction:
-----------------------
Date Entered 25-Sep-94
Error Type: Content
Page Number: 7.67
Error Description: The prototype for V_Opnwk() is incorrect.
Error Correction: The function takes devno as indicated but takes dev
as a pointer to a VDI_Workstation structure.
-----------------------
Date Entered 25-Sep-94
Error Type: Content
Page Number: 7.68
Error Description: The binding for V_Opnwk is incorrect.
Error Correction: The name of the function should be V_Opnwk() and it
takes devno as listed but takes dev as a pointer to a
VDI_Workstation structure.
-----------------------
Date Entered 25-Sep-94
Error Type: Content
Page Number: 7.69
Error Description: The sub-opcode for v_output_window() is wrong.
Error Correction: The correct sub-opcode is 21.
-----------------------
Date Entered 25-Sep-94
Error Type: Content
Page Number: 7.71
Error Description: The ptsin array is incorrectly assigned in the loop
in the binding for v_pline().
Error Correction: ptsin[i] should be set to pxy[i].
-----------------------
Date Entered 25-Sep-94
Error Type: Content
Page Number: 7.71
Error Description: ptsin[7] is not assigned to anything in the binding
for v_pieslice.
Error Correction: ptsin[7] should be set to 0.
-----------------------
Date Entered 25-Sep-94
Error Type: Content
Page Number: 7.77
Error Description: contrl[3] is incorrectly assigned in the binding for
v_set_app_buff().
Error Correction: contrl[3] should be set to 3.
-----------------------
Date Entered 25-Sep-94
Error Type: Content
Page Number: 7.81
Error Description: The opcode for vex_curv() is incorrect.
Error Correction: The opcode should be 127 (this must be changed in the
binding as well).
-----------------------
Date Entered 25-Sep-94
Error Type: Content
Page Number: 7.83
Error Description: The binding for vex_timv is missing a line at the
end.
Error Correction: The last line should read "*mpt = intout[0]".
-----------------------
Date Entered 25-Sep-94
Error Type: Content
Page Number: 7.85
Error Description: contrl[3] is incorrectly assigned in vm_pagesize().
Error Correction: contrl[3] should be set to 3.
-----------------------
Date Entered 25-Sep-94
Error Type: Content
Page Number: 7.9
Error Description: The entry in the table called XINCL is incorrect.
Error Correction: The correct name is XMINCL.
-----------------------
Date Entered 25-Sep-94
Error Type: Omission
Page Number: 7.90
Error Description: No header names are given for valid mode values.
Error Correction: Use VQ_BASE for 0 and VQ_EXTENDED for 1.
-----------------------
Date Entered 25-Sep-94
Error Type: Omission
Page Number: 7.92
Error Description: No indication is made as to how third-party GDOS
replacements can be found.
Error Correction: Older GDOS replacements fall into the 'other value'
category of the table. Check with the manufacturer
for more product specific details.
-----------------------
Date Entered 25-Sep-94
Error Type: Content
Page Number: 7.98
Error Description: The opcode for vql_attributes is incorrect.
Error Correction: The correct opcode is 35 (this must be changed in the
binding as well).
-----------------------
Date Entered 25-Sep-94
Error Type: Content
Page Number: 7.99
Error Description: The binding for vqm_attributes assigns the wrong
values to attr[3] and attr[4].
Error Correction: attr[3] should be assigned to ptsout[0] and attr[4]
should be assigned to ptsout[1].
-----------------------
Date Entered 25-Sep-94
Error Type: Content
Page Number: 8.5
Error Description: The entry in the table called V_CEL_BG is incorrect.
Error Correction: The correct name is V_COL_BG.
-----------------------
Date Entered 25-Sep-94
Error Type: Content
Page Number: 9.4
Error Description: Three environment variables used by the Desktop are
not mentioned.
Error Correction: If the system variable ACCPATH is present, it will be
used as a path from where to load accessories from.
The variables SHSHOW and SHPRINT can be assigned the
complete path and name of programs which are called
when the user tries to view or print a desktop file.
-----------------------
Date Entered 25-Sep-94
Error Type: Content
Page Number: A.10
Error Description: An XBIOS function 'WakeTime' was omitted.
Error Correction: The XBIOS has a function, WakeTime (opcode 0x2F)
which takes two unsigned shorts as input. The first
gives a BIOS date, and the second gives a BIOS time.
This function is only available on the ST Book and
puts it to sleep until the given time.
-----------------------
Date Entered 25-Sep-94
Error Type: Content
Page Number: A.15
Error Description: The description for v_clrwk() is incorrect.
Error Correction: v_clrwk() clears the specified workstation.
-----------------------
Date Entered 25-Sep-94
Error Type: Content
Page Number: B.17
Error Description: The start of the STe operating system is incorrectly
indicated.
Error Correction: The STe's TOS started at 0xE00000, not 0xFC0000 as
indicated.
-----------------------
Date Entered 25-Sep-94
Error Type: Content
Page Number: B.28
Error Description: Bit #3 of the Falcon030 DSP/DMA controller are
incorrectly labeled.
Error Correction: When bit 3 is 0 it selects the DSP as the
destination.
-----------------------
Date Entered 25-Sep-94
Error Type: Content
Page Number: B.29
Error Description: Bit #3 of the DMA Crossbar Input Select is incorrect.
Error Correction: Having this bit set to 1 selects all others besides
the DSP.
-----------------------
Date Entered 25-Sep-94
Error Type: Content
Page Number: B.29
Error Description: The DAC Output controls appear in the wrong bits in
the diagram.
Error Correction: The DAC output controls actually appear in bits
14-13.
-----------------------
Date Entered 25-Sep-94
Error Type: Content
Page Number: B.32
Error Description: According to the chart, the STe does not contain a
Blitter.
Error Correction: The STe does contain a Blitter.
-----------------------
Date Entered 25-Sep-94
Error Type: Content
Page Number: B.33
Error Description: According to the chart, the Mega STe contains an has
a DMA controller for the SCC.
Error Correction: The Mega STe did not contain SCC DMA registers.
-----------------------
Date Entered 25-Sep-94
Error Type: Content
Page Number: I.3
Error Description: The register numbers for PSG_CPITCHLOW and
PSG_CPITCHHIGH are incorrect.
Error Correction: The correct register numbers are 4 and 5
respectively.
-----------------------
Date Entered 25-Sep-94
Error Type: Content
Page Number: I.3
Error Description: The names for registers 0 and 1 are incorrect.
Error Correction: The name for register 0 is PSG_APITCHLOW. The name
for register 1 is PSG_APITCHHIGH.
-----------------------
Date Entered 25-Sep-94
Error Type: Design
Page Number: 10.23
Error Description: The variable name event is not italicized properly in
cpx_m1().
-----------------------
Date Entered 25-Sep-94
Error Type: Content
Page Number: 10.24
Error Description: The parameter "event" for cpx_m2 is given the wrong
type in the prototype.
Error Correction: event should be a pointer to a WORD.
-----------------------
Date Entered 25-Sep-94
Error Type: Content
Page Number: 10.39
Error Description: In the list of possible messages for Xform_do() to
return it spells WM_CLOSED as WM_CLOSE.
-----------------------
Date Entered 25-Sep-94
Error Type: Content
Page Number: 10.4
Error Description: The structure member cpx_close in the CPXINFO
structure is defined with an incorrect return type.
Error Correction: cpx_close returns VOID, not WORD.
-----------------------
Date Entered 25-Sep-94
Error Type: Content
Page Number: 10.5
Error Description: The XCPB structure member MFsave is spelled wrong.
Error Correction: It should be MFsave, not MFSave.
-----------------------
Date Entered 25-Sep-94
Error Type: Content
Page Number: 10.5
Error Description: The XCPB structure member reserved has the wrong
name.
Error Correction: Replace the reserved member with the name version (it
contains the version number of the currently running
control panel).
Table of Contents | Index