bugGNU Octave - Bugs: bug #62855, "doc" command opens gui...


bug #62855: "doc" command opens gui window in octave cli

Submitter:  vidnyan kendra <octnuby>
Submitted:  Wed 03 Aug 2022 08:08:18 AM UTC
Category:  Documentation Severity:  3 - Normal
Priority:  5 - Normal Item Group:  Regression
Status:  Confirmed Assigned to:  None
Originator Name:  Open/Closed:  * Open
Release:  * 7.2.0 Operating System:  * GNU/Linux
* Mandatory Fields

Add a New Comment (Rich Markup)

Comment Type & Canned Response:


Wed 03 Aug 2022 03:07:10 PM UTC, comment #1: 

The code in question is located in scripts/help/doc.m at line 56

  ## Give event manager the first shot.

  status = ! __event_manager_show_documentation__ (function_name);

  if (status)

In Octave 5.2 this code was

  ## if GUI is running, let it display the function
  if (isguirunning ())
    status = ! __octave_link_show_doc__ (function_name);

It seems like this should be configurable because some people running the CLI will want to stay entirely in a terminal environment, while others might still appreciate being able to open up a Qt-based document browser for help while still coding in the CLI.

Rik <rik5>
Project Administrator
Wed 03 Aug 2022 08:08:18 AM UTC, original submission:  

It appears that the `doc` command (in `doc.m`) now tries to launch a GUI documentation browser always, versus only when the GUI is running.  This seems like it should be a configurable option.

I think a simple example to reference is

doc ls

In version 6.4, this launches a CLI Info browser when running with the `--no-gui` option.  In Octave version 7.X this launches a Qt-based Info browser.

vidnyan kendra <octnuby>


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

Attach Files:

No files currently attached


Depends on the following items: None found

Items that depend on this one: None found


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

    There are 0 votes so far. Votes easily highlight which items people would like to see resolved in priority, independently of the priority of the item set by tracker managers.

    Only project members can vote.





    Follow 2 latest changes.

    Date Changed by Updated Field Previous Value => Replaced by
    2022-08-03 rik5 StatusNone Confirmed
    2022-08-03 rik5 Item GroupDocumentation Regression

    Back to the top

    Powered by Savane 3.9