[R] Surprise when mapping matrix to image

[Patrick Burns]

Peter Dalgaard wrote:

>"Richard A. O'Keefe" <ok at cs.otago.ac.nz> writes:
>  
>
[snip]

>  
>
>
>Good idea, but perhaps not phrased sharply enough to catch the user's
>eye. How about something like this:
>
>"Notice that image() interprets a matrix as a table of f(x_i, y_j), so
>the x axis corresponds to row number and the y axis to column number
>(bottom to top)."
>
>and then use Brian's one-liner in the examples section?
>  
>

Though I think the added text is a good idea, the addition of the example
is probably 102.58 times more useful than any text that could be inserted.

The examples in help files are probably the main reason that people think
of R having better documentation than other programs.  Like Unix man
pages, for example, which would be wonderful if only they had examples
so that you could figure out what the sentences mean when you understand
every word.

Patrick Burns

Burns Statistics
patrick at burns-stat.com
+44 (0)20 8525 0696
http://www.burns-stat.com
(home of S Poetry and "A Guide for the Unwilling S User")