/hg/icedtea-web: Properly disconnect all connected http connecti...

[Omair Majid]

* Jiri Vanek <jvanek at redhat.com> [2014-05-21 05:48]:
> We are a bit deadlocking around usability of comments. Well from where you
> are looking on it? I got an impression you are looking on them from *code*.

Yes, that's right.

> I think most of your arguments become invalid, when you look to them as on
> final html file. ANd Imean pure html file without the code. If tose which
> you wont me to remove will be removed (or when you wont some infomratin to
> be removed in behalf of somthing else...) then this information is really
> missing in final html.

I see your point. And I admit that the html "looks" a bit empty when you
remove redundant comments. I say "looks" because the same information is
conveyed: for example, do you really need a comment describing the
parameter's purpose when the name of the parameter makes it obvious?

But even more than that, I am wondering what the point of html docs is.
They are nice to have, for sure, but who would be using them? To me,
focusing on them means more (on-going) effort without any benefit. In
fact, it means a harder-to-understand system when your comments disagree
with the code.

Thanks,
Omair

-- 
PGP Key: 66484681 (http://pgp.mit.edu/)
Fingerprint = F072 555B 0A17 3957 4E95  0056 F286 F14F 6648 4681