PHPDoc parsing too restrictive?

[Yannick-18]

Hi again,

Apparently, the parsing of the PHPDoc comments is so severe that if I
use:

/**
 * This library provides functions for user management.
 * it in your code to use its functionality.
 *
 * @service
 * @binding.soap
*
*/

it won't work, but if I add one space before the star on the line
before the last, then it works:

/**
 * This library provides functions for user management.
 * it in your code to use its functionality.
 *
 * @service
 * @binding.soap
 *
*/

However, the last line (the closing tag) works, with or without space.
I haven't found any documentation about this, but it sure takes some
time to figure out! (and error reporting is un-existing about that
one)

Isn't this a little too restrictive for a package that is supposed to
provide a simple mechanism of re-use of existing functions?

Yannick
--~--~---------~--~----~------------~-------~--~----~
You received this message because you are subscribed to the Google Groups "phpsoa" group.
To post to this group, send email to phpsoa@...
To unsubscribe from this group, send email to phpsoa-unsubscribe@...
For more options, visit this group at http://groups.google.co.uk/group/phpsoa?hl=en
-~----------~----~----~----~------~----~------~--~---

[Matthew Peters-3]

Hi Yannick, that's really bad! You could spend hours hunting that down
and then you would really hate SCA at the end of it. I don't know what
causes that but I totally agree that it should be fixed. One of the
package owners will get to it in due course, or of course anyone is
free to sign the CLA and submit a patch.

Matthew

On Jul 28, 2:52 am, Yannick <ywarn...@...> wrote:

> Hi again,
>
> Apparently, the parsing of the PHPDoc comments is so severe that if I
> use:
>
> /**
>  * This library provides functions for user management.
>  * it in your code to use its functionality.
>  *
>  * @service
>  * @binding.soap
> *
> */
>
> it won't work, but if I add one space before the star on the line
> before the last, then it works:
>
> /**
>  * This library provides functions for user management.
>  * it in your code to use its functionality.
>  *
>  * @service
>  * @binding.soap
>  *
> */
>
> However, the last line (the closing tag) works, with or without space.
> I haven't found any documentation about this, but it sure takes some
> time to figure out! (and error reporting is un-existing about that
> one)
>
> Isn't this a little too restrictive for a package that is supposed to
> provide a simple mechanism of re-use of existing functions?
>
> Yannick

--~--~---------~--~----~------------~-------~--~----~
You received this message because you are subscribed to the Google Groups "phpsoa" group.
To post to this group, send email to phpsoa@...
To unsubscribe from this group, send email to phpsoa-unsubscribe@...
For more options, visit this group at http://groups.google.co.uk/group/phpsoa?hl=en
-~----------~----~----~----~------~----~------~--~---

[Yannick-18]

What's the CLA?

On 29 juil, 05:07, Matthew Peters <matthew.f.pet...@...>
wrote:

> Hi Yannick, that's really bad! You could spend hours hunting that down
> and then you would really hate SCA at the end of it. I don't know what
> causes that but I totally agree that it should be fixed. One of the
> package owners will get to it in due course, or of course anyone is
> free to sign the CLA and submit a patch.
>
> Matthew
>
> On Jul 28, 2:52 am, Yannick <ywarn...@...> wrote:
>
> > Hi again,
>
> > Apparently, the parsing of the PHPDoc comments is so severe that if I
> > use:
>
> > /**
> >  * This library provides functions for user management.
> >  * it in your code to use its functionality.
> >  *
> >  * @service
> >  * @binding.soap
> > *
> > */
>
> > it won't work, but if I add one space before the star on the line
> > before the last, then it works:
>
> > /**
> >  * This library provides functions for user management.
> >  * it in your code to use its functionality.
> >  *
> >  * @service
> >  * @binding.soap
> >  *
> > */
>
> > However, the last line (the closing tag) works, with or without space.
> > I haven't found any documentation about this, but it sure takes some
> > time to figure out! (and error reporting is un-existing about that
> > one)
>
> > Isn't this a little too restrictive for a package that is supposed to
> > provide a simple mechanism of re-use of existing functions?
>
> > Yannick

--~--~---------~--~----~------------~-------~--~----~
You received this message because you are subscribed to the Google Groups "phpsoa" group.
To post to this group, send email to phpsoa@...
To unsubscribe from this group, send email to phpsoa+unsubscribe@...
For more options, visit this group at http://groups.google.co.uk/group/phpsoa?hl=en
-~----------~----~----~----~------~----~------~--~---

[Graham Charters-2]

Hi Yannick,

The CLA is a Contributors License Agreement.  The one we have in place
for SCA_SDO is derived from the CLA which covers contributions to the
Apache projects.  It's contained in the SCA_SDO distribution and is a
text document called "CLA".  We are only able to include contributions
to the project from people who have signed the CLA.

Regards, Graham.

On 30 Jul, 04:10, Yannick <ywarn...@...> wrote:

> What's the CLA?
>
> On 29 juil, 05:07, Matthew Peters <matthew.f.pet...@...>
> wrote:
>
> > Hi Yannick, that's really bad! You could spend hours hunting that down
> > and then you would really hate SCA at the end of it. I don't know what
> > causes that but I totally agree that it should be fixed. One of the
> > package owners will get to it in due course, or of course anyone is
> > free to sign the CLA and submit a patch.
>
> > Matthew
>
> > On Jul 28, 2:52 am, Yannick <ywarn...@...> wrote:
>
> > > Hi again,
>
> > > Apparently, the parsing of the PHPDoc comments is so severe that if I
> > > use:
>
> > > /**
> > >  * This library provides functions for user management.
> > >  * it in your code to use its functionality.
> > >  *
> > >  * @service
> > >  * @binding.soap
> > > *
> > > */
>
> > > it won't work, but if I add one space before the star on the line
> > > before the last, then it works:
>
> > > /**
> > >  * This library provides functions for user management.
> > >  * it in your code to use its functionality.
> > >  *
> > >  * @service
> > >  * @binding.soap
> > >  *
> > > */
>
> > > However, the last line (the closing tag) works, with or without space.
> > > I haven't found any documentation about this, but it sure takes some
> > > time to figure out! (and error reporting is un-existing about that
> > > one)
>
> > > Isn't this a little too restrictive for a package that is supposed to
> > > provide a simple mechanism of re-use of existing functions?
>
> > > Yannick

--~--~---------~--~----~------------~-------~--~----~
You received this message because you are subscribed to the Google Groups "phpsoa" group.
To post to this group, send email to phpsoa@...
To unsubscribe from this group, send email to phpsoa+unsubscribe@...
For more options, visit this group at http://groups.google.co.uk/group/phpsoa?hl=en
-~----------~----~----~----~------~----~------~--~---