Re: [pdf-devel] Missing stream backend error conditions.

[gerel]

Hey all, 

First, I'm sorry for the delay, studies and other projects keep me busy. :-/

Here is a patch for the stm/fsys/filter API documentation update, i.e.
 - pdf_stm_read/write
 - pdf_stm_peek/read_char
 - pdf_stm_flush
 - pdf_fsys_file_read/write
 - pdf_fsys_file_flush

Also, the Arch document includes 3 new filter status codes as we agreed.

##
# Bazaar merge directive format 2 (Bazaar 0.90)
# revision_id: address@hidden
# target_branch: file:///home/gerel/PROJECTS/libgnupdf/trunk/
# testament_sha1: 3a67cbabc4f85f73abbbd91c7feebaa5e091b2ce
# timestamp: 2009-07-23 13:56:43 -0300
# base_revision_id: address@hidden
# 
# Begin patch
=== modified file 'ChangeLog'
--- ChangeLog   2009-07-20 18:34:37 +0000
+++ ChangeLog   2009-07-23 16:34:57 +0000
@@ -1,3 +1,11 @@
+2009-07-23  Gerardo E. Gidoni  <address@hidden>
+
+       * doc/gnupdf-arch.texi: added missing error status codes.
+
+       * doc/gnupdf.texi: likewise.
+
+       * src/base/pdf-error.h: added new status code, PDF_EIO.
+
 2009-07-20  Jose E. Marchesi  <address@hidden>
 
        * configure.ac: Condition fixed in the reporting of the

=== modified file 'doc/gnupdf-arch.texi'
--- doc/gnupdf-arch.texi        2009-06-20 02:25:19 +0000
+++ doc/gnupdf-arch.texi        2009-07-23 16:34:57 +0000
@@ -719,6 +719,12 @@
 ready to fill it when it becomes available, via a new call to the
 'apply' function. It is assumed that the output buffer is full after
 the apply function returns this value.
address@hidden PDF_EIMPLLIMIT
+The filter has been asked for features that aren't implemented yet.
address@hidden PDF_ENOMEM
+The filter implementation needs more memory to proceed.
address@hidden PDF_EBADFILE
+The requested data violates PDF specifications.
 @item PDF_ERROR
 Error in the data processed by the filter. If the filter
 implementation returns this value then the 'apply' function will not be

=== modified file 'doc/gnupdf.texi'
--- doc/gnupdf.texi     2009-07-13 19:06:37 +0000
+++ doc/gnupdf.texi     2009-07-23 16:56:40 +0000
@@ -4463,8 +4463,18 @@
 All the requested bytes were successfully read into @var{buf}.
 @item PDF_EEOF
 An end of file condition occurred.
address@hidden PDF_EAGAIN
+Resource temporarily unavailable, try later.
address@hidden PDF_EIO
+Input/output error.
 @item PDF_EINVOP
 Reading was requested in a writing stream.
address@hidden PDF_EIMPLLIMIT
+Filter implementation limit.
address@hidden PDF_ENOMEM
+Filter needs more memory.
address@hidden PDF_EBADFILE
+Filter requested data violates PDF specifications.
 @item PDF_ERROR
 An error prevented to read the bytes.
 @end table
@@ -4498,10 +4508,16 @@
 @table @code
 @item PDF_OK
 All the requested bytes were successfully written into @var{stm}.
address@hidden PDF_EEOF
address@hidden PDF_ENOSPC
 A disk full condition occurred.
 @item PDF_EINVOP
 Writting was requested in a read stream.
address@hidden PDF_EIMPLLIMIT
+Filter implementation limit.
address@hidden PDF_ENOMEM
+Filter needs more memory.
address@hidden PDF_EIO
+Input/output error.
 @item PDF_ERROR
 An error prevented to write the bytes.
 @end table
@@ -4533,6 +4549,16 @@
 End of file.
 @item PDF_EINVOP
 Reading was requested in a writing stream.
