You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@commons.apache.org by "Mark R. Diggory" <md...@latte.harvard.edu> on 2004/02/08 18:14:51 UTC

[vote] Separate Directory for Commons Project files

I don't want to make this change and step on anyones foot while doing it 
so I'll put it to a vote. To recap:

The issue involves consolidating the global commons build and site 
generation files into their own directory within the jakarta-commons 
project dir.

Here is a list of the current files:

/jakarta-commons/xdocs/ 	  	  	  	
/jakarta-commons/.cvsignore
/jakarta-commons/BUILD_DOCS.txt
/jakarta-commons/LICENSE
/jakarta-commons/LICENSE.txt
/jakarta-commons/build.properties.sample
/jakarta-commons/build.xml
/jakarta-commons/charter.html
/jakarta-commons/incl_nav.xml
/jakarta-commons/maven.xml
/jakarta-commons/navigation.vm
/jakarta-commons/project.xml

1.) I'm suggesting the following changes initially for Maven related stuff:

/jakarta-commons/commons-site/xdocs
/jakarta-commons/commons-site/project.xml
/jakarta-commons/commons-site/navigation.vm
/jakarta-commons/commons-site/maven.xml
/jakarta-commons/commons-site/incl_nav.xml
/jakarta-commons/commons-site/LICENSE.txt

---

This change would require the project.xml's for each project in both the 
jakarta-commons and jakarta-commons-sandbox to have its extends tag 
adjusted and any relative references to "commons-site" files adjusted.

This change will be done within the cvs directory of the server to 
maintain historical info on the changes to these files.

-Mark

-- 
Mark Diggory
Software Developer
Harvard MIT Data Center
http://www.hmdc.harvard.edu

---------------------------------------------------------------------
To unsubscribe, e-mail: commons-dev-unsubscribe@jakarta.apache.org
For additional commands, e-mail: commons-dev-help@jakarta.apache.org


Re: [all] commons-build directory now created (was Re: [vote] Separate Directory for Commons Project files)

Posted by "Mark R. Diggory" <md...@latte.harvard.edu>.

Mark R. Diggory wrote:

> 1.) Change all the project.xml files in all the projects to point to
> 
>   <extend>../commons-build/project.xml</extend>
> 

This task is now complete on all project.xml files that originally had 
this extension present. Note: there are existing project.xml files that 
do not actually extend the global project.xml currently present in 
subprojects.

> 2.) reconfigure any maven.xml and project.properties to be run from this 
> new location.
> 

I'm having some difficulty with this in 
/jakarta-commons/commons-build/maven.xml

specifically, I can seem to change the relative location of the 
*/project.xml files from the base to "../*/project.xml". Any tips here 
would be great.

For example:

   <goal name="build">

     <reactor:execute
       basedir="${basedir}"
       includes="../*/project.xml"
       excludes="../commons-build/project.xml"
       goals="clean,jar:install"
       banner="Building"
       ignoreFailures="true"
     />

   </goal>

just seems to fail silently when I run maven build. Maybe I'm missing 
something simple. Here's the resulting output

mdiggory@minotaur:/home/mdiggory/jakarta-commons/commons-build> maven -X 
build
  __  __
