php.net |  support |  documentation |  report a bug |  advanced search |  search howto |  statistics |  random bug |  login
Doc Bug #70640 Wrapping operators in <em> leads to confusion
Submitted: 2015-10-05 10:17 UTC Modified: 2020-12-09 16:43 UTC
From: teamhydro55555 at gmail dot com Assigned: cmb (profile)
Status: Closed Package: Doc Build problem
PHP Version: Irrelevant OS:
Private report: No CVE-ID: None
View Add Comment Developer Edit
Welcome! If you don't have a Git account, you can't do anything here.
You can add a comment by following this link or if you reported this bug, you can edit this bug over here.
(description)
Block user comment
Status: Assign to:
Package:
Bug Type:
Summary:
From: teamhydro55555 at gmail dot com
New email:
PHP Version: OS:

 

 [2015-10-05 10:17 UTC] teamhydro55555 at gmail dot com
Description:
------------
---
From manual page: http://www.php.net/function.preg-split
---
I think it is not a good idea to apply the <em> tag to the bitwise | operator as in most browsers <em> renders it as italic making or liik like a /


Patches

Add a Patch

Pull Requests

Add a Pull Request

History

AllCommentsChangesGit/SVN commitsRelated reports
 [2015-10-05 12:12 UTC] salathe@php.net
-Summary: <em> to | +Summary: Wrapping operators in <em> leads to confusion -Package: Documentation problem +Package: Doc Build problem
 [2015-10-05 12:12 UTC] salathe@php.net
Note that the "from manual page" link is incorrect, it should be http://php.net/operators.bitwise

Also moving this to be a PhD bug. 

It would be nice if we abandoned using "em" tags for code, operators, etc. in prose, and used some more appropriate tag like "code" quiet apart from the visual styling, though that would have the effect of removing the italics.
 [2015-10-05 12:20 UTC] teamhydro55555 at gmail dot com
I got here from the page where I made the bug and it does affect the split page, so I think it IS correct, let me quote: "[flags] can be any combination of the follwing flags (combined with the <em>|</em> bitwise operator)"
 [2015-10-05 14:30 UTC] salathe@php.net
Ahh my mistake. Anyhow, this bug affects all pages that refer to an operator in prose, so any of the linked ones and hundreds more besides.

The idea is to change the software that generates the documentation HTML, so all pages will be affected at once.
 [2015-10-05 14:40 UTC] teamhydro55555 at gmail dot com
Also can somebody explain to me how this bug us related to philosophy?
 [2015-10-05 14:42 UTC] salathe@php.net
> Also can somebody explain to me how this bug us related to philosophy?

http://doc.php.net/phd/docs/
 [2020-12-09 16:43 UTC] cmb@php.net
-Status: Open +Status: Closed -Assigned To: +Assigned To: cmb
 [2020-12-09 16:43 UTC] cmb@php.net
This has been fixed in the meantime.
 
PHP Copyright © 2001-2024 The PHP Group
All rights reserved.
Last updated: Tue Mar 19 08:01:29 2024 UTC