emacs-matlab/toolbox/help.m

function [out, docTopic] = help(varargin)
% Provide help, augmented so Emacs picks it up to display in a special buffer.
% See the help for the built-in help command by asking for "help help" in
% MATLAB, which will redirect to the correct location.
    
    ah = which('help', '-all');
    builtinhelp = ah{2};
    
    [ helpPath, ~ ] = fileparts(builtinhelp);
    
    args = varargin;

    cookie = true;
    if nargin > 0 && strcmp(args{1}, '-emacs')
        cookie=false;
        args = args(2:end);
    end

    % Provide access to the built-in help by CDing to that location.
    oldpath = pwd;
    cd(helpPath);
    cleanup = onCleanup(@()cd(oldpath));
    
    switch nargout
      case 0
        if cookie
            disp('<EMACSCAP>(*MATLAB Help*)');
        end
        help(args{:});
        if cookie
            disp('</EMACSCAP>');
        end
      case 1
        [out] = help(args{:});
      case 2
        [out, docTopic] = help(args{:});
    end
end