/usr/share/octave/packages/miscellaneous-1.2.1/infoskeleton.m is in octave-miscellaneous 1.2.1-2build2.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 | ## Copyright (C) 2008 Muthiah Annamalai <muthiah.annamalai@uta.edu>
##
## This program is free software; you can redistribute it and/or modify it under
## the terms of the GNU General Public License as published by the Free Software
## Foundation; either version 3 of the License, or (at your option) any later
## version.
##
## This program is distributed in the hope that it will be useful, but WITHOUT
## ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
## FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more
## details.
##
## You should have received a copy of the GNU General Public License along with
## this program; if not, see <http://www.gnu.org/licenses/>.
##-*- texinfo -*-
## @deftypefn{Function File} infoskeleton(@var{prototype}, @var{index_str}, @var{see_also})
## Generate TeXinfo skeleton documentation of @var{prototype}.
##
## Optionally @var{index_str} and @var{see_also} can be specified.
##
## Usage of this function is typically,
## @example
## infoskeleton('[V,Q] = eig( A )','linear algebra','eigs, chol, qr, det')
## @end example
## @seealso{info}
## @end deftypefn
function infoskeleton( prototype , index_str, seealso)
## FIXME: add placeholders for math TeX code, examples etc.
if nargin < 1
print_usage();
end
if nargin < 2
index_str = "";
end
if nargin < 3
seealso = "";
end
##
## try to parse the function prototype
## as:
## function retval = fname ( arg1, arg2, etc )"
##
prototype = strtrim( prototype );
idx = strfind( prototype, "function" );
if ( !isempty( idx ) )
prototype(idx:idx+7) = "";
end
idx = strfind( prototype, "=" );
retval = "";
if( !isempty( idx ) )
retval = strtrim ( prototype( 1 : idx(1)-1 ) );
prototype = prototype ( idx(1) + 1: end );
end
idx = strfind( prototype, "(" );
fname = prototype;
if( !isempty( idx ) )
fname = strtrim( prototype(1:idx(1)-1) );
prototype = prototype(idx(1) + 1:end);
end
## next time, use strtok() very easy & simple
pos = 0; args = {};
idx = strfind( prototype , "," );
if ( !isempty( idx ) )
prev = [ 0, idx ];
for pos=1:length( idx )
args{ pos } = strtrim ( prototype(prev( pos )+1 :idx(pos)-1) );
end
prototype = prototype(idx(end) + 1:end);
end
idx = strfind( prototype, ")" );
if ( !isempty( idx ) )
lvar = strtrim ( prototype(1:idx(1)-1) );
if ( length( lvar ) > 0 )
args{ pos + 1 } = lvar;
end
end
## generate the code
fprintf("## -*- texinfo -*-\n")
if ( length( retval ) > 0 )
fprintf("## @deftypefn{Function File} {@var{%s} = } %s (", ...
retval,fname );
else
fprintf("## @deftypefn{Function File} { } %s (", ...
fname );
end
pos = 0;
for pos = 1:length(args)-1
fprintf(" %s,", args{pos} );
end
if ( length(args) > 0 )
fprintf(" %s ) \n", args{pos+1} );
end
fprintf("## @cindex %s \n",index_str);
fprintf("## The function %s calculates where",fname );
pos = 0;
for pos = 1:length(args)-1
fprintf(" @var{%s} is ,", args{pos} );
end
if ( length(args) > 0 )
fprintf(" @var{%s} is .\n", args{pos+1} );
end
fprintf("## @example\n");
fprintf("## \n");
fprintf("## @end example\n");
fprintf("## @seealso{%s}\n",seealso);
fprintf("## @end deftypefn\n");
end
%!demo infoskeleton( ' [x,y,z]=infoskeleton(func , z , z9 , jj, fjh, x) ')
%!demo infoskeleton('[V,Q] = eig( A )','linear algebra','eigs, chol, qr, det')
%!demo infoskeleton( 'function [x,y,z] = indian_languages ( x) ')
|