From:             hugorumens at yahoo dot com
Operating system: WinXP
PHP version:      Irrelevant
PHP Bug Type:     Documentation problem
Bug description:  Heredoc syntax documentation incorrect?

Description:
------------
Regarding this page:
http://uk.php.net/manual/en/language.types.string.php#language.types.string.syntax.heredoc

The first sentence reads:

"Another way to delimit strings is by using heredoc syntax ("<<<"). One
should provide an identifier after <<<, then the string, and then the same
identifier to close the quotation."

Surely this should read, for example:

"...One should provide an identifier after <<<, followed by a newline
character, then the string..."

The same situation as described for the closing identifier is needed for
the opening, that of a newline char, else a
parse error occurs. This is not clear in the docs as is.

Secondly:

Are the references to "except possibly a semicolon (;)" correct? A
semicolon is absolutely needed after the closing identifier to avoid a
parse error.

Thanks.



Reproduce code:
---------------
<?php

$somevar = <<<ABC
This is my string that HAS to start on this newline.
If the word 'This' was on the same line as the ABC
identifier, I'd get a parse error.
The semicolon after my closing identifier is absolutely
needed.
ABC;
?>


-- 
Edit bug report at http://bugs.php.net/?id=40283&edit=1
-- 
Try a CVS snapshot (PHP 4.4): 
http://bugs.php.net/fix.php?id=40283&r=trysnapshot44
Try a CVS snapshot (PHP 5.2): 
http://bugs.php.net/fix.php?id=40283&r=trysnapshot52
Try a CVS snapshot (PHP 6.0): 
http://bugs.php.net/fix.php?id=40283&r=trysnapshot60
Fixed in CVS:                 http://bugs.php.net/fix.php?id=40283&r=fixedcvs
Fixed in release:             
http://bugs.php.net/fix.php?id=40283&r=alreadyfixed
Need backtrace:               http://bugs.php.net/fix.php?id=40283&r=needtrace
Need Reproduce Script:        http://bugs.php.net/fix.php?id=40283&r=needscript
Try newer version:            http://bugs.php.net/fix.php?id=40283&r=oldversion
Not developer issue:          http://bugs.php.net/fix.php?id=40283&r=support
Expected behavior:            http://bugs.php.net/fix.php?id=40283&r=notwrong
Not enough info:              
http://bugs.php.net/fix.php?id=40283&r=notenoughinfo
Submitted twice:              
http://bugs.php.net/fix.php?id=40283&r=submittedtwice
register_globals:             http://bugs.php.net/fix.php?id=40283&r=globals
PHP 3 support discontinued:   http://bugs.php.net/fix.php?id=40283&r=php3
Daylight Savings:             http://bugs.php.net/fix.php?id=40283&r=dst
IIS Stability:                http://bugs.php.net/fix.php?id=40283&r=isapi
Install GNU Sed:              http://bugs.php.net/fix.php?id=40283&r=gnused
Floating point limitations:   http://bugs.php.net/fix.php?id=40283&r=float
No Zend Extensions:           http://bugs.php.net/fix.php?id=40283&r=nozend
MySQL Configuration Error:    http://bugs.php.net/fix.php?id=40283&r=mysqlcfg

Reply via email to