You are viewing a plain text version of this content. The canonical link for it is here.
Posted to users@maven.apache.org by Peter Nabbefeld <Pe...@gmx.de> on 2004/07/31 23:29:11 UTC

Default value for ${maven.conf.dir}

Hello,

what is the default value for ${maven.conf.dir}? Due to 
http://maven.apache.org/reference/user-guide.html#Behavioural_Properties 
it is ${basedir}/conf, but at 
http://maven.apache.org/reference/user-guide.html#Starting_a_New_Project 
there is a tree structure ${basedir}/src/conf, generated by the GenApp 
plugin, so I'd expect this to be the value of ${maven.conf.dir}. What is 
the correct value?

Kind regards

Peter Nabbefeld


---------------------------------------------------------------------
To unsubscribe, e-mail: users-unsubscribe@maven.apache.org
For additional commands, e-mail: users-help@maven.apache.org


Recommended location of package-list files?

Posted by Charles Daniels <cj...@yahoo.com>.
Hi All,

Just wondering if there is a recommended location to put package-list files.
I tend to use offlineLinks with the javadoc plugin, but have not seen a
recommended location to place the package-list files required when using
offline linking.  At the moment, I do something like the following, but I'm
not necessarily crazy about it:

src/package-lists/j2se/package-list
src/package-lists/j2ee/package-list
src/package-lists/commons-xxx/package-list
...

Any suggestions?

Thanks,
Chuck


---------------------------------------------------------------------
To unsubscribe, e-mail: users-unsubscribe@maven.apache.org
For additional commands, e-mail: users-help@maven.apache.org


RE: Default value for ${maven.conf.dir}

Posted by Charles Daniels <cj...@yahoo.com>.
That WIKI doesn't mention anything about a 'conf' directory.  However,
thanks for the reference.  It is very useful.

> -----Original Message-----
> From: Carlos Sanchez [mailto:apache@carlos.cousas.net]
> Sent: Sunday, August 01, 2004 1:11 PM
> To: 'Maven Users List'
> Subject: RE: Default value for ${maven.conf.dir}
>
>
> Hi,
>
> Take a look to http://wiki.codehaus.org/maven/DirectoryLayout
>
> Regards
>
> Carlos Sanchez
> A Coruña, Spain
>
> Oness Project
> http://oness.sourceforge.net
>
>
> > I suppose what I'm really looking for is a "best practice" or
> > a "standard convention" with respect to the conf dir.  Is
> > there a purpose for having both ${basedir}/conf and
> > ${basedir}/src/conf?  Or should there be only one "conf" dir
> > for a project?  If so, what is the recommended location --
> > ${basedir}/conf or ${basedir}/src/conf?
> >
>
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: users-unsubscribe@maven.apache.org
> For additional commands, e-mail: users-help@maven.apache.org
>


---------------------------------------------------------------------
To unsubscribe, e-mail: users-unsubscribe@maven.apache.org
For additional commands, e-mail: users-help@maven.apache.org


RE: Default value for ${maven.conf.dir}

Posted by Carlos Sanchez <ap...@carlos.cousas.net>.
Hi,

Take a look to http://wiki.codehaus.org/maven/DirectoryLayout

Regards

Carlos Sanchez
A Coruña, Spain

Oness Project
http://oness.sourceforge.net


> I suppose what I'm really looking for is a "best practice" or 
> a "standard convention" with respect to the conf dir.  Is 
> there a purpose for having both ${basedir}/conf and 
> ${basedir}/src/conf?  Or should there be only one "conf" dir 
> for a project?  If so, what is the recommended location -- 
> ${basedir}/conf or ${basedir}/src/conf?
> 



---------------------------------------------------------------------
To unsubscribe, e-mail: users-unsubscribe@maven.apache.org
For additional commands, e-mail: users-help@maven.apache.org


RE: Default value for ${maven.conf.dir}

Posted by Charles Daniels <cj...@yahoo.com>.
> -----Original Message-----
> From: news [mailto:news@sea.gmane.org]On Behalf Of Peter Nabbefeld
> Sent: Sunday, August 01, 2004 8:46 AM
> To: users@maven.apache.org
> Subject: Re: Default value for ${maven.conf.dir}
>
> Hello,
>
> I shouldn't reply to my own comments - however, I've found out more
> about the conf dirs, and I'd like it to be documented on the
> Maven web site:
>
> ./conf   is used from some plugins, e.g. the jar manifest is expected
> here (using ${maven.conf.dir}, of course).
>
> src/conf is therefore for app-only data.
>
> The differences are sometime very marginal, as of course one will
> sometimes have to edit e.g. the manifest file.

