[Octave-bug-tracker] [bug #50680] Better documentation of colororder property

[Pantxo Diribarne]

Follow-up Comment #3, bug #50680 (project octave):

I don't think it is the colororder property documentation that has to be
better improved; most properties are reset by newplot, not only this
particular property.

We need to find a place to fully document the interaction between axes and
high level plotting functions. Something like:

"Some properties of axes objects ("colororder" for example) have to be changed
before any plot to be effective. On the other hand, unless "hold" has been
used, high level plotting functions will reset axes properties (see newplot)
before plotting. Basically there are two ways to deal with this case:
* Create the axes, set its properties at your convenience and then use "hold
on" to prevent newplot from resetting the axes properties. E.g:

axes ("colororder", jet (5), "box", "on");
hold ("on")
plot (rand (5,5))

* Set properties as defaults. E.g:

figure ("defaultaxescolororder", jet (5))
axes ();
plot (rand (5,5))


Note also that most 2D high level plotting functions set the "box" axes
property "on". In the first method we need to set "box" to "on" manually,
otherwise the resulting plot will have its "box" "off" (the default)."

I think something like this covers much of this bug and bug #49400.

    _______________________________________________________

Reply to this item at:

  <http://savannah.gnu.org/bugs/?50680>

_______________________________________________
  Message sent via/by Savannah
  http://savannah.gnu.org/