Lists Home |
Date Index |
email@example.com (K. Ari Krupnikov) writes:
>> You can turn that off with the -public option for the JavaDoc
>> command, which restricts the output to public classes and members.
>Exactly my point. You know some bits are irrelevant, you mark them as
>such, so when you send me the data, you can exclude them. And I'd
>trust you to decide what's relevant and what's not in your data.
>Unless you want to sprinkle ssl:relevance-level attributes in your
>documents, so I might filter them :=)
So long as the source code is available, you trusting me isn't even
really necessary, since you can always do a global replace anyway.
Basically I think it boils down to whatever a programmer considers
relevant. XML seems by default to say "here are all the relevant bits".
>> 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 don't think it's a matter of trust, rather of views on what is
Or of different perspective on compile-time optimization, etc. I guess
I just don't have much patience for programmers who default to private,
as it seems to scream "this is mine, you shouldn't look here, now bug
off." Telling me something isn't relevant to me may or may not mean you
don't trust me to work with it. In environments where trust is already
assumed, a polite interpretation may make sense, but there are many many
times where that isn't the case.
Again, I prefer to make my own decisions about what is relevant to me
rather than leaving that in the hands of a master programmer / designer
/ spec-writer / whatever.
> Perhaps if James were still maintaining XT, he would
>consider refactoring it. Perhaps you'd like to help Bill Lindsey with
If I had the time or the patience to deal with that style of code, I'd
be interested. As it is, I'm trying to put my limited programming time
toward addressing other gaps in the XML infrastructure.
Simon St.Laurent - SSL is my TLA
http://simonstl.com may be my URI
http://monasticxml.org may be my ascetic URI
urn:oid:22.214.171.124.4.1.6320 is another possibility altogether