reporting: code cleanup

matlab/reports/@graph/createGraph.m

@@ -3,10 +3,10 @@ function o = createGraph(o)
 % Create the graph
 %
 % INPUTS
-%   o   - Graph Object
+%   o   [graph] graph object
 %
 % OUTPUTS
-%   o   - Graph Object
+%   o   [graph] graph object
 %
 % SPECIAL REQUIREMENTS
 %   none

matlab/reports/@graph/display.m

@@ -3,7 +3,7 @@ function display(o)
 % Display a Graph object
 %
 % INPUTS
-%   none
+%   o   [graph] graph object
 %
 % OUTPUTS
 %   none

matlab/reports/@graph/graph.m

@@ -3,11 +3,13 @@ function o = graph(varargin)
 % Graph Class Constructor
 %
 % INPUTS
-%   0 args => empty graph
-%   1 arg (graph class) => copy object
+%   varargin        0 args  : empty graph object
+%                   1 arg   : must be graph object (return a copy of arg)
+%                   > 1 args: option/value pairs (see structure below for
+%                   options)
 %
 % OUTPUTS
-%   none
+%   o   [graph] graph object
 %
 % SPECIAL REQUIREMENTS
 %   none

matlab/reports/@graph/write.m

@@ -3,10 +3,11 @@ function o = write(o, fid)
 % Write a Graph object
 %
 % INPUTS
-%   fid - int, file id
+%   o   [graph]   graph object
+%   fid [integer] file id
 %
 % OUTPUTS
-%   o   - this
+%   o   [graph] graph object
 %
 % SPECIAL REQUIREMENTS
 %   none

matlab/reports/@pages/addPage.m

@@ -19,10 +19,4 @@ function ps = addPage(ps, varargin)
 % along with Dynare.  If not, see <http://www.gnu.org/licenses/>.
 
 ps.objArray = ps.objArray.addObj(page(varargin{:}));
-%assert(nargin >= 1 && nargin <= 3)
-%if nargin == 1
-%    ps.objArray = ps.objArray.addObj(page());
-%else
-%    ps.objArray = ps.objArray.addObj(varargin{:});
-%end
 end

matlab/reports/@report/addGraph.m

@@ -1,13 +1,13 @@
 function o = addGraph(o, varargin)
 %function o = addGraph(o, varargin)
-% Add a section to the current page in the current report
+% Add a graph to the current section of the current page in the report
 %
 % INPUTS
-%   o        - report object
-%   varargin - arguments to @section/addGraph.m
+%   o          [report]  report object
+%   varargin             arguments to @section/addGraph.m
 %
 % OUTPUTS
-%   o        - updated report object
+%   o          [report]  updated report object
 %
 % SPECIAL REQUIREMENTS
 %   none

matlab/reports/@report/addPage.m

@@ -1,14 +1,13 @@
 function o = addPage(o, varargin)
 %function o = addPage(o, varargin)
-% Add a page to the Cell Array of pages in the report
+% Add a page to the report
 %
 % INPUTS
-%   1 args => add empty page
-%   2 args => add given page
-%   3 args => add page at index
+%   o          [report]  report object
+%   varargin             arguments to @section/addGraph.m
 %
 % OUTPUTS
-%   updated report object
+%   o          [report]  updated report object
 %
 % SPECIAL REQUIREMENTS
 %   none
@@ -30,22 +29,6 @@ function o = addPage(o, varargin)
 % You should have received a copy of the GNU General Public License
 % along with Dynare.  If not, see <http://www.gnu.org/licenses/>.
 
-%assert(nargin >= 1 && nargin <= 3, ['incorrect number of arguments passed ' ...
-%    'to addPage']);
-%assert(isa(r, 'report'), 'First argument must be a report object');
-%if nargin > 1
-%    assert(isa(varargin{1},'page'), ['Optional 2nd arg to addPage must be a ' ...
-%        'Page']);
-%    if nargin > 2
-%        assert(isnumeric(varargin{2}), ['Optional 3rd arg to addPage must be ' ...
-%            'an index']);
-%    end
-%end
-
-if nargin == 1
-    o.pages = o.pages.addPage('orientation', o.orientation, 'paper', o.paper);
-else
-    o.pages = o.pages.addPage('orientation', o.orientation, 'paper', ...
-                              o.paper, varargin{:});
-end
+o.pages = o.pages.addPage('orientation', o.orientation, 'paper', o.paper, ...
+                          varargin{:});
 end

