php.net |  support |  documentation |  report a bug |  advanced search |  search howto |  statistics |  random bug |  login

go to bug id or search bugs for

Request #73051 Improve misleading <literal> markup
Submitted: 2016-09-09 00:36 UTC Modified: 2020-04-09 09:53 UTC
From: cmb@php.net Assigned: cmb (profile)
Status: Duplicate Package: Website problem
PHP Version: Irrelevant OS: *
Private report: No CVE-ID: None
View Developer Edit
 [2016-09-09 00:36 UTC] 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.

Patches

Pull Requests

History

AllCommentsChangesGit/SVN commitsRelated reports
 [2016-09-22 16:30 UTC] kalle@php.net 
What about a monospace font like Consolas or something?
 [2016-09-22 17:43 UTC] cmb@php.net 
> What about a monospace font like Consolas or something?

That would be fine.
 [2020-04-09 09:53 UTC] cmb@php.net
-Status: Open +Status: Duplicate -Assigned To: +Assigned To: cmb
 [2020-04-09 09:53 UTC] cmb@php.net 
Closing as duplicate of bug #79133.
 
PHP Copyright © 2001-2025 The PHP Group
All rights reserved. 		Last updated: Tue Feb 18 23:01:29 2025 UTC