matlab - 在另见文档部分解决名称与内置函数的冲突

Question

我有以下类，它有一个隐藏（或阴影）内置函数的方法。我希望文档包含一个“另见”部分，该部分链接到隐藏的内置函数。

classdef CatHelper
  %CATHELPER Makes implementing vertcat/horzcat easy on a custom class
  %
  %   See Also: cat

  methods (Abstract)
    obj = cat(obj, ndim, varargin);
  end
end

不幸的是，“另见”链接只是试图为未记录的抽象方法提供帮助CatHelper/cat。

如何指定我希望链接转到内置 cat函数？

Answer 1

在玩了一会儿之后doc.m\resolveTopic()，我想出了如下所示的三个选项。前一个 ( \cat) 给出了最好的结果，但你应该使用你认为在你的情况下最不模糊的那个。

%   See Also: \cat
%   See Also: elmat\cat
%   See Also: matlab\elmat\cat

这些是通过传递topic = 'cat'到：

matlab.internal.language.introspective.resolveName(topic, '', false);

Answer 2

一个稍微难看的解决方法是只包含一个直接链接：

%   See Also: <a href="matlab:help cat">cat</a>