[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