Doc #76278 [Fbk->NoF]: Categorization of get_headers and get_meta_tags
| From: | php-bugs at lists dot php dot net | Date: | Sun, 24 Jun 2018 04:25:45 +0000 |
| Subject: | Doc #76278 [Fbk->NoF]: Categorization of get_headers and get_meta_tags | ||
| References: | 1 | Groups: | php.doc.bugs |
| Request: | Send a blank email to doc-bugs+get-15818@lists.php.net to get a copy of this message | ||
Edit report at https://bugs.php.net/bug.php?id=76278&edit=1
ID: 76278
Updated by: php-bugs@lists.php.net
Reported by: crazytonyi at gmail dot com
Summary: Categorization of get_headers and get_meta_tags
-Status: Feedback
+Status: No Feedback
Type: Documentation Problem
Package: URL related
PHP Version: Irrelevant
Private report: N
New Comment:
No feedback was provided. The bug is being suspended because
we assume that you are no longer experiencing the problem.
If this is not the case and you are able to provide the
information that was requested earlier, please do so and
change the status of the bug back to "Re-Opened". Thank you.
Previous Comments:
------------------------------------------------------------------------
[2018-04-28 00:01:12] requinix@php.net
Here's all the sections:
http://php.net/manual/en/funcref.php
Can you see a better place for those functions to go in? I can't.
Saying that the only relation they have to URLs is that they expect on as their argument kinda
ignores the fact that the entire purpose of both of them is to provide information about the
resource/HTML page fetched from that URL. That's a really important aspect of their behavior to
gloss over.
How about just fixing the description on the introduction page?
http://php.net/manual/en/intro.url.php
"Dealing with URL strings: encoding, decoding and parsing."
------------------------------------------------------------------------
[2018-04-27 17:06:54] crazytonyi at gmail dot com
Description:
------------
---
From manual page: http://www.php.net/function.get-headers
From manual page: http://www.php.net/function.get-meta-tags
---
These are pretty nifty functions, but are currently listed under:
http://php.net/manual/en/ref.url.php
Is this really where they belong? I'm not sure what section of the documentation would be the
right home for them, but URLs isn't it. The functions don't manipulate or parse a URL
string, contribute to generating a URL, or have anything else relating to URLs other than they
expect a URL as their primary argument.
It isn't just a matter of "it's kind of weird that these functions are listed
here." I've actually never heard of them until today when someone referenced it in a SO
post. I thought "these are neat, how have I not noticed them before?" and then saw they
were under the URL function category. I'm pretty nerdy and will peruse function categories
looking for neat functions I might not use regularly, and thus these were essentially hidden because
I wouldn't really look for functions under URL functions that involve sending HTTP requests.
------------------------------------------------------------------------
--
Edit this bug report at https://bugs.php.net/bug.php?id=76278&edit=1