This has been a point of confusion for me as well.  However, I don't know if
this explanation provides any clarity.  As you said, genapp creates a
${basedir}/src/conf directory, but the default for maven.conf.dir is
${basedir}/conf.  Also, the jar manifest file is expected in
${maven.conf.dir}, but who's to say that shouldn't be ${basedir}/src/conf?
Is it not also "app-only data", as you say src/conf is for?

I suppose what I'm really looking for is a "best practice" or a "standard
convention" with respect to the conf dir.  Is there a purpose for having
both ${basedir}/conf and ${basedir}/src/conf?  Or should there be only one
"conf" dir for a project?  If so, what is the recommended location --
${basedir}/conf or ${basedir}/src/conf?

Furthermore, what sorts of files is the "conf" dir intended to hold?  I see
that some of the genapp templates put cactus-web.xml there, which makes
sense to me, but what is the app.properties intended for?  What other files
are candidates for the "conf" dir?

>
> It'd be very fine, if someone could document all the GenApp templates
> (not only list them). Sometimes it will help to understand one simple
> template, if there are docs for a more complicated one. I've understood
> the default template only after having a look at the complex template:
> I've seen the various conf dirs, then I began to understand.
>
> Kind regards
>
> Peter
>
>
>
> Peter Nabbefeld schrieb:
>
> >
> >
> >
> >
> > Dion Gillard schrieb:
> >
> >> maven.conf.dir = ${basedir}/conf
> >
> >
> > Hmm, looks strange to me: While the conf directory is created
> in the src
> > folder, the property points to the project root. Is there probably some
> > purpose for an additional conf directory in the root dir? Or should the
> > GenApp plugin create a project.properties file with an entry for
> > ${maven.conf.dir} to point to src/conf?
> >
> > Kind regards
> >
> > Peter
> >
> >>
> >> On Sat, 31 Jul 2004 23:29:11 +0200, Peter Nabbefeld
> >> <pe...@gmx.de> wrote:
> >>
> >>> Hello,
> >>>
> >>> what is the default value for ${maven.conf.dir}? Due to
> >>>
http://maven.apache.org/reference/user-guide.html#Behavioural_Properties
>>> it is ${basedir}/conf, but at
>>> http://maven.apache.org/reference/user-guide.html#Starting_a_New_Project
>>> there is a tree structure ${basedir}/src/conf, generated by the GenApp
>>> plugin, so I'd expect this to be the value of ${maven.conf.dir}. What is
>>> the correct value?
>>>
>>> Kind regards
>>>
>>> Peter Nabbefeld
>>>
>>> ---------------------------------------------------------------------
>>> To unsubscribe, e-mail: users-unsubscribe@maven.apache.org
>>> For additional commands, e-mail: users-help@maven.apache.org
>>>
>>>
>>
>>
>>


---------------------------------------------------------------------
To unsubscribe, e-mail: users-unsubscribe@maven.apache.org
For additional commands, e-mail: users-help@maven.apache.org


---------------------------------------------------------------------
To unsubscribe, e-mail: users-unsubscribe@maven.apache.org
For additional commands, e-mail: users-help@maven.apache.org


Re: Default value for ${maven.conf.dir}

Posted by Peter Nabbefeld <Pe...@gmx.de>.
Hello,

I shouldn't reply to my own comments - however, I've found out more 
about the conf dirs, and I'd like it to be documented on the Maven web site:

./conf   is used from some plugins, e.g. the jar manifest is expected 
here (using ${maven.conf.dir}, of course).

src/conf is therefore for app-only data.

The differences are sometime very marginal, as of course one will 
sometimes have to edit e.g. the manifest file.

It'd be very fine, if someone could document all the GenApp templates 
(not only list them). Sometimes it will help to understand one simple 
template, if there are docs for a more complicated one. I've understood 
the default template only after having a look at the complex template: 
I've seen the various conf dirs, then I began to understand.

Kind regards

Peter



Peter Nabbefeld schrieb:

