| 主权项 |
一种用于使用注释来提供与存储在存储设备中的代码的使用有关的向导的方法，所述方法包括：基于通过对代码的分析所确定的代码模块的功能性意图将适当的注释与所述代码模块相关联，其中注释列举已被指定给所述代码的角色或分类，并且其中通过指示功能性意图，所述角色或分类描述其中适合使用特定代码模块的一个或多个上下文，而不是描述该特定代码模块的精确功能，并且其中指定给所述代码的角色或分类包括以下的至少之一：内循环代码角色，其指示代码有可能在更大的循环中被客户端应用程序、程序、函数、或其它代码的程序集调用，以作为更大的算法的一部分，输入输出代码角色，其指示代码有可能被用于批处理过程或服务过程，交互代码角色，其指示代码有可能被交互事件驱动的应用程序、程序、函数、或其它代码的程序集的一部分使用，启动代码角色，其指示代码有可能在对应的应用程序、程序、函数、或其它代码的程序集的启动路径上出现，呈现经注释的向导作为用户接口的一部分，所述向导包括：对于内循环代码角色，建议该代码由被赋予输入输出代码、交互代码或启动代码角色或分类的代码调用，对于输入输出代码角色，建议该输入输出代码在功能上与内循环代码不兼容，并因此不能被内循环代码调用，对于交互代码角色，提倡调用被赋予内循环角色或分类的代码，对于启动代码角色，不鼓励或拒绝从已被赋予另一个角色或分类的代码中进行调用。 |
