Function trailing commas

[Crell]

• Trailing commas in function parameter list.
• Trailing commas in use clause.
• Minor language change along the way.
• I have no idea what the difference is between para and simplepara...

[Girgias]

I feel how this comment is written it means that prior to PHP 8.0.0 the trailing comma was mandatory

[cmb69]

<simpara> is somewhat like a HTML <p>, but <para> is more like a <div>. See https://tdg.docbook.org/tdg/4.5/para.html#d0e133584 for a more specific explanation.

That said, I think that currently PhD treats both pretty similar, and in practise, the documentation mostly uses <para>.

[Girgias]

<simpara> is somewhat like a HTML <p>, but <para> is more like a <div>. See https://tdg.docbook.org/tdg/4.5/para.html#d0e133584 for a more specific explanation.

That said, I think that currently PhD treats both pretty similar, and in practise, the documentation mostly uses <para>.

I think the only important distinction is when it's inside a <note>, <warning>, etc. element. With a simpara you'll get something like:

Note: simpara content

whereas with a para you get:

Note:

Para content

[Crell]

Updated the comment.

[Girgias]

LGTM :)

[cmb69]

Thanks!

It seems that the manual is generally sloppy regarding the term "argument", so I left it as is, but in the long run we may consider to distinguish between "parameter" and "argument" (or "formal parameter" and "actual parameter").

[Crell]

What even is the difference between an argument and a parameter? I've generally seen/used them interchangeably.

[cmb69]

See https://stackoverflow.com/questions/156767/whats-the-difference-between-an-argument-and-a-parameter

[Girgias]

Huh, I've been getting the proper order wrong then apparently, oh well TIL