RE: [PHP] Documentation

2010-10-28 Thread Jay Blanchard
[snip]...[/snip]

http://evolt.org/node/21173

This is an article that I wrote long ago (it needs some severe updating)
that speaks to a lot of the phases of documentation. Any application
typically has several audiences; developers, administrators, supporters
and users are just an example of the audiences that can be involved.
Each audience requires their own unique set of documentation. Hope this
helps. 

--
PHP General Mailing List (http://www.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php



Re: [PHP] Documentation

2010-10-27 Thread Rico Secada
On Wed, 27 Oct 2010 10:52:58 +0200
Jordan Jovanov  wrote:

> Hello All,
> 
> I finished with coding and now I am on the part when need to write 
> documentation. But I don't know how to write correct documentation.
> Does have some rules or standard for writing documentation for PHP?
> Or maybe have some programs for writing documentations?

You should consider who is going to read the documentation. Are we
talking about end users and/or other coders?

Other coders benefit from code comments and as some suggests
phpDocumentor has some nice features if you want to automate some of it.

End users on the other hand need hand written documentation and in most
cases non-technical explanations.

> Best Regards,
> Jordan JOVANOV
> 
> -- 
> PHP General Mailing List (http://www.php.net/)
> To unsubscribe, visit: http://www.php.net/unsub.php
> 

-- 
PHP General Mailing List (http://www.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php



Re: [PHP] Documentation

2010-10-27 Thread Teto
On Wed, Oct 27, 2010 at 2:20 PM, Nicholas Kell wrote:

>
> On Oct 27, 2010, at 4:09 AM, Tommy Pham wrote:
>
> >> -Original Message-
> >> From: Jordan Jovanov [mailto:jovanovj...@gmail.com]
> >> Sent: Wednesday, October 27, 2010 1:53 AM
> >> To: php-general@lists.php.net
> >> Subject: [PHP] Documentation
> >>
> >> Hello All,
> >>
> >> I finished with coding and now I am on the part when need to write
> >> documentation. But I don't know how to write correct documentation.
> >> Does have some rules or standard for writing documentation for PHP?
> >> Or maybe have some programs for writing documentations?
> >>
> >> Best Regards,
> >> Jordan JOVANOV
> >>
> >
> > Jordan,
> >
> > I believe the standard is still phpdoc.org.  If you're on Windows and
> use
> > phpDesigner, it has a nice built-in phpDocumentor to cover your basic
> > documentation.  I don't know about other IDEs.
> >
> > Regards,
> > Tommy
> >
> >
> > --
> > PHP General Mailing List (http://www.php.net/)
> > To unsubscribe, visit: http://www.php.net/unsub.php
> >
>
>
> As for IDE's I have used Netbeans. It autocompletes some of the function
> headers for you as soon as you enter /** and hit enter, when directly above
> a function, method or class. The things that it will autocomplete for you
> are: params with names, and an @return if a return statement is present.
>
> After I use NB for putting in headers I usually use phpdoc as mentioned.
> Aptana has PHPDoc built into it.
> --
> PHP General Mailing List (http://www.php.net/)
> To unsubscribe, visit: http://www.php.net/unsub.php
>
> I use doxygen with eclipse. Eclipse fills automatically some fields like
netbeans. Doxygen is easy to use with the GUI and once you learned to use
it, you can use it for java,C++ etc...


Re: [PHP] Documentation

2010-10-27 Thread Nicholas Kell

On Oct 27, 2010, at 4:09 AM, Tommy Pham wrote:

>> -Original Message-
>> From: Jordan Jovanov [mailto:jovanovj...@gmail.com]
>> Sent: Wednesday, October 27, 2010 1:53 AM
>> To: php-general@lists.php.net
>> Subject: [PHP] Documentation
>> 
>> Hello All,
>> 
>> I finished with coding and now I am on the part when need to write
>> documentation. But I don't know how to write correct documentation.
>> Does have some rules or standard for writing documentation for PHP?
>> Or maybe have some programs for writing documentations?
>> 
>> Best Regards,
>> Jordan JOVANOV
>> 
> 
> Jordan,
> 
> I believe the standard is still phpdoc.org.  If you're on Windows and use
> phpDesigner, it has a nice built-in phpDocumentor to cover your basic
> documentation.  I don't know about other IDEs.
> 
> Regards,
> Tommy
> 
> 
> -- 
> PHP General Mailing List (http://www.php.net/)
> To unsubscribe, visit: http://www.php.net/unsub.php
> 


As for IDE's I have used Netbeans. It autocompletes some of the function 
headers for you as soon as you enter /** and hit enter, when directly above a 
function, method or class. The things that it will autocomplete for you are: 
params with names, and an @return if a return statement is present.

After I use NB for putting in headers I usually use phpdoc as mentioned. Aptana 
has PHPDoc built into it.
--
PHP General Mailing List (http://www.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php



RE: [PHP] Documentation

2010-10-27 Thread Tommy Pham
> -Original Message-
> From: Jordan Jovanov [mailto:jovanovj...@gmail.com]
> Sent: Wednesday, October 27, 2010 1:53 AM
> To: php-general@lists.php.net
> Subject: [PHP] Documentation
> 
> Hello All,
> 
> I finished with coding and now I am on the part when need to write
> documentation. But I don't know how to write correct documentation.
> Does have some rules or standard for writing documentation for PHP?
> Or maybe have some programs for writing documentations?
> 
> Best Regards,
> Jordan JOVANOV
> 

Jordan,

I believe the standard is still phpdoc.org.  If you're on Windows and use
phpDesigner, it has a nice built-in phpDocumentor to cover your basic
documentation.  I don't know about other IDEs.

Regards,
Tommy


-- 
PHP General Mailing List (http://www.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php



Re: [PHP] Re: PHP documentation parsing?

2008-07-19 Thread Daniel Brown
On Fri, Jul 18, 2008 at 9:22 AM, Christian A. Reiter
<[EMAIL PROTECTED]> wrote:
> Hi,
> Sorry for "spamming", but i got a error reply from sending this to
> [EMAIL PROTECTED]

Don't worry, you're not "spamming", you were following up.  The
gods have forgiven you, so you're good to go!  ;-P

[EMAIL PROTECTED] is a common typo.  The real address is
[EMAIL PROTECTED]  Note the lack of hyphen.

I think it's safe to say that *most* of us have done it.  I know,
at least, that I have and so has Tul, just yesterday.  ;-P

-- 

Better prices on dedicated servers:
Intel 2.4GHz/60GB/512MB/2TB $49.99/mo.
Intel 3.06GHz/80GB/1GB/2TB $59.99/mo.
Dedicated servers, VPS, and hosting from $2.50/mo.

-- 
PHP General Mailing List (http://www.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php



[PHP] Re: PHP documentation parsing?

2008-07-18 Thread Christian A. Reiter
Am Freitag, 18. Juli 2008 13:03:43 schrieb M. Sokolewicz:
> This is more of a question for the PHP Documentation Mailinglist than
> for php-general, so I'm cc'ing it there.
>
> Could you perhaps put up such a toc file somewhere online, so we could
> take a look at what it actually looks like, for those of us not having
> access to a kdevelop installation.
>
> Also, the php documentation on that homepage, was it just the XML-source
> ? or the rendered html output? I'm having a bit of a hard time figuring
> that out from your mail.
>
> - Tul


Hi,
Sorry for "spamming", but i got a error reply from sending this to 
[EMAIL PROTECTED]

here is the content of the php.toc file: http://paste.ubuntu.com/28269/

I don't know exactly how the old documentation looked like (because I never 
saw it online) - but what I can read out of the .toc file the structure was 
quite the same as the one on your php.net page.

The toc file describes just URLs; 
- one base URL (in your case "www.php.net/manual/en") 
- all other xml nodes are titles and relative paths.

I replaced the line
   http://epoxy.mrs.umn.edu/doc/python2.2-doc/html"/>
with
   http://www.php.net/manual/en"/>

-> most of the documentation works  -  but not all of it, and some chapter 
numbers are wrong too.

So I ask you if there exists a possibility to get this documentation in a 
format that suites better than parsing the html file op php.net ;-)

Thanks,
Chris

-- 
PHP General Mailing List (http://www.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php



[PHP] Re: PHP documentation parsing?

2008-07-18 Thread M. Sokolewicz

Christian A. Reiter wrote:
As you maybe know, the program "kdevelop" under Linux has a built in 
documentation browser which uses the online php documentation which was on 
the homepage of the Minnesota university.

Since this homepage isn't available any more the documentation is broken.
I tried to link to the new page, but the doc-browser uses an internal xml file 
which describes the base URL and the nodes of the manual
(if you have a linux installation with kdevelop, look at 
the /usr/share/apps/kdevdocumentation/tocs/php.toc file).


I just wanted to update the doc link, but the new page isn't in sync with the 
old with it's structure exactly.
Could you provide me a list of the nodes of the php doc, or do I have to parse 
the html file (http://www.php.net/manual/en/index.php -> browser html output) 
to convert it to a .toc file?


Thank you,
Chris


This is more of a question for the PHP Documentation Mailinglist than 
for php-general, so I'm cc'ing it there.


Could you perhaps put up such a toc file somewhere online, so we could 
take a look at what it actually looks like, for those of us not having 
access to a kdevelop installation.


Also, the php documentation on that homepage, was it just the XML-source 
? or the rendered html output? I'm having a bit of a hard time figuring 
that out from your mail.


- Tul

--
PHP General Mailing List (http://www.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php



Re: [PHP] Documentation of PHP sourcecode

2006-08-02 Thread Ligaya Turmelle

Chris Boget wrote:
I am looking in some possibilities for automatically documenting my 
functions

and classes. Preferably with some markup in the sourcecode and easy to
implement. I am running Linux on my desktop so w* stuff won't do it 
for me :)

Can anyone point me in the right direction?



Check out PHPDocumentor.

http://www.phpdoc.org/

This is just one package of the many that are out there.  A quick search on
google will show others.

thnx,
Chris
And if you use vim - there is a plugin to automatically generate some 
basic documentation.


http://www.vim.org/scripts/script.php?script_id=1355

--

life is a game... so have fun.

-- 
PHP General Mailing List (http://www.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php

Re: [PHP] Documentation of PHP sourcecode

2006-08-02 Thread Brad Bonkoski

www.phpdoc.org
similar to javadocs, and works pretty well.
-Brad

Paul Zwiers wrote:

Dear all,

With a growing base of previous PHP work (not to be be mistaken for a 
"framework" :) ) I also find myself recoding and reinventing the wheel. 
Something I really do not want to do.


I am looking in some possibilities for automatically documenting my functions 
and classes. Preferably with some markup in the sourcecode and easy to 
implement. I am running Linux on my desktop so w* stuff won't do it for me :)


Can anyone point me in the right direction?

Thanks in advance!

  


--
PHP General Mailing List (http://www.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php



Re: [PHP] Documentation of PHP sourcecode

2006-08-02 Thread Jochem Maas
Paul Zwiers wrote:
> Dear all,
> 
> With a growing base of previous PHP work (not to be be mistaken for a 
> "framework" :) ) I also find myself recoding and reinventing the wheel. 
> Something I really do not want to do.
> 
> I am looking in some possibilities for automatically documenting my functions 
> and classes. Preferably with some markup in the sourcecode and easy to 
> implement. I am running Linux on my desktop so w* stuff won't do it for me :)
> 
> Can anyone point me in the right direction?

google on 'phpdocumentor' - it will do exactly what your looking for
(apart from write the documentation comments ;-)

> 
> Thanks in advance!
> 

-- 
PHP General Mailing List (http://www.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php



Re: [PHP] Documentation of PHP sourcecode

2006-08-02 Thread John Nichel

Paul Zwiers wrote:

Dear all,

With a growing base of previous PHP work (not to be be mistaken for a 
"framework" :) ) I also find myself recoding and reinventing the wheel. 
Something I really do not want to do.


I am looking in some possibilities for automatically documenting my functions 
and classes. Preferably with some markup in the sourcecode and easy to 
implement. I am running Linux on my desktop so w* stuff won't do it for me :)


Can anyone point me in the right direction?

Thanks in advance!



http://www.phpdoc.org/

--
John C. Nichel IV
Programmer/System Admin (ÜberGeek)
Dot Com Holdings of Buffalo
716.856.9675
[EMAIL PROTECTED]

--
PHP General Mailing List (http://www.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php



Re: [PHP] Documentation of PHP sourcecode

2006-08-02 Thread Chris Boget
I am looking in some possibilities for automatically documenting my 
functions

and classes. Preferably with some markup in the sourcecode and easy to
implement. I am running Linux on my desktop so w* stuff won't do it for me 
:)

Can anyone point me in the right direction?


Check out PHPDocumentor.

http://www.phpdoc.org/

This is just one package of the many that are out there.  A quick search on
google will show others.

thnx,
Chris 


--
PHP General Mailing List (http://www.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php



Re: [PHP] Documentation software

2006-06-29 Thread Jochem Maas
Mathieu Dumoulin wrote:
> This is not a php specific question but more a programming question. I'd

oh we'll answer Q's on anything from ASP to STDs on this list ;-)

> like to know names of software that help in creating documentation like
> the microsoft style of documentation when you visit the MSDN library. I

MSDN is documentation hell in terms of navigation AND content (jmho).

you could try this: http://www.phpdoc.org/
note that phpDocumentor is aimed primarily at API documentation

alternatively maybe this gives you a few options:
http://www.google.com/search?q=php+documentation+tool

> can also see that often one some sites like the VBCORLIB web site.
> 
> I'm sure there is something out there, i'd like mostly a web based one
> and open source or free obviously...
> 
> Waiting for your input, thanks
> 

-- 
PHP General Mailing List (http://www.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php



Re: [PHP] Documentation for VAR

2005-04-23 Thread Richard Davey
Hello Satyam,

Friday, April 22, 2005, 3:59:38 PM, you wrote:

S> I've been going through the manual and haven't found 'var'
S> documented anywhere, as far as I found, it is just used, and that's
S> it. It seems it first appears when it talks about Classes, and it
S> is just used in the examples as if everyone knew what var is
S> supposed to do.

It's a "constant initializer" - which is both an accurate and
misleading title at the same time :) It will initialise a variable to
be constant through-out your entire class (meaning any method can
access it) but unlike true PHP constants (those created with define)
the value of the variable can be manipulated from just about anywhere.

It is of course PHP4 only and is depreciated in PHP5.

Best regards,

Richard Davey
-- 
 http://www.launchcode.co.uk - PHP Development Services
 "I do not fear computers. I fear the lack of them." - Isaac Asimov

-- 
PHP General Mailing List (http://www.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php



RE: [PHP] Documentation for VAR

2005-04-23 Thread Jay Blanchard
[snip]
I've been going through the manual and haven't found 'var' documented 
anywhere, as far as I found, it is just used, and that's it.  It seems
it 
first appears when it talks about Classes, and it is just used in the 
examples as if everyone knew what var is supposed to do.
[/snip]

It is just a variable name.

--
PHP General Mailing List (http://www.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php



Re: [PHP] Documentation for VAR

2005-04-23 Thread Satyam
I was looking for formal documentation because I am doing a pre-processor 
for some PHP extensions and wanted to know the right and formal description 
for it.  Nevertheless, I think your examples below cover most cases, a help 
much appreciated.  Thanks

Satyam



"Jochem Maas" <[EMAIL PROTECTED]> wrote in message 
news:[EMAIL PROTECTED]
> Richard Davey wrote:
>> Hello Satyam,
>>
>> Friday, April 22, 2005, 3:59:38 PM, you wrote:
>>
>> S> I've been going through the manual and haven't found 'var'
>> S> documented anywhere, as far as I found, it is just used, and that's
>> S> it. It seems it first appears when it talks about Classes, and it
>> S> is just used in the examples as if everyone knew what var is
>> S> supposed to do.
>>
>> It's a "constant initializer" - which is both an accurate and
>> misleading title at the same time :) It will initialise a variable to
>> be constant through-out your entire class (meaning any method can
>> access it) but unlike true PHP constants (those created with define)
>> the value of the variable can be manipulated from just about anywhere.
>
>
> indeed in php you can do the following instead:
>
> 
> error_reporting( E_ALL & E_STRICT );
> class Test
> {
> // this first var (commented out) should (I thought) act as if defined
> // 'public' - it doesn't given a parse error with php -l, but does 
> when run.
> // I haven't run into this problem in 1.5 years of writing php5...
> // I must be having a brain freeze :-/
> //$myVar;
>
> // publically accessible instances variables
> public $myVar1; // not initialized with a value
> public $myVar2 = "2"; // initialized with a value
>
> // an instance variable thats only available
> // from within _all_ methods of this object.
> // .. methods could be defined in subclasses or parent-classes
> protected $myVar3 = "3";
>
> // an instance variable that is only available to the
> // methods defined in _this_ class
> private $myVar4 = "4";
>
> // a variable with class scope (all instances see the same value),
> // publically accessible
> static $myVar5 = "5";
> static public $myVar6 = "6";
>
> // a variable with class scope (all instances see the same value),
> // thats only available from within _all_ methods of this object.
> static protected $myVar7 = "7";
>
> // a variable with class scope (all instances see the same value),
> // thats only available from methods defined in _this_ class
> static private $myVar8 = "8";
>
> public function get4() { return $this->myVar4; }
> public function get8() { return self::$myVar8; }
> }
>
> // basic usage examples:
>
> var_dump( ($t = new Test), $t->myVar2, $t->get4(), Test::$myVar6, 
> $t->get8() );
>
> ?>
>
> I can thoroughly recommend php5's much improved object model,
> try other variations of calls to the defined 'myVar's, also try doing
> with sublcasses, see what does/doesn't work, have fun :-)
>
>>
>> It is of course PHP4 only and is depreciated in PHP5.
>>
>> Best regards,
>>
>> Richard Davey 

-- 
PHP General Mailing List (http://www.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php



Re: [PHP] Documentation for VAR

2005-04-22 Thread Jochem Maas
Richard Davey wrote:
Hello Satyam,
Friday, April 22, 2005, 3:59:38 PM, you wrote:
S> I've been going through the manual and haven't found 'var'
S> documented anywhere, as far as I found, it is just used, and that's
S> it. It seems it first appears when it talks about Classes, and it
S> is just used in the examples as if everyone knew what var is
S> supposed to do.
It's a "constant initializer" - which is both an accurate and
misleading title at the same time :) It will initialise a variable to
be constant through-out your entire class (meaning any method can
access it) but unlike true PHP constants (those created with define)
the value of the variable can be manipulated from just about anywhere.

indeed in php you can do the following instead:

error_reporting( E_ALL & E_STRICT );
class Test
{
// this first var (commented out) should (I thought) act as if defined
// 'public' - it doesn't given a parse error with php -l, but does when run.
// I haven't run into this problem in 1.5 years of writing php5...
// I must be having a brain freeze :-/
//$myVar;
// publically accessible instances variables
public $myVar1; // not initialized with a value
public $myVar2 = "2"; // initialized with a value
// an instance variable thats only available
// from within _all_ methods of this object.
// .. methods could be defined in subclasses or parent-classes
protected $myVar3 = "3";
// an instance variable that is only available to the
// methods defined in _this_ class
private $myVar4 = "4";
// a variable with class scope (all instances see the same value),
// publically accessible
static $myVar5 = "5";
static public $myVar6 = "6";
// a variable with class scope (all instances see the same value),
// thats only available from within _all_ methods of this object.
static protected $myVar7 = "7";
// a variable with class scope (all instances see the same value),
// thats only available from methods defined in _this_ class
static private $myVar8 = "8";
public function get4() { return $this->myVar4; }
public function get8() { return self::$myVar8; }
}
// basic usage examples:
var_dump( ($t = new Test), $t->myVar2, $t->get4(), Test::$myVar6, $t->get8() );
?>
I can thoroughly recommend php5's much improved object model,
try other variations of calls to the defined 'myVar's, also try doing
with sublcasses, see what does/doesn't work, have fun :-)
It is of course PHP4 only and is depreciated in PHP5.
Best regards,
Richard Davey
--
PHP General Mailing List (http://www.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php


Re: [PHP] Documentation on features not in current release (SimpleXML PHP5 Beta 3)

2004-01-17 Thread Chris Shiflett
--- Jonathan <[EMAIL PROTECTED]> wrote:
> Where would I be able to find a function reference or documentation
> on new features that are not documented in the official manual?

Usually nowhere. Features that have yet to be documented are probably so
experimental, new, unfinished, or whatever, that documentation written now
would be wrong by the time those features are stable.

However, if you're just wanting to learn more about SimpleXML
specifically, Adam wrote a nice article about it yesterday. You can find
it here:

http://www.onlamp.com/pub/a/php/2004/01/15/simplexml.html

Hope that helps.

Chris

=
Chris Shiflett - http://shiflett.org/

PHP Security Handbook
 Coming mid-2004
HTTP Developer's Handbook
 http://httphandbook.org/

-- 
PHP General Mailing List (http://www.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php



RE: [PHP] documentation on "<<<"

2003-10-01 Thread Chris W. Parker
Rich Fox 
on Wednesday, October 01, 2003 10:08 AM said:

> Can someone point me to documentation on the <<< operator? I am
> wondering if there are some quirks I don't know about. Yet I can't
> find it documented on the php website.

I don't know the answer to your question but...

Did you know that it's called the heredoc operator? You
may be able to find information if you search google for "heredoc php"
and/or "heredoc operator php".


hth,
Chris.

--
PHP General Mailing List (http://www.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php



Re: [PHP] documentation on "<<<"

2003-10-01 Thread Eugene Lee
On Wed, Oct 01, 2003 at 01:07:35PM -0400, Rich Fox wrote:
: 
: Can someone point me to documentation on the <<< operator? I am wondering if
: there are some quirks I don't know about. Yet I can't find it documented on
: the php website.

Try searching for "heredoc".

-- 
PHP General Mailing List (http://www.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php



RE: [PHP] documentation on pg_escape_string()

2003-03-17 Thread John W. Holmes
> Anyone know where to find documentation on this? Who knows what it
> escapes?

I always look in the manual when I'm looking for documentation, but
that's just me. Hell, call me crazy, but I'd probably look in the
chapter on the PG functions... but that's just me... and I have no idea
what I'm doing.

---John W. Holmes...

PHP Architect - A monthly magazine for PHP Professionals. Get your copy
today. http://www.phparch.com/



-- 
PHP General Mailing List (http://www.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php



Re: [PHP] documentation on pg_escape_string()

2003-03-17 Thread Joe Conway
Dennis Gearon wrote:
Anyone know where to find documentation on this? Who knows what it escapes?

From PostgreSQL source (~/pgsql/src/interfaces/libpq/fe-exec.c):

8<
/* ---
 * Escaping arbitrary strings to get valid SQL strings/identifiers.
 *
 * Replaces "\\" with "" and "'" with "''".
 * length is the length of the buffer pointed to by
 * from.  The buffer at to must be at least 2*length + 1 characters
 * long.  A terminating NUL character is written.
 * ---
 */
size_t
PQescapeString(char *to, const char *from, size_t length)
8<
I presume the PHP function is just a wrapper around this one (but did 
not actually check).

HTH,

Joe



--
PHP General Mailing List (http://www.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php


RE: [PHP] Documentation Help

2003-02-05 Thread Jon Haworth
Hi Hardik,

> I worked on educational intranet and library management system. I 
> did comment my code but i dont know how to document functional 
> and technical specification as well as database schema. 

Theoretically, you should write the specs before the program (that way, the
program matches the specs, not the other way round)

Looks like it's too late for that now though :-)

Here's a good article on writing functional specs (part 1 of 4):
http://joelonsoftware.com/articles/fog36.html

Cheers
Jon

-- 
PHP General Mailing List (http://www.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php




RE: [PHP] documentation comment

2001-11-04 Thread Matthew Loff



I would have to agree on a global scale.

However, strictly in discussion of server-side languages, I haven't seen
ASP documentation as complete/useful as PHP's...  I have never had to
use anything besides the PHP manual to solve a problem in writing
something.


-Original Message-
From: Andrew Brampton [mailto:[EMAIL PROTECTED]] 
Sent: Sunday, November 04, 2001 5:46 PM
To: [EMAIL PROTECTED]
Subject: Re: [PHP] documentation comment


Have you seen a MSDN subscription latly?
Its many many CDs of Help Files and such...

Php.net has comments added by coders on the end, but other than that
they
have nothing over M$ unless i'm missing something?

Andrew
- Original Message -
From: "Jack Dempsey" <[EMAIL PROTECTED]>
To: <[EMAIL PROTECTED]>
Sent: Sunday, November 04, 2001 7:59 PM
Subject: [PHP] documentation comment


> not to start a war, but have you seen php.net's documentation compared
to
> anything microsoft or anyone else has ever put out? i'd say that
> documentation is microsoft's achilles heel
>
>
> --
> PHP General Mailing List (http://www.php.net/)
> To unsubscribe, e-mail: [EMAIL PROTECTED]
> For additional commands, e-mail: [EMAIL PROTECTED]
> To contact the list administrators, e-mail:
[EMAIL PROTECTED]
>
>


-- 
PHP General Mailing List (http://www.php.net/)
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
To contact the list administrators, e-mail: [EMAIL PROTECTED]


-- 
PHP General Mailing List (http://www.php.net/)
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
To contact the list administrators, e-mail: [EMAIL PROTECTED]




Re: [PHP] documentation comment

2001-11-04 Thread Andrew Brampton

Have you seen a MSDN subscription latly?
Its many many CDs of Help Files and such...

Php.net has comments added by coders on the end, but other than that they
have nothing over M$ unless i'm missing something?

Andrew
- Original Message -
From: "Jack Dempsey" <[EMAIL PROTECTED]>
To: <[EMAIL PROTECTED]>
Sent: Sunday, November 04, 2001 7:59 PM
Subject: [PHP] documentation comment


> not to start a war, but have you seen php.net's documentation compared to
> anything microsoft or anyone else has ever put out? i'd say that
> documentation is microsoft's achilles heel
>
>
> --
> PHP General Mailing List (http://www.php.net/)
> To unsubscribe, e-mail: [EMAIL PROTECTED]
> For additional commands, e-mail: [EMAIL PROTECTED]
> To contact the list administrators, e-mail: [EMAIL PROTECTED]
>
>


-- 
PHP General Mailing List (http://www.php.net/)
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
To contact the list administrators, e-mail: [EMAIL PROTECTED]




RE: [PHP] Documentation

2001-05-11 Thread Altunergil, Oktay

I hate the fact that php.net, phpbuilder.com are down very frequently and
mysql.com is slow usually.. 

It's too bad for our image.

Oktay Altunergil

-Original Message-
From: Philip Olson [mailto:[EMAIL PROTECTED]]
Sent: Friday, May 11, 2001 1:26 PM
To: Don Pro
Cc: php list
Subject: Re: [PHP] Documentation




  http://uk.php.net/mirrors.php


regards,
philip

On Fri, 11 May 2001, Don Pro wrote:

> Does anyone know alternative sites for PHP documentation?
> 
> www.php.net seems to be down.
> 
> Thankls,
> Don
> 
> 
> -- 
> PHP General Mailing List (http://www.php.net/)
> To unsubscribe, e-mail: [EMAIL PROTECTED]
> For additional commands, e-mail: [EMAIL PROTECTED]
> To contact the list administrators, e-mail: [EMAIL PROTECTED]
> 


-- 
PHP General Mailing List (http://www.php.net/)
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
To contact the list administrators, e-mail: [EMAIL PROTECTED]

-- 
PHP General Mailing List (http://www.php.net/)
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
To contact the list administrators, e-mail: [EMAIL PROTECTED]




Re: [PHP] Documentation

2001-05-11 Thread Philip Olson



  http://uk.php.net/mirrors.php


regards,
philip

On Fri, 11 May 2001, Don Pro wrote:

> Does anyone know alternative sites for PHP documentation?
> 
> www.php.net seems to be down.
> 
> Thankls,
> Don
> 
> 
> -- 
> PHP General Mailing List (http://www.php.net/)
> To unsubscribe, e-mail: [EMAIL PROTECTED]
> For additional commands, e-mail: [EMAIL PROTECTED]
> To contact the list administrators, e-mail: [EMAIL PROTECTED]
> 


-- 
PHP General Mailing List (http://www.php.net/)
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
To contact the list administrators, e-mail: [EMAIL PROTECTED]