我正在使用sproutcore,我使用sc-gen生成这样的控制器(这是来自sproutcore Todos教程):
sc-gen controller Todos.tasksController SC.ArrayController
在生成的javascript文件中,我找到了这个javascript注释行:
/** @scope Todos.tasksController.prototype */
我想知道这个@scope是做什么的。这有必要吗?解析这个@scope关键字的工具是什么?这是sproutcore特有的东西还是一般用于javascript?
答案 0 :(得分:3)
SproutCore支持生成文档的JSDoc标准。
@scope语法是其中的一部分。这里有一个更深入的解释:
http://code.google.com/p/jsdoc-toolkit/wiki/DocExamples#Changing_Scope
如果您不打算使用JSDoc,则不需要您自己的代码。但是如果你这样做,或者你正在使用支持JSDoc的编辑器/ IDE(例如JetBrains WebStorm),那么保留它是个好主意。
在构建SC应用程序时,所有注释都会被删除(缩小版本),因此不会影响应用程序的大小。