From maechler at stat.math.ethz.ch  Fri Nov  5 12:32:50 2004
From: maechler at stat.math.ethz.ch (Martin Maechler)
Date: Fri Nov  5 12:32:54 2004
Subject: [Rd] Bug report (PR#7341)
In-Reply-To: <20041104180808.174B110F56@slim.kubism.ku.dk>
References: <20041104180808.174B110F56@slim.kubism.ku.dk>
Message-ID: <16779.25826.488530.297612@gargle.gargle.HOWL>

>>>>> "dan" == dan  <dan@bolser.co.uk>
>>>>>     on Thu,  4 Nov 2004 19:08:08 +0100 (CET) writes:

    dan> Full_Name: Dan B Version: na OS: na Submission from:
    dan> (NULL) (80.6.127.185)


    dan> I can't log into the bug tracker (I can't find where to
    dan> register / login).

[that's not what you should do. 
 Have you read on this in the FAQ or  help(bug.report) ?
 Please, please, do.
]

    dan> In this way I can't add the following context diff
    dan> (hopefully in the right order) for my changes to the
    dan> matrix.Rd...

    dan> Hmm... I guess this should be a separate report
    dan> anyway...

No, this is really not a bug report __AT ALL__

You had all this long discussion about how the documentation 
can/could/should/{is_hard_to} be improved  and end up sending
a *bug report* ?
Really!

Whereas I value your contribution for improving the matrix help
page -- and I do think both changes are worthwhile ---
there is no bug, and hence a bug report is *WRONG*!

Sending this to R-devel [instead! - not automagically via the
bug report] would have been perfectly fine and helpful...

    dan> The first diff explains how the dimnames list should
    dan> work, and the second diff gives an example of using the
    dan> dimnames list. (no equivelent example exists, and where
    dan> better than the matrix man page to show this off).

agreed.

I'll put in a version of your proposed improvement,
but please do try more to understand what's appropriate for bug
reports.

Regards,
Martin Maechler, ETH Zurich


[Rd] Bug report (PR#7341)
Martin Maechler