bugGNU Octave - Bugs: bug #49373, Visual documentation for all...


bug #49373: Visual documentation for all plot/image functions

Submitted by:  Rik <rik5>
Submitted on:  Mon 17 Oct 2016 03:41:07 PM UTC  
Category: DocumentationSeverity: 1 - Wish
Priority: 5 - NormalItem Group: Feature Request
Status: ConfirmedAssigned to: None
Originator Name: Open/Closed: Open
Release: devOperating System: Any

Add a New Comment(Rich Markup)

You are not logged in

Please log in, so followups can be emailed to you.


Mon 17 Oct 2016 05:07:51 PM UTC, comment #2:

Both things. Every visual function should have a %!demo so we can catch differences with the dump_plot_demos script. But I mostly wanted a picture in the PDF documentation which is the second thing. It's cool that Octave-Forge has already been hooked up that way, but I was thinking of just one, or maybe two, pictures per function that were for documentation purposes.

Rik <rik5>
Project Administrator
Mon 17 Oct 2016 05:00:26 PM UTC, comment #1:


Do you mean that each plotting function should have at least one demo or that demos (all or part of) should appear in the html/pdf versions of the manual. I agree with the former, and the latter seams to have been implemented in the documentation generated in octave-forge. See e.g. http://octave.sourceforge.net/octave/function/contourf.html

Pantxo Diribarne <pantxo>
Project Member
Mon 17 Oct 2016 03:41:07 PM UTC, original submission:

It would be very helpful if every plot/image function had at least one accompanying image to demonstrate what the function actually does.

In English, we say "A picture is worth a thousand words". And it is true that it is often very difficult to document in text the output of a function, but quite easy to show it.

As an example, the text for the jet colormap is.

I'm not sure what that would look like, but the image from

is quite clear.

Rik <rik5>
Project Administrator


(Note: upload size limit is set to 16384 kB, after insertion of the required escape characters.)

Attach File(s):

No files currently attached


Depends on the following items: None found

Items that depend on this one: None found


Carbon-Copy List
  • -unavailable- added by pantxo (Posted a comment)
  • -unavailable- added by rik5 (Submitted the item)

    Do you think this task is very important?
    If so, you can click here to add your encouragement to it.
    This task has 0 encouragements so far.

    Only project members can vote.


    Please enter the title of George Orwell's famous dystopian book (it's a date):



    No Changes Have Been Made to This Item

    Back to the top

    Powered by Savane 3.1-cleanup1