Doc #70640 [Opn->Csd]: Wrapping operators in <em> leads to confusion
| From: | cmb@php.net | Date: | Wed, 09 Dec 2020 16:43:08 +0000 |
| Subject: | Doc #70640 [Opn->Csd]: Wrapping operators in <em> leads to confusion | ||
| References: | 1 | Groups: | php.doc.bugs |
| Request: | Send a blank email to doc-bugs+get-18228@lists.php.net to get a copy of this message | ||
Edit report at https://bugs.php.net/bug.php?id=70640&edit=1
ID: 70640
Updated by: cmb@php.net
Reported by: teamhydro55555 at gmail dot com
Summary: Wrapping operators in <em> leads to confusion
-Status: Open
+Status: Closed
Type: Documentation Problem
Package: Doc Build problem
PHP Version: Irrelevant
-Assigned To:
+Assigned To: cmb
Block user comment: N
Private report: N
New Comment:
This has been fixed in the meantime.
Previous Comments:
------------------------------------------------------------------------
[2015-10-05 14:42:21] salathe@php.net
> Also can somebody explain to me how this bug us related to philosophy?
http://doc.php.net/phd/docs/
------------------------------------------------------------------------
[2015-10-05 14:40:03] teamhydro55555 at gmail dot com
Also can somebody explain to me how this bug us related to philosophy?
------------------------------------------------------------------------
[2015-10-05 14:30:00] 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 12:20:49] 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 12:12:50] 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.
------------------------------------------------------------------------
The remainder of the comments for this report are too long. To view
the rest of the comments, please view the bug report online at
https://bugs.php.net/bug.php?id=70640
--
Edit this bug report at https://bugs.php.net/bug.php?id=70640&edit=1