[Octave-bug-tracker] [bug #42460] Section 15.3.3 required update for current system

[Michael Godfrey]

Follow-up Comment #19, bug #42460 (project octave):

On Tue, Jun 3, 2014 at 17:00:54 +0100, Michael D. Godfrey wrote:
> On 06/03/2014 04:28 PM, Rik wrote:
>
>> I haven't applied anything.  It seemed like Mike Miller was handling that
>> issue report.
>
>
>> I think we do need a little blurb about every property.  These values
>> don't
>> change often so generating them once and putting them in the documentation
>> is probably a worthwhile use of time.  Also, Matlab does a good job of
>> documenting every single property and it does make things clearer.  See,
>> for example,http://www.mathworks.com/help/matlab/ref/figure_props.html.
>>
>> --Rik
>
> Rik,
> I really liked your suggestion:
> ## In Octave
> unlink doctmp
> diary doctmp
> set (0)
> diary off
> exit
>
> ## In a shell
> perl -i.bak -pe 's/([{}])/@$1/g' doctmp
> ==================
> You say that these things have not been changing much, but when I edited
> the entries for each property group I found lots of errors.  This
> documentation
> may not have been kept up-to-date, but...  Obviously, people who have been
> changing the properties have not bothered to update the documentation
> in plot.txi.
>
> With the automation above being in use then each category could
> be followed by a bock of explanation and examples. This would be clearer
> and easier to maintain.
>
> Anyhow, the current changeset is up-to-date right now, and is a lot
> clearer than the current, so it would be nice if one of you could push it.

Can we move this back onto the bug tracker? I've lost track of the
context a bit. Is this the "final_v2" changeset you're talking about
now?

Thanks,

-- mike 

    _______________________________________________________

Reply to this item at:

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

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