Re: Aligning plugin artifacts with normal projects
[EMAIL PROTECTED] wrote: We also need it for documentation. Its quite common for people to ask 'what property do I set to do' because there are so many undocumented properties. If there was a metadata file that described plugin properties, it could be used to generate the xdocs. There is one. It's called plugin.properties, and it can be used to generate the xdocs :-) We could probably make a contract that the comment block directly above the property contains it's description, but I'm not sure if this is what we really want? Generating an xdoc from the property files itself has an advantage of on the spot documentation, just like JavaDoc - you can read it in the Java source, but also in the generated HTML pages. We also don't have two files that need to be kept in sync (humans *always* forget...) We could go the other way around, and generated plugin.properties files from the metadata, to lift the need for synchronizing files. Descriptions in the metadata file could be emmited into the file as well. The metadata file would be xml (seems natural to me), so we could have a schema for it and take advantage of validation. On the other hand, should we really introduce a new format for specifying properties? Given the choice I'd probably stay with .properties files only, and write the PropertyDoc thingy. The reason the documentation is lacking is noone has been willing to do it. True. No matter which way we go - metadata files, or PropertiesDoc plugin maintainers will have to fill in the descriptions anyway... R. - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
RE: Aligning plugin artifacts with normal projects
We also need it for documentation. Its quite common for people to ask 'what property do I set to do' because there are so many undocumented properties. If there was a metadata file that described plugin properties, it could be used to generate the xdocs. There is one. It's called plugin.properties, and it can be used to generate the xdocs :-) The reason the documentation is lacking is noone has been willing to do it. -- I think we soon will need more flexibility with documentation of properties. Sorry for being ridiculous (I know even English documentation su..) I suppose that we might need also localized documentation of the properties (translation) and possibly also definition of some constrains for those properties. If we have it: we can finally imagine that somebody will write a GUI front-end to maven which will dynamically create user interface. I really would prefer to use maven integrated with my Eclipse :) Michal - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
Re: Aligning plugin artifacts with normal projects
On Wed, 2003-06-25 at 23:58, Jason van Zyl wrote: We had a quick chat in IRC about aligning plugin artifacts with normal Is there a special maven channel where you guy hang around? Could one provide server and channelname? Forgive me if it's somewhere documented... Thanks -- Martin Skopp Riege Software International GmbH Support: mailto:[EMAIL PROTECTED], Information: http://www.riege.com This email is intended to be viewed with a nonproportional font. Public Key on http://www.keyserver.net, Key-ID: 3D4027B5 Fingerprint: 1970 C78D 9A1D 99FA 5CE4 5C0D 29E6 6A95 3D40 27B5 - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
Re: Aligning plugin artifacts with normal projects
irc.codehaus.org:6667 #maven Probably is documented, but I have no idea where :) Martin Skopp wrote: On Wed, 2003-06-25 at 23:58, Jason van Zyl wrote: We had a quick chat in IRC about aligning plugin artifacts with normal Is there a special maven channel where you guy hang around? Could one provide server and channelname? Forgive me if it's somewhere documented... Thanks - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
Re: Aligning plugin artifacts with normal projects
I could only find it on the Jelly site :) - Brett Ben Walding wrote: irc.codehaus.org:6667 #maven Probably is documented, but I have no idea where :) Martin Skopp wrote: -- Web Developer f2 network ~ everything essential 02 8596 4437 - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
RE: Aligning plugin artifacts with normal projects
On Thu, 2003-06-26 at 01:27, Vincent Massol wrote: ATM I have different properties in plugin.properties and in project.properties. The ones in project.properties are used to build the plugin only and they must not be used when the user uses the plugin. How do we deal with this? Again I can leave them separate. As I'm refactoring I'm just popping out questions to users to make sure I don't bonk anyone. Thanks -Vincent -Original Message- From: Jason van Zyl [mailto:[EMAIL PROTECTED] Sent: 25 June 2003 23:59 To: Maven Developers List Subject: Aligning plugin artifacts with normal projects Hi, We had a quick chat in IRC about aligning plugin artifacts with normal Maven Projects. By this I mean using maven.xml instead of plugin.jelly and the simple project.properties instead of plugin.properties. I think this alignment would make explaining plugins work as they now do work the same as a normal project. I can change all the plugins in CVS but admittedly plugins outside the ones we store will have to change the file names if we make the change. I would like to make the plugins more consistent with normal projects for 1.0 if there are no objections. -- jvz. Jason van Zyl [EMAIL PROTECTED] http://tambora.zenplex.org In short, man creates for himself a new religion of a rational and technical order to justify his work and to be justified in it. -- Jacques Ellul, The Technological Society - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED] - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED] -- jvz. Jason van Zyl [EMAIL PROTECTED] http://tambora.zenplex.org In short, man creates for himself a new religion of a rational and technical order to justify his work and to be justified in it. -- Jacques Ellul, The Technological Society - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
Re: Aligning plugin artifacts with normal projects
On Thu, 2003-06-26 at 01:40, [EMAIL PROTECTED] wrote: How would we be able to differentiate then between the properties a plugin exposes and those it uses for it's own purposes? The plugin plugin uses plugin.properties to generate docs. Ok, it looks like we will keep both in order to make a distinction between building the plugin and running the plugin. I jumped the gun a bit. That's why I asked. -- dIon Gillard, Multitask Consulting Blog: http://blogs.codehaus.org/people/dion/ Work: http://www.multitask.com.au Jason van Zyl [EMAIL PROTECTED] wrote on 26/06/2003 07:58:52 AM: Hi, We had a quick chat in IRC about aligning plugin artifacts with normal Maven Projects. By this I mean using maven.xml instead of plugin.jelly and the simple project.properties instead of plugin.properties. I think this alignment would make explaining plugins work as they now do work the same as a normal project. I can change all the plugins in CVS but admittedly plugins outside the ones we store will have to change the file names if we make the change. I would like to make the plugins more consistent with normal projects for 1.0 if there are no objections. -- jvz. Jason van Zyl [EMAIL PROTECTED] http://tambora.zenplex.org In short, man creates for himself a new religion of a rational and technical order to justify his work and to be justified in it. -- Jacques Ellul, The Technological Society - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED] -- jvz. Jason van Zyl [EMAIL PROTECTED] http://tambora.zenplex.org In short, man creates for himself a new religion of a rational and technical order to justify his work and to be justified in it. -- Jacques Ellul, The Technological Society - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
RE: Aligning plugin artifacts with normal projects
On Thu, 2003-06-26 at 08:23, Michal Maczka wrote: I like this idea! I agree, that is a good idea. It definitely allows using the same tools throughout the source code. Having the little niggly bits for reading plugin.jelly and plugin.properties causes some problems internally. I think this is the best idea so far. mm -Original Message- From: Mark H. Wilkinson [mailto:[EMAIL PROTECTED] Sent: Thursday, June 26, 2003 11:10 AM To: Maven Developers List Subject: Re: Aligning plugin artifacts with normal projects On Wed, 2003-06-25 at 22:58, Jason van Zyl wrote: Hi, We had a quick chat in IRC about aligning plugin artifacts with normal Maven Projects. By this I mean using maven.xml instead of plugin.jelly and the simple project.properties instead of plugin.properties. Responses seem to be suggesting that it's not unheard of for a plugin project to use maven.xml and project.properties at build time. I'd have thought the obvious solution to make this all more consistent would be to move the run-time executable parts of the plugin somewhere under the src directory rather than having everything dumped in the project root as at the moment: plugin project.xml project.properties maven.xml /src /java /org... /maven maven.xml project.properties /xdocs This would tighten up the distinction between project metadata and build-time stuff (project root) and run-time artifacts (somewhere under src). -Mark. - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED] - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED] -- jvz. Jason van Zyl [EMAIL PROTECTED] http://tambora.zenplex.org In short, man creates for himself a new religion of a rational and technical order to justify his work and to be justified in it. -- Jacques Ellul, The Technological Society - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
Re: Aligning plugin artifacts with normal projects
How would we be able to differentiate then between the properties a plugin exposes and those it uses for it's own purposes? The plugin plugin uses plugin.properties to generate docs. -- dIon Gillard, Multitask Consulting Blog: http://blogs.codehaus.org/people/dion/ Work: http://www.multitask.com.au Jason van Zyl [EMAIL PROTECTED] wrote on 26/06/2003 07:58:52 AM: Hi, We had a quick chat in IRC about aligning plugin artifacts with normal Maven Projects. By this I mean using maven.xml instead of plugin.jelly and the simple project.properties instead of plugin.properties. I think this alignment would make explaining plugins work as they now do work the same as a normal project. I can change all the plugins in CVS but admittedly plugins outside the ones we store will have to change the file names if we make the change. I would like to make the plugins more consistent with normal projects for 1.0 if there are no objections. -- jvz. Jason van Zyl [EMAIL PROTECTED] http://tambora.zenplex.org In short, man creates for himself a new religion of a rational and technical order to justify his work and to be justified in it. -- Jacques Ellul, The Technological Society - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]