Thilo Goetz wrote:
Marshall, how hard is it to obtain and install the DocBook build env?
We're currently completely free of third-party licenses, and while it
seems possible to include the DocBook stuff, it'll be some work to get
everything straightened out. Is it worth the effort? We tell people
to install Maven and a Java SDK as well. Can't we just put up some
instructions on how to set up the DocBook build env and remove it from
svn and our distribution?
Good point. It's very easy to obtain the DocBook build environment -
just go to our SVN repository and extract the uima-docbooks project.
I think I agree we don't need to "distribute" this at all; just leave it
in SVN.
If we do that, it's not clear to me if we even need to distribute the
docbook sources. I suggest we not put the sources into our
"distribution" packages, but just put the results of the html and pdf
builds there. And maybe add something to a "README" that describes all
this, and says if you want to modify the sources, get the uima-docbooks
project from our SVN.
-Marshall
--Thilo
Marshall Schor wrote:
Adam Lally wrote:
I added the Maven assembly descriptor for the source distribution.
There is one issue. I didn't include uima-docbooks, so with the
resulting source distribution you can build the jars/plugins but you
can't build the actual binary distribution (if you run mvn
assembly:assembly you get a file not found error).
Should we include the docbooks sources in the source distribution?
Yes, I think.
Even if we do that, there's still the matter of the 3rd-party JARs
needed to run docbook - I'm not sure if we're allowed to bundle them
in our distribution even if we wanted to.
Don't include the things we're not allowed to redistribute. Those
should not even be in SVN, I think.
-Adam