> 
> 
> 
> 
> Dion Gillard schrieb:
> 
>> maven.conf.dir = ${basedir}/conf
> 
> 
> Hmm, looks strange to me: While the conf directory is created in the src 
> folder, the property points to the project root. Is there probably some 
> purpose for an additional conf directory in the root dir? Or should the 
> GenApp plugin create a project.properties file with an entry for 
> ${maven.conf.dir} to point to src/conf?
> 
> Kind regards
> 
> Peter
> 
>>
>> On Sat, 31 Jul 2004 23:29:11 +0200, Peter Nabbefeld
>> <pe...@gmx.de> wrote:
>>
>>> Hello,
>>>
>>> what is the default value for ${maven.conf.dir}? Due to
>>> http://maven.apache.org/reference/user-guide.html#Behavioural_Properties
>>> it is ${basedir}/conf, but at
>>> http://maven.apache.org/reference/user-guide.html#Starting_a_New_Project
>>> there is a tree structure ${basedir}/src/conf, generated by the GenApp
>>> plugin, so I'd expect this to be the value of ${maven.conf.dir}. What is
>>> the correct value?
>>>
>>> Kind regards
>>>
>>> Peter Nabbefeld
>>>
>>> ---------------------------------------------------------------------
>>> To unsubscribe, e-mail: users-unsubscribe@maven.apache.org
>>> For additional commands, e-mail: users-help@maven.apache.org
>>>
>>>
>>
>>
>>


---------------------------------------------------------------------
To unsubscribe, e-mail: users-unsubscribe@maven.apache.org
For additional commands, e-mail: users-help@maven.apache.org


Re: Default value for ${maven.conf.dir}

Posted by Peter Nabbefeld <Pe...@gmx.de>.



Dion Gillard schrieb:
> maven.conf.dir = ${basedir}/conf

Hmm, looks strange to me: While the conf directory is created in the src 
folder, the property points to the project root. Is there probably some 
purpose for an additional conf directory in the root dir? Or should the 
GenApp plugin create a project.properties file with an entry for 
${maven.conf.dir} to point to src/conf?

Kind regards

Peter

> 
> On Sat, 31 Jul 2004 23:29:11 +0200, Peter Nabbefeld
> <pe...@gmx.de> wrote:
> 
>>Hello,
>>
>>what is the default value for ${maven.conf.dir}? Due to
>>http://maven.apache.org/reference/user-guide.html#Behavioural_Properties
>>it is ${basedir}/conf, but at
>>http://maven.apache.org/reference/user-guide.html#Starting_a_New_Project
>>there is a tree structure ${basedir}/src/conf, generated by the GenApp
>>plugin, so I'd expect this to be the value of ${maven.conf.dir}. What is
>>the correct value?
>>
>>Kind regards
>>
>>Peter Nabbefeld
>>
>>---------------------------------------------------------------------
>>To unsubscribe, e-mail: users-unsubscribe@maven.apache.org
>>For additional commands, e-mail: users-help@maven.apache.org
>>
>>
> 
> 
> 


---------------------------------------------------------------------
To unsubscribe, e-mail: users-unsubscribe@maven.apache.org
For additional commands, e-mail: users-help@maven.apache.org


Re: Default value for ${maven.conf.dir}

Posted by Dion Gillard <di...@gmail.com>.
maven.conf.dir = ${basedir}/conf

On Sat, 31 Jul 2004 23:29:11 +0200, Peter Nabbefeld
<pe...@gmx.de> wrote:
> 
> Hello,
> 
> what is the default value for ${maven.conf.dir}? Due to
> http://maven.apache.org/reference/user-guide.html#Behavioural_Properties
> it is ${basedir}/conf, but at
> http://maven.apache.org/reference/user-guide.html#Starting_a_New_Project
> there is a tree structure ${basedir}/src/conf, generated by the GenApp
> plugin, so I'd expect this to be the value of ${maven.conf.dir}. What is
> the correct value?
> 
> Kind regards
> 
> Peter Nabbefeld
> 
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: users-unsubscribe@maven.apache.org
> For additional commands, e-mail: users-help@maven.apache.org
> 
> 


-- 
http://www.multitask.com.au/people/dion/

---------------------------------------------------------------------
To unsubscribe, e-mail: users-unsubscribe@maven.apache.org
For additional commands, e-mail: users-help@maven.apache.org