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: ge...@gnu.org-20090723165640-uiv7mde1x5k7t51v
# target_branch: file:///home/gerel/PROJECTS/libgnupdf/trunk/
# testament_sha1: 3a67cbabc4f85f73abbbd91c7feebaa5e091b2ce
# timestamp: 2009-07-23 13:56:43 -0300
# base_revision_id: jema...@gnu.org-20090720183437-iye9toydjdn9vunb
#
# 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 <ge...@gnu.org>
+
+ * 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 <jema...@gnu.org>
* 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.
+...@item PDF_EIMPLLIMIT
+The filter has been asked for features that aren't implemented yet.
+...@item PDF_ENOMEM
+The filter implementation needs more memory to proceed.
+...@item 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.
+...@item PDF_EAGAIN
+Resource temporarily unavailable, try later.
+...@item PDF_EIO
+Input/output error.
@item PDF_EINVOP
Reading was requested in a writing stream.
+...@item PDF_EIMPLLIMIT
+Filter implementation limit.
+...@item PDF_ENOMEM
+Filter needs more memory.
+...@item 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}.
-...@item PDF_EEOF
+...@item PDF_ENOSPC
A disk full condition occurred.
@item PDF_EINVOP
Writting was requested in a read stream.
+...@item PDF_EIMPLLIMIT
+Filter implementation limit.
+...@item PDF_ENOMEM
+Filter needs more memory.
+...@item 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.
+...@item PDF_EAGAIN
+Resource temporarily unavailable, try later.
+...@item PDF_EIO
+Input/output error.
+...@item PDF_EIMPLLIMIT
+Filter implementation limit.
+...@item PDF_ENOMEM
+Filter needs more memory.
+...@item 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.
+...@item PDF_EAGAIN
+Resource temporarily unavailable, try later.
+...@item PDF_EIO
+Input/output error.
+...@item PDF_EIMPLLIMIT
+Filter implementation limit.
+...@item PDF_ENOMEM
+Filter needs more memory.
+...@item 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}.
-...@item PDF_EEOF
+...@item PDF_ENOSPC
A disk full condition occurred.
@item PDF_EINVOP
Writting was requested in a read stream.
+...@item 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.
+...@item PDF_EINVOP
+Invalid operation, requested read on write mode file.
+...@item PDF_EAGAIN
+Resource temporarily unavailable, try later.
+...@item 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.
-...@item PDF_ENOMEM
+...@item PDF_ENOSPC
A disk full condition ocurred.
+...@item PDF_EINVOP
+Invalid operation, requested write on read mode file.
+...@item PDF_EAGAIN
+Resource temporarily unavailable, try later.
+...@item 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.
+...@item PDF_EINVOP
+Invalid operation, requested write on read mode file.
+...@item PDF_ENOSPC
+A disk full condition ocurred.
+...@item 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
