Re: [pdf-devel] Hello

[jemarch]

   > In my opinion we have several alternatives:
   >
   > a) To introduce a new subsection under "Filtered Streams" describing
   >   each filter: what the filter does, what parameters are expected by
   >   the filter, etc.
   >
   > b) To document the parameters required by each filter implementation
   >   in the documentation of 'pdf_stm_install_filter'.
   >
   > I think that the option a) would be better but, what do you think?
   >
   >

   I agree, considering the number of filters involved ..
   and that we need to provide descriptions about each filter
   .. one should write a separate sub-section.

Ok.

   And I assume, I should read the source code for each filter to get the
   information about the parameters required.

You can also take a look to the ISO PDF and PDF 1.7 reference
documents: section 7.4 in ISO PDF. The parameters for the several
filters are described there. But beware that there is not a 1-1
relationship between the PDF filters and our stm filters: in some
cases (such as the crypt filters) we are using different
parameters. The ultimate documentation is the source code.

   Regarding the texinfo file, since this is the first time I would be
   editing texinfo...I'd appreciate any pointers to help me get started.

You can get the texinfo manual from
http://www.gnu.org/software/texinfo/manual/texinfo/ Anyway, texinfo is
a really simple language and also quite intuitive, so looking at the
manual should give you enough information to start making changes.