Hi Phil, On 17/08/07, Phil Endecott < spam_from_boost_dev@chezphil.org> wrote:
I'd like to look at the tutorial or quickstart sections, but the links from the introduction page don't work (as expected), and they're not listed in the TOC. Can you post a link?
I've restructured the docs a bit. Now the tutorial is linked from the first page: http://cgi.sf.net
From what I can see so far -
- You've chosen some too-short identifiers; abbreviating "request" to "req" is fine, but abbreviating "sync" to "s" is not. So I'd vote for "sync_req", rather than "srequest".
I based that on things like xpressive::sregex (static regex). I agree it's not particularly clear though and it's probably a good idea to remove the difference and just follow the conventions described here: http://tinyurl.com/35cnrg. - The documentation is all very "in at the deep end", starting by
describing the differences between the different protocols that you've implemented. It would be better to describe the common aspects, i.e. how to access form or other data. As far as I can see you don't ever describe this, always just commenting "use the request here", or something like that.
Hopefully it's a bit clearer now, with the quickstart put up. Two main sections which still need to be uploaded - on `cgi::reply` and `basic_protocol_service<>`s - will have to wait as this computer can't do what I need. Still, it should be relatively guessable how to write a basic CGI program (but I could be mistaken). - Err, actually maybe you do describe the functions for accessing the
form data, in the "request meta-data" section at the end of http://cgi.sourceforge.net/html/cgi/ug.html . But why is this _meta_ data, not just "data"?
That's because form/environment data are 'meta-variables', according to the CGI specification. Perhaps it's a bit liberal/confusing to swap 'variables' for 'data', since this is C++ after all? I've tried to clear this up, so as to not be misleading. I will have another look when some more tutorial material is available. Thanks again for the interest. Sorry the internal links are still broken! Regards, Darren