Skip to content

Conversation

@simPod
Copy link

@simPod simPod commented Mar 7, 2020

This is a reaction to php/doc-en#55

Allows to properly render:

  • arguments
  • arguments by reference
  • varible-length argument lists
  • varible-length argument lists passed by reference

It will also require changes (see below) in docs repository (I will send PR) but did not find a non-BC breaking way because:

  • params in docs are currently named as ...
  • the param name build is performed as <tag>$ + param_name resulting in <tag>$param_name
  • however, that does not work for variadic args as we need ...$args instead of $...args

Current:

<methodparam choice="opt">
    <type>bool|float|int|string</type>
    <parameter>...</parameter>
</methodparam>

sprintf ( string $format [, mixed $... ] ) : string

This PR allows:

<methodparam choice="opt">
    <type>bool|float|int|string</type>
    <parameter role="vararglist">args</parameter>
</methodparam>

sprintf ( string $format [, mixed ...$args ] ) : string

Allow to properly render:
- arguments
- arguments by reference
- varible-length argument lists
- varible-length argument lists passed by reference
@cmb69
Copy link
Member

cmb69 commented Oct 17, 2020

Oh, I haven't seen this PR before. From what I can tell, this is basically the same as PR #28, while potentially #29 would be preferable.

@simPod
Copy link
Author

simPod commented Oct 17, 2020

Kk let's proceed there

@cmb69
Copy link
Member

cmb69 commented Nov 2, 2020

PR #29 has just been merged; it seems to me this PR is now obsolete. However, we may need to port the changes to other renderers, although I'm not sure whether these are still used at all.

@simPod simPod closed this by deleting the head repository Mar 23, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants