• To: xml-dev <xml-dev@l...>
• Subject: Re: XML as "passive data" (Re: The Browser Wars are Dead! Long Live the Browser Wars!)
• From: "Simon St.Laurent" <simonstl@s...>
• Date: Fri, 25 Oct 2002 11:28:41 -0400
• In-reply-to: <86d6q0ewn2.fsf@p...>
• References: <r01050400-1021-D8BE0296E68311D6B5470003937A08C2@[192.168.124.21]><r01050400-1021-D8BE0296E68311D6B5470003937A08C2@[192.168.124.21]>

At 09:19 PM 10/23/2002 +0100, K. Ari Krupnikov wrote:
>Reading through org.apache.xml.* JavaDocs, with hundreds of protected
>fields and methods, it takes forever to understand what the data
>model, or the intended use are.

You can turn that off with the -public option for the JavaDoc command, 
which restricts the output to public classes and members.

>Not all data in an OO object are "real" data that you might want to
>send; much of that are procedural implementation details. Is your
>recipient really interested in those integers you used as loop
>counters?

I guess I prefer to be able to make that choice for myself.  Loop counters 
are uninteresting, yes, but the heavy use of private in packages like XT 
has caused me more than a few problems.

I guess I'm just happier with XML's all information is public approach - if 
it's not relevant, it shouldn't be in the doc...

Simon St.Laurent
"Every day in every way I'm getting better and better." - Emile Coue

• Follow-Ups:
  • Re: XML as "passive data" (Re: The Browser Wars are Dead! Long Live the Browser Wars!)
    • From: ari@c... (K. Ari Krupnikov)

• References:
  • Re: XML as "passive data" (Re: The Browser Wars are Dead! Long Live the Browser Wars!)
    • From: "Simon St.Laurent" <simonstl@s...>
  • Re: XML as "passive data" (Re: The Browser Wars are Dead! Long Live the Browser Wars!)
    • From: ari@c... (K. Ari Krupnikov)

• Prev by Date: Design of streamform declaration.
• Next by Date: RE: We need SAX features to say a parser supports XML
• Previous by thread: Re: XML as "passive data" (Re: The Browser Wars are Dead! Long Live the Browser Wars!)
• Next by thread: Re: XML as "passive data" (Re: The Browser Wars are Dead! Long Live the Browser Wars!)
• Index(es):
  • Date
  • Thread