Leo Sutic wrote:
>
>>From: Nicola Ken Barozzi [mailto:[EMAIL PROTECTED]]
>>
>>Peter Donald wrote:
>
>
> ...
>
>
>>This is generally known as "literal programming".
>
>
> And pretty much breaks the DefaultConfigurationBuilder.
>
> -1
Too bad it is set in stone :'-(
> Use comments for comments. If it isn't supposed to be given
> to the program code for processing, keep it away from it.
Which is exactly the point.
Someone just said that documentation is as important as code, so it
should be regarded as code. @see literal programming
...
> And THAT said...
>
> Personally I prefer elements for multiplicity and for long text:
>
> <description>
> This is my component. There are many like it,
> but this one is mine.
>
> "This is the second paragraph."
> </description>
>
> is better than:
>
> <description text="This is my component. There are many like it, but
> this one is mine. "This is the second paragraph.""/>
Which is what I said.
Hey, doesn't this break DefaultConfigurationBuilder.?
Go figure *shrugs*
--
Nicola Ken Barozzi [EMAIL PROTECTED]
- verba volant, scripta manent -
(discussions get forgotten, just code remains)
---------------------------------------------------------------------
--
To unsubscribe, e-mail: <mailto:[EMAIL PROTECTED]>
For additional commands, e-mail: <mailto:[EMAIL PROTECTED]>
