How do I use the help command to display multi-line comments?
显示 更早的评论
Multi-line comments can be achieved using:
%{
random foobars
%}
However, whenever I place this at the top of a new script and try to call the help command, the output keeps on resulting in just:
{
Does this mean that the help command is limited to only single-line comments? I would assume that this was the case and call it a day but a textbook on MATLAB shows an example that prints out a multi-line comment using 'help'.
3 个评论
Walter Roberson
2016-11-2
It is interpreting "random foobars" as a command, and so proceeding to foobar??
Benjamin Wong
2016-11-3
Walter Roberson
2016-11-3
Sigh. I feel so old some days, my culture lost in time, like tears in the rain.
采纳的回答
Abhinav Gurram
2016-11-7
4 个投票
The ability to add block comments to the help text of a function is not available in MATLAB.
MATLAB considers the group of consecutive lines immediately following the H1 line and those beginning with a % sign to be the online help text for the function. The H1 line is the first help text line that consists of comment text. Therefore, the H1 line begins with a % sign. The first line without a % sign as the left-most character ends the help.
In this case, as a block comment using the operators %{ and %} is added, the lines inside the block do not start with a % sign. Therefore, MATLAB considers the %{ line as the end of the help.
As an alternative, use a % sign at the beginning of each line instead of block comments. You can comment multiple lines by selecting them and using Ctrl + R. To uncomment them, select the group of lines, and use Ctrl + T.
Hope this helps!
2 个评论
Aaron Kaw
2020-11-20
Yes this definitely helps.
But doesn't address ease of use. This multiline documentation feature exists in so many other languages already. The pain of manually adding a % for each newline I make gets irritating.
And using CTRL + R means we have to keep toggling with CTRL + T whenever we need to make major edits to the help documentation of each function/class/etc.
Additionally, CTRL + R places the comment symbol at the beginning of each line, not indented to the the needed position.
Andrew Sandeman
2023-11-7
Building on the above comment by Aaron with an example, say you would like to document your function as closely as possible to how MATLAB documents it (down to the whitespacing and indentation), see example below:
%CAT Concatenate arrays.
% CAT(DIM,A,B) concatenates the arrays A and B along
% the dimension DIM.
% CAT(2,A,B) is the same as [A,B].
% CAT(1,A,B) is the same as [A;B].
%
% B = CAT(DIM,A1,A2,A3,A4,...) concatenates the input
% arrays A1, A2, etc. along the dimension DIM.
I currently struggle to have a quick way to do this, for the reasons in the above comment.
(MATLAB 2023a)
更多回答（0 个）
类别
在 帮助中心 和 File Exchange 中查找有关 Entering Commands 的更多信息
Community Treasure Hunt
Find the treasures in MATLAB Central and discover how the community can help you!
Start Hunting!
Translated by 
