Doc #52714 [NEW]: Intro to HTTP subsystem unclear

From: Operating system: PHP version: Irrelevant Package: Documentation problem Bug Type: Documentation Problem Bug description:Intro to HTTP subsystem unclear Description: ------------ http://php.he.net/manual/en/intro.http.php: the intro to the "HTTP" package is unclear; specifically, there's HTTP that called the PHP script in the first place (incoming), then there's HTTP requests that the script can in turn do before the script returns (outgoing). Does it concern both? or just outgoing? "powerful set of functionality for one of PHPs major applications" - that says to me, the incoming HTTP that called the script to build a web page. That's the major application of PHP. But, I think the package does very little for that, right? "It eases handling of HTTP URLs, dates, redirects, headers and messages," = both incoming and outgoing. " provides means for negotiation of clients preferred language and charset" = incoming "a convenient way to send any arbitrary data with caching and resuming capabilities." => 'send' - do you mean, send as a reply to the incoming request, or send as the data for an outgoing request? "It provides powerful request functionality, if built with CURL support." = outgoing. OK, so if I rolled up my sleeves and read some of it i'd get my answer, but the Intro is supposed to answer big questions like that. And this intro leaves me confused. Thanks, I know docs are hard work, I do a lot of it myself. -- Edit bug report at http://bugs.php.net/bug.php?id=52714&edit=1 -- Try a snapshot (PHP 5.2): http://bugs.php.net/fix.php?id=52714&r=trysnapshot52 Try a snapshot (PHP 5.3): http://bugs.php.net/fix.php?id=52714&r=trysnapshot53 Try a snapshot (trunk): http://bugs.php.net/fix.php?id=52714&r=trysnapshottrunk Fixed in SVN: http://bugs.php.net/fix.php?id=52714&r=fixed Fixed in SVN and need be documented: http://bugs.php.net/fix.php?id=52714&r=needdocs Fixed in release: http://bugs.php.net/fix.php?id=52714&r=alreadyfixed Need backtrace: http://bugs.php.net/fix.php?id=52714&r=needtrace Need Reproduce Script: http://bugs.php.net/fix.php?id=52714&r=needscript Try newer version: http://bugs.php.net/fix.php?id=52714&r=oldversion Not developer issue: http://bugs.php.net/fix.php?id=52714&r=support Expected behavior: http://bugs.php.net/fix.php?id=52714&r=notwrong Not enough info: http://bugs.php.net/fix.php?id=52714&r=notenoughinfo Submitted twice: http://bugs.php.net/fix.php?id=52714&r=submittedtwice register_globals: http://bugs.php.net/fix.php?id=52714&r=globals PHP 4 support discontinued: http://bugs.php.net/fix.php?id=52714&r=php4 Daylight Savings: http://bugs.php.net/fix.php?id=52714&r=dst IIS Stability: http://bugs.php.net/fix.php?id=52714&r=isapi Install GNU Sed: http://bugs.php.net/fix.php?id=52714&r=gnused Floating point limitations: http://bugs.php.net/fix.php?id=52714&r=float No Zend Extensions: http://bugs.php.net/fix.php?id=52714&r=nozend MySQL Configuration Error: http://bugs.php.net/fix.php?id=52714&r=mysqlcfg