bugGNU Octave - Bugs: bug #40342, help "FolderName" to...

 
 

bug #40342: help "FolderName" to print Contents.m files does not work properly.

Submitted by:  None
Submitted on:  Tue 22 Oct 2013 02:54:17 AM UTC  
 
Category: Octave FunctionSeverity: 3 - Normal
Priority: 5 - NormalItem Group: Regression
Status: FixedAssigned to: None
Originator Name: Mario KleinerOriginator Email: -unavailable-
Open/Closed: ClosedRelease: dev
Operating System: Any

Add a New Comment(Rich Markup)
   

You are not logged in

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

 

Tue 22 Oct 2013 09:37:44 AM UTC, comment #2:

I checked in the following change:

http://hg.savannah.gnu.org/hgweb/octave/rev/5b0036d89d4a

John W. Eaton <jwe>
Project Administrator
Tue 22 Oct 2013 03:14:17 AM UTC, comment #1:

Confirmed the behavior and that this did work in 3.6.4.

The reason it now fails to show help is because

for the PsychDemos/Contents.m file mentioned in the report with no blank lines.

Mike Miller <mtmiller>
Project Administrator
Tue 22 Oct 2013 02:54:17 AM UTC, original submission:

Hi,

this is a funny regression. If i have a Contents.m file in a folder, e.g, "PsychDemos" with functions, then

help PsychDemos

does display the Contents.m file in that folder as it should in Octave 3.6.x and earlier, but doing the same thing in the 3.7.x development versions will say "error: help: 'PsychDemos' not found".

This makes it difficult to provide high level help files.
Strangely, adding two blank lines (newlines) to the end of such a Contents.m file makes the help function work again.

I tested this with Psychtoolbox, which has Contents.m files in each subfolder.

<https://github.com/Psychtoolbox-3/Psychtoolbox-3/tree/master/Psychtoolbox>

"help Psychtoolbox" works, as the Contents.m file in the top-level Psychtoolbox folder has 2 blank lines, but "help PsychDemos" doesn't work , as the Psychtoolbox/PsychDemos/Contents.m file doesn't have two extra blank lines.

This makes our help system a bit crippled on Octave 3.7+

It would be great if this could be fixed before the 3.8 release.

thanks,
-mario

Anonymous

 

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

Attach File(s):
   
   
Comment:
   

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 rik5 (Updated the item)
  • -unavailable- added by jwe (Posted a comment)
  • -unavailable- added by mtmiller (Posted a comment)
  • -unavailable- added by None (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):

     

     

    Follow 5 latest changes.

    Date Changed By Updated Field Previous Value => Replaced By
    Thu 24 Oct 2013 12:19:37 AM UTCrik5StatusReady For Test=>Fixed
      Open/ClosedOpen=>Closed
    Tue 22 Oct 2013 09:37:44 AM UTCjweStatusConfirmed=>Ready For Test
    Tue 22 Oct 2013 03:14:17 AM UTCmtmillerCategoryInterpreter=>Octave Function
      StatusNone=>Confirmed

    Back to the top


    Powered by Savane 3.1-cleanup1