do also something for classes ...

Author: ralfHielscher

@DocFile/copy.m

@@ -1,10 +1,12 @@
 function copy(docFile,destination)
 % copy all docFiles to the given destination folder 
 
-if isempty(dir(destination))
+[~,~,ext] = fileparts(destination);
+
+if isempty(dir(destination)) && isempty(ext)
   mkdir(destination);
 end
 
 for k=1:numel(docFile)
   copyfile(docFile(k).sourceFile,destination);
-end
+end

@DocFile/exclude.m

@@ -0,0 +1,8 @@
+function docFile = exclude(docFile,varargin)
+% remove directories or files from docfile
+
+for i = 1:nargin-1
+  
+  docFile = docFile(cellfun('isempty',strfind({docFile.sourceFile},varargin{i})));
+  
+end

@DocFile/getFormatedRef.m

@@ -1,16 +1,16 @@
 function helpStr = getFormatedRef( file ,varargin)
 % returns a processed string for function file
 %
-%% Input
+% Input
 % file     - current file
 %
-%% Output
+% Output
 % helpString - a string for publishing
 %
-%% Remarks !TODO
+% Remarks !TODO
 % 'input', 'output', 'example', 'see also', 'description', 'syntax', 'view code'
 %
-%% See also
+% See also
 % DocFile/getFormatedDoc DocFile/publish
 
 options = parseArguments(varargin);
@@ -61,15 +61,32 @@
 function  sections = help2struct(file,options)
 % struct('title','sectioname','content','descriptive text')
 
-
 helpStr = helpfunc(file.sourceFile);
+
+if isempty(helpStr)
+  process = helpUtils.helpProcess(0,1, {file.sourceFile});
+
+  process.getHelpText;
+  
+  helpStr = process.helpStr;
+  
+end
+
+
+
 docName = file.sourceInfo.docName;
 Title = regexprep(docName,'(\w*)\.(\w*)', ...
   ['$2' char(10) '  \(method of [[$1_index.html,$1]]\)' char(10) ' % ']);
 
 helpStr = [' % ' Title  char(10)  helpStr];
 
 helpStr = regexprep(helpStr,'(?<=^|\n) ','%');
+
+keyWords = {'Input','Output','Syntax','Options','Flags','See also','Description'};
+for i = 1:numel(keyWords)
+  helpStr =  regexprep(helpStr,['\n\%\s*' keyWords{i}],['\n\%\% ' keyWords{i}]);
+end
+
 helpStr = globalReplacements(helpStr,options.outputDir);
 m = m2struct(helpStr);
 

@DocFile/isClass.m

@@ -0,0 +1,12 @@
+function isCl = isClass(file)
+% checks whether docFile is a class file
+%
+%% Input
+% file   - a @DocFile
+%
+%% Output
+% isCl  - |true| / |false| 
+
+str = read(file);
+
+isCl = any(strfind(str,'classdef'));

@DocFile/isFunction.m

@@ -19,19 +19,18 @@
   lineBreak = regexp(str,'\n');
   if hasKeyword(1) == 1
     Syntax = str(10:lineBreak(1));
+    isFun = true;
   else
     lastLineBreak = lineBreak(lineBreak<hasKeyword(1));    
     lineTillFuncStr = str(lastLineBreak+1:hasKeyword(1)+7);
 
-    if isempty(strfind(lineTillFuncStr,'%'))
-     nextLineBreak = lineBreak(lineBreak > hasKeyword(1));
-     Syntax = str(hasKeyword(1)+9:nextLineBreak(1));
-    end
+    nextLineBreak = lineBreak(lineBreak > hasKeyword(1));
+    Syntax = str(hasKeyword(1)+9:nextLineBreak(1));
+    if isempty(strfind(lineTillFuncStr,'%')), isFun = true; end
   end
 
   if exist('Syntax','var')
     Syntax = strtrim(Syntax);
-    Syntax = regexprep(Syntax,'varargin','...,param,val,...');    
-    isFun = true;
+    Syntax = regexprep(Syntax,'varargin','''param1'',val1,''param2'',val2');        
   end
 end

@DocFile/publish.m

@@ -87,7 +87,9 @@
 
 
 
-% if ~isfield(options,'publishSettings')
+if ~isfield(options,'publishSettings')
+  options.publishSettings = struct;
+end
 
 switch options.format
   case {'latex','tex'}
@@ -105,7 +107,7 @@
 end
 
 % end
-options.publishSettings = struct;
+
 options.publishSettings.useNewFigure = true;
 if ~isfield(options.publishSettings,'format')
   options.publishSettings.format = format;
@@ -176,7 +178,7 @@ function prepareFilesToPublish(docFiles,options)
     %     end
 
     try
-      if isFunction(docFile)
+      if isFunction(docFile) || isClass(docFile)
         text = getFormatedRef(docFile,'outputDir',outputDir);
       else
         text = getFormatedDoc(docFile,docFiles);

resources/style/toolbox.xml

@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="utf-8"?>
+<mytoolbox>
+   <name>MTEX</name>
+   <fullname>&lt;b&gt;MTEX&lt;/b&gt; - A MATLAB Toolbox for Quantitative Texture Analysis</fullname>
+   <versionname>MTEX 4.0.0</versionname>
+   <procuctpage>mtex_product_page.html</procuctpage>
+   <icon>$toolbox/matlab/icons/book_mat.gif</icon>
+</mytoolbox>