|  \/  |__ _Apache__ ___
| |\/| / _` \ V / -_) ' \  ~ intelligent projects ~
|_|  |_\__,_|\_/\___|_||_|  v. 1.0-rc1-SNAPSHOT

[DEBUG] Adding reference: maven.dependency.classpath ->
     [available] [VERBOSE] Unable to find src/java to set property 
sourcesPresent
     [available] [VERBOSE] Unable to find src/test to set property 
unitTestSourcesPresent
[DEBUG] Adding reference: maven-classpath ->
BUILD SUCCESSFUL
Total time: 7 seconds
Finished at: Tue Feb 10 12:45:06 PST 2004

mdiggory@minotaur:/home/mdiggory/jakarta-commons/commons-build>




> 3.) Remove the original from this location:
> 
>  >>> /jakarta-commons/xdocs
>  >>> /jakarta-commons/project.xml
>  >>> /jakarta-commons/navigation.vm
>  >>> /jakarta-commons/maven.xml
>  >>> /jakarta-commons/incl_nav.xml
>  >>> /jakarta-commons/LICENSE.txt
> 
> 
> So, please, if your working on any of these files, do checkout the 
> /jakarta-commons/commons-build, verify you can edit it, and make any 
> future modifications there instead of in the jakarta-commons directory.
> 
> -Mark
> 
> Mark R. Diggory wrote:
> 
>>
>>
>> Martin Cooper wrote:
>>
>>> On Sun, 8 Feb 2004, Mark R. Diggory wrote:
>>>
>>>
>>>> I don't want to make this change and step on anyones foot while 
>>>> doing it
>>>> so I'll put it to a vote. To recap:
>>>>
>>>> The issue involves consolidating the global commons build and site
>>>> generation files into their own directory within the jakarta-commons
>>>> project dir.
>>>>
>>>> Here is a list of the current files:
>>>>
>>>> /jakarta-commons/xdocs/
>>>> /jakarta-commons/.cvsignore
>>>> /jakarta-commons/BUILD_DOCS.txt
>>>> /jakarta-commons/LICENSE
>>>> /jakarta-commons/LICENSE.txt
>>>> /jakarta-commons/build.properties.sample
>>>> /jakarta-commons/build.xml
>>>> /jakarta-commons/charter.html
>>>> /jakarta-commons/incl_nav.xml
>>>> /jakarta-commons/maven.xml
>>>> /jakarta-commons/navigation.vm
>>>> /jakarta-commons/project.xml
>>>
>>>
>>>
>>>
>>> One significant omission from this list is /jakarta-commons/combo/. Any
>>> discussion of centralising global build and site creation needs to take
>>> this into account as well.
>>>
>>
>> I was avoiding anything not to do with the new Maven Build stuff, 
>> primarily because I have no idea how many are truly dependent on it 
>> (i.e. Craig M. or Gump etc).
>>
>> I'd also note that the multiproject plugin and proper tagging of the 
>> cvs tree may actually supersede the combo project in functionality in 
>> terms of generating a full versioned release distribution of commons 
>> components.
>>
>>
>>
>>>
>>>> 1.) I'm suggesting the following changes initially for Maven related 
>>>> stuff:
>>>>
>>>> /jakarta-commons/commons-site/xdocs
>>>> /jakarta-commons/commons-site/project.xml
>>>> /jakarta-commons/commons-site/navigation.vm
>>>> /jakarta-commons/commons-site/maven.xml
>>>> /jakarta-commons/commons-site/incl_nav.xml
>>>> /jakarta-commons/commons-site/LICENSE.txt
>>>
>>>
>>>
>>>
>>> I don't like commons-site (or site either) because it's more than 
>>> just the
>>> web site. I'd be more tempted to call it something like shared-build.
>>>
>>
>> how about just "build" or "commons-build"?
>>
>>
>>> Note that any changes here need to preserve the ability to build
>>> components using 'ant clean dist', regardless of whether the 
>>> component has
>>> been Mavenised, so that they don't break the nightly build process.
>>>
>>  > --
>>  > Martin Cooper
>>
>> Again, this is a separate process from the Maven related build stuff. 
>> I wasn't planning a move of the old ant build stuff.
>>
> 

-- 
Mark Diggory
Software Developer
Harvard MIT Data Center
http://www.hmdc.harvard.edu

---------------------------------------------------------------------
To unsubscribe, e-mail: commons-dev-unsubscribe@jakarta.apache.org
For additional commands, e-mail: commons-dev-help@jakarta.apache.org


[all] commons-build directory now created (was Re: [vote] Separate Directory for Commons Project files)

Posted by "Mark R. Diggory" <md...@latte.harvard.edu>.
Ok, I copied the following contents to /jakarta-commons/commons-build

 >>> /jakarta-commons/xdocs
 >>> /jakarta-commons/project.xml
 >>> /jakarta-commons/navigation.vm
 >>> /jakarta-commons/maven.xml
 >>> /jakarta-commons/incl_nav.xml
 >>> /jakarta-commons/LICENSE.txt

The following contents will remain in the jakarta-commons directory 
unless others suggest a better solution for them.

 >>> /jakarta-commons/.cvsignore
 >>> /jakarta-commons/BUILD_DOCS.txt
 >>> /jakarta-commons/LICENSE
 >>> /jakarta-commons/build.properties.sample
 >>> /jakarta-commons/build.xml
 >>> /jakarta-commons/charter.html

Now that I've done this, there are these steps left:

1.) Change all the project.xml files in all the projects to point to

   <extend>../commons-build/project.xml</extend>

2.) reconfigure any maven.xml and project.properties to be run from this 
new location.

3.) Remove the original from this location:

 >>> /jakarta-commons/xdocs
 >>> /jakarta-commons/project.xml
 >>> /jakarta-commons/navigation.vm
 >>> /jakarta-commons/maven.xml
 >>> /jakarta-commons/incl_nav.xml
 >>> /jakarta-commons/LICENSE.txt


So, please, if your working on any of these files, do checkout the 
/jakarta-commons/commons-build, verify you can edit it, and make any 
future modifications there instead of in the jakarta-commons directory.

-Mark

Mark R. Diggory wrote:

> 
> 
> Martin Cooper wrote:
> 
>> On Sun, 8 Feb 2004, Mark R. Diggory wrote:
>>
>>
>>> I don't want to make this change and step on anyones foot while doing it
>>> so I'll put it to a vote. To recap:
>>>
>>> The issue involves consolidating the global commons build and site
>>> generation files into their own directory within the jakarta-commons
>>> project dir.
>>>
>>> Here is a list of the current files:
>>>
>>> /jakarta-commons/xdocs/
>>> /jakarta-commons/.cvsignore
>>> /jakarta-commons/BUILD_DOCS.txt
>>> /jakarta-commons/LICENSE
>>> /jakarta-commons/LICENSE.txt
>>> /jakarta-commons/build.properties.sample
>>> /jakarta-commons/build.xml
>>> /jakarta-commons/charter.html
>>> /jakarta-commons/incl_nav.xml
>>> /jakarta-commons/maven.xml
>>> /jakarta-commons/navigation.vm
>>> /jakarta-commons/project.xml
>>
>>
>>
>> One significant omission from this list is /jakarta-commons/combo/. Any
>> discussion of centralising global build and site creation needs to take
>> this into account as well.
>>
> 
> I was avoiding anything not to do with the new Maven Build stuff, 
> primarily because I have no idea how many are truly dependent on it 
> (i.e. Craig M. or Gump etc).
> 
> I'd also note that the multiproject plugin and proper tagging of the cvs 
> tree may actually supersede the combo project in functionality in terms 
> of generating a full versioned release distribution of commons components.
> 
> 
> 
>>
>>> 1.) I'm suggesting the following changes initially for Maven related 
>>> stuff:
>>>
>>> /jakarta-commons/commons-site/xdocs
>>> /jakarta-commons/commons-site/project.xml
>>> /jakarta-commons/commons-site/navigation.vm
>>> /jakarta-commons/commons-site/maven.xml
>>> /jakarta-commons/commons-site/incl_nav.xml
>>> /jakarta-commons/commons-site/LICENSE.txt
>>
>>
>>
>> I don't like commons-site (or site either) because it's more than just 
>> the
>> web site. I'd be more tempted to call it something like shared-build.
>>
> 
> how about just "build" or "commons-build"?
> 
> 
>> Note that any changes here need to preserve the ability to build
>> components using 'ant clean dist', regardless of whether the component 
>> has
>> been Mavenised, so that they don't break the nightly build process.
>>
>  > --
>  > Martin Cooper
> 
> Again, this is a separate process from the Maven related build stuff. I 
> wasn't planning a move of the old ant build stuff.
> 

-- 
Mark Diggory
Software Developer
Harvard MIT Data Center
http://www.hmdc.harvard.edu

---------------------------------------------------------------------
To unsubscribe, e-mail: commons-dev-unsubscribe@jakarta.apache.org
For additional commands, e-mail: commons-dev-help@jakarta.apache.org


Re: [vote] Separate Directory for Commons Project files

Posted by "Mark R. Diggory" <md...@latte.harvard.edu>.

Martin Cooper wrote:

> On Sun, 8 Feb 2004, Mark R. Diggory wrote:
> 
> 
>>I don't want to make this change and step on anyones foot while doing it
>>so I'll put it to a vote. To recap:
>>
>>The issue involves consolidating the global commons build and site
>>generation files into their own directory within the jakarta-commons
>>project dir.
>>
>>Here is a list of the current files:
>>
>>/jakarta-commons/xdocs/
>>/jakarta-commons/.cvsignore
>>/jakarta-commons/BUILD_DOCS.txt
>>/jakarta-commons/LICENSE
>>/jakarta-commons/LICENSE.txt
>>/jakarta-commons/build.properties.sample
>>/jakarta-commons/build.xml
>>/jakarta-commons/charter.html
>>/jakarta-commons/incl_nav.xml
>>/jakarta-commons/maven.xml
>>/jakarta-commons/navigation.vm
>>/jakarta-commons/project.xml
> 
> 
> One significant omission from this list is /jakarta-commons/combo/. Any
> discussion of centralising global build and site creation needs to take
> this into account as well.
> 

I was avoiding anything not to do with the new Maven Build stuff, 
primarily because I have no idea how many are truly dependent on it 
(i.e. Craig M. or Gump etc).

I'd also note that the multiproject plugin and proper tagging of the cvs 
tree may actually supersede the combo project in functionality in terms 
of generating a full versioned release distribution of commons components.



> 
>>1.) I'm suggesting the following changes initially for Maven related stuff:
>>
>>/jakarta-commons/commons-site/xdocs
>>/jakarta-commons/commons-site/project.xml
>>/jakarta-commons/commons-site/navigation.vm
>>/jakarta-commons/commons-site/maven.xml
>>/jakarta-commons/commons-site/incl_nav.xml
>>/jakarta-commons/commons-site/LICENSE.txt
> 
> 
> I don't like commons-site (or site either) because it's more than just the
> web site. I'd be more tempted to call it something like shared-build.
> 

how about just "build" or "commons-build"?


> Note that any changes here need to preserve the ability to build
> components using 'ant clean dist', regardless of whether the component has
> been Mavenised, so that they don't break the nightly build process.
> 
 > --
 > Martin Cooper

Again, this is a separate process from the Maven related build stuff. I 
wasn't planning a move of the old ant build stuff.

-- 
Mark Diggory
Software Developer
Harvard MIT Data Center
http://www.hmdc.harvard.edu

---------------------------------------------------------------------
To unsubscribe, e-mail: commons-dev-unsubscribe@jakarta.apache.org
For additional commands, e-mail: commons-dev-help@jakarta.apache.org


Re: [vote] Separate Directory for Commons Project files

Posted by Martin Cooper <ma...@apache.org>.
On Sun, 8 Feb 2004, Mark R. Diggory wrote:

> I don't want to make this change and step on anyones foot while doing it
> so I'll put it to a vote. To recap:
>
> The issue involves consolidating the global commons build and site
> generation files into their own directory within the jakarta-commons
> project dir.
>
> Here is a list of the current files:
>
> /jakarta-commons/xdocs/
> /jakarta-commons/.cvsignore
> /jakarta-commons/BUILD_DOCS.txt
> /jakarta-commons/LICENSE
> /jakarta-commons/LICENSE.txt
> /jakarta-commons/build.properties.sample
> /jakarta-commons/build.xml
> /jakarta-commons/charter.html
> /jakarta-commons/incl_nav.xml
> /jakarta-commons/maven.xml
> /jakarta-commons/navigation.vm
> /jakarta-commons/project.xml

One significant omission from this list is /jakarta-commons/combo/. Any
discussion of centralising global build and site creation needs to take
this into account as well.

>
> 1.) I'm suggesting the following changes initially for Maven related stuff:
>
> /jakarta-commons/commons-site/xdocs
> /jakarta-commons/commons-site/project.xml
> /jakarta-commons/commons-site/navigation.vm
> /jakarta-commons/commons-site/maven.xml
> /jakarta-commons/commons-site/incl_nav.xml
> /jakarta-commons/commons-site/LICENSE.txt

I don't like commons-site (or site either) because it's more than just the
web site. I'd be more tempted to call it something like shared-build.

Note that any changes here need to preserve the ability to build
components using 'ant clean dist', regardless of whether the component has
been Mavenised, so that they don't break the nightly build process.

--
Martin Cooper


>
> ---
>
> This change would require the project.xml's for each project in both the
> jakarta-commons and jakarta-commons-sandbox to have its extends tag
> adjusted and any relative references to "commons-site" files adjusted.
>
> This change will be done within the cvs directory of the server to
> maintain historical info on the changes to these files.
>
> -Mark
>
>

---------------------------------------------------------------------
To unsubscribe, e-mail: commons-dev-unsubscribe@jakarta.apache.org
For additional commands, e-mail: commons-dev-help@jakarta.apache.org


Re: [vote] Separate Directory for Commons Project files

Posted by Jörg Schaible <jo...@gmx.de>.
> This change would require the project.xml's for each project in both the
> jakarta-commons and jakarta-commons-sandbox to have its extends tag
> adjusted and any relative references to "commons-site" files adjusted.

Well, I am not supposed to give a vote, but I want to remark that such a
structure will also allow you to define external global entities in your
(Maven) xml files, that can be inherited from the global commons-site
project and you might write later on something like:

<!ENTITY  dep-commons-logger-SNAPSHOT  SYSTEM
"file:../commons-site/entities/dep-commons-logger-SNAPSHOT.entity">
<!ENTITY  dep-commons-jelly-SNAPSHOT  SYSTEM
"file:../commons-site/entities/dep-commons-jelly-SNAPSHOT.entity">

<dependencies>
        &dep-commons-logger-SNAPSHOT;
        &dep-commons-jelly-SNAPSHOT;
</dependencies>

You might do this also for developers or anything else, e.g. in our local
project we split the site.jsl in this way:
http://www.mail-archive.com/dev@maven.apache.org/msg09093.html

So you might gain a lot more with the new structure as originally thought :)

Regards,
Jörg



---------------------------------------------------------------------
To unsubscribe, e-mail: commons-dev-unsubscribe@jakarta.apache.org
For additional commands, e-mail: commons-dev-help@jakarta.apache.org


Re: [vote] Separate Directory for Commons Project files

Posted by Henri Yandell <ba...@generationjava.com>.
site's cool.

What about the projects not on maven yet. Do they need the
build.xml, build.properties.sample system still?

Also, the old xdocs->docs build system. Are we ready to replace that with
a maven multiproject?

Hen

On Sun, 8 Feb 2004, Mark R. Diggory wrote:

> "site" is fine too. If anyone is opposed to "site" speakup know, I'm not
> really interested in seeing this "lag" on-and-on over the name of the
> directory. ;-)
>
> -Mark
>
> Noel J. Bergman wrote:
>
> >>/jakarta-commons/commons-site/
> >
> >
> > Any reason for the seemingly redundant "commons", as opposed to:
> >
> >   /jakarta-commons/site/
> >
> > ?  Not a sticking point.  Just a question.
> >
> > 	--- Noel
> >
> > ---------------------------------------------------------------------
> > To unsubscribe, e-mail: commons-dev-unsubscribe@jakarta.apache.org
> > For additional commands, e-mail: commons-dev-help@jakarta.apache.org
> >
>
> --
> Mark Diggory
> Software Developer
> Harvard MIT Data Center
> http://www.hmdc.harvard.edu
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: commons-dev-unsubscribe@jakarta.apache.org
> For additional commands, e-mail: commons-dev-help@jakarta.apache.org
>


---------------------------------------------------------------------
To unsubscribe, e-mail: commons-dev-unsubscribe@jakarta.apache.org
For additional commands, e-mail: commons-dev-help@jakarta.apache.org


RE: [vote] Separate Directory for Commons Project files

Posted by "Noel J. Bergman" <no...@devtech.com>.
> I'm not really interested in seeing this "lag" on-and-on
> over the name of the directory. ;-)

Me neither, hence the "Not a sticking point" comment.  Whatever everyone can
agree on is fine with me.  :-)

	--- Noel


---------------------------------------------------------------------
To unsubscribe, e-mail: commons-dev-unsubscribe@jakarta.apache.org
For additional commands, e-mail: commons-dev-help@jakarta.apache.org


Re: [vote] Separate Directory for Commons Project files

Posted by "Mark R. Diggory" <md...@latte.harvard.edu>.
"site" is fine too. If anyone is opposed to "site" speakup know, I'm not 
really interested in seeing this "lag" on-and-on over the name of the 
directory. ;-)

-Mark

Noel J. Bergman wrote:

>>/jakarta-commons/commons-site/
> 
> 
> Any reason for the seemingly redundant "commons", as opposed to:
> 
>   /jakarta-commons/site/
> 
> ?  Not a sticking point.  Just a question.
> 
> 	--- Noel
> 
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: commons-dev-unsubscribe@jakarta.apache.org
> For additional commands, e-mail: commons-dev-help@jakarta.apache.org
> 

-- 
Mark Diggory
Software Developer
Harvard MIT Data Center
http://www.hmdc.harvard.edu

---------------------------------------------------------------------
To unsubscribe, e-mail: commons-dev-unsubscribe@jakarta.apache.org
For additional commands, e-mail: commons-dev-help@jakarta.apache.org


RE: [vote] Separate Directory for Commons Project files

Posted by "Noel J. Bergman" <no...@devtech.com>.
> /jakarta-commons/commons-site/

Any reason for the seemingly redundant "commons", as opposed to:

  /jakarta-commons/site/

?  Not a sticking point.  Just a question.

	--- Noel

---------------------------------------------------------------------
To unsubscribe, e-mail: commons-dev-unsubscribe@jakarta.apache.org
For additional commands, e-mail: commons-dev-help@jakarta.apache.org