Re: [Plplot-devel] Re: Suggested name change for plHLS_RGB and plRGB_HLS

[Alan W. I. <ir...@be...>]

On 2005-03-13 22:51+0100 Rafael Laboissiere wrote:

> * Alan W. Irwin <ir...@be...> [2005-03-13 12:45]:
>> Regardless of that minor issue, I agree plHLS_RGB and plRGB_HLS have
>> already been publically documented in our docbook documentation. I
>> propose to deprecate (or remove?, comments please) those and document
>> plhlsrgb and plrgbhls instead.
>
> Please, just deprecate them, but maintain them in the API for backward
> compatibility.

I have finally pinned down when plHLS_RGB got introduced into our common API
documentation despite its not being part of the common API at that time.
This was done in the last-minute rush before the release of PLplot-5.3.1,
and the more experienced PLplot developers at the time (including me) should
have caught and corrected this documentation problem, but we didn't
(probably because we were too mentally exhausted). Because plHLS_RGB did get
introduced into 5.3.1, I will deprecate it rather than removing it from the
documentation altogether.

Alan
__________________________
Alan W. Irwin
email: ir...@be...
phone: 250-727-2902

Astronomical research affiliation with Department of Physics and Astronomy,
University of Victoria (astrowww.phys.uvic.ca).

Programming affiliations with the FreeEOS equation-of-state implementation
for stellar interiors (freeeos.sf.net); PLplot scientific plotting software
package (plplot.org); the Yorick front-end to PLplot (yplot.sf.net); the
Loads of Linux Links project (loll.sf.net); and the Linux Brochure Project
(lbproject.sf.net).
__________________________

Linux-powered Science
__________________________