Re: incorrect sentence in online doc

From: 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

« previous php.webmaster (#6450) next »