php.net |  support |  documentation |  report a bug |  advanced search |  search howto |  statistics |  random bug |  login
Doc Bug #50062 strftime %e example
Submitted: 2009-11-03 16:06 UTC Modified: 2009-11-03 16:50 UTC
From: mvds dot 00 at gmail dot com Assigned:
Status: Wont fix Package: Documentation problem
PHP Version: Irrelevant OS: n/a
Private report: No CVE-ID: None
Have you experienced this issue?
Rate the importance of this bug to you:

 [2009-11-03 16:06 UTC] mvds dot 00 at gmail dot com
Description:
------------
A very minor issue: The example for the %e format character shows in html as:

<td align="left"><i> 1</i> to <i>31</i></td>

I suggest " 1" is replaced by "&nbsp;1" so that in every browser the space will actually show up.

As a further suggestion, some hint to highlight the space character would have saved me a few moments. Maybe underline? "<u>&nbsp;</u>1"


Reproduce code:
---------------
---
From manual page: function.strftime#Parameters
---



Patches

Add a Patch

Pull Requests

Add a Pull Request

History

AllCommentsChangesGit/SVN commitsRelated reports
 [2009-11-03 16:09 UTC] rquadling@php.net
I have to say that this is a bit bogus. The description (the bit between 
the %e and  1 to 31) does say "with a space preceding single digits".


 [2009-11-03 16:09 UTC] danbrown@php.net
The textual description on that very line describes the expected output 
in plain English:

"Day of the month, with a space preceding single digits"

That is far more likely to be read than the HTML source of the page as 
you showed, and an underline character would likely be confusing.
 [2009-11-03 16:50 UTC] mvds dot 00 at gmail dot com
That's all true, I'm just pointing out that the example doesn't come out as intended, since whitespace in html doesn't always lead to whitespace displayed.

I referred to the html source to point out that an attempt to include the space was made already.

Of course the description is OK. However, for quick reference I think most people scan through the example column instead of the descriptions.
 
PHP Copyright © 2001-2024 The PHP Group
All rights reserved.
Last updated: Thu Apr 25 19:01:33 2024 UTC