L PROTECTED]>
To: "James Moore" <[EMAIL PROTECTED]>
Cc: "'Lars Torben Wilson'" <[EMAIL PROTECTED]>; "'Daniel Beckham'"
<[EMAIL PROTECTED]>; "'phpdoc'" <[EMAIL PROTECTED]>
Sent: Monday, May 21, 2001 4:04 AM
["James Moore" <[EMAIL PROTECTED]>]
> > > bad: Foo() does bar;
> > > good: The function foo() does bar.
> > >
> > > Daniel
> >
> > I agree with your second assertion. I could see a lot of
> > users getting confused if the first were followed blindly,
> > though (say, if one was documenting C).
Wilson'" <[EMAIL PROTECTED]>; "'Daniel Beckham'"
<[EMAIL PROTECTED]>
Cc: "'phpdoc'" <[EMAIL PROTECTED]>
Sent: Sunday, May 20, 2001 6:08 PM
Subject: RE: [PHP-DOC] Function References not showing up in docs for mixed
case function na
James Moore writes:
>
> > > bad: Foo() does bar;
> > > good: The function foo() does bar.
> > >
> > > Daniel
> >
> > I agree with your second assertion. I could see a lot of
> > users getting confused if the first were followed blindly,
> > though (say, if one was documenting C). Which is one
> > bad: Foo() does bar;
> > good: The function foo() does bar.
> >
> > Daniel
>
> I agree with your second assertion. I could see a lot of
> users getting confused if the first were followed blindly,
> though (say, if one was documenting C). Which is one reason
> (besides style) why I agree
> - Original Message -
> From: "Lars Torben Wilson" <[EMAIL PROTECTED]>
> Newsgroups: php.doc
> To: <[EMAIL PROTECTED]>
> Cc: <[EMAIL PROTECTED]>
> Sent: Sunday, May 20, 2001 7:09 AM
> Subject: Re: [PHP-DOC] Function References not showing up in docs
[EMAIL PROTECTED] writes:
> On Sun, May 20, 2001 at 02:56:31AM -0700, Lars Torben Wilson wrote:
>
> > To be honest, I've never noticed this problem before, and I've been
> > working on the manual for 3 years. But then, I always use lowercase
> > for function names so I wouldn't necessarily have c
Egon wrote:
> Some years ago there have been disscusions and there have recently beens
> some discussions to make the function names more user friendly. I have
> made the suggestion to make function names with underscores and not with
> capitalized letters. I mean the function name ImageCopyResi
aniel
- Original Message -
From: "Hojtsy Gabor" <[EMAIL PROTECTED]>
To: "Daniel Beckham" <[EMAIL PROTECTED]>; "phpdoc" <[EMAIL PROTECTED]>
Sent: Sunday, May 20, 2001 3:19 PM
Subject: Re: [PHP-DOC] Function References not showing up in docs for mix
[EMAIL PROTECTED] writes:
> > I took a quick look through the DSSSL before I committed the patch
> > which lowercased the Hyperwave tags a couple of days ago,
> > and it looked as though case-folding was intended, as did the XSL
> > stylesheet. I haven't had time to look up the syntax used and I'
On Sun, May 20, 2001 at 03:18:26PM -0500, Daniel Beckham wrote:
> > This problem with the functions names have been discussed several times.
> > Look at the mysql_*() functions, there is everything ok. Zeev made aliases
> > so we have now easy functions name which can be rememberd by any average
> It took me a few minutes to understand what you were saying, but I see now
> that you mean that it's difficult to read those long function names in
code.
> What does it take to add aliases for these functions? Is having this many
> function aliases ok with the development team, etc.? If this i
CTED]>
Sent: Sunday, May 20, 2001 1:23 PM
Subject: Re: [PHP-DOC] Function References not showing up in docs for mixed
case function names
> This problem with the functions names have been discussed several times.
> Look at the mysql_*() functions, there is everything ok. Zeev made aliases
On Sun, May 20, 2001 at 02:56:31AM -0700, Lars Torben Wilson wrote:
> To be honest, I've never noticed this problem before, and I've been
> working on the manual for 3 years. But then, I always use lowercase
> for function names so I wouldn't necessarily have clued in before
> now. :)
Add 2 year
On Sun, May 20, 2001 at 02:56:31AM -0700, Lars Torben Wilson wrote:
> Hojtsy Gabor writes:
> > > by Daniel:
> > > I would propose that a phpdoc wide change be made so that all functions
> > are
> > > written in lowercase form. It's not necessary to have them in a mixed
> > case
> > > created on t
- Original Message -
From: "Lars Torben Wilson" <[EMAIL PROTECTED]>
Newsgroups: php.doc
To: <[EMAIL PROTECTED]>
Cc: <[EMAIL PROTECTED]>
Sent: Sunday, May 20, 2001 7:09 AM
Subject: Re: [PHP-DOC] Function References not showing up in docs for mixed
case function names
>
Subject: Re: [PHP-DOC] Function References not showing up in docs for mixed
case function names
> > > XML *IS* case sensitive, and we use XML to make the docs.
> > > So I think we should be XML compatible with function names too.
> >
> > True, but the tool used to docume
Hojtsy Gabor" <[EMAIL PROTECTED]>
Cc: "Daniel Beckham" <[EMAIL PROTECTED]>; "phpdoc"
<[EMAIL PROTECTED]>; <[EMAIL PROTECTED]>
Sent: Sunday, May 20, 2001 4:56 AM
Subject: Re: [PHP-DOC] Function References not showing up in docs for mixed
case function
[EMAIL PROTECTED] writes:
> > > XML *IS* case sensitive, and we use XML to make the docs.
> > > So I think we should be XML compatible with function names too.
> >
> > True, but the tool used to document another tool should not define
> > what is presented to the reader. :)
>
> I agree, but for a
> > XML *IS* case sensitive, and we use XML to make the docs.
> > So I think we should be XML compatible with function names too.
>
> True, but the tool used to document another tool should not define
> what is presented to the reader. :)
I agree, but for a little consistance it would still be a
Hojtsy Gabor writes:
> > by Daniel:
> > I would propose that a phpdoc wide change be made so that all functions
> are
> > written in lowercase form. It's not necessary to have them in a mixed
> case
> > created on the author's whim.
>
> > by Jeroen:
> >
> > function-names are NOT case-sensitive
> by Daniel:
>
> Actually, I think that having function names in anything but lower case
only
> makes the manual less consistant and could even confuse new comers by
> possibly making them think that certain functions that are written a
certain
> way in the docs (ala pdflib) must be written that w
IL PROTECTED]>
Sent: Saturday, May 19, 2001 5:10 PM
Subject: Re: [PHP-DOC] Function References not showing up in docs for mixed
case function names
> > Linking is case sensitive. You should use lowercase
> > names to have links.
>
> function-names are NOT case-sensitiv
How about the issue by the way? I haven't seen anything in
CVS yet... Or did you beam it straight to me?
Jeroen
[EMAIL PROTECTED] wrote:
>
> > Linking is case sensitive. You should use lowercase
> > names to have links.
>
> function-names are NOT case-sensitive in PHP itself... so why not change the
> stylesheets or something so that it is NOT case-sensitive in the docs
> either?
>
> We've got an excelle
> Linking is case sensitive. You should use lowercase
> names to have links.
function-names are NOT case-sensitive in PHP itself... so why not change the
stylesheets or something so that it is NOT case-sensitive in the docs
either?
We've got an excellent DSSSL-fu'er over here :), maybe he or som
> This is strange, for some reason, function references in the PDF section
are
> not working. It only bolds the function name, but does not link it to the
> actual html document. I also checked the functions in the Graphics
section
> and some of the links are working, some are not. It appears th
This is strange, for some reason, function references in the PDF section are
not working. It only bolds the function name, but does not link it to the
actual html document. I also checked the functions in the Graphics section
and some of the links are working, some are not. It appears the differ
28 matches
Mail list logo