Thank you for the detailed feedback, Art. I'll reupload later on.

Aug 25, 2022, 20:36 by [email protected]:

> 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
>

----------------------------------------------------------------------
For information about J forums see http://www.jsoftware.com/forums.htm

Reply via email to