Re: incorrect sentence in online doc
| From: | Richard Quadling | Date: | Tue, 10 Nov 2009 10:14:35 +0000 |
| Subject: | Re: incorrect sentence in online doc | ||
| References: | 1 | Groups: | php.webmaster |
| Request: | Send a blank email to php-webmaster+get-6450@lists.php.net to get a copy of this message | ||
2009/11/10 Jeffrey Gonzales <jeffrey@dpinfo.fr>:
> Hello,
>
> I've come across an incorrect sentence in the online documentation (or what
> appears to be an incorrect sentence to me) and I'm not sure who I should
> report it to.
>
> Here's the incorrect sentence (2009-11-10 09:56 - time in Paris) :
> "Nowdocs are to single-quoted strings what heredocs are to double-quoted
> strings." link
>
> <http://fr2.php.net/manual/en/language.types.string.php#language.types.string.syntax.nowdoc>
>
> Here's my suggestion :
> "Nowdocs are to heredocs what single-quoted strings are to double-quoted
> strings."
>
> Here's an analogy to understand better :
> Incorrect : "Eagles are to cats what cubs are to mice."
> Correct : "Eagles are to cubs what cats are to mice."
>
> The same goes for the French translation :
> Incorrect : "Nowdoc est aux chaînes entourées de guillemet simple ce
> qu'Heredoc est aux chaînes entourées de guillemet double." link
>
> <http://fr2.php.net/manual/fr/language.types.string.php#language.types.string.syntax.nowdoc>
>
> Suggestion : "Nowdoc est à Heredoc ce que les chaînes entourées de
> guillemets simples sont aux chaînes entourées de guillemets doubles."
>
> It's been months that this sentence has been like that so I hope this
> suggestion can benefit the php community as much as it helped me.
>
> Thanks for all the hard work :-)
> Jeffrey
>
I don't think this requires changing.
Analogies are A to B as C to D. A and C and B and D are the similar entities.
Haggis is to Scotland as Caviar is to Russia.
Haggis/Caviar => Nowdoc/Heredoc
Scotland/Russia => SingleQuote/DoubleQuote
All works for me.
Richard
--
-----
Richard Quadling
"Standing on the shoulders of some very clever giants!"
EE : http://www.experts-exchange.com/M_248814.html
Zend Certified Engineer : http://zend.com/zce.php?c=ZEND002498&r=213474731
ZOPA : http://uk.zopa.com/member/RQuadling