Matlab社区

Matlab,社区和更多

R2010B评论包装改进

在R2010b中,我们对MATLAB编辑器中的“注释包装”特性做了一系列改进。在这个由两部分组成的系列中,我们将详细研究这些改进。

在第一部分中,我们将介绍注释换行,并讨论它现在如何更容易使用。在第二部分中,我们将为严肃的评论作者介绍更高级的操作。

等等,什么是评论包装?
简而言之,注释换行是MATLAB编辑器的一个功能(可通过“文本”>“注释换行”菜单项访问),它允许你从杂乱的注释:

comment-wrapping-before

格式整齐:

解释包装后

该功能还包括自动的注释换行,当输入超出行尾时发生。在R2010b中,我们使这个特性更简单、更强大。

不需要选择

在R2010b之前,如果您想在编辑注释时重新格式化一段注释,首先必须选择需要重新格式化的区域,然后按Ctrl-J(或在Mac上按Shift-Fan-W)。

comment-wrapping-selection.png

在R2010B中,您仍然可以这样做。但更方便,您可以跳过进行选择,并让编辑推断您的当前评论部分。例如,假设您的墨卡圈在下面第5行的末尾:

comment-wrapping-noselection.png

现在,只需按Ctrl-J重新格式化这部分注释,插入符号将保持在文本中原来的位置。插入符号实际上可以在第一行到第五行的任何地方。这可以让你在不中断输入的情况下整理你所写的内容。

注意,编辑器只包装了评论的当前“部分”。那么如何定义section呢?但愿与您所想的完全一样:一系列连续的、同样缩进的注释行。因此,非注释行、空行或缩进不同的注释都表示一节的结束。这允许独立的“段落”注释保持完整,防止它们串在一起,即使你做一个“选择所有”>“包装注释”来重新格式化整个文件。

不再有断弦

在R2010b之前,注释包装的一个令人沮丧的行为是,如果你的注释包含不应该被破坏的文本,比如发布超链接标记中的URL,注释包装将继续并破坏它:

comment-wrapping-brokenstring.png

这是真实的评论包装,如果你在键入长弦并达到右边的边缘,它会破裂。这对阅读并不乐意,特别是出版的人:

注释 - 包装发布 -  biskstring.png

在R2010b中,注释换行遵守这个简单的规则:如果没有空格,就不要中断!这意味着url或任何长字符串将被保留:

comment-wrapping-published.png

结束(呻吟)
目前为止就这样了。在下一部分中,我们将对此功能讨论更多的增强功能。与此同时,尝试一下,让我知道你的想法!

|

注释

要留下评论,请点击这里登录到您的MathWorks帐户或创建一个新帐户。