Req #73051 [Opn]: Improve misleading <literal> markup
| From: | kalle@php.net | Date: | Thu, 22 Sep 2016 16:30:48 +0000 |
| Subject: | Req #73051 [Opn]: Improve misleading <literal> markup | ||
| References: | 1 | Groups: | php.webmaster |
| Request: | Send a blank email to php-webmaster+get-25156@lists.php.net to get a copy of this message | ||
Edit report at https://bugs.php.net/bug.php?id=73051&edit=1
ID: 73051
Updated by: kalle@php.net
Reported by: cmb@php.net
Summary: Improve misleading <literal> markup
Status: Open
Type: Feature/Change Request
Package: Website problem
Operating System: *
PHP Version: Irrelevant
Block user comment: N
Private report: N
New Comment:
What about a monospace font like Consolas or something?
Previous Comments:
------------------------------------------------------------------------
[2016-09-09 00:36:44] cmb@php.net
Description:
------------
I've just rejected a PhDOE submission for the German
file_put_contents() man page:
> - Der Wert von <parameter>flags</parameter> kann eine Kombination der folgenden
> Flags sein, verbunden mit dem binären OR(<literal>|</literal>)
> + Der Wert von <parameter>flags</parameter> kann eine Kombination der folgenden
> Flags sein, verbunden mit dem binären OR(|)
Obviously, the issue is that
| looks like / in italics, what
is confusing. Therefore I suggest to style <literals> differently;
a non-proportional font might be better anyway, and perhaps a
(slightly) different background color would also be appropriate.
------------------------------------------------------------------------
--
Edit this bug report at https://bugs.php.net/bug.php?id=73051&edit=1