Opened 14 years ago

Last modified 13 years ago

#1446 closed defect (fixed)

OMEdit does not show non-HTML documentation

Reported by: perost Owned by: perost
Priority: high Milestone:
Component: Version:
Keywords: Cc: perost, adeas31

Description

OMEdit does not seem to show non-HTML documentation, such as in any of the Modelica.Math.Matrices.LAPACK classes.

Change History (8)

comment:1 Changed 14 years ago by adeas31

yes beacuse OMEdit uses the getDocumentationAnnotation API and since getDocumentaitonAnnotaiton API only reads the HTML section of the documentation annotation. I will check the API list and see if there is any command to get the full documentation.

comment:2 Changed 14 years ago by adrpo

I will push a change in a little while that will make:

getDocumentationAnnotation(Modelica.Math.Matrices.LAPACK.dgeev);

return the correct string.
We haven't looked inside external declarations for the documentation annotations!

comment:3 Changed 14 years ago by adrpo

  • partially fixed in revsion: 8148, see SCM Commits tab.
  • now omc returns the documentation annotation from the external declaration.
  • checks with OMEdit are needed to see if it works properly.

comment:4 Changed 14 years ago by perost

Ok, with Adrians changes OMEdit now shows the documentation. The formatting is not preserved though, which makes the documentation for the LAPACK models pretty much unreadable. This seems to be an issue with OMEdit, since the formatting is preserved in the test case Adrian added.

comment:5 Changed 14 years ago by adrpo

Yes, OMEdit should check if the string starts/ends with <html> and if not, preserve
the formatting, i.e. you could add pre (verbose) tags so that the html editor knows that
it need to preserve the formatting.

<pre>
documentation that needs preserving
</pre>

comment:6 Changed 14 years ago by sjoelund.se

Don't you mean <pre></pre> ?

comment:7 Changed 14 years ago by adrpo

yes, i got mixed in tags :)

comment:8 Changed 14 years ago by sjoelund.se

Fixed in r8206

Note: See TracTickets for help on using tickets.