在另请参阅文档部分中解决与内置函数的名称冲突

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

不幸的是,"see also"链接只是尝试在未记录的抽象方法上提供帮助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);