Re: pdfbox develpment

2010-03-09 Thread Maruan Sahyoun
Hi ,

I started with the documentation of some tools and opened an issue in JIRA for 
that (PDFBOX-653). Please let me know if that workflow is OK for you or if I 
should use a different approach. 

Kind regards
 
Maruan Sahyoun

Am 09.03.2010 um 09:37 schrieb Andreas Lehmkühler:

 Hi,
 
 Betreff: Re: pdfbox develpment
 Gesendet: Di, 09. Mrz 2010
 Von: Maruan Sahyounsahy...@fileaffairs.de
 
 Hi,
 
 we were looking to start fixing some of the open issues but can instead
 develop some small tutorials for common tasks like text extraction, forms
 handling and highlighting.
 
 WDYT
 Sounds good to me. Some of the command line utilities are already described 
 at [1] and
 some other documentation can be found at [2], so that will be a good point to 
 start.
 IMHO, the following command line tools should be described anyway:
 
 - PDFSplit, PDFMerger, Overlay
 - PDFReader
 - PDFDebugger
 
 These can be found here [3]. Probably we should describe some/all of the 
 examples
 which can be found here [4]. The sources for the documentation itself can be 
 found here [5]
 
 BR
 Andreas Lehmkühler
 
 [1] http://pdfbox.apache.org/commandlineutilities/index.html
 [2] http://pdfbox.apache.org/userguide/index.html
 [3] http://svn.apache.org/viewvc/pdfbox/trunk/src/main/java/org/apache/pdfbox/
 [4] 
 http://svn.apache.org/viewvc/pdfbox/trunk/src/main/java/org/apache/pdfbox/examples/
 [5] http://svn.apache.org/viewvc/pdfbox/trunk/src/site/
 
 Kind regards
 
 Maruan Sahyoun
 
 Am 09.03.2010 um 07:58 schrieb Andreas Lehmkuehler:
 
 Hi,
 
 Michael Müller schrieb:
 Daniel,
 Yes, I found some activities on the lists. But on the project site
 neither developer nor commiter. Just missing documentation? ;-)
 Great to hear, this project is alive.
 I have big problems to use it, due to missing or vague docs.
 EG: setTextMatrix
 public void setTextMatrix(double a, double b, double c, double d, double
 e, double f)
 What's a, b, c, d, e, f? I figured out, e and f to be coordinates. Would
 be much better to name this x and y or to enhance this documentation.
 These values correspond to the naming used in the pdf reference for a
 matrix.
 
 Maybe enhancing documentaion is an entry point for me to support the
 project? Or does any doc exists beside the published java docs?
 Be our guest, a good and complete documentation is always useful,
 especially
 for beginners.
 
 BR
 Andreas Lehmkühler
 
 
 
 --- original Nachricht Ende 
 



Re: pdfbox develpment

2010-03-09 Thread Andreas Lehmkuehler

Hi,


Maruan Sahyoun schrieb:

Hi ,

I started with the documentation of some tools and opened an issue in JIRA for that (PDFBOX-653). Please let me know if that workflow is OK for you or if I should use a different approach. 

The workflow ist quite perfect.

BR
Andreas Lehmkühler




Re: pdfbox develpment

2010-03-08 Thread Michael Müller
Daniel,

Yes, I found some activities on the lists. But on the project site
neither developer nor commiter. Just missing documentation? ;-)

Great to hear, this project is alive.

I have big problems to use it, due to missing or vague docs.

EG: setTextMatrix
public void setTextMatrix(double a, double b, double c, double d, double
e, double f)
What's a, b, c, d, e, f? I figured out, e and f to be coordinates. Would
be much better to name this x and y or to enhance this documentation.
Maybe enhancing documentaion is an entry point for me to support the
project? Or does any doc exists beside the published java docs?

Best,
Michael



Am 08.03.2010 22:30, schrieb Daniel Wilson:
 No, not dead at all!  If you'll have a look at
 http://issues.apache.org/jira/browse/PDFBOX you'll see that we are updating
 and resolving issues actively.
 
 Most of the committers have started by adding patches.
 
 So if you can solve some problems, enhance capabilities, etc., that's great!
 
 Daniel
 
 On Mon, Mar 8, 2010 at 4:13 PM, Michael Müller 
 michael.muel...@mueller-bruehl.de wrote:
 
 Hi,

 I just started using pdfbox and like to help to develop.
 But in project team list neither members nor contributers are listed.
 Has development stoped? Is pdfbox dead? :(

 Michael

 


Re: pdfbox develpment

2010-03-08 Thread Daniel Wilson
There is the user guide:
http://pdfbox.apache.org/userguide/faq.html

Then there's the Javadoc stuff ... and there's the PDF reference that Adobe
provides:
http://www.adobe.com/devnet/pdf/

In many cases, function and parameter names have some reference to the PDF
reference.  I don't know about setTextMatrix.

I'm sure some more documentation would be appreciated.

Daniel

On Mon, Mar 8, 2010 at 4:51 PM, Michael Müller 
michael.muel...@mueller-bruehl.de wrote:

 Daniel,

 Yes, I found some activities on the lists. But on the project site
 neither developer nor commiter. Just missing documentation? ;-)

 Great to hear, this project is alive.

 I have big problems to use it, due to missing or vague docs.

 EG: setTextMatrix
 public void setTextMatrix(double a, double b, double c, double d, double
 e, double f)
 What's a, b, c, d, e, f? I figured out, e and f to be coordinates. Would
 be much better to name this x and y or to enhance this documentation.
 Maybe enhancing documentaion is an entry point for me to support the
 project? Or does any doc exists beside the published java docs?

 Best,
 Michael



 Am 08.03.2010 22:30, schrieb Daniel Wilson:
  No, not dead at all!  If you'll have a look at
  http://issues.apache.org/jira/browse/PDFBOX you'll see that we are
 updating
  and resolving issues actively.
 
  Most of the committers have started by adding patches.
 
  So if you can solve some problems, enhance capabilities, etc., that's
 great!
 
  Daniel
 
  On Mon, Mar 8, 2010 at 4:13 PM, Michael Müller 
  michael.muel...@mueller-bruehl.de wrote:
 
  Hi,
 
  I just started using pdfbox and like to help to develop.
  But in project team list neither members nor contributers are listed.
  Has development stoped? Is pdfbox dead? :(
 
  Michael
 
 



Re: pdfbox develpment

2010-03-08 Thread Michael Müller
Hmm, I know this. Don't call a hint just to open a pdf a full
documentation! True, it's hard to document. Me too, I prefer coding than
to writing docs...

Michael

Am 08.03.2010 23:07, schrieb Daniel Wilson:
 There is the user guide:
 http://pdfbox.apache.org/userguide/faq.html
 
 Then there's the Javadoc stuff ... and there's the PDF reference that Adobe
 provides:
 http://www.adobe.com/devnet/pdf/
 
 In many cases, function and parameter names have some reference to the PDF
 reference.  I don't know about setTextMatrix.
 
 I'm sure some more documentation would be appreciated.
 
 Daniel
 
 On Mon, Mar 8, 2010 at 4:51 PM, Michael Müller 
 michael.muel...@mueller-bruehl.de wrote:
 
 Daniel,

 Yes, I found some activities on the lists. But on the project site
 neither developer nor commiter. Just missing documentation? ;-)

 Great to hear, this project is alive.

 I have big problems to use it, due to missing or vague docs.

 EG: setTextMatrix
 public void setTextMatrix(double a, double b, double c, double d, double
 e, double f)
 What's a, b, c, d, e, f? I figured out, e and f to be coordinates. Would
 be much better to name this x and y or to enhance this documentation.
 Maybe enhancing documentaion is an entry point for me to support the
 project? Or does any doc exists beside the published java docs?

 Best,
 Michael



 Am 08.03.2010 22:30, schrieb Daniel Wilson:
 No, not dead at all!  If you'll have a look at
 http://issues.apache.org/jira/browse/PDFBOX you'll see that we are
 updating
 and resolving issues actively.

 Most of the committers have started by adding patches.

 So if you can solve some problems, enhance capabilities, etc., that's
 great!

 Daniel

 On Mon, Mar 8, 2010 at 4:13 PM, Michael Müller 
 michael.muel...@mueller-bruehl.de wrote:

 Hi,

 I just started using pdfbox and like to help to develop.
 But in project team list neither members nor contributers are listed.
 Has development stoped? Is pdfbox dead? :(

 Michael



 


Re: pdfbox develpment

2010-03-08 Thread Ted Dunning
OK.  I filed a JIRA.  I would have put myself into the page, but I don't
know how and, more importantly, I am not a committer nor even really a
contributor just yet.

Real committers should speak up!

https://issues.apache.org/jira/browse/PDFBOX-651


On Mon, Mar 8, 2010 at 9:58 PM, Michael Müller 
michael.muel...@mueller-bruehl.de wrote:

 http://pdfbox.apache.org/team-list.html

 Am 09.03.2010 05:44, schrieb Ted Dunning:
  Which project site were you looking at?
 
  On Mon, Mar 8, 2010 at 1:51 PM, Michael Müller 
  michael.muel...@mueller-bruehl.de wrote:
 
  But on the project site
  neither developer nor commiter. Just missing documentation? ;-)
 
 



Re: pdfbox develpment

2010-03-08 Thread Andreas Lehmkuehler

Hi,

Michael Müller schrieb:

Daniel,

Yes, I found some activities on the lists. But on the project site
neither developer nor commiter. Just missing documentation? ;-)

Great to hear, this project is alive.

I have big problems to use it, due to missing or vague docs.

EG: setTextMatrix
public void setTextMatrix(double a, double b, double c, double d, double
e, double f)
What's a, b, c, d, e, f? I figured out, e and f to be coordinates. Would
be much better to name this x and y or to enhance this documentation.

These values correspond to the naming used in the pdf reference for a matrix.


Maybe enhancing documentaion is an entry point for me to support the
project? Or does any doc exists beside the published java docs?

Be our guest, a good and complete documentation is always useful, especially
for beginners.

BR
Andreas Lehmkühler