address@hidden PDF_EAGAIN
+Resource temporarily unavailable, try later.
address@hidden PDF_EIO
+Input/output error.
address@hidden PDF_EIMPLLIMIT
+Filter implementation limit.
address@hidden PDF_ENOMEM
+Filter needs more memory.
address@hidden PDF_EBADFILE
+Filter requested data violates PDF specifications.
 @item PDF_ERROR
 An error prevented to read the character.
 @end table
@@ -4564,6 +4590,16 @@
 End of file.
 @item PDF_EINVOP
 Peeking was requested in a writing stream.
address@hidden PDF_EAGAIN
+Resource temporarily unavailable, try later.
address@hidden PDF_EIO
+Input/output error.
address@hidden PDF_EIMPLLIMIT
+Filter implementation limit.
address@hidden PDF_ENOMEM
+Filter needs more memory.
address@hidden PDF_EBADFILE
+Filter requested data violates PDF specifications.
 @item PDF_ERROR
 An error prevented to peek the character.
 @end table
@@ -4597,10 +4633,12 @@
 @table @code
 @item PDF_OK
 All the requested bytes were successfully written into @var{stm}.
address@hidden PDF_EEOF
address@hidden PDF_ENOSPC
 A disk full condition occurred.
 @item PDF_EINVOP
 Writting was requested in a read stream.
address@hidden PDF_EIO
+Input/output error.
 @item PDF_ERROR
 An error prevented to write the bytes.
 @end table
@@ -9198,6 +9236,12 @@
 The file element or a given pointer is invalid.
 @item PDF_EEOF
 An end of file condition occurred.
address@hidden PDF_EINVOP
+Invalid operation, requested read on write mode file.
address@hidden PDF_EAGAIN
+Resource temporarily unavailable, try later.
address@hidden PDF_EIO
+Input/output error.
 @item PDF_ERROR
 An error prevented to read the bytes.
 @end table
@@ -9232,8 +9276,14 @@
 All the requested bytes were successfully written to @var{file}.
 @item PDF_EBADDATA
 The file element or a given pointer is invalid.
address@hidden PDF_ENOMEM
address@hidden PDF_ENOSPC
 A disk full condition ocurred.
address@hidden PDF_EINVOP
+Invalid operation, requested write on read mode file.
address@hidden PDF_EAGAIN
+Resource temporarily unavailable, try later.
address@hidden PDF_EIO
+Input/output error.
 @item PDF_ERROR
 An error prevented to write the bytes.
 @end table
@@ -9264,6 +9314,12 @@
 Bad function parameters to underlying @code{write()}.
 @item PDF_EAGAIN
 Try again.
address@hidden PDF_EINVOP
+Invalid operation, requested write on read mode file.
address@hidden PDF_ENOSPC
+A disk full condition ocurred.
address@hidden PDF_EIO
+Input/output error.
 @item PDF_ERROR
 There was an error flushing the open file.
 @end table

=== modified file 'src/base/pdf-error.h'
--- src/base/pdf-error.h        2009-05-19 18:19:15 +0000
+++ src/base/pdf-error.h        2009-07-23 16:34:57 +0000
@@ -1,4 +1,4 @@
-/* -*- mode: C -*- Time-stamp: "2009-05-11 16:05:06 davazp"
+/* -*- mode: C -*- Time-stamp: "2009-07-23 12:43:28 gerel"
  *
  *       File:         pdf-error.h
  *       Date:         Sun Feb  24 20:22:05 2008
@@ -113,6 +113,7 @@
   ERROR_ENTRY (PDF_EDIVBYZERO,  "divison by zero"),                     \
   ERROR_ENTRY (PDF_ENONODE,     "no node found"),                       \
   ERROR_ENTRY (PDF_EINVRANGE,   "invalid range"),                       \
+  ERROR_ENTRY (PDF_EIO,         "input/output error"),                  \
   ERROR_ENTRY (PDF_ETEXTENC,    "error in text encoding"),              \
   ERROR_ENTRY (PDF_ENOMATCH,    "no matching found"),                   \
   ERROR_ENTRY (PDF_EBADTEXT,    "invalid text format"),                 \

# Begin bundle
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
i7kinChIQUax+AA=

###

-gerel