matlab/reports/@report/addSection.m

@@ -1,13 +1,13 @@
 function o = addSection(o, varargin)
 %function o = addSection(o, varargin)
-% Add a section to the current page in the current report
+% Add a section to the current page in the report
 %
 % INPUTS
-%   o        - report object
-%   varargin - arguments to @page/addSection.m
+%   o          [report]  report object
+%   varargin             arguments to @section/addGraph.m
 %
 % OUTPUTS
-%   o        - updated report object
+%   o          [report]  updated report object
 %
 % SPECIAL REQUIREMENTS
 %   none

matlab/reports/@report/addTable.m

@@ -1,13 +1,13 @@
 function o = addTable(o, varargin)
 %function o = addTable(o, varargin)
-% Add a section to the current page in the current report
+% Add a table to the current section of the current page in the report
 %
 % INPUTS
-%   o        - report object
-%   varargin - arguments to @section/addTable.m
+%   o          [report]  report object
+%   varargin             arguments to @section/addTable.m
 %
 % OUTPUTS
-%   o        - updated report object
+%   o          [report]  updated report object
 %
 % SPECIAL REQUIREMENTS
 %   none

matlab/reports/@report/display.m

@@ -3,7 +3,7 @@ function display(o)
 % Display a Report object
 %
 % INPUTS
-%   none
+%   o     [report]  report object
 %
 % OUTPUTS
 %   none

matlab/reports/@report/numPages.m

@@ -1,12 +1,12 @@
-function np = numPages(r)
-%function np = numPages(r)
+function n = numPages(o)
+%function n = numPages(o)
 % return the number of pages currently in the report
 %
 % INPUTS
-%   none
+%   o     [report]  report object
 %
 % OUTPUTS
-%   none
+%   n     [integer] number of pages in the report object
 %
 % SPECIAL REQUIREMENTS
 %   none
@@ -28,5 +28,5 @@ function np = numPages(r)
 % You should have received a copy of the GNU General Public License
 % along with Dynare.  If not, see <http://www.gnu.org/licenses/>.
 
-np = r.pages.numPages();
+n = o.pages.numPages();
 end

matlab/reports/@report/private/validateOrientation.m

@@ -3,10 +3,10 @@ function validateOrientation(orientation)
 % Validate orientation string
 %
 % INPUTS
-%   char : the orientation
+%   orientation     [char] orientation (one of 'portrait' or 'landscape')
 %
 % OUTPUTS
-%   char : lowercase orientation
+%   none
 %
 % SPECIAL REQUIREMENTS
 %   none
@@ -29,5 +29,6 @@ function validateOrientation(orientation)
 % along with Dynare.  If not, see <http://www.gnu.org/licenses/>.
 
 assert(any(strcmpi(orientation, {'portrait', 'landscape'})), ['Valid ' ...
-                    'orientation arguments are: ''portrait'' and ''landscape''.']);
+                    'orientation arguments are: ''portrait'' and ' ...
+                    '''landscape''.']);
 end

matlab/reports/@report/private/validatePaper.m

@@ -3,10 +3,10 @@ function validatePaper(paper)
 % Validate paper string
 %
 % INPUTS
-%   char : paper size
+%   paper    [char]  valid LaTeX paper type
 %
 % OUTPUTS
-%   char : lowercase paper
+%   none
 %
 % SPECIAL REQUIREMENTS
 %   none

matlab/reports/@report/report.m

@@ -3,11 +3,12 @@ function o = report(varargin)
 % Report Class Constructor
 %
 % INPUTS
-%   1 report class object => make a copy
-%   Otherwise, option/value pairs (see structure below for options)
+%   varargin        0 args  : empty report object
+%                   1 arg   : must be report object (return a copy of arg)
+%                   > 1 args: option/value pairs (see structure below for options)
 %
 % OUTPUTS
-%   none
+%   o     [report]  report object
 %
 % SPECIAL REQUIREMENTS
 %   none

matlab/reports/@report/write.m

@@ -3,10 +3,10 @@ function o = write(o)
 % Write Report object
 %
 % INPUTS
-%   o   - Report Object
+%   o     [report]  report object
 %
 % OUTPUTS
-%   o   - Report Object
+%   o     [report]  report object
 %
 % SPECIAL REQUIREMENTS
 %   none