Doc #70640 [Opn]: Wrapping operators in <em> leads to confusion

From: Date: Mon, 05 Oct 2015 14:30:05 +0000
Subject: Doc #70640 [Opn]: Wrapping operators in <em> leads to confusion
References: 1  Groups: php.doc.bugs 
Request: Send a blank email to doc-bugs+get-12801@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: salathe@php.net Reported by: teamhydro55555 at gmail dot com Summary: Wrapping operators in <em> leads to confusion Status: Open Type: Documentation Problem Package: Doc Build problem PHP Version: Irrelevant Block user comment: N Private report: N New Comment: 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. Previous Comments: ------------------------------------------------------------------------ [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. ------------------------------------------------------------------------ [2015-10-05 10:17:03] 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 / ------------------------------------------------------------------------ -- Edit this bug report at https://bugs.php.net/bug.php?id=70640&edit=1

« previous php.doc.bugs (#12801) next »