diff --git a/matlab/reports/@graph/createGraph.m b/matlab/reports/@graph/createGraph.m
index d2c663db2..9874ca78f 100644
--- a/matlab/reports/@graph/createGraph.m
+++ b/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
diff --git a/matlab/reports/@graph/display.m b/matlab/reports/@graph/display.m
index 71c2b2ea2..7938abb45 100644
--- a/matlab/reports/@graph/display.m
+++ b/matlab/reports/@graph/display.m
@@ -3,7 +3,7 @@ function display(o)
 % Display a Graph object
 %
 % INPUTS
-%   none
+%   o   [graph] graph object
 %
 % OUTPUTS
 %   none
diff --git a/matlab/reports/@graph/graph.m b/matlab/reports/@graph/graph.m
index b8a73374e..1836ac9c3 100644
--- a/matlab/reports/@graph/graph.m
+++ b/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
diff --git a/matlab/reports/@graph/write.m b/matlab/reports/@graph/write.m
index aecf8ab08..7eb10c731 100644
--- a/matlab/reports/@graph/write.m
+++ b/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
diff --git a/matlab/reports/@pages/addPage.m b/matlab/reports/@pages/addPage.m
index 174d39b23..e248cba7a 100644
--- a/matlab/reports/@pages/addPage.m
+++ b/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
\ No newline at end of file
diff --git a/matlab/reports/@report/addGraph.m b/matlab/reports/@report/addGraph.m
index 37ced6625..a9b247b32 100644
--- a/matlab/reports/@report/addGraph.m
+++ b/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
diff --git a/matlab/reports/@report/addPage.m b/matlab/reports/@report/addPage.m
index f5f2c2468..0f65bead4 100644
--- a/matlab/reports/@report/addPage.m
+++ b/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
diff --git a/matlab/reports/@report/addSection.m b/matlab/reports/@report/addSection.m
index fabc7a191..a0667a5ec 100644
--- a/matlab/reports/@report/addSection.m
+++ b/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
diff --git a/matlab/reports/@report/addTable.m b/matlab/reports/@report/addTable.m
index 7257aa5ac..15199b4bd 100644
--- a/matlab/reports/@report/addTable.m
+++ b/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
diff --git a/matlab/reports/@report/display.m b/matlab/reports/@report/display.m
index 5c1f47148..60c3f11f4 100644
--- a/matlab/reports/@report/display.m
+++ b/matlab/reports/@report/display.m
@@ -3,7 +3,7 @@ function display(o)
 % Display a Report object
 %
 % INPUTS
-%   none
+%   o     [report]  report object
 %
 % OUTPUTS
 %   none
diff --git a/matlab/reports/@report/numPages.m b/matlab/reports/@report/numPages.m
index 27bc12ed0..5863c55e1 100644
--- a/matlab/reports/@report/numPages.m
+++ b/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
\ No newline at end of file
diff --git a/matlab/reports/@report/private/validateOrientation.m b/matlab/reports/@report/private/validateOrientation.m
index 98683c36c..41bf58eed 100644
--- a/matlab/reports/@report/private/validateOrientation.m
+++ b/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
\ No newline at end of file
diff --git a/matlab/reports/@report/private/validatePaper.m b/matlab/reports/@report/private/validatePaper.m
index 0395db76f..73b6bb367 100644
--- a/matlab/reports/@report/private/validatePaper.m
+++ b/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
diff --git a/matlab/reports/@report/report.m b/matlab/reports/@report/report.m
index 77f3faa90..62cedefbb 100644
--- a/matlab/reports/@report/report.m
+++ b/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
diff --git a/matlab/reports/@report/write.m b/matlab/reports/@report/write.m
index 21496e2e9..39b965f19 100644
--- a/matlab/reports/@report/write.m
+++ b/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