RE: [PHP-DOC] Contractions in the English PHP Documentation and supporting scripts/files.
| From: | Richard A. Quadling | Date: | Wed, 05 Jul 2006 11:58:38 +0000 |
| Subject: | RE: [PHP-DOC] Contractions in the English PHP Documentation and supporting scripts/files. | ||
| Groups: | php.doc | ||
| Request: | Send a blank email to phpdoc+get-969373454@lists.php.net to get a copy of this message | ||
The only reason I said about the contractions is that the patch done by
Horst removed one. Not sure why.
As for the regex, I can see nothing wrong with it!
preg_match("!^(.+)<hr>!s", $content, $_index1);
This says capture everything in from the beginning of the text to just
in front of <hr>. Easy. But no output!
This is the current code ...
// Make the old index look somewhat better
function newIndex ($content)
{
global $HTML_TARGET;
// Get contents we need to build the _index.html file
preg_match("!^(.+)<hr>!s", $content, $_index1);
preg_match("!</div></div>(<a
id=\"user_notes\">.+</html>)!s",
$content, $_index2);
// Write out the two components to form a complete file
$fp = fopen("$HTML_TARGET/_index.html", "w");
fwrite($fp, $_index1[1] . $_index2[1]);
fclose($fp);
...
}
I'm using ...
// Make the old index look somewhat better
function newIndex ($content)
{
global $HTML_TARGET;
file_put_contents('/captured_content.html', 'Captured at ' .
date('r') . "\n$content\n\n", FILE_APPEND);
// Get contents we need to build the _index.html file
preg_match("!^(.+)<hr>!s", $content, $_index1);
preg_match("!</div></div>(<a
id=\"user_notes\">.+</html>)!s",
$content, $_index2);
file_put_contents('/captured_content.html', var_export($_index1,
True) . "\n" . var_export($index_2, True) , FILE_APPEND);
// Write out the two components to form a complete file
$fp = fopen("$HTML_TARGET/_index.html", "w");
fwrite($fp, $_index1[1] . $_index2[1]);
fclose($fp);
...
}
To capture the $content and the output of $index_1 and $index_2.
I'm doing a complete rebuild, so will take a couple of hours to get the
file out.
Richard.
-----Original Message-----
From: Nuno Lopes [mailto:nlopess@php.net]
Sent: 05 July 2006 12:48
To: phpdoc@lists.php.net; Richard Quadling
Subject: Re: [PHP-DOC] Contractions in the English PHP Documentation and
supporting scripts/files.
No way!!!!
We cannot start breaking translators' work. Anyway, what's the problem
with contractions? When I studied English (British) I learned that
contractions weren't so formal, but they aren't wrong per se.
Any English native speaker correct me if I'm wrong.
But thanks for your offer, Richard.
Nuno
P.S.: offtopic: Richard: I cannot fix your bug with xchm manual because
my laptop got broken, unless you can send me the index.html file before
processing by the scripts, so that I can try to tune the regex.
----- Original Message -----
> OOI, should all contractions be removed?
>
> I did a quick check on the entire phpdoc/en directory.
>
> Looking for aren't, can't, shouldn't, won't and wouldn't.
>
> Found 167 occurrences.
>
> Increased that to the entire phpdoc directory and got 362.
>
> I can easily correct the phpdoc/en ones and provide a patch.
>
> Should I?
>
> And what about the other files
>
> Regards,
>
> Richard Quadling.
>
>
> Horst Schirmeier wrote:
>> - and what the returned value may look like. Statements that aren't
>> listed - will return &false;
>> + and what the returned value may look like. Statements that are
>> + not
>> listed + will return &false;.
>> </para>
>> </refsect1>