[DOC-BUGS] Doc #81547 [Com]: print documentation section Documentation is contradictory

[email protected] ("blogaccess07 at gmail dot com") Mon, 06 May 2024 11:54:49 +0000
Newsgroups php.doc.bugs
Message-ID <[email protected]>
Edit report at https://bugs.php.net/bug.php?id=81547&edit=1

 ID:                 81547
 Comment by:         blogaccess07 at gmail dot com
 Reported by:        ddpm at liscovius dot de
 Summary:            print documentation section Documentation is
                     contradictory
 Status:             Open
 Type:               Documentation Problem
 Package:            Documentation problem
 PHP Version:        Irrelevant
 Block user comment: N
 Private report:     N

 New Comment:

Nice post! We do our best to stay compliant. We don't need issues.


(https://github.com/php/php-src/blob/php-8.1.0/NEWS)(https://www.myaccountaccess.run/)


Previous Comments:
------------------------------------------------------------------------
[2024-04-24 09:15:59] dgme dot life at gmail dot com

thanks


(https://github.com/php/php-src/blob/php-8.1.0/NEWS)(https://www.dgme.run/)

------------------------------------------------------------------------
[2024-04-23 12:45:28] dgme dot life at gmail dot com

The blog was absolutely fantastic! Thank you for sharing this.It is worth reading for everyone. Very informative article. Keep it up.


(https://github.com/php/php-src/blob/php-8.1.0/NEWS)(https://www.dgme.run/)

------------------------------------------------------------------------
[2023-04-20 08:56:22] simona at myaccountaccess dot onl

Thanks for that. (https://www.myaccountaccess.onl/)github.com

------------------------------------------------------------------------
[2022-12-09 06:28:14] amin dot jadabari242 at gmail dot com

Thanks for that. (https://www.myaccountaccess.one/)github.com

------------------------------------------------------------------------
[2021-11-03 13:08:37] [email protected]

To my knowledge, DocBook has no special support for language
constructs (except maybe for EBNF, but that's a different story);
this is why our existing documentation for language constructs[1]
is suboptimal.  For print, and other language constructs which are
somewhat function-like, it makes probably still sense to document
these as functions.  If we want to get rid of the parentheses in
the synopses, this could be accomplished by adding some attribute
and to adapt PhD[2] accordingly.  However, it is not clear what to
do with the return values, and whether it's worth working on this
at all.

[1] <https://www.php.net/manual/en/language.control-structures.php>
[2] <https://github.com/php/phd>

------------------------------------------------------------------------


The remainder of the comments for this report are too long. To view
the rest of the comments, please view the bug report online at

    https://bugs.php.net/bug.php?id=81547


--
Edit this bug report at https://bugs.php.net/bug.php?id=81547&edit=1