The format is improved:  the darker two-tone striping delineates whitespace 
clearly between most blocks.  Some blocks have new or extended examples.  
Symbols are colored for their part of speech.  Even so, there is still room for 
improvement.

The '&' character with a rounded center is not readily recognized by me as an 
ampersand, which I usually see with a diagonal center.  They can easily be seen 
as a wheelchair icon or read as 'Б' or 'd'.

In the "Glossary" block, the names are not highlighted in my browser as links, 
and the printed copy doesn't clarify them, either.  A note could refer readers 
to their Vocabulary pages.

In "Shape, Length, Rank", most results don't correspond to the argument value 
given in the footnote.

In "Scalar dyadic verbs", the sum should be 5.  '?' is termed 'rnd' here, but 
'rand' in the monadic block.

In "Scalar monadic verbs", the usual notation for Factorial would be 'y!'.

In "Verbs on Booleans", '!' is used for Complement, which is more often notated 
by a hooked horizontal bar.  The two '1x1's seem to use a (small) 
multiplication sign in place of letter 'x'.

In "Special Code", the meaning of '(PPPP)' needs extensive explanation, and 
should probably be listed last, if at all.

In "Selection", '(<<1 3){C' yields '|index error', while  '(<<0 2)C' will yield 
   0 1 2
   6 7 8
'((<1 0) ; <<2 0 1) { C' gives a result of shape 2 3 3.
'(a: ; << 2 0) { C' gives a result of shape 2 2 3.

In "Join and reshape", results for appending '8 9' and '8' are interchanged.  
Footnote (a) should say "1's are prepended to shape...".  ["1s" is easily 
misread as "Is".]  
Footnotes (c) and (d) are pushed into their predecessors' areas.  
The box for '3;4;5' appears at first to be misaligned;  it should be repeated.

In "Adverbs", the result for 'amend' should be '1 9 8'.  
The argument for 'insert' should be '0 1 2'.  
'subarray[s]' are missing the argument.  The horizontal partition should be 
below three rows.  The vertical shadings should be continuous as in the second 
example.
Footnote (f) could read "u applies collectively to the shaded item(s) in each 
tile."  
The broken outlines for '[self-]intervals' (and in other blocks) are almost 
invisible.

In "Indexing", first two descriptions should really begin 'index of ...'.  
Third could be 'flags x-values matched in y'.
Fourth-line y-argument needs to be literal, e.g.:  '3 4 2 6'.
Description for E. could be 'flags starts in y of whole copies of x'.
Description for I. could be '...each y'.

In the small table with headings 'Arg' and 'Of', I can't make much sense of the 
first three lines, and the last two could also state their context.

In "Miscellaneous", description for '#.' could be 'number given by y as digits 
in base x'.
Description for '#.^:_1' could be 'list of base-x digits representing y'.
'{.^:a:&0' needs extensive footnote.
Description for 'b.' could be 'u info for y: _1=inv, 0=ranks, 1=ident fn'.
Description for 'F..' could be 'fold: apply u to each item of v\y'.
Label for '$:' could be 'recur' or 'recursion'.
The entry for "extended floating-point" needs a footnote clarifying which is 
the main verb.  Its color bar has a gap.

In "Foreigns", '0!:111 sentences' would behave more like ' ". ' .
Footnote (a) is missing.
Descriptions for '3!:0' and '3!:1' could be '...of noun y'
Description for '3!:4 integers' could be '...2/4/8-byte value'.
Listing for '3!:4 integers' should be repeated on two lines.
Description for '3!:4 bytes; x=0' could be 'unsigned 2-byte value to J int'.  
For other x: 'signed 2/4/8-byte value to J int'.  For '3!:5: '4/8-bit value'.
Equivalent for '4!:0' is not 'datatype'.
Description for '6!:1' could say '...since J session started'.
Description for '6!:2' should say '...execute...'.
Description for '7!:2' could be 'space used in execution of sentence'.

"Selected debug commands" needs statement of various relevant operating 
environments and their activations.
Description for 'dbr 0' could be 'clear most recent suspension from stack and 
disable new suspensions'.
[Other listed commands killed my J902 session.]
----------------------------------------------------------------------
For information about J forums see http://www.jsoftware.com/forums.htm

Reply via email to