From tplate at acm.org  Wed Nov  3 20:52:30 2004
From: tplate at acm.org (Tony Plate)
Date: Wed Nov  3 20:52:45 2004
Subject: [Rd] barplot manpage (PR#7331)
In-Reply-To: <x2lldi21n0.fsf@biostat.ku.dk>
References: <Pine.LNX.4.21.0411021602000.6111-100000@mail.mrc-dunn.cam.ac.uk>
	<4187DA6F.9020602@pburns.seanet.com>
	<6.1.0.6.2.20041102124129.0bb1de70@mailhost.blackmesacapital.com>
	<x2lldi21n0.fsf@biostat.ku.dk>
Message-ID: <6.1.0.6.2.20041103122719.0bb8eb58@mailhost.blackmesacapital.com>

You're right: it's ?par that could use fixing (wrt to definitions of 
"cex"-related arguments).

This is also a good example of why making even small changes to 
documentation is fraught with difficulty.  I suspect that such discussions 
could be had about many "minor improvements".

-- Tony Plate


At Wednesday 12:06 PM 11/3/2004, Peter Dalgaard wrote:
>Tony Plate <tplate@acm.org> writes:
>
> > (1) Change "expansion factor" to "character scaling factor" or
> > "character magnification" in the descriptions of 'cex.axis' and
> > 'cex.names'
>
>Now that's a really bad idea in my book... The "ex" in "cex" is
>*ex*actly for *ex*pansion, also note the consistency with "mex".
>
> > (The documentation for 'barplot' uses 'expansion factor', while the
> > documentation for 'par' itself uses two other different terms
> > 'magnification' and 'scaling' to describe various 'cex' related
> > arguments.  Both common sense (my own, at least) and guidelines I
> > could find on the net suggest that it is better to consistently use a
> > single term to refer to a single concept.)
>
>Yup, but I think it is ?par that could use fixing. (The description of
>"mex" in there is a bit iffy as well. Why mix character sizes into
>something that really deals in interline distances?)
>
> > (2) add "par" to the "see also" section
>
>Obvious. In a bunch of other places too, I guess.
>
>--
>    O__  ---- Peter Dalgaard             Blegdamsvej 3
>   c/ /'_ --- Dept. of Biostatistics     2200 Cph. N
>  (*) \(*) -- University of Copenhagen   Denmark      Ph: (+45) 35327918
>~~~~~~~~~~ - (p.dalgaard@biostat.ku.dk)             FAX: (+45) 35327907
>
>______________________________________________
>R-devel@stat.math.ethz.ch mailing list
>https://stat.ethz.ch/mailman/listinfo/r-devel


[Rd] barplot manpage (PR#7331)
Tony Plate