Better error return codes for Fl_PSfile_Device::start_job()

git-svn-id: file:///fltk/svn/fltk/branches/branch-1.3@7323 ea41ed52-d2ee-0310-a9c1-e6b18d33e121

1 files changed, 2 insertions, 2 deletions

diff --git a/FL/Fl_PSfile_Device.H b/FL/Fl_PSfile_Device.H
index b8e571fb9..247cb2a2f 100644
--- a/FL/Fl_PSfile_Device.H
+++ b/FL/Fl_PSfile_Device.H
@@ -265,7 +265,7 @@ class FL_EXPORT Fl_PSfile_Device : public  Fl_Abstract_Printer {
    @param pagecount The total number of pages to be created.
    @param format Desired page format.
    @param layout Desired page layout.
-   @return 0 iff OK
+   @return 0 iff OK, 1 if user cancelled the file dialog, 2 if fopen failed on user-selected output file.
    */
   int start_job(int pagecount, enum Page_Format format = A4, enum Page_Layout layout = PORTRAIT);
   
@@ -276,7 +276,7 @@ class FL_EXPORT Fl_PSfile_Device : public  Fl_Abstract_Printer {
    @param pagecount The total number of pages to be created.
    @param format Desired page format.
    @param layout Desired page layout.
-   @return 0 iff OK
+   @return 0 iff OK, 1 if fopen(fname, "w") call failed.
    */
   int start_job(const char *fname, int pagecount, enum Page_Format format = A4, enum Page_Layout layout = PORTRAIT);