Doc #77435 [Ver->Csd]: Documentation linking issue for hrtime()
| From: | cmb@php.net | Date: | Wed, 09 Jan 2019 18:48:06 +0000 |
| Subject: | Doc #77435 [Ver->Csd]: Documentation linking issue for hrtime() | ||
| References: | 1 | Groups: | php.doc.bugs |
| Request: | Send a blank email to doc-bugs+get-16314@lists.php.net to get a copy of this message | ||
Edit report at https://bugs.php.net/bug.php?id=77435&edit=1
ID: 77435
Updated by: cmb@php.net
Reported by: love at sickpeople dot se
Summary: Documentation linking issue for hrtime()
-Status: Verified
+Status: Closed
Type: Documentation Problem
Package: Documentation problem
PHP Version: Irrelevant
Assigned To: cmb
Block user comment: N
Private report: N
New Comment:
This bug has been fixed in the documentation's XML sources. Since the
online and downloadable versions of the documentation need some time
to get updated, we would like to ask you to be a bit patient.
Thank you for the report, and for helping us make our documentation better.
Previous Comments:
------------------------------------------------------------------------
[2019-01-09 18:47:41] cmb@php.net
Automatic comment from SVN on behalf of cmb
Revision: http://svn.php.net/viewvc/?view=revision&revision=346582
Log: Fix #77435: Documentation linking issue for hrtime()
------------------------------------------------------------------------
[2019-01-09 18:38:42] cmb@php.net
> php.net/book.hrtime is for the HRTime PECL extension. The hrtime
> function is not part of it.
Still it makes sense to cross-reference the extension and the
function.
------------------------------------------------------------------------
[2019-01-09 18:34:55] requinix@php.net
1. The short php.net/NAME convenience URL prioritizes "book" pages over
"function" pages. The same thing happens with php.net/hash and I think another one. If
you're typing the short URL yourself you can use the "function." prefix like
php.net/function.hrtime.
2/3. php.net/book.hrtime is for the HRTime PECL extension. The hrtime function is not part of it.
------------------------------------------------------------------------
[2019-01-09 18:22:53] love at sickpeople dot se
Description:
------------
The hrtime() function is currently *hard to find*, some linking is missing I think. You can search
for it on the page search box and find it easily, but
1) http://php.net/hrtime leads to the "book hrtime"
page. I somewhat expect it to lead to the function instead (maybe just because I more often search
for functions via the URL)
2) hrtime() is not mentioned on the "book hrtime" page
3) hrtime() is sorted under misc functions. Maybe it should be moved to "book hrtime". On
the other hand, sleep(), usleep() et al are sorted under misc functions. Maybe it can be on both?
------------------------------------------------------------------------
--
Edit this bug report at https://bugs.php.net/bug.php?id=77435&edit=1