Documentation Ada-处理子单元的gnatdoc问题

Documentation Ada-处理子单元的gnatdoc问题,documentation,ada,Documentation,Ada,我正试图使用GNATdoc工具为我的Ada项目生成文档信息。GNATdoc能够为所有包生成信息,但标记为子单元的包除外(使用单独的标识符)。 示例- package body A is x : Integer; package B is y : Natural; end B; package body B is separate; end A; -------------------------------- separate (A) package bo

我正试图使用GNATdoc工具为我的Ada项目生成文档信息。GNATdoc能够为所有包生成信息,但标记为子单元的包除外(使用单独的标识符)。 示例-

package body A is
    x : Integer;
   package B is 
     y : Natural;
   end B;
   package body B is separate;
 end A;
--------------------------------
separate (A)
package body B is
 b1 : Float;
 b2 : Character;
end B; 
对于上述代码段,GNATdoc不会生成子单元包内容(b1、b2)的文档信息,即使这些内容存在于相应父单元的.ali文件中


任何关于此处可能错误的见解都将不胜感激。

GNATdoc通常不会处理包体的内容。但是,根据您的需要,有两个命令行开关可能会改变这种行为:

流程主体完成规范文件(-b)

默认情况下,GNATdoc不处理包体。这个开关 允许查看包体中的子程序,作为 查找文档。当提供此开关时,先使用GNATdoc 在包规范中查找文档;如果没有 在规范中找到文档,然后搜索文档 在子程序的主体中

文件正文(-d)

当通过此开关时,GNATdoc处理实体和提取 库级实体的文档。在HTML输出中,GNATdoc 为从正文中提取的文档发布单独的页面。这 开关与-b开关不兼容