bugGNU Octave - Bugs: bug #40557, Rework manual Java "FAQ"...

 
 

bug #40557: Rework manual Java "FAQ" sections

Submitted by:  Philip Nienhuis <philipnienhuis>
Submitted on:  Tue Nov 12 20:41:48 2013  
 
Category: DocumentationSeverity: 3 - Normal
Priority: 5 - NormalItem Group: Incorrect Documentation
Status: FixedAssigned to: None
Originator Name: Philip NienhuisOpen/Closed: Closed
Release: devOperating System: Any

Add a New Comment (Rich MarkupRich Markup):
   

You are not logged in

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

 

Wed Nov 23 21:54:14 2016, comment #5:

Agreed, I think this was resolved with http://hg.savannah.gnu.org/hgweb/octave/rev/b5d9b95d1e1a. The relevant pieces of the previous java.txi texinfo file were merged into external.txi, the "How to distinguish between Octave and Matlab" section was moved to bugs.txi, and the rest was discarded.

Mike Miller <mtmiller>
Project Administrator
Wed Nov 23 21:45:00 2016, comment #4:

I think this issue might be CLOSED now.

When I have a look at the Octave manual in version 4.2.0:

  • The chapter "How to Distinguish Between Octave and Matlab" is now part of "Appendix D Known Causes of Trouble". This seems reasonable to me.
  • There is no FAQ chapter any more.
  • The Java chapter (A.4) does not have a list of TeX symbols any more.
Hartmut <hardy>
Thu Mar 27 03:08:41 2014, comment #3:

I agree the section about distinguishing Octave and Matlab doesn't seem like it fits with the rest of the manual.

The rest of the "FAQ" sections could probably be worked better into the manual, rather than calling it a FAQ.

The list of TeX symbols seems really out of place in the Java section also, particularly since the dialog functions are implemented both in Java and in Qt now.

Retitling for the remaining issues.

Mike Miller <mtmiller>
Project Administrator
Wed Dec 4 04:56:48 2013, comment #2:

I made the changes to the Octave manual suggested in comment #1 (http://hg.savannah.gnu.org/hgweb/octave/rev/42c3e30557a4).

Does the section about distinguishing Octave from Matlab even belong in the Octave manual or should it be moved to the FAQ?

Rik <rik5>
Project Administrator
Wed Nov 13 15:14:44 2013, comment #1:

In the Java section, there's mention of "37.3.1 How to distinguish between Octave and Matlab?"
This section isn't only relevant for Java; it's applicable in many other situations.

What would be a better place for this part of the docs?

Philip Nienhuis <philipnienhuis>
Project Member
Tue Nov 12 20:41:48 2013, original submission:

Appendix D, D.3 Basics of generating a changeset, somewhere in the middle:
"Mercurial has a more useful extensions that really should be enabled"
=> (I think it should read:) =>
"Mercurial has a <b>few</b> more useful extensions that really should be enabled"

Appendix G.1.3:

- Isn't gl2ps needed since recently?

- In the Qt stanza, Qt WebKit is mentioned. IIRC that one was dropped a while ago?

Philip Nienhuis <philipnienhuis>
Project Member

 

(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 hardy (Posted a comment)
  • -unavailable- added by mtmiller (Posted a comment)
  • -unavailable- added by rik5 (Posted a comment)
  • -unavailable- added by philipnienhuis (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 4 latest changes.

    Date Changed By Updated Field Previous Value => Replaced By
    Wed Nov 23 21:54:14 2016mtmillerStatusNeed Info=>Fixed
      Open/ClosedOpen=>Closed
    Thu Mar 27 03:08:41 2014mtmillerStatusNone=>Need Info
      SummarySome doc errors + questions=>Rework manual Java "FAQ" sections

    Back to the top


    Powered by Savane 3.1-cleanup