No problem with it being there, I just wanted to point out that there can be more than one config file for each module so the description/name only applies to the config file, not even a whole module.
Steve > -----Original Message----- > From: Rob Leland [mailto:[EMAIL PROTECTED] > Sent: August 4, 2003 6:56 PM > To: Struts Developers List > Subject: Re: struts-config and xslt > > > Steve Raeburn wrote: > > >>>While messing with the struts-config_1_1.dtd, I was surprised > not to find > >>> > >>> > >a > > > > > >>>way to name and describe the whole application. > >>> > >>> > > > >As you can have multiple config files for each module, display-name and > >description could really only describe the contents of each file > rather than > >describing the application or module. (web.xml already has this info at > >application level). > > > You're right it would be module level information. My thought is that > while not read or used by struts > it keeps a useful summary description with the struts-config.xml that > could then be digested/processed by > some other tool like maven when generating documentation. > > > > >Would this still be meaningful? I think description probably > would but I'm > >not sure about display-name. > > > I was assuming display-name was the same as saying 'a short 1 to 5' word > descriptive phrase. > It certainly couldn't/shouldn't be the module name. > > -Rob > > > > >Steve > > > > > > > > > >>-----Original Message----- > >>From: Rob Leland [mailto:[EMAIL PROTECTED] > >>Sent: August 4, 2003 6:26 PM > >>To: Struts Developers List > >>Subject: Re: struts-config and xslt > >> > >> > >>Jonas Björnerstedt wrote: > >> > >> > >> > >>>Hello, > >>> > >>>Having to evaluate an xml editor (I won't say which), I decided to use > >>>struts-config.xml as an example. After some hours wrestling with the > >>>program, this is the result I got: > >>> > >>>http://bjornerstedt.org/struts-config.html > >>> > >>>It is the config file from the struts-example application. It > was created > >>>using: > >>> > >>>http://bjornerstedt.org/struts-config_1_1.xslt > >>> > >>>It's not that pretty (especially not in Mozilla). I am sure > >>> > >>> > >>others can do it > >> > >> > >>>better, but given that it is rather easy to create an xslt, I > >>> > >>> > >>think it would > >> > >> > >>>be a good idea to include one in Struts. Not only does it make > >>> > >>> > >>the file more > >> > >> > >>>readable for large applications, it can also be used to make the xml - > >>>editor a decent Struts editor. > >>> > >>>While messing with the struts-config_1_1.dtd, I was surprised > >>> > >>> > >>not to find a > >> > >> > >>>way to name and describe the whole application. Specifically, I > >>> > >>> > >>would like > >> > >> > >>>to see display-name and description added to the struts-config > element in > >>>the dtd: > >>> > >>><!ELEMENT struts-config (display-name?, description?, data-sources?, > >>>form-beans?, global-exceptions?, global-forwards?, action-mappings?, > >>>controller?, message-resources*, plug-in*)> > >>> > >>> > >>> > >>This seems reasonable, if no others object I'll change the dtd to add > >>this info. > >>However, I see no reason for struts itself to read in this information. > >>If you want this info in your application you can use the > resource files. > >> > >> > >> > >>>instead of: > >>> > >>><!ELEMENT struts-config (data-sources?, form-beans?, > global-exceptions?, > >>>global-forwards?, action-mappings?, controller?, message-resources*, > >>>plug-in*)> > >>> > >>>Descriptions should be available at all levels. > >>> > >>>Jonas > >>> > ----- > Rob Leland (703-525-3580) > > > Choose a job you love, and you will never have to work a day of your life. > > -Confucius. > > --------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
