opendylan
opendylan copied to clipboard
Problems with export -format rst interface-reference
The interface-reference report has some problems determining the correct library and module names. I ran the report for the collection-extensions library and it has two problems I've noticed so far:
-
Classes in the Dylan library are output as
:class:<foo>rather than:drm:<foo>even though the report attempts to do the latter, so there's a bug in the logic ofrst-xref-definition-namewhere it compares the library name to "dylan". (In that functionlibhas to be true, else we would see the problem below... -
The type
<insert-entry>is output as follows``{<insert-entry> in sequence-diff}``Since sequence-diff is the current module for this output it should just be
:class:`<insert-entry>`
- It generates an entry for names that are re-exported from the module, but there's no indication that they are in fact defined elsewhere and just re-exported. For example, the report for
common-dylancontains
.. generic-function:: ^
:open:
:signature: ^ (x y) => (#rest values)
:parameter x: An instance of :class:`<object>`.
:parameter y: An instance of :class:`<object>`.
:value #rest values: An instance of :class:`<object>`.
even though ^ is owned by the dylan library.