You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@uima.apache.org by Marshall Schor <ms...@schor.com> on 2007/03/05 22:53:24 UTC

change in docbook building

Currently our docbook build tooling has copies of zip files for the 
docbook system xml/xsl, in our SVN, and "unzips" them the first time 
they're used in the user's extracted copy.

Ant has a task which will fetch these from their sources on the 
internet.  I tried this out and it works just fine.  With this change, 
we don't need to have copies of the docbook system in our SVN at all.

I could imagine there might an issue if the downloaded things required 
accepting a license agreement, etc., but these don't.
See http://issues.apache.org/jira/browse/UIMA-167 comments for details 
on the licenses. 

Anyone object to these changes? 

-Marshall

Re: change in docbook building

Posted by Thilo Goetz <tw...@gmx.de>.
Marshall Schor wrote:
> Thilo Goetz wrote:
>> I just meant an internet link that wasn't likely to change, that's all.
> 
> Sorry, I misunderstood.  The internet links are pretty stable, I think.  
> One is to SourceForge which keeps things forever, the
> other is to OASIS standards which I think will be stable.
> 
> The other choice would be to keep a copy at Apache.
> The docbook scripts are being modified (not checked in yet) to migrate 
> to new levels and also to FOP 0.93.  So, over time,
> we'll need to handle multiple levels of things - which was one reason I 
> was trying to not bring over copies of each thing into Apache.
> 
> -Marshall

+1 to modifying the docbook build as you suggested.  If we have a stable 
location where to get the stuff, I think that's a better solution than 
checking the binaries into our own svn.

--Thilo

Re: change in docbook building

Posted by Marshall Schor <ms...@schor.com>.
Thilo Goetz wrote:
> I just meant an internet link that wasn't likely to change, that's all.

Sorry, I misunderstood.  The internet links are pretty stable, I think.  
One is to SourceForge which keeps things forever, the
other is to OASIS standards which I think will be stable.

The other choice would be to keep a copy at Apache. 

The docbook scripts are being modified (not checked in yet) to migrate 
to new levels and also to FOP 0.93.  So, over time,
we'll need to handle multiple levels of things - which was one reason I 
was trying to not bring over copies of each thing into Apache.

-Marshall
>
> --Thilo
>
> Marshall Schor wrote:
>> Thilo Goetz wrote:
>>> Can we make this so that it only goes off to the internet when the 
>>> files don't exist locally?  Do we have a stable location to get them?
>>
>> The script will only go off to the internet the first time you run 
>> this on a new SVN extract.  After that, it unzips the docbook system 
>> into the uima-docbooks project and never does this again (until you 
>> do your next clean extract...)  I don't know of any stable location 
>> to get these, other than the internet.  They are in our SVN, but 
>> they're not really SVN materials.
>>
>> What kind of other stable locations (not the internet) were you 
>> thinking of?
>>
>> -Marshall
>
>


Re: change in docbook building

Posted by Thilo Goetz <tw...@gmx.de>.
I just meant an internet link that wasn't likely to change, that's all.

--Thilo

Marshall Schor wrote:
> Thilo Goetz wrote:
>> Can we make this so that it only goes off to the internet when the 
>> files don't exist locally?  Do we have a stable location to get them?
> 
> The script will only go off to the internet the first time you run this 
> on a new SVN extract.  After that, it unzips the docbook system into the 
> uima-docbooks project and never does this again (until you do your next 
> clean extract...)  I don't know of any stable location to get these, 
> other than the internet.  They are in our SVN, but they're not really 
> SVN materials.
> 
> What kind of other stable locations (not the internet) were you thinking 
> of?
> 
> -Marshall

Re: change in docbook building

Posted by Marshall Schor <ms...@schor.com>.
Thilo Goetz wrote:
> Can we make this so that it only goes off to the internet when the 
> files don't exist locally?  Do we have a stable location to get them?

The script will only go off to the internet the first time you run this 
on a new SVN extract.  After that, it unzips the docbook system into the 
uima-docbooks project and never does this again (until you do your next 
clean extract...)  I don't know of any stable location to get these, 
other than the internet.  They are in our SVN, but they're not really 
SVN materials.

What kind of other stable locations (not the internet) were you thinking of?

-Marshall

Re: change in docbook building

Posted by Thilo Goetz <tw...@gmx.de>.
Can we make this so that it only goes off to the internet when the files 
don't exist locally?  Do we have a stable location to get them?

--Thilo

Marshall Schor wrote:
> Currently our docbook build tooling has copies of zip files for the 
> docbook system xml/xsl, in our SVN, and "unzips" them the first time 
> they're used in the user's extracted copy.
> 
> Ant has a task which will fetch these from their sources on the 
> internet.  I tried this out and it works just fine.  With this change, 
> we don't need to have copies of the docbook system in our SVN at all.
> 
> I could imagine there might an issue if the downloaded things required 
> accepting a license agreement, etc., but these don't.
> See http://issues.apache.org/jira/browse/UIMA-167 comments for details 
> on the licenses.
> Anyone object to these changes?
> -Marshall