Doc #61560 [Opn->Csd]: user note to remove: Pointless, Confusing, Already stated & probably inaccurate

From: Date: Fri, 30 Mar 2012 00:20:52 +0000
Subject: Doc #61560 [Opn->Csd]: user note to remove: Pointless, Confusing, Already stated & probably inaccurate
References: 1  Groups: php.doc.bugs 
Request: Send a blank email to doc-bugs+get-8134@lists.php.net to get a copy of this message
Edit report at https://bugs.php.net/bug.php?id=61560&edit=1 ID: 61560 Updated by: aharvey@php.net Reported by: Ultimater at gmail dot com Summary: user note to remove: Pointless, Confusing, Already stated & probably inaccurate -Status: Open +Status: Closed Type: Documentation Problem Package: Documentation problem PHP Version: Irrelevant -Assigned To: +Assigned To: aharvey Block user comment: N Private report: N New Comment: Sorted, thanks. Previous Comments: ------------------------------------------------------------------------ [2012-03-30 00:18:21] Ultimater at gmail dot com Description: ------------ I'd like to bring to your attention the following post: http://www.php.net/manual/en/function.halt-compiler.php#105994 Not only is this comment very confusing, it only appears to be re-stating what the manual already stated. Their code snippet is not helpful at all since it does nothing but merely show how the __halt_compiler() language construct works. To make matters worse, their PHP comment: "at this point, PHP interprets stuff with waiting for rest" uses terrible grammar. I can't for the life of me make heads or tails of what the poster meant to say. Their opening line is a run-on that uses terrible coding terminology. It will confuse many since it makes close to no sense at all to begin with. It attempts to point something out that the manual already states and its a waste of space and everyone's time. Even if you could find some merit in this post, I wouldn't consider the poster very reliable in the least judging from his or her poor code terminology and snippet. Do us all a favor and just delete it. ------------------------------------------------------------------------ -- Edit this bug report at https://bugs.php.net/bug.php?id=61560&edit=1

« previous php.doc.bugs (#8134) next »