Hi Mike and Kevin,
The merge that Mike did of the 1.0.3 docbook changes at r678449 cleared
up the problem that I was seeing. A local docbook build shows the
repository downgrading. The pdf generates just fine, with just a few
errors concerning overflowing lines on a couple of pages and something
about a failure to generate an image.
Thanks,
David
Kevin Sutter wrote:
Thank you, David, for moving your changes from 1.1.x to trunk. Much
appreciated.
You are probably right about the docbook stuff. We're probably "lucking
out" due to an older version. If we could determine which version still
works, then we could update our pom accordingly. Until then, I guess we
will have to live with it.
Thanks again,
Kevin
On Fri, Jul 18, 2008 at 11:09 AM, David Ezzio <[EMAIL PROTECTED]> wrote:
Hi Michael and Kevin,
I upgraded to maven 2.0.9. I rebuilt the repository. I'm still seeing
the same problem, but a different error message. I found a way to work
around the problem so that I could see a generated PDF, and based on that, I
cleaned up my changes in the 1.1.x branch and merged them back to the main
line. While using the workaround, I also found a minor problem (use of
font-style instead of font-weight to set bold) in our manual-pdf.xsl, which
I corrected in the 1.1.x branch and also merged back to mainline.
Now the details.
The behavior remains that the manual.fo is built but the resulting small
pdf file is corrupt. Instead of a NullPointerException, I am now seeing a
more informative -- but, at least for me, no more helpful -- error message:
Embedded error: org.apache.fop.apps.FOPException: null:1:29571:
Error(1/29571): No element mapping definition found for (Namespace URI: "
http://xml.apache.org/fop/extensions", Local Name: "destination")
Looking in the generated manual.fo file, I find a reference to the fop
extensions (they are used for the table of contents, I think.) Likewise,
there is a reference in the manual-pdf.xsl to use the fop extension.
There are several notes on mailing lists that can be found by Google under
the search key "fop/extensions 'No element mapping definition found'", and
the the like. Solutions seem to resolve around the fact that fop extensions
have been replaced by features in XSL 1.1, and not upgraded in an upwardly
compatible way from fop 0.25 to fop 0.94 and beyond.
I tried locally a suggestion (found at
http://lists.oasis-open.org/archives/docbook-apps/200708/msg00231.html) to
"Yes, the fop.extensions is the problem. Set that back to zero, and set
fop1.extensions to 1.". It did allow the pdf to generate, but there were
several errors and I believe the details of formatting were not observed
(margins, etc.).
In sum, I think that those who are having no difficulty are likely using a
older version of maven docbook plugin (or the XSL/FO pieces that it uses)
rather than the newer version that I picked up recently.
That what little I know. I am hopeful that others more knowledgeable on
Docbook and Formatting Objects can take it from there. In the meantime, I
am hopeful that the current builds of the pdf that are working will not be
broken, but I cannot be sure.
Cheers,
David
Michael Dick wrote:
Sorry, spoke too quick : the docbook plugin is at 2.0.7. The release
plugin
is at 2.0-beta-7.
-mike
On Wed, Jul 16, 2008 at 6:22 PM, Michael Dick <[EMAIL PROTECTED]>
wrote:
Minor edit, the previous version is 2.0.-beta-7, not 2.0.7
On Wed, Jul 16, 2008 at 6:21 PM, Michael Dick <[EMAIL PROTECTED]>
wrote:
Hi David,
I've seen NPEs when generating the manual too if I run mvn -f
openjpa-project/pom.xml -Pdocbook-profile clean verify. Replacing "clean
verify" with process-sources seemed to resolve the problem.
This isn't an ideal solution, but I wasn't able to gather any additional
information. Mvn -e ... was less than enlightening. I did try rolling
back
to the previous version of the docbook plugin, 2.0.7 and that worked
better
for me (lots of warning / info messages but still better).
I haven't checked the PDF for corruption though. I got a bit sidetracked
on an issue with the distribution zip files.
If 2.0.7 resolves the problem for you we should rollback the version for
the time being.
-mike
On Wed, Jul 16, 2008 at 11:02 AM, David Ezzio <[EMAIL PROTECTED]>
wrote:
Hi Kevin,
Thanks for the instructions on building the User Guide.
I'm seeing problems in my three attempts thus far. During the two
failures, it doesn't build the html, and it gives a
NullPointerException
when generating the PDF. During its one success, it generated the html
but
the pdf was small and "corrupted."
On my last try, I did a successful clean and install. Then followed
your
instructions. Got the failure outcome. See attached console snippet.
I'm
sync'ed to 1.1.x head.
On the first try, it downloaded a bunch of jars and poms for the
repository.
Any insights?
Thanks,
David
----------- console snippet ----------
[INFO]
------------------------------------------------------------------------
[INFO] Reactor Summary:
[INFO]
------------------------------------------------------------------------
[INFO] OpenJPA ............................................... SUCCESS
[3.328s]
[INFO] OpenJPA Utilities ..................................... SUCCESS
[27.782s]
[INFO] OpenJPA Kernel ........................................ SUCCESS
[16.484s]
[INFO] OpenJPA JDBC .......................................... SUCCESS
[10.281s]
[INFO] OpenJPA JPA ........................................... SUCCESS
[4.938s]
[INFO] OpenJPA JPA JDBC ...................................... SUCCESS
[20:15.797s]
[INFO] OpenJPA XML Store ..................................... SUCCESS
[1.109s]
[INFO] OpenJPA Slice ......................................... SUCCESS
[23.016s]
[INFO] OpenJPA Aggregate Jar ................................. SUCCESS
[7.468s]
[INFO] OpenJPA Distribution .................................. SUCCESS
[14.219s]
[INFO] OpenJPA Persistence Examples .......................... SUCCESS
[1.469s]
[INFO] OpenJPA Integration Tests ............................. SUCCESS
[0.172s]
[INFO] OpenJPA Examples Integration Tests .................... SUCCESS
[1.187s]
[INFO] OpenJPA JPA TCK Integration Tests ..................... SUCCESS
[0.422s]
[INFO]
------------------------------------------------------------------------
[INFO]
------------------------------------------------------------------------
[INFO] BUILD SUCCESSFUL
[INFO]
------------------------------------------------------------------------
[INFO] Total time: 22 minutes 8 seconds
[INFO] Finished at: Wed Jul 16 11:46:04 EDT 2008
[INFO] Final Memory: 26M/87M
[INFO]
------------------------------------------------------------------------
C:\code\svn\RW_OpenJPA1-1Branch>mvn -f openjpa-project/pom.xml
process-resources -Pdocbook-profile
[INFO] Scanning for projects...
[INFO]
----------------------------------------------------------------------------
[INFO] Building OpenJPA Distribution
[INFO] task-segment: [process-resources]
[INFO]
----------------------------------------------------------------------------
[INFO] [docbkx:generate-pdf {execution: build-pdf-doc}]
[INFO] Processing manual.xml
[INFO]
------------------------------------------------------------------------
[ERROR] BUILD ERROR
[INFO]
------------------------------------------------------------------------
[INFO] Failed to transform document.
Embedded error: java.lang.NullPointerException
[INFO]
------------------------------------------------------------------------
[INFO] For more information, run Maven with the -e switch
[INFO]
------------------------------------------------------------------------
[INFO] Total time: 35 seconds
[INFO] Finished at: Wed Jul 16 11:46:55 EDT 2008
[INFO] Final Memory: 14M/64M
[INFO]
------------------------------------------------------------------------
C:\code\svn\RW_OpenJPA1-1Branch>mvn -version
Maven version: 2.0.4
C:\code\svn\RW_OpenJPA1-1Branch>java -version
java version "1.5.0_14"
Java(TM) 2 Runtime Environment, Standard Edition (build 1.5.0_14-b03)
Java HotSpot(TM) Client VM (build 1.5.0_14-b03, mixed mode)
C:\code\svn\RW_OpenJPA1-1Branch>
----------- end console snippet --------
Kevin Sutter wrote:
Shoot, I forgot to hit "reply all"... :-)
---------- Forwarded message ----------
From: Kevin Sutter <[EMAIL PROTECTED]>
Date: Wed, Jul 16, 2008 at 9:03 AM
Subject: Re: Merging 1.1.x changes into mainline, was: svn commit:
r676592
-/openjpa/branches/1.1.x/openjpa-project/src/doc/manual/ref_guide_dbsetup.xml
To: David Ezzio <[EMAIL PROTECTED]>
Thanks, David, for the reply. I can understand your need to ensure
that
the
changes are solid. As far as the docbook is concerned, you can build
that
yourself and see if you messed up the tags or not. The instructions
are
in
the pom.xml, but here's what you can do to build it:
<!--
Docbook profile. Docs can be built by running:
MAVEN_OPTS=-Xmx512m
mvn -f openjpa-project/pom.xml process-resources -Pdocbook-profile
-->
As far as merging the 1.1.x branch back into the mainline. That's how
Patrick was first maintaining that branch until it became "real".
Patrick
has since migrated all of the 1.1.x changes back into trunk. I would
expect
all subsequent changes going into 1.1.x (or 1.0.x) would immediately
get
moved to trunk as well. If we don't follow this practice, then it
would
be
very easy for our branches and trunk to get seriously out of whack.
Customers moving from one release to another wouldn't know whether
fixes
from an older release were also resolved in the next release.
Thanks for looking into this and starting to resolve the situation.
Kevin
On Wed, Jul 16, 2008 at 8:44 AM, David Ezzio <[EMAIL PROTECTED]>
wrote:
Hi Kevin,
You can always ask! I have a multipart answer. One: I'm not 100%
sure
if
the changes are solid. I know they are substantial. I have been
waiting
for the snapshots of the 1.1.x line to come back on line so that I
can
see
whether I messed up any of the docbook (I'm assuming that's what
we're
using) tags. Two: I assumed, perhaps naively, that there was a plan
to
merge the 1.1.x line into the mainline, and I was hoping, perhaps
somewhat
optimistically, that I might not be part of that plan.
So, it looks like I need to learn about the plan and my role in it.
Cheers,
David
Kevin Sutter wrote:
David,
Are you noticing these type of messages? A few of the OpenJPA
developers
(myself included) have noticed that your committing some solid
changes
into
the 1.1.x branch, but not back into trunk. We should be trying to
keep
trunk up-to-date with the service branches (1.0.x, 1.1.x, etc) -- if
the
changes apply. And, in most cases, they do apply. Can I ask what
your
plans
are for synching up trunk with 1.1.x?
Thanks!
Kevin
---------- Forwarded message ----------
From: ** <[EMAIL PROTECTED] <mailto:[EMAIL PROTECTED]>>
Date: Mon, Jul 14, 2008 at 9:41 AM
Subject: Re: svn commit: r676592
-/openjpa/branches/1.1.x/openjpa-project/src/doc/manual/ref_guide_dbsetup.xml
To: [email protected] <mailto:[email protected]>
Shouldn't these type of changes also be put into trunk?
Kevin
Sent from my Verizon Wireless BlackBerry