fixing return values and handling of invalid files

[wxWidgets.git] / docs / doxygen / overviews / printing.h

diff --git a/docs/doxygen/overviews/printing.h b/docs/doxygen/overviews/printing.h
index de21b4b77b6965c9f553c47a93454a8e510c795e..6026fa7e6eb82d052ae13578d8847f836bda4a61 100644 (file)
--- a/docs/doxygen/overviews/printing.h
+++ b/docs/doxygen/overviews/printing.h
@@ -6,9 +6,9 @@
 // Licence:     wxWindows license
 /////////////////////////////////////////////////////////////////////////////
 
-/*!
+/**
 
-@page overview_printing Printing Overview
+@page overview_printing Printing Framework Overview
 
 Classes:
 @li wxPrintout
@@ -22,6 +22,22 @@ Classes:
 @li wxPageSetupDialog
 @li wxPageSetupDialogData
 
+
+@li @ref overview_printing_printout
+@li @ref overview_printing_printer
+@li @ref overview_printing_printpreview
+@li @ref overview_printing_printerdc
+@li @ref overview_printing_postscriptdc
+@li @ref overview_printing_printdialog
+@li @ref overview_printing_printdata
+@li @ref overview_printing_printdialogdata
+@li @ref overview_printing_pagesetupdialog
+@li @ref overview_printing_pagesetupdialogdata
+
+
+<hr>
+
+
 The printing framework relies on the application to provide classes whose
 member functions can respond to particular requests, such as 'print this page'
 or 'does this page exist in the document?'. This method allows wxWidgets to
@@ -81,7 +97,7 @@ printing under MSW and Mac), or a wxPostScriptDC (for printing under GTK or
 generating PostScript output).
 
 The @ref overview_docview "document/view framework" creates a default
-wxPrintout object for every view, calling wxView::OnDraw to achieve a
+wxPrintout object for every view, calling wxView::OnDraw() to achieve a
 prepackaged print/preview facility.
 
 If your window classes have a Draw(wxDC *dc) routine to do screen rendering,
@@ -125,7 +141,7 @@ There are two important rectangles in printing: the <em>page rectangle</em>
 defines the printable area seen by the application, and under MSW and Mac, it
 is the printable area specified by the printer. (For PostScript printing, the
 page rectangle is the entire page.) The inherited function
-wxDC::GetSize returns the page size in device pixels. The
+wxDC::GetSize() returns the page size in device pixels. The
 point (0,0) on the wxPrinterDC represents the top left corner of the page
 rectangle; that is, the page rect is given by wxRect(0, 0, w, h), where (w,h)
 are the values returned by GetSize.
@@ -134,7 +150,7 @@ The <em>paper rectangle</em>, on the other hand, represents the entire paper
 area including the non-printable border. Thus, the coordinates of the top left
 corner of the paper rectangle will have small negative values, while the width
 and height will be somewhat larger than that of the page rectangle. The
-wxPrinterDC-specific function wxPrinterDC::GetPaperRect returns the paper
+wxPrinterDC-specific function wxPrinterDC::GetPaperRect() returns the paper
 rectangle of the given wxPrinterDC.