On Sun, 2008-06-15 at 22:03 +0200, Quintin Beukes wrote: > Hey, > > Like I promised, I started creating documentation for HttpComponents. > I am creating them as I learn it while implementing it in my own > software. Since my software is closed source, I have to make parallel > classes which simply use HttpCore in a similar way. > > I also removed certain features, to allow splitting it into different > wiki pages, each focussing on it's own specific topic, for example > thread safety, or error handling, and so forth. > > Here it the first page, which discusses making a simple class that > accepts a URL, and supplies interface to read the headers and content. > > If you can proofread it, tell me of any mistakes or errors I made. >
Quintin, I am in the process of reviewing the content, but it'll take a few days > As I get the time I will continue making more pages. Improving the > connection manager and error handling is what I'm currently busy with, > so please let me know of obvious bad practise I'm doing in this guide. > It's possible that the improvements focus on those, but it's also > possible that I missed them. And those I've missed I would prefer to > fix in this one already, since the ones I left in there on purpose are > there for a reason (they don't really make the class dangerous, but > they do open a door to create a page that focusses on why they are bad > and how to do it properly, learning by example). > > Also, the wiki page: > http://wiki.apache.org/HttpComponents/HelpOnParsers has an error on > it. Where it discusses line numbering for source code parsers, it > gives the example: > ---- > (#FORMAT python start=10 step=10 numbering=on or #!python numbering=off). > ---- > > This should read (the option is numbers, not numbering): > ---- > (#FORMAT python start=10 step=10 numbers=on or #!python numbers=off). > ---- > > Being an immutable page, I can't correct this myself. > I also do not have permissions to change the content of that page. It seems to require admin privileges. > One more, I put the source code files, as separate sections on this > page. Is there any way I can attach them, or is this not possible? > Not that I know of. Once again, many thanks for this contribution. Oleg --------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]