[PHP-DOC] cvs: phpdoc /en/reference/uodbc reference.xml /entities global.ent
dmytton Mon Feb 26 20:11:52 2007 UTC Modified files: /phpdoc/en/reference/uodbc reference.xml /phpdoc/entitiesglobal.ent Log: Reworded description about iODBC to make it clearer. Closes #39453 http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/uodbc/reference.xml?r1=1.9r2=1.10diff_format=u Index: phpdoc/en/reference/uodbc/reference.xml diff -u phpdoc/en/reference/uodbc/reference.xml:1.9 phpdoc/en/reference/uodbc/reference.xml:1.10 --- phpdoc/en/reference/uodbc/reference.xml:1.9 Sun Sep 4 19:39:30 2005 +++ phpdoc/en/reference/uodbc/reference.xml Mon Feb 26 20:11:52 2007 @@ -1,5 +1,5 @@ ?xml version=1.0 encoding=iso-8859-1? -!-- $Revision: 1.9 $ -- +!-- $Revision: 1.10 $ -- !-- Purpose: database.abstract -- !-- Membership: bundled, external -- @@ -28,14 +28,15 @@ /para note para - There is no ODBC involved when connecting to the above - databases. The functions that you use to speak natively to them - just happen to share the same names and syntax as the ODBC - functions. The exception to this is iODBC. Building PHP with iODBC - support enables you to use any ODBC-compliant drivers with your PHP - applications. iODBC is maintained by ulink url=url.openlink; - OpenLink Software/ulink. More information on iODBC, as well as a - HOWTO, is available at ulink url=url.iodbc;www.iodbc.org/ulink. + With the exception of iODBC, there is no ODBC involved when + connecting to the above databases. The functions that you + use to speak natively to them just happen to share the same + names and syntax as the ODBC functions. However, building PHP + with iODBC support enables you to use any ODBC-compliant + drivers with your PHP applications. More information on iODBC, + is available at ulink url=url.iodbc;www.iodbc.org/ulink + with the alternative unixODBC available at + ulink url=url.unixodbc;www.unixodbc.org/ulink. /para /note /section http://cvs.php.net/viewvc.cgi/phpdoc/entities/global.ent?r1=1.286r2=1.287diff_format=u Index: phpdoc/entities/global.ent diff -u phpdoc/entities/global.ent:1.286 phpdoc/entities/global.ent:1.287 --- phpdoc/entities/global.ent:1.286Sun Feb 25 21:14:25 2007 +++ phpdoc/entities/global.ent Mon Feb 26 20:11:52 2007 @@ -1,6 +1,6 @@ !-- -*- SGML -*- - $Id: global.ent,v 1.286 2007/02/25 21:14:25 philip Exp $ + $Id: global.ent,v 1.287 2007/02/26 20:11:52 dmytton Exp $ Contains global macros for all the XML documents. @@ -366,6 +366,7 @@ !ENTITY url.ultimatezip http://www.ultimatezip.com/; !ENTITY url.unicode http://www.unicode.org/; !ENTITY url.unicode.reports http://www.unicode.org/unicode/reports/tr21/; +!ENTITY url.unixodbc http://www.unixodbc.org/; !ENTITY url.userlandnaming.cs http://cvs.php.net/viewvc.cgi/php-src/CODING_STANDARDS?view=co; !ENTITY url.vb4linux http://sourceforge.net/projects/vb4linux/; !ENTITY url.vlife http://www.vodafone.jp/english/live/;
[PHP-DOC] cvs: phpdoc /en/reference/mbstring/functions mb-strrpos.xml
dmytton Sun Feb 25 18:14:09 2007 UTC Modified files: /phpdoc/en/reference/mbstring/functions mb-strrpos.xml Log: Patch from #40522 http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/mbstring/functions/mb-strrpos.xml?r1=1.5r2=1.6diff_format=u Index: phpdoc/en/reference/mbstring/functions/mb-strrpos.xml diff -u phpdoc/en/reference/mbstring/functions/mb-strrpos.xml:1.5 phpdoc/en/reference/mbstring/functions/mb-strrpos.xml:1.6 --- phpdoc/en/reference/mbstring/functions/mb-strrpos.xml:1.5 Sat Feb 24 21:12:24 2007 +++ phpdoc/en/reference/mbstring/functions/mb-strrpos.xml Sun Feb 25 18:14:08 2007 @@ -1,5 +1,5 @@ ?xml version=1.0 encoding=iso-8859-1? -!-- $Revision: 1.5 $ -- +!-- $Revision: 1.6 $ -- !-- splitted from ./en/functions/mbstring.xml, last change in rev 1.1 -- refentry id=function.mb-strrpos refnamediv @@ -50,9 +50,11 @@ /note note simpara - As of PHP 5.2.0, for back compatibility, parameterencoding/parameter - can be specified as the third parameter. However, doing so is - deprecated and will be removed from a future release of PHP. + The parameterencoding/parameter parameter was moved from + the third position to the fourth in PHP 5.2.0. For backward + compatibility, parameterencoding/parameter can be specified + as the third parameter, but doing so is deprecated and will be + removed in the future. /simpara /note /refsect1
[PHP-DOC] cvs: phpdoc /en/appendices ini.xml
dmytton Sat Feb 24 20:42:20 2007 UTC Modified files: /phpdoc/en/appendices ini.xml Log: Fixed #40614 Incorrect memory_limit documentation http://cvs.php.net/viewvc.cgi/phpdoc/en/appendices/ini.xml?r1=1.48r2=1.49diff_format=u Index: phpdoc/en/appendices/ini.xml diff -u phpdoc/en/appendices/ini.xml:1.48 phpdoc/en/appendices/ini.xml:1.49 --- phpdoc/en/appendices/ini.xml:1.48 Fri Feb 9 15:56:07 2007 +++ phpdoc/en/appendices/ini.xmlSat Feb 24 20:42:20 2007 @@ -1,5 +1,5 @@ ?xml version=1.0 encoding=iso-8859-1? -!-- $Revision: 1.48 $ -- +!-- $Revision: 1.49 $ -- appendix id=ini titlephp.ini; directives/title @@ -2834,9 +2834,9 @@ para This sets the maximum amount of memory in bytes that a script is allowed to allocate. This helps prevent poorly written -scripts for eating up all available memory on a server. In order to -use this directive you must have enabled it at compile time. So, -your configure line would have included: +scripts for eating up all available memory on a server. Prior to +PHP 5.2.1, in order to use this directive you must have enabled +it at compile time. So, your configure line would have included: option role=configure--enable-memory-limit/option. Note that you have to set it to -1 if you don't want any limit for your memory. /para
[PHP-DOC] cvs: phpdoc /en/reference/image reference.xml
dmytton Sat Feb 24 20:57:32 2007 UTC Modified files: /phpdoc/en/reference/image reference.xml Log: Applied patch in #40525 http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/image/reference.xml?r1=1.29r2=1.30diff_format=u Index: phpdoc/en/reference/image/reference.xml diff -u phpdoc/en/reference/image/reference.xml:1.29 phpdoc/en/reference/image/reference.xml:1.30 --- phpdoc/en/reference/image/reference.xml:1.29Sun Jan 21 15:13:40 2007 +++ phpdoc/en/reference/image/reference.xml Sat Feb 24 20:57:32 2007 @@ -1,5 +1,5 @@ ?xml version=1.0 encoding=iso-8859-1? -!-- $Revision: 1.29 $ -- +!-- $Revision: 1.30 $ -- !-- Purpose: utilspec.image -- !-- Membership: bundled -- @@ -102,7 +102,13 @@ row entryliteraljpeg-6b/literal/entry entryulink url=url.jpeg;url.jpeg;/ulink/entry - entry/entry + entry + When buliding the jpeg-v6b library (prior to building PHP) you + must use the option role=configure--enable-shared/option + option in the configure step. If you do not, you will receive + an error saying literallibjpeg.(a|so) not found/literal + when you get to the configure step of building PHP. + /entry /row row entryliteralpng/literal/entry
[PHP-DOC] cvs: phpdoc /en/reference/mbstring/functions mb-strrpos.xml
dmytton Sat Feb 24 21:12:24 2007 UTC Modified files: /phpdoc/en/reference/mbstring/functions mb-strrpos.xml Log: Missed space in previous commit http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/mbstring/functions/mb-strrpos.xml?r1=1.4r2=1.5diff_format=u Index: phpdoc/en/reference/mbstring/functions/mb-strrpos.xml diff -u phpdoc/en/reference/mbstring/functions/mb-strrpos.xml:1.4 phpdoc/en/reference/mbstring/functions/mb-strrpos.xml:1.5 --- phpdoc/en/reference/mbstring/functions/mb-strrpos.xml:1.4 Sat Feb 24 21:09:25 2007 +++ phpdoc/en/reference/mbstring/functions/mb-strrpos.xml Sat Feb 24 21:12:24 2007 @@ -1,5 +1,5 @@ ?xml version=1.0 encoding=iso-8859-1? -!-- $Revision: 1.4 $ -- +!-- $Revision: 1.5 $ -- !-- splitted from ./en/functions/mbstring.xml, last change in rev 1.1 -- refentry id=function.mb-strrpos refnamediv @@ -50,7 +50,7 @@ /note note simpara - As of PHP 5.2.0, for back compatibility,parameterencoding/parameter + As of PHP 5.2.0, for back compatibility, parameterencoding/parameter can be specified as the third parameter. However, doing so is deprecated and will be removed from a future release of PHP. /simpara
[PHP-DOC] cvs: phpdoc /en/reference/stream/functions stream-socket-client.xml
dmytton Sat Feb 24 21:32:28 2007 UTC Modified files: /phpdoc/en/reference/stream/functions stream-socket-client.xml Log: Added note about timeout with async. Closes #40517 http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/stream/functions/stream-socket-client.xml?r1=1.13r2=1.14diff_format=u Index: phpdoc/en/reference/stream/functions/stream-socket-client.xml diff -u phpdoc/en/reference/stream/functions/stream-socket-client.xml:1.13 phpdoc/en/reference/stream/functions/stream-socket-client.xml:1.14 --- phpdoc/en/reference/stream/functions/stream-socket-client.xml:1.13 Wed Nov 10 08:30:45 2004 +++ phpdoc/en/reference/stream/functions/stream-socket-client.xml Sat Feb 24 21:32:27 2007 @@ -1,5 +1,5 @@ ?xml version=1.0 encoding=iso-8859-1? -!-- $Revision: 1.13 $ -- +!-- $Revision: 1.14 $ -- refentry id=function.stream-socket-client refnamediv refnamestream_socket_client/refname @@ -46,6 +46,12 @@ connecting the socket. /simpara /note +note + simpara + The timeout parameter only applies if you are not making an asynchronous + connection attempt. + /simpara +/note para functionstream_socket_client/function returns a stream resource which may
[PHP-DOC] SOAP
Is anyone working on the SOAP documentation at the moment? I have been working with it in PHP recently and have found the documentation to be a bit sparse. If nobody else is doing stuff, I'm planning on adding some more detail. -- David Mytton http://www.olate.co.uk http://www.mytton.net
Re: [PHP-DOC] Web site translation?
I suppose this is where the notes should be scanned (by a human rather than a script) to see if they can improve the documentation. Well notes are checked anyway - quite a few are rejected or deleted before they ever appear on the site. I Moving the notes away from the page may not be a great idea. If the notes where tagged with the language they are in (based upon which manual was used to add the note maybe) then have these sorted first, so you see notes in your language and then other languages - maybe. I think tagging them with the language they're in would be a good thing to do. That way the new note notification can be directed to the relevant translation team and reviewed by them. Perhaps on the manual pages, it would show all the notes for that language, and on the non-English pages, there could be an option to show notes that are in English. Or just show all notes on the non-English pages regardless. -- David Mytton http://www.olate.co.uk
Re: [PHP-DOC] Web site translation?
This sounds like a good idea. If the manual is available in the various languages then it would make sense to have the whole website available too. However, if you do this would that also mean having notes being submitting in different languages, and if so, there would need to be people available to review them in the various languages too. -- David Mytton http://www.olate.co.uk
Re: [PHP-DOC] Quick Setup
Is it worth me using the RFC for this? -- David Mytton http://www.olate.co.uk
Re: [PHP-DOC] Quick Setup
No, I mean http://doc.php.net/php/rfc/rfc-overview.php - request for comments...if that is indeed what it is for? :) -- David Mytton http://www.olate.co.uk
Re: [PHP-DOC] PHP Doc ./configure
I added PHP = `echo $PHP | sed 's/ /\\ /'` to line 68: fi ] ) PHP = `echo $PHP | sed 's/ /\\ /'` if test $PHP = no; then but it didn't seem to have any effect. I like to have my filesystem organised so I put PHP into Prog Files. The guide I'm writing, however, is not specific on that so it does't matter where you put PHP. But I think I'll create a separate copy in C:\PHP so as to avoid this problem. -- David Mytton http://www.olate.co.uk
Re: [PHP-DOC] PHP Doc ./configure
On 17/11/05, Richard A. Quadling [EMAIL PROTECTED] wrote: Which is why PHP is in the root. Probably. Also, the issues with having PHP not in C:\PHP for newbies and IIS is going to cause a LOT of issues. Editing the INI file is hard enough for some. Yes, I agree. Most people will just install it to the root. But I'm not most people :) Are you ready to give me a trial run? Not yet. I've got the Cygwin setup, checkout and config instructions done. Now I'm doing the basics of editing, checking the syntax and building the manual. -- David Mytton http://www.olate.co.uk
Re: [PHP-DOC] PHP Doc ./configure
On 17/11/05, Richard A. Quadling [EMAIL PROTECTED] wrote: Just took a look at all the progs install in C:\ Heh, my C:\ is virtually empty :p Looking forward to this. I know I got a fair way before, but getting the updates sent back to the CVS was handled by Nuno for me. Could you not use CVS, or do you not have a CVS account? Can you give some thought the steps of upgrading Cygwin. This is what broke my last attempt (before the server went pop!). Not bothered since. Hmm. Isn't this a case of just running setup.exe again and checking to see if there are any updated packages? Do you still need the openjade tools separate from Cygwin? Or do the jade tools that cygwin supply now work OK? I seem to remember having major problems with this last time - Jade wasn't working properly and I had to do a lot of manual stuff I can't remember! But I've just gone through the setup process on my brand new x64 PC and the jade that comes with Cygwin worked perfectly first time. In fact, everything has worked perfectly first time with the exception of the Program Files path issue. Or shall I just wait and see what the notes say! I'll send the first copy now in my original message. :) -- David Mytton http://www.olate.co.uk
Re: [PHP-DOC] Quick Setup
=statusdirection=ASCcmd=displaystatus=Openbug_type%5B%5D=Documentation+problembug_age=0 Function aliases: http://www.phpdoc.info/meta/function-aliases.php phpdoc mailing list archive: http://marc.theaimsgroup.com/?l=phpdoc -- David Mytton http://www.olate.co.uk
Re: [PHP-DOC] PHP Doc ./configure
On 17/11/05, Nuno Lopes [EMAIL PROTECTED] wrote: Stupid question: did you run 'autoconf' after this change? whats the value of `echo $PHP` after the sed command? Ahh no, I didn't. However, I just did that (changed path to prog files again, launched cygwin, cd phpdoc, autoconf, ./configure) and even with that line, I get a similar error: file versions Makefile.in,v 1.170 configure.in,v 1.233 configure options: source directory: . working directory: /home/Administrator/phpdoc checking for php... /cygdrive/c/Program Files/PHP/php Could not open input file: =. ./configure: line 1404: test: too many arguments checking php version... ./configure: line 1411: /cygdrive/c/Program: No such file or directory ./configure: line 1413: /cygdrive/c/Program: No such file or directory ./configure: line 1413: test: yes: unary operator expected configure: error: PHP version 4.0.0 or newer needed -- David Mytton http://www.olate.co.uk
[PHP-DOC] PHP Doc ./configure
I've come across my first problem with Windows/PHP doc setup and that is with the ./configure script after checking out a fresh copy from CVS. My PHP dir is C:\Program Files\PHP which seems to be giving the configure script problems because of the space. It is getting the path directly from the system PATH variable. This is the output I get: file versions Makefile.in,v 1.170 configure.in,v 1.233 configure options: source directory: . working directory: /home/Administrator/phpdoc checking for php... /cygdrive/c/Program Files/PHP/php checking php version... ./configure: line 1403: test: too many argyments ./configure: line 1410: /cygdrive/c/Program: No such file or directory ./configure: line 1412: /cygdrive/c/Program: No such file or directory ./configure: line 1412: test: yes: unary operator expected configure: error: PHP version 4.0.0 or newer needed -- Regards, David Mytton http://www.olate.co.uk
Re: [PHP-DOC] Quick Setup
On 15/11/05, Richard A. Quadling [EMAIL PROTECTED] wrote: I'll be very interested in following your phpdoc for windows notes. I'm willing to act as a guinea pig if you want. I don't have cygwin installed locally, though I do have PEAR. I use PHP5 with Sambar Server and MSSQL as my DB. I use a LOT of cli based PHP (hence php-cli.ini and php-isapi.ini being different!). Ok great thanks. I've written the instructions for getting cygwin installed and the phpdoc sources downloaded - the next step is for compiling them. I had problems with this when I first started so I'll see if I can remember how to do it! -- Regards, David Mytton http://www.olate.co.uk
Re: Re[2]: [PHP-DOC] Manual Credits/Contributors
I'd like to appear on the Authors and Editors list. I've not done too much recently but I'm hoping to make some time to continue adding examples to functions without then like I started doing a while back :) -- Regards, David Mytton http://www.olate.co.uk
[PHP-DOC] Adding link
If I wanted to add a link to http://www.php.net/manual/en/ref.mysql.php would the link be: link linkend=ref.mysqlLink text/link ? -- Regards, David Mytton http://www.olate.co.uk
Re: [PHP-DOC] Adding link
Thanks. On 12/08/05, Dan Scott [EMAIL PROTECTED] wrote: On 8/12/05, David Mytton [EMAIL PROTECTED] wrote: If I wanted to add a link to http://www.php.net/manual/en/ref.mysql.php would the link be: link linkend=ref.mysqlLink text/link ? -- Regards, David Mytton http://www.olate.co.uk Yes, that's exactly right. Dan -- Regards, David Mytton http://www.olate.co.uk
[PHP-DOC] cvs: phpdoc /en/faq databases.xml
dmytton Fri Aug 12 09:33:14 2005 EDT Modified files: /phpdoc/en/faq databases.xml Log: Added link to installation instructions for bug #34081 http://cvs.php.net/diff.php/phpdoc/en/faq/databases.xml?r1=1.27r2=1.28ty=u Index: phpdoc/en/faq/databases.xml diff -u phpdoc/en/faq/databases.xml:1.27 phpdoc/en/faq/databases.xml:1.28 --- phpdoc/en/faq/databases.xml:1.27Sun Sep 5 03:46:11 2004 +++ phpdoc/en/faq/databases.xml Fri Aug 12 09:33:13 2005 @@ -1,5 +1,5 @@ ?xml version=1.0 encoding=iso-8859-1? -!-- $Revision: 1.27 $ -- +!-- $Revision: 1.28 $ -- chapter id=faq.databases titleDatabase issues/title titleabbrevDatabase issues/titleabbrev @@ -234,7 +234,7 @@ their system's libmyqlclient library simply by adding the option role=configure--with-mysql=/usr/option option when building PHP. Windows users may enable the extension - filenamephp_mysql.dll/filename inside php.ini;. Also, be sure + filenamephp_mysql.dll/filename inside php.ini;. For more details, see the link linkend=ref.mysqlMySQL Reference/link for installation instructions. Also, be sure filenamelibmysql.dll/filename is available to the systems PATH. For more details on how, read the FAQ on link linkend=faq.installation.addtopathsetting up the Windows
[PHP-DOC] Links
I am updating http://www.php.net/manual/en/ref.pdo.php to add some extra information for installation as per http://bugs.php.net/bug.php?id=33696 and I want to add a link to http://pecl.php.net/package-search.php?pkg_name=PDO_ - how do I add my own link in to do this? -- Regards, David Mytton http://www.olate.co.uk
Re: [PHP-DOC] doc.php.net
I have subscribed to the docweb list now, and reminding Gabor about the karma ;) -- Regards, David Mytton http://www.olate.co.uk
[PHP-DOC] Bug 33298
Presumably one has to have access to the php.net website CVS to fix this? :) -- Regards, David Mytton http://www.olate.co.uk
Re: [PHP-DOC] doc.php.net
Ok great. I'll subscribe to the mailing list this evening. -- Regards, David Mytton http://www.olate.co.uk
[PHP-DOC] doc.php.net
Hi, Today, in a revision break I have been browsing around the various PHPDoc related websites to remind myself what is available and I was thinking that although there is a lot of information, it is not all centralised in one place. I also think it is also quite confusing for anyone new to start contributing. Coming back to an idea I had a month or so ago to write a quick start guide, I thought it might be worth gathering all the stuff that is available and putting together a full resource site. I think the best place to do that would be on http://doc.php.net/ For example, there is the most up to date guide (I could find) at http://doc.php.net/php/dochowto/index.php but the main php.net website links to http://www.php.net/manual/howto (which seems to be the same thing). There is also http://wiki.phpdoc.info/DocLinks and the useful tools at http://www.phpdoc.info/meta/ My idea is to gather all the resources available (with the permission of the owners) and put them all on http://doc.php.net/ with links to everything on that one site. I would also like to have a quick start guide available from the homepage so that it will make it easier for phpdoc members to find everything but also assist new people. Presumably the php.net website can then link to the doc.php.net site. What do you think? -- Regards, David Mytton http://www.olate.co.uk
[PHP-DOC] cvs: phpdoc /en/reference/datetime/functions strtotime.xml
dmytton Mon Jun 6 13:50:56 2005 EDT Modified files: /phpdoc/en/reference/datetime/functions strtotime.xml Log: Tweak for bug 33105 http://cvs.php.net/diff.php/phpdoc/en/reference/datetime/functions/strtotime.xml?r1=1.12r2=1.13ty=u Index: phpdoc/en/reference/datetime/functions/strtotime.xml diff -u phpdoc/en/reference/datetime/functions/strtotime.xml:1.12 phpdoc/en/reference/datetime/functions/strtotime.xml:1.13 --- phpdoc/en/reference/datetime/functions/strtotime.xml:1.12 Sun Apr 24 19:50:58 2005 +++ phpdoc/en/reference/datetime/functions/strtotime.xmlMon Jun 6 13:50:53 2005 @@ -1,5 +1,5 @@ ?xml version=1.0 encoding=iso-8859-1? -!-- $Revision: 1.12 $ -- +!-- $Revision: 1.13 $ -- !-- splitted from ./en/functions/datetime.xml, last change in rev 1.8 -- refentry id=function.strtotime refnamediv @@ -14,7 +14,7 @@ methodparam choice=opttypeint/typeparameternow/parameter/methodparam /methodsynopsis simpara - The function expects to be given a string containing an English date + The function expects to be given a string containing a US English date format and will try to parse that format into a Unix timestamp (the number of seconds since January 1 1970 00:00:00 GMT), relative to the timestamp given in parameternow/parameter, or the current time
[PHP-DOC] Activity
Hi all, I'm not sure what level of activity is expected of PHP Docs members but I thought I'd say that at the end of next week, I hope to be much more active again. I have exams until then and have been revising for the last month or so. But once they are done, I intend to get back into handling bugs and working on adding stuff to the docs :) -- Regards, David Mytton http://www.olate.co.uk
Re: Fwd: [PHP-DOC] Switching the howto to doc.php.net (was Re: [PHP-DOC] Contributing)
Hey, Gabor and David -- thanks for the interest -- here's what I sent to Nuno earlier today. That looks pretty good. One thing that sprung to mind is that you don't mention much about Windows tools, but you do give examples of Linux tools. I don't know what the common platform is, but I use Windows. My tool of choice is obviously Cygwin for source management, but also Jedit for the actual editing of the docs. Might be worth mentioning? -- Regards, David Mytton http://www.olate.co.uk
Re: [PHP-DOC] Switching the howto to doc.php.net (was Re: [PHP-DOC] Contributing)
Sure, I'd like to take a look! On 4/27/05, Dan Scott [EMAIL PROTECTED] wrote: If anyone on the list is interested in reviewing the presentation, let me know and I'll forward it to you in its current state. (Marco, if you're reading this -- it'll be done soon, I promise!) Dan -- Regards, David Mytton http://www.olate.co.uk
Re: [PHP-DOC] docbook wiki
That would be a good idea to set up. It would save a lot of trouble getting things like CygWin set up at least. -- Regards, David Mytton http://www.olate.co.uk
Re: [PHP-DOC] Switching the howto to doc.php.net (was Re: [PHP-DOC] Contributing)
On 4/6/05, David Mytton [EMAIL PROTECTED] wrote: Since I recently started working on the docs, do you think it is worth me writing a quick start document with bullet points explaining exactly how to get involved (referencing pages in the howto)? When I originally looked at it, I found the howto very in depth and not that great for beginners. Well I was going to do this last week, but I have been stupidly busy so haven't gotten around to it. Maybe this next week won't be so busy :( -- Regards, David Mytton http://www.olate.co.uk
Re: [PHP-DOC] Switching the howto to doc.php.net (was Re: [PHP-DOC] Contributing)
On 4/15/05, Dan Scott [EMAIL PROTECTED] wrote: I'm on the hook to put together a presentation on the same topic for php|tropics over the next couple of days, so perhaps we can review each other's work? (I hear you on the busy-ness side of things) Dan Yeh, sounds good. My plan is to provide a numbered step by step guide on how to get into helping with the PHP documentation along with some common problems and FAQs. My idea is that it is brief, but concise with any elaboration done by linking to the documentation already there. I haven't started as yet, have you got anything? -- Regards, David Mytton http://www.olate.co.uk
Re: [PHP-DOC] [webmaster] deadlink
I think the best option is to report this as a bug to the PHP Website team via http://bugs.php.net/report.php On Apr 8, 2005 4:01 PM, colder.ch [EMAIL PROTECTED] wrote: Hi. There is deadlink on the mailing list page (http://www.php.net/mailing-lists.php) under the section Local mailing lists and newsgroup : The French Mailing List link is dead. regards -- colder http://www.colder.ch/v2 [EMAIL PROTECTED] -- Regards, David Mytton http://www.olate.co.uk
[PHP-DOC] cvs: phpdoc /en/faq installation.xml
dmytton Thu Apr 7 17:45:39 2005 EDT Modified files: /phpdoc/en/faq installation.xml Log: Added note as per bug #32625 http://cvs.php.net/diff.php/phpdoc/en/faq/installation.xml?r1=1.43r2=1.44ty=u Index: phpdoc/en/faq/installation.xml diff -u phpdoc/en/faq/installation.xml:1.43 phpdoc/en/faq/installation.xml:1.44 --- phpdoc/en/faq/installation.xml:1.43 Tue Mar 8 08:51:17 2005 +++ phpdoc/en/faq/installation.xml Thu Apr 7 17:45:38 2005 @@ -1,5 +1,5 @@ ?xml version=1.0 encoding=iso-8859-1? -!-- $Revision: 1.43 $ -- +!-- $Revision: 1.44 $ -- chapter id=faq.installation titleInstallation/title titleabbrevInstallation/titleabbrev @@ -570,7 +570,13 @@ Save the file and restart your computer /para/listitem /itemizedlist - /para + /para + note + simpara + Be sure to reboot after following the steps above to ensure that the + varnamePATH/varname changes are applied. + /simpara + /note para The PHP manual used to promote the copying of files into the Windows system directory, this is because this directory
Re: [PHP-DOC] cvs: phpdoc /en/reference/calendar/functions cal-info.xml
Ahh, perhaps I should have read that README also... *printed* -- Regards, David Mytton http://www.olate.co.uk
Re: [PHP-DOC] Switching the howto to doc.php.net (was Re: [PHP-DOC] Contributing)
Since I recently started working on the docs, do you think it is worth me writing a quick start document with bullet points explaining exactly how to get involved (referencing pages in the howto)? When I originally looked at it, I found the howto very in depth and not that great for beginners. -- Regards, David Mytton http://www.olate.co.uk
Re: [PHP-DOC] Switching the howto to doc.php.net (was Re: [PHP-DOC] Contributing)
On Apr 6, 2005 4:14 PM, Gabor Hojtsy [EMAIL PROTECTED] wrote: A quick start guide would be nice at the start of the howto, which links to detailed information in the document. Goba Ok, I'll write something up either today or tomorrow. -- Regards, David Mytton http://www.olate.co.uk
Re: [PHP-DOC] Switching the howto to doc.php.net (was Re: [PHP-DOC] Contributing)
On Apr 6, 2005 6:18 PM, Philip Olson [EMAIL PROTECTED] wrote: Have you looked at the README? Yes, I have. -- Regards, David Mytton http://www.olate.co.uk
Re: [PHP-DOC] cvs: phpdoc /en/reference/errorfunc/functions
Yeah, I agree with the changes. It would make it much less confusing when you actually see the error output! Mehdi Achour wrote: Gabor Hojtsy wrote: +// redefine the user error constants - PHP 4 only +define(FATAL, E_USER_ERROR); +define(ERROR, E_USER_WARNING); +define(WARNING, E_USER_NOTICE); Is this from a different part of the manual? Is it supposed to be a good idea to rename WARNING to ERROR and NOTICE to WARNING? It is becoming a support nightmare then isn't it? I just copied it from the set_error_handler docs and changed the code so it demonstrated the revert to previous handler function. Yes, this was my suspicion... So I would like to hear others' opinions about the above confusing people (or not?). +1 for change it, and also to prefix the constants with something. (APP_ERROR, .. ) Mehdi
[PHP-DOC] cvs: phpdoc /en/reference/errorfunc/functions restore-error-handler.xml
dmytton Tue Apr 5 06:51:54 2005 EDT Modified files: /phpdoc/en/reference/errorfunc/functionsrestore-error-handler.xml Log: Fixed example switch statement output to show correct error types http://cvs.php.net/diff.php/phpdoc/en/reference/errorfunc/functions/restore-error-handler.xml?r1=1.7r2=1.8ty=u Index: phpdoc/en/reference/errorfunc/functions/restore-error-handler.xml diff -u phpdoc/en/reference/errorfunc/functions/restore-error-handler.xml:1.7 phpdoc/en/reference/errorfunc/functions/restore-error-handler.xml:1.8 --- phpdoc/en/reference/errorfunc/functions/restore-error-handler.xml:1.7 Tue Apr 5 03:16:48 2005 +++ phpdoc/en/reference/errorfunc/functions/restore-error-handler.xml Tue Apr 5 06:51:53 2005 @@ -1,5 +1,5 @@ ?xml version=1.0 encoding=iso-8859-1? -!-- $Revision: 1.7 $ -- +!-- $Revision: 1.8 $ -- !-- splitted from ./en/functions/errorfunc.xml, last change in rev 1.1 -- refentry id=function.restore-error-handler refnamediv @@ -47,17 +47,17 @@ { switch ($errno) { case E_USER_ERROR: -echo bMy FATAL/b [$errno] $errstrbr /\n; +echo bMy ERROR/b [$errno] $errstrbr /\n; echo Fatal error in line $errline of file $errfile; echo , PHP . PHP_VERSION . ( . PHP_OS . )br /\n; echo Aborting...br /\n; exit(1); break; case E_USER_WARNING: -echo bMy ERROR/b [$errno] $errstrbr /\n; +echo bMy WARNING/b [$errno] $errstrbr /\n; break; case E_USER_NOTICE: -echo bMy WARNING/b [$errno] $errstrbr /\n; +echo bMy NOTICE/b [$errno] $errstrbr /\n; break; default: echo My unkown error type: [$errno] $errstrbr /\n;
Re: [PHP-DOC] cvs: phpdoc /en/reference/errorfunc/functions restore-error-handler.xml
Gabor Hojtsy wrote: The output should be changed too :) It is not a good prectice to echo WARNING in case of a NOTICE, right? David's copy of this example should also be fixed. David? Goba All done :) Regards, David Mytton Olate Ltd http://www.olate.co.uk
[PHP-DOC] cvs: phpdoc /en/reference/mysqli/functions mysqli-data-seek.xml
dmytton Tue Apr 5 06:57:50 2005 EDT Modified files: /phpdoc/en/reference/mysqli/functions mysqli-data-seek.xml Log: Fixed bug 32570 http://cvs.php.net/diff.php/phpdoc/en/reference/mysqli/functions/mysqli-data-seek.xml?r1=1.17r2=1.18ty=u Index: phpdoc/en/reference/mysqli/functions/mysqli-data-seek.xml diff -u phpdoc/en/reference/mysqli/functions/mysqli-data-seek.xml:1.17 phpdoc/en/reference/mysqli/functions/mysqli-data-seek.xml:1.18 --- phpdoc/en/reference/mysqli/functions/mysqli-data-seek.xml:1.17 Fri Nov 12 09:01:03 2004 +++ phpdoc/en/reference/mysqli/functions/mysqli-data-seek.xml Tue Apr 5 06:57:48 2005 @@ -1,5 +1,5 @@ ?xml version=1.0 encoding=iso-8859-1? -!-- $Revision: 1.17 $ -- +!-- $Revision: 1.18 $ -- refentry id=function.mysqli-data-seek refnamediv refnamemysqli_data_seek/refname @@ -30,7 +30,7 @@ /para note para - This function can only be used with unbuffered results attained from the use of the + This function can only be used with buffered results attained from the use of the functionmysqli_store_result/function or functionmysqli_query/function functions. /para /note
Re: [PHP-DOC] #32573 [NEW]: Incomplete documentation of mysqli_query command
Sean Coates wrote: David Mytton wrote: By the way, the text you closed it with - is that in the quick fix drop menu as I can't see it on there anywhere? Yes, fixed in CVS S In which case, should http://bugs.php.net/quick-fix-desc.php be updated to say that the actual message posted will change depending on the category (I'm assuming it changes depending if the category is docs or PHP itself?) Regards, David Mytton Olate Ltd http://www.olate.co.uk
Re: [PHP-DOC] #32573 [NEW]: Incomplete documentation of mysqli_query command
Derick Rethans wrote: On Mon, 4 Apr 2005, David Mytton wrote: Should work now, can you please test? regards, Derick Yeh, it does work now - I just closed a bug ok. It had me logged in automatically. Regards, David Mytton Olate Ltd http://www.olate.co.uk
[PHP-DOC] Bug #26096 - Date format
Presumably, this was decided long ago and won't be changed, so this bug can be closed? http://bugs.php.net/bug.php?id=26096 -- Regards, David Mytton Managing Director - Olate Ltd http://www.olate.co.uk
[PHP-DOC] cvs: phpdoc /en/reference/filesystem/functions is-readable.xml
dmytton Tue Apr 5 11:36:42 2005 EDT Modified files: /phpdoc/en/reference/filesystem/functions is-readable.xml Log: Added example http://cvs.php.net/diff.php/phpdoc/en/reference/filesystem/functions/is-readable.xml?r1=1.5r2=1.6ty=u Index: phpdoc/en/reference/filesystem/functions/is-readable.xml diff -u phpdoc/en/reference/filesystem/functions/is-readable.xml:1.5 phpdoc/en/reference/filesystem/functions/is-readable.xml:1.6 --- phpdoc/en/reference/filesystem/functions/is-readable.xml:1.5Sat Nov 29 11:39:55 2003 +++ phpdoc/en/reference/filesystem/functions/is-readable.xmlTue Apr 5 11:36:41 2005 @@ -1,5 +1,5 @@ ?xml version=1.0 encoding=iso-8859-1? -!-- $Revision: 1.5 $ -- +!-- $Revision: 1.6 $ -- !-- splitted from ./en/functions/filesystem.xml, last change in rev 1.2 -- refentry id=function.is-readable refnamediv @@ -20,6 +20,23 @@ id that the web server runs as (often 'nobody'). Safe mode limitations are not taken into account. /para +para + example + titlefunctionis_writable/function example/title + programlisting role=php +![CDATA[ +?php +$filename = 'test.txt'; +if (is_readable($filename)) { + echo 'The file is readable'; +} else { + echo 'The file is not readable'; +} +? +]] + /programlisting + /example +/para note.clearstatcache;
[PHP-DOC] Missing Examples List Updating
Hi, The http://www.phpdoc.info/meta/missing-examples.php list isn't updating. I'd like to use that so I can add examples to functions that don't have them. Is anyone able to set it updating again or tell me how I can do it? Thanks -- Regards, David Mytton http://www.olate.co.uk
[PHP-DOC] cvs: phpdoc /en/reference/filesystem/functions is-file.xml
dmytton Tue Apr 5 11:46:30 2005 EDT Modified files: /phpdoc/en/reference/filesystem/functions is-file.xml Log: Added example http://cvs.php.net/diff.php/phpdoc/en/reference/filesystem/functions/is-file.xml?r1=1.6r2=1.7ty=u Index: phpdoc/en/reference/filesystem/functions/is-file.xml diff -u phpdoc/en/reference/filesystem/functions/is-file.xml:1.6 phpdoc/en/reference/filesystem/functions/is-file.xml:1.7 --- phpdoc/en/reference/filesystem/functions/is-file.xml:1.6Sat Nov 29 11:39:55 2003 +++ phpdoc/en/reference/filesystem/functions/is-file.xmlTue Apr 5 11:46:30 2005 @@ -1,5 +1,5 @@ ?xml version=1.0 encoding=iso-8859-1? -!-- $Revision: 1.6 $ -- +!-- $Revision: 1.7 $ -- !-- splitted from ./en/functions/filesystem.xml, last change in rev 1.2 -- refentry id=function.is-file refnamediv @@ -15,6 +15,26 @@ para Returns true; if the filename exists and is a regular file. /para +para + example + titlefunctionis_file/function example/title + programlisting role=php +![CDATA[ +? +var_dump(is_file('a_file.txt')) . \n; +var_dump(is_file('/usr/bin/')) . \n; +? +]] + /programlisting + example.outputs; + screen +![CDATA[ +bool(true) +bool(false) +]] + /screen + /example +/para note.clearstatcache;
[PHP-DOC] cvs: phpdoc /en/reference/filesystem/functions is-readable.xml is-writable.xml
dmytton Tue Apr 5 13:36:37 2005 EDT Modified files: /phpdoc/en/reference/filesystem/functions is-readable.xml is-writable.xml Log: Removed tabs from examples http://cvs.php.net/diff.php/phpdoc/en/reference/filesystem/functions/is-readable.xml?r1=1.6r2=1.7ty=u Index: phpdoc/en/reference/filesystem/functions/is-readable.xml diff -u phpdoc/en/reference/filesystem/functions/is-readable.xml:1.6 phpdoc/en/reference/filesystem/functions/is-readable.xml:1.7 --- phpdoc/en/reference/filesystem/functions/is-readable.xml:1.6Tue Apr 5 11:36:41 2005 +++ phpdoc/en/reference/filesystem/functions/is-readable.xmlTue Apr 5 13:36:37 2005 @@ -1,5 +1,5 @@ ?xml version=1.0 encoding=iso-8859-1? -!-- $Revision: 1.6 $ -- +!-- $Revision: 1.7 $ -- !-- splitted from ./en/functions/filesystem.xml, last change in rev 1.2 -- refentry id=function.is-readable refnamediv @@ -28,9 +28,9 @@ ?php $filename = 'test.txt'; if (is_readable($filename)) { - echo 'The file is readable'; +echo 'The file is readable'; } else { - echo 'The file is not readable'; +echo 'The file is not readable'; } ? ]] http://cvs.php.net/diff.php/phpdoc/en/reference/filesystem/functions/is-writable.xml?r1=1.7r2=1.8ty=u Index: phpdoc/en/reference/filesystem/functions/is-writable.xml diff -u phpdoc/en/reference/filesystem/functions/is-writable.xml:1.7 phpdoc/en/reference/filesystem/functions/is-writable.xml:1.8 --- phpdoc/en/reference/filesystem/functions/is-writable.xml:1.7Mon Apr 4 13:31:30 2005 +++ phpdoc/en/reference/filesystem/functions/is-writable.xmlTue Apr 5 13:36:37 2005 @@ -1,5 +1,5 @@ ?xml version=1.0 encoding=iso-8859-1? -!-- $Revision: 1.7 $ -- +!-- $Revision: 1.8 $ -- !-- splitted from ./en/functions/filesystem.xml, last change in rev 1.2 -- refentry id=function.is-writable refnamediv @@ -30,9 +30,9 @@ ?php $filename = 'test.txt'; if (is_writable($filename)) { - echo 'The file is writable'; +echo 'The file is writable'; } else { - echo 'The file is not writable'; +echo 'The file is not writable'; } ? ]]
[PHP-DOC] cvs: phpdoc /en/reference/calendar/functions cal-info.xml
dmytton Tue Apr 5 17:31:12 2005 EDT Modified files: /phpdoc/en/reference/calendar/functions cal-info.xml Log: Added param calendar info from note and added example http://cvs.php.net/diff.php/phpdoc/en/reference/calendar/functions/cal-info.xml?r1=1.10r2=1.11ty=u Index: phpdoc/en/reference/calendar/functions/cal-info.xml diff -u phpdoc/en/reference/calendar/functions/cal-info.xml:1.10 phpdoc/en/reference/calendar/functions/cal-info.xml:1.11 --- phpdoc/en/reference/calendar/functions/cal-info.xml:1.10Thu Nov 11 09:54:23 2004 +++ phpdoc/en/reference/calendar/functions/cal-info.xml Tue Apr 5 17:31:12 2005 @@ -1,5 +1,5 @@ ?xml version=1.0 encoding=iso-8859-1? -!-- $Revision: 1.10 $ -- +!-- $Revision: 1.11 $ -- !-- splitted from ./en/functions/calendar.xml, last change in rev 1.19 -- refentry id='function.cal-info' refnamediv @@ -20,13 +20,92 @@ Calendar information is returned as an array containing the elements literalcalname/literal, literalcalsymbol/literal, literalmonth/literal, literalabbrevmonth/literal and - literalmaxdaysinmonth/literal. + literalmaxdaysinmonth/literal. The names of the different calendars + which can be used as parametercalendar/parameter are as follows: + itemizedlist + listitem + simpara +0 or CAL_GREGORIAN - Gregorian Calendar + /simpara + /listitem + listitem + simpara +1 or CAL_JULIAN - Julian Calendar + /simpara + /listitem + listitem + simpara +2 or CAL_JEWISH - Jewish Calendar + /simpara + /listitem + listitem + simpara +3 or CAL_FRENCH - French Revolutionary Calendar + /simpara + /listitem + /itemizedlist /para para If no parametercalendar/parameter is specified information on all supported calendars is returned as an array. This functionality is available beginning with PHP 5. /para +para + example + titlefunctioncal_info/function example/title + programlisting role=php +![CDATA[ +?php +$info = cal_info(0); +print_r($info); +? +]] + /programlisting + example.outputs; + screen +![CDATA[ +Array +( +[months] = Array +( +[1] = January +[2] = February +[3] = March +[4] = April +[5] = May +[6] = June +[7] = July +[8] = August +[9] = September +[10] = October +[11] = November +[12] = December +) + +[abbrevmonths] = Array +( +[1] = Jan +[2] = Feb +[3] = Mar +[4] = Apr +[5] = May +[6] = Jun +[7] = Jul +[8] = Aug +[9] = Sep +[10] = Oct +[11] = Nov +[12] = Dec +) + +[maxdaysinmonth] = 31 +[calname] = Gregorian +[calsymbol] = CAL_GREGORIAN +) +]] + /screen + /example +/para /refsect1 /refentry
[PHP-DOC] dir.closedir
Hi, I have added an example to the dir.closedir function. Diff is attached. -- Regards, David Mytton Olate Ltd http://www.olate.co.uk ? dir.closedir.xml.diff Index: closedir.xml === RCS file: /repository/phpdoc/en/reference/dir/functions/closedir.xml,v retrieving revision 1.4 diff -u -r1.4 closedir.xml --- closedir.xml1 Nov 2004 16:08:20 - 1.4 +++ closedir.xml4 Apr 2005 15:45:38 - @@ -17,6 +17,26 @@ parameterdir_handle/parameter. The stream must have previously been opened by functionopendir/function. /para +para + example + titlefunctionclosedir/function example/title + programlisting role=php +![CDATA[ +?php +$dir = /etc/php5/; + +// Open a known directory, read directory into variable and then close +if (is_dir($dir)) { +if ($dh = opendir($dir)) { +$directory = readdir($dh); +closedir($dh); +} +} +? +]] + /programlisting + /example +/para /refsect1 /refentry
[PHP-DOC] errorfunc.restore-error-handler
Hi, I have added an example to the errorfunc.restore_error_handler function. Diff is attached. -- Regards, David Mytton Olate Ltd http://www.olate.co.uk ? errorfunc.restore-error-handler.xml.diff Index: restore-error-handler.xml === RCS file: /repository/phpdoc/en/reference/errorfunc/functions/restore-error-handler.xml,v retrieving revision 1.5 diff -u -r1.5 restore-error-handler.xml --- restore-error-handler.xml 14 Dec 2004 11:53:48 - 1.5 +++ restore-error-handler.xml 4 Apr 2005 16:18:05 - @@ -26,6 +26,68 @@ functionrestore_exception_handler/function, functiontrigger_error/function. /para +para + The example below shows the handling of internal exceptions by + triggering errors and handling them with a user defined function. It then + restores the original PHP error handling: + example + title + Error handling with functionset_error_handler/function, + functiontrigger_error/function and + functionrestore_error_handler/function + /title + programlisting role=php +![CDATA[ +?php +// redefine the user error constants - PHP 4 only +define(FATAL, E_USER_ERROR); +define(ERROR, E_USER_WARNING); +define(WARNING, E_USER_NOTICE); + +// set the error reporting level for this script +error_reporting(FATAL | ERROR | WARNING); + +// error handler function +function myErrorHandler($errno, $errstr, $errfile, $errline) +{ + switch ($errno) { + case FATAL: +echo bMy FATAL/b [$errno] $errstrbr /\n; +echo Fatal error in line $errline of file $errfile; +echo , PHP . PHP_VERSION . ( . PHP_OS . )br /\n; +echo Aborting...br /\n; +exit(1); +break; + case ERROR: +echo bMy ERROR/b [$errno] $errstrbr /\n; +break; + case WARNING: +echo bMy WARNING/b [$errno] $errstrbr /\n; +break; + default: +echo My unkown error type: [$errno] $errstrbr /\n; +break; + } +} + +set_error_handler(myErrorHandler); +trigger_error('Test error', ERROR); + +restore_error_handler(); // Will restore standard PHP handler +trigger_error('Test error', ERROR); +? +]] + /programlisting + example.outputs; + screen +![CDATA[ +My ERROR [512] Test error + +Warning: Test error in C:\Program Files\Apache Group\Apache2\htdocs\readdir.php on line 45 +]] + /screen + /example +/para /refsect1 /refentry
[PHP-DOC] cvs: phpdoc /en/reference/filesystem/functions is-writable.xml
dmytton Mon Apr 4 13:31:30 2005 EDT Modified files: /phpdoc/en/reference/filesystem/functions is-writable.xml Log: Added example http://cvs.php.net/diff.php/phpdoc/en/reference/filesystem/functions/is-writable.xml?r1=1.6r2=1.7ty=u Index: phpdoc/en/reference/filesystem/functions/is-writable.xml diff -u phpdoc/en/reference/filesystem/functions/is-writable.xml:1.6 phpdoc/en/reference/filesystem/functions/is-writable.xml:1.7 --- phpdoc/en/reference/filesystem/functions/is-writable.xml:1.6Sat Nov 29 11:39:55 2003 +++ phpdoc/en/reference/filesystem/functions/is-writable.xmlMon Apr 4 13:31:30 2005 @@ -1,5 +1,5 @@ ?xml version=1.0 encoding=iso-8859-1? -!-- $Revision: 1.6 $ -- +!-- $Revision: 1.7 $ -- !-- splitted from ./en/functions/filesystem.xml, last change in rev 1.2 -- refentry id=function.is-writable refnamediv @@ -22,6 +22,23 @@ that the web server runs as (often 'nobody'). Safe mode limitations are not taken into account. /para +para + example + titlefunctionis_writable/function example/title + programlisting role=php +![CDATA[ +?php +$filename = 'test.txt'; +if (is_writable($filename)) { + echo 'The file is writable'; +} else { + echo 'The file is not writable'; +} +? +]] + /programlisting + /example +/para note.clearstatcache;
[PHP-DOC] cvs: phpdoc /en/reference/filesystem/functions fwrite.xml
dmytton Mon Apr 4 13:32:43 2005 EDT Modified files: /phpdoc/en/reference/filesystem/functions fwrite.xml Log: Added function tag to example title http://cvs.php.net/diff.php/phpdoc/en/reference/filesystem/functions/fwrite.xml?r1=1.12r2=1.13ty=u Index: phpdoc/en/reference/filesystem/functions/fwrite.xml diff -u phpdoc/en/reference/filesystem/functions/fwrite.xml:1.12 phpdoc/en/reference/filesystem/functions/fwrite.xml:1.13 --- phpdoc/en/reference/filesystem/functions/fwrite.xml:1.12Thu Aug 26 04:57:23 2004 +++ phpdoc/en/reference/filesystem/functions/fwrite.xml Mon Apr 4 13:32:43 2005 @@ -1,5 +1,5 @@ ?xml version=1.0 encoding=iso-8859-1? -!-- $Revision: 1.12 $ -- +!-- $Revision: 1.13 $ -- !-- splitted from ./en/functions/filesystem.xml, last change in rev 1.2 -- refentry id=function.fwrite refnamediv @@ -43,7 +43,7 @@ /note para example - titleA simple fwrite example/title + titleA simple functionfwrite/function example/title programlisting role=php ![CDATA[ ?php
[PHP-DOC] cvs: phpdoc /en/reference/mysqli/functions mysqli-query.xml
dmytton Mon Apr 4 13:47:31 2005 EDT Modified files: /phpdoc/en/reference/mysqli/functions mysqli-query.xml Log: Fix for bug #32573 http://cvs.php.net/diff.php/phpdoc/en/reference/mysqli/functions/mysqli-query.xml?r1=1.8r2=1.9ty=u Index: phpdoc/en/reference/mysqli/functions/mysqli-query.xml diff -u phpdoc/en/reference/mysqli/functions/mysqli-query.xml:1.8 phpdoc/en/reference/mysqli/functions/mysqli-query.xml:1.9 --- phpdoc/en/reference/mysqli/functions/mysqli-query.xml:1.8 Fri Nov 12 09:01:03 2004 +++ phpdoc/en/reference/mysqli/functions/mysqli-query.xml Mon Apr 4 13:47:28 2005 @@ -1,5 +1,5 @@ ?xml version=1.0 encoding=iso-8859-1? -!-- $Revision: 1.8 $ -- +!-- $Revision: 1.9 $ -- refentry id=function.mysqli-query refnamediv refnamemysqli_query/refname @@ -21,6 +21,7 @@ methodsynopsis typemixed/typemethodnamequery/methodname methodparamtypestring/typeparameterquery/parameter/methodparam + methodparam choice='opt'typeint/typeparameterresultmode/parameter/methodparam /methodsynopsis /classsynopsis para
[PHP-DOC] cvs: phpdoc /en/reference/errorfunc/functions restore-error-handler.xml
dmytton Mon Apr 4 14:00:22 2005 EDT Modified files: /phpdoc/en/reference/errorfunc/functionsrestore-error-handler.xml Log: Added example http://cvs.php.net/diff.php/phpdoc/en/reference/errorfunc/functions/restore-error-handler.xml?r1=1.5r2=1.6ty=u Index: phpdoc/en/reference/errorfunc/functions/restore-error-handler.xml diff -u phpdoc/en/reference/errorfunc/functions/restore-error-handler.xml:1.5 phpdoc/en/reference/errorfunc/functions/restore-error-handler.xml:1.6 --- phpdoc/en/reference/errorfunc/functions/restore-error-handler.xml:1.5 Tue Dec 14 06:53:48 2004 +++ phpdoc/en/reference/errorfunc/functions/restore-error-handler.xml Mon Apr 4 14:00:21 2005 @@ -1,5 +1,5 @@ ?xml version=1.0 encoding=iso-8859-1? -!-- $Revision: 1.5 $ -- +!-- $Revision: 1.6 $ -- !-- splitted from ./en/functions/errorfunc.xml, last change in rev 1.1 -- refentry id=function.restore-error-handler refnamediv @@ -26,6 +26,68 @@ functionrestore_exception_handler/function, functiontrigger_error/function. /para +para + The example below shows the handling of internal exceptions by + triggering errors and handling them with a user defined function. It then + restores the original PHP error handling: + example + title + Error handling with functionset_error_handler/function, + functiontrigger_error/function and + functionrestore_error_handler/function + /title + programlisting role=php +![CDATA[ +?php +// redefine the user error constants - PHP 4 only +define(FATAL, E_USER_ERROR); +define(ERROR, E_USER_WARNING); +define(WARNING, E_USER_NOTICE); + +// set the error reporting level for this script +error_reporting(FATAL | ERROR | WARNING); + +// error handler function +function myErrorHandler($errno, $errstr, $errfile, $errline) +{ + switch ($errno) { + case FATAL: +echo bMy FATAL/b [$errno] $errstrbr /\n; +echo Fatal error in line $errline of file $errfile; +echo , PHP . PHP_VERSION . ( . PHP_OS . )br /\n; +echo Aborting...br /\n; +exit(1); +break; + case ERROR: +echo bMy ERROR/b [$errno] $errstrbr /\n; +break; + case WARNING: +echo bMy WARNING/b [$errno] $errstrbr /\n; +break; + default: +echo My unkown error type: [$errno] $errstrbr /\n; +break; + } +} + +set_error_handler(myErrorHandler); +trigger_error('Test error', ERROR); + +restore_error_handler(); // Will restore standard PHP handler +trigger_error('Test error', ERROR); +? +]] + /programlisting + example.outputs.similar; + screen +![CDATA[ +My ERROR [512] Test error + +Warning: Test error in C:\Program Files\Apache Group\Apache2\htdocs\readdir.php on line 45 +]] + /screen + /example +/para /refsect1 /refentry
Re: [PHP-DOC] errorfunc.restore-error-handler
Ahh yes, thanks for that. I'll remember for next time :) I also committed the changes since I now have my CVS account. Regards, David Mytton Olate Ltd http://www.olate.co.uk Philip Olson wrote: Be sure to use example.outputs.similar; instead of example.outputs; where appropriate.
Re: [PHP-DOC] #32573 [NEW]: Incomplete documentation of mysqli_query command
I fixed this but I can't close the bug - The username or password you supplied was incorrect. Regards, David Mytton Olate Ltd http://www.olate.co.uk jmarbas at hotmail dot com wrote: From: jmarbas at hotmail dot com Operating system: n/a PHP version: 5.0.3 PHP Bug Type: Documentation problem Bug description: Incomplete documentation of mysqli_query command Description: http://ca3.php.net/manual/en/function.mysqli-query.php On the documentation for mysql_query you listed its syntax as below: class mysqli { mixed query (string query) } But you missed the resultmode parameter and it should read class mysqli { mixed query (string query[,int resultmode]) }
Re: [PHP-DOC] #32573 [NEW]: Incomplete documentation of mysqli_query command
Thanks for that. By the way, the text you closed it with - is that in the quick fix drop menu as I can't see it on there anywhere? Regards, David Mytton Olate Ltd http://www.olate.co.uk Sean Coates wrote: David Mytton wrote: I fixed this but I can't close the bug - The username or password you supplied was incorrect. I'd guess that your account info hasn't porpagated, yet. I've closed it for you, in the mean time. S
Re: [PHP-DOC] #32573 [NEW]: Incomplete documentation of mysqli_query command
Derick Rethans wrote: You can do it, go to the developer tab. Theusername and password are only for the original bug's submitter. Derick On the developer tag, it says CVS Username and Password though... Isn't the Edit Submission tab for the original submitter? Regards, David Mytton Olate Ltd http://www.olate.co.uk
Re: [PHP-DOC] #32573 [NEW]: Incomplete documentation of mysqli_query command
Derick Rethans wrote: On Mon, 4 Apr 2005, David Mytton wrote: correct. you're saying that your cvs username and password don't work? Derick Yeh, it didn't work when I tried to login. I suspect it hasn't propagated throughout the whole site yet? David
Re: [PHP-DOC] cvs: phpdoc /en/reference/errorfunc/functions restore-error-handler.xml
Gabor Hojtsy wrote: +// redefine the user error constants - PHP 4 only +define(FATAL, E_USER_ERROR); +define(ERROR, E_USER_WARNING); +define(WARNING, E_USER_NOTICE); Is this from a different part of the manual? Is it supposed to be a good idea to rename WARNING to ERROR and NOTICE to WARNING? It is becoming a support nightmare then isn't it? Goba I just copied it from the set_error_handler docs and changed the code so it demonstrated the revert to previous handler function. David
Re: [PHP-DOC] openjade/opensp with cygwin
Hi, I'm going to be installing Cygwin today so I'll try and check this. David Gabor Hojtsy wrote: Hi, Have someone tried an openjade and sp install within cygwin? It would greatly simplify the windows setup process, if we could say that someone is fine with using the openjade provided with cygwin, if it works well, and would not need to setup openjade/opensp themselfs... Could someone on Windows please try this out? http://cygwin.com/cgi-bin2/package-cat.cgi?file=OpenSP%2FOpenSP-1.5.1-1 http://cygwin.com/cgi-bin2/package-cat.cgi?file=openjade%2Fopenjade-1.3.3-1 Goba
Re: [PHP-DOC] Contributing
Gabor Hojtsy wrote: Yes, it would definitely be better. I can hand out CVS write access to those, who are willing to contribute to the doc.php.net website, which is supposed to be this very place. The doc website team has a mailing list, but sadly only a few people are active. http://news.php.net/php.doc.web Since I'm new I'll be going through the process described in the doc website at the moment so I could help out by adding to it in places I get stuck. Perhaps a FAQ might be appropriate because I asked a couple of questions on this list and in IRC last night which weren't answered in the howto. But I don't have a CVS account yet (I have e-mailed group@). My first thoughts when looking at it was that there is a lot of info there and some of it is quite complex. It might be worth adding a 'First Steps' page which has a numbered list of very brief instructions about how to get started. That could be the first thing to read for new people which explains what to do next and could link to the other pages which describe everything in more detail. David
Re: [PHP-DOC] Functions without examples - datetime
Sean Coates wrote: The data at http://www.phpdoc.info/meta/ has been inaccurate for at least as long (less than a week, though), as these scripts used to be located in a different place, and I forgot to update the config. (I have them half moved to docweb, but.. time constraints...) The generator is running now (and it updates daily when it's not broken). So that will update every day now will it? I'd like to be able to use that to go through and add examples to functions that don't have any. David
Re: [PHP-DOC] #32410 [Opn]: Documentation unclear for SoapHeader
Is this really a valid bug? Is it down to the doc writers to provide examples for something like this? David gehrig at ishd dot de wrote: ID: 32410 User updated by: gehrig at ishd dot de Reported By: gehrig at ishd dot de Status: Open Bug Type: Documentation problem Operating System: Linux PHP Version: 5.0.3 New Comment: On http://www.php3.de/soap there is a section headed SoapHeader. In this section the manual states: SoapHeader is a special low-level class for passing or returning SOAP headers. It's just a data holder and it does not have any special methods except its constructor. It can be used in the SoapClient-__soapCall() method to pass a SOAP header or in a SOAP header handler to return the header in a SOAP response. But it doesn't mention how to implement a, what it calls, SOAP header handler. I'd like to receive a header in a SOAP request to a PhP5-SOAP-server (which is no problem at all) and I'd like to send back a header in the SOAP response from this server - but I have no clue how to do this.
Re: [PHP-DOC] #32410 [Opn]: Documentation unclear for SoapHeader
Ok. I'm not too familiar with SOAP (never needed to use it before) so I'll have to do some research into this before I do so. But does anyone have any examples for this function I could possibly use? Mehdi Achour wrote: IMHO, the more (consistant) examples we have, the more we help our readers. Feel free to add the example :) Mehdi
Re: [PHP-DOC] #32410 [Opn]: Documentation unclear for SoapHeader
Thanks! Leonardo Boshell wrote: Hi David, Ok. I'm not too familiar with SOAP (never needed to use it before) so I'll have to do some research into this before I do so. But does anyone have any examples for this function I could possibly use? I was asked recently to develop a program that used Google's AdWords API, which uses SOAP as the transport protocol. I'm attaching a piece of the PHP code I used in that program. It only shows how to send SOAP headers when acting as a client, but I guess it should be similar when acting as a server. Feel free to modify it to the needs of the manual. Leonardo B.
Re: [PHP-DOC] openjade/opensp with cygwin
I thought I'd provide some notes for my experience with cygwin because it was not straightforward! - Downloading and installing the default setup.exe from cygwin is not sufficient. It does not come with any of the packages that you need by default. I had to manually install the following: Devel autoconf Devel automake Devel binutils Devel cvs Devel make Doc libxml2 Editors nano (my preferred editor) - The step described at http://doc.php.net/php/dochowto/tools-on-windows.php where you have to mkdir phpdoc-tools and then create the php.bat file resulted in a file being created that strangely had incorrect permissions. When running the ./configure command I got this: checking for php... ../phpdoc-tools/php.bat checking php version ... ./configure: line 1: ../phpdoc-tools/php.bat: Permission denied ./configure: line 1: ../phpdoc-tools/php.bat: Permission denied ./configure: line 1412: test: yes: unary operator expected configure: error: PHP version 4.0.0 or newer needed So I deleted the file through Windows Explorer and then created it using notepad. The it worked fine. - I have got kind of stuck when it came to doing validation. First I ran make test as suggested in http://doc.php.net/php/dochowto/chapter-validating.php but that output masses of errors about badly formed xml files (which weren't mine). I then tried to run scripts/xml-check.php en/reference/datetime/functions/localtime.xml but nobody said you had to put that through the PHP CLI first! That was solved by running it as: ../phpdoc-tools/php.bat scripts/xml-check.php en/reference/datetime/functions/localtime.xml Which ran and output an error saying xmlint is not recognised as an internal or external command. Seems I needed another cygwin package - xmllib2. After that was installed, everything went fine and the script ran without outputting any errors - I assume that is good and my XML is fine. - Finally, since I have no CVS account I need to generate a CVS diff. cd en/reference/datetime/functions cvs diff localtime.xml localtime.diff So everything seemed to work ok. I'll mail the CVS diff in a separate e-mail. Might be worth mentioning some of my above points on the docs howto somewhere. David Gabor Hojtsy wrote: Hi, Have someone tried an openjade and sp install within cygwin? It would greatly simplify the windows setup process, if we could say that someone is fine with using the openjade provided with cygwin, if it works well, and would not need to setup openjade/opensp themselfs... Could someone on Windows please try this out? http://cygwin.com/cgi-bin2/package-cat.cgi?file=OpenSP%2FOpenSP-1.5.1-1 http://cygwin.com/cgi-bin2/package-cat.cgi?file=openjade%2Fopenjade-1.3.3-1 Goba
Re: [PHP-DOC] function.localtime
Hi, I've attached the diff of my latest attempt using cygwin this time. David Index: localtime.xml === RCS file: /repository/phpdoc/en/reference/datetime/functions/localtime.xml,v retrieving revision 1.3 diff -u -r1.3 localtime.xml --- localtime.xml 29 Mar 2003 15:15:45 - 1.3 +++ localtime.xml 3 Apr 2005 14:59:44 - @@ -78,6 +78,11 @@ /simpara /listitem /itemizedlist + note + simpara + Months are from 0 (Jan) to 11 (Dec) and days of the week are from 0 (Sunday) to 6 (Saturday) + /simpara + /note /para /refsect1 /refentry
Re: [PHP-DOC] Re: openjade/opensp with cygwin
Hi, Just tried to do a make html but it failed with an openjade error saying it could not find certain .xml files even though they are present in the correct directories. I have downloaded new copies from the website and tried to build them manually but I still can't get it to work. Any suggestions? David Gabor Hojtsy wrote: Just tried to do a make html but it failed with an openjade error saying it could not find certain .xml files even though they are present in the correct directories. I have downloaded new copies from the website and tried to build them manually but I still can't get it to work. Any suggestions? Please post this to the phpdoc list. Goba
Re: [PHP-DOC] Re: openjade/opensp with cygwin
Using the openjade provided with cygwin. I have attached the output from running make html but it doesn't show the errors afterwards. For some reason they are outputted to the console. But it is like this: /usr/bin/openjade:manual.xml:49:1:E: cannot find C:/cygwin/home/David/phpdocen/bookinfo.xml /usr/bin/openjade:manual.xml:50:1:E: cannot find C:/cygwin/home/David/phpdocen/preface.xml /usr/bin/openjade:manual.xml:54:2:E: cannot find C:/cygwin/home/David/phpdocen/intro.xml ... David Gabor Hojtsy wrote: Openjade installed by cygwin? Openjade installed by you as windows exe? What XML files does it miss? Goba
Re: [PHP-DOC] Re: openjade/opensp with cygwin
Here is the output but without any of the errors. Gabor Hojtsy wrote: Openjade installed by cygwin? Openjade installed by you as windows exe? What XML files does it miss? Goba rm -rf html mkdir html ../phpdoc-tools/php.bat -q ./scripts/rtlpatch/hackmanuallang.php en SP_ENCODING=XML SP_CHARSET_FIXED=YES /usr/bin/openjade -D . -wno-idref -c ./entities/ISO/catalog -c ./dsssl/docbook/catalog -c ./dsssl/defaults/catalog -d dsssl/html.dsl -V use-output-dir -t sgml ./dtds/dbxml-4.1.2/phpdocxml.dcl manual.xml ../phpdoc-tools/php.bat -q ./scripts/html_syntax.php html html/ ../phpdoc-tools/php.bat -q ./scripts/rtlpatch/hackmanuallang.php en
Re: [PHP-DOC] Re: openjade/opensp with cygwin
I have it all working now. First, I installed openjade through cygwin and ran autoconf and ./configure. Running make html generated the errors I posted a while ago. Then I tried downloading jade itself but I didn't realise I was downloading the windows source (I didn't spot the link to the binaries). Finally, I spotted the binary (which has the jade.exe file) and then extracted that to the phpdoc-tools/jade dir. Then reconfigured the phpdoc and ran make html - which is running right now. So I'm hoping it will be successful :-) So in conclusion, the openjade that comes with cygwin doesn't work. Gabor Hojtsy wrote: Well, slashes are missing between phpdoc and en in the path values. David, could you copy-paste the first 20 lines of your phpdoc/entities/file-entities.ent file? It should have proper path values, but it probably has bogus ones. Goba So, openjade seems still not to work.. - Original Message - Using the openjade provided with cygwin. I have attached the output from running make html but it doesn't show the errors afterwards. For some reason they are outputted to the console. But it is like this: /usr/bin/openjade:manual.xml:49:1:E: cannot find C:/cygwin/home/David/phpdocen/bookinfo.xml /usr/bin/openjade:manual.xml:50:1:E: cannot find C:/cygwin/home/David/phpdocen/preface.xml /usr/bin/openjade:manual.xml:54:2:E: cannot find C:/cygwin/home/David/phpdocen/intro.xml ... David Gabor Hojtsy wrote: Openjade installed by cygwin? Openjade installed by you as windows exe? What XML files does it miss? Goba
Re: [PHP-DOC] Re: openjade/opensp with cygwin
Gabor Hojtsy wrote: Could you please revert back to the without jade setup and post those 20 lines I have asked you for? !-- DON'T TOUCH - AUTOGENERATED BY file-entities.php -- !-- ZendAPI not found -- !ENTITY zendapi.toc '' !-- global function index file -- !ENTITY global.function-indexSYSTEM 'C:/cygwin/home/David/phpdoc/funcindex.xml' !-- generated file with missing ids -- !ENTITY missing-ids SYSTEM 'C:/cygwin/home/David/phpdoc/entities/missing-ids.xml' !-- all other files -- !ENTITY appendices.about SYSTEM 'C:/cygwin/home/David/phpdoc/en/appendices/about.xml' !ENTITY appendices.aliases SYSTEM 'C:/cygwin/home/David/phpdoc/en/appendices/aliases.xml' !ENTITY appendices.comparisons SYSTEM 'C:/cygwin/home/David/phpdoc/en/appendices/comparisons.xml' !ENTITY appendices.configure.index SYSTEM 'C:/cygwin/home/David/phpdoc/en/appendices/configure/index.xml' !ENTITY appendices.configure.miscSYSTEM 'C:/cygwin/home/David/phpdoc/en/appendices/configure/misc.xml' !ENTITY appendices.configure.php SYSTEM 'C:/cygwin/home/David/phpdoc/en/appendices/configure/php.xml' !ENTITY appendices.configure.servers SYSTEM 'C:/cygwin/home/David/phpdoc/en/appendices/configure/servers.xml' !ENTITY appendices.debugger SYSTEM 'C:/cygwin/home/David/phpdoc/en/appendices/debugger.xml' !ENTITY appendices.filters SYSTEM 'C:/cygwin/home/David/phpdoc/en/appendices/filters.xml' !ENTITY appendices.history SYSTEM 'C:/cygwin/home/David/phpdoc/en/appendices/history.xml' !ENTITY appendices.ini SYSTEM 'C:/cygwin/home/David/phpdoc/en/appendices/ini.xml' !ENTITY appendices.license SYSTEM 'C:/cygwin/home/David/phpdoc/en/appendices/license.xml' !ENTITY appendices.migration SYSTEM 'C:/cygwin/home/David/phpdoc/en/appendices/migration.xml'
Re: [PHP-DOC] Re: openjade/opensp with cygwin
The rest of the document is just like that. All the paths seem to be correct. For example one of the errors is: /usr/bin/openjade:manual.xml:168:2:E: cannot find C:/cygwin/home/David/phpdoc/entities/missing-ids.xml; tried entities/C:/cygwin/home/David/phpdoc/entities/missing-ids.xml, ./C:/cygwin/home/David/phpdoc/entities/missing-ids.xml But the line mentioning missing-ids.xml in the file-entities.ent file is: !-- generated file with missing ids -- !ENTITY missing-ids SYSTEM 'C:/cygwin/home/David/phpdoc/entities/missing-ids.xml' And that file does exist. David Gabor Hojtsy wrote: Could you please revert back to the without jade setup and post those 20 lines I have asked you for? !-- all other files -- !ENTITY appendices.about SYSTEM 'C:/cygwin/home/David/phpdoc/en/appendices/about.xml' Well, thanks. This looks quite fine indeed. Is there no phpdocen stuff in the file? We are searching for the path values you got in the error messages. They should come from file-entities.ent. Goba
Re: [PHP-DOC] Re: openjade/opensp with cygwin
I can't find the PHP option in the setup. I did a search on their website at http://www.cygwin.com/packages and PHP isn't listed. David Gabor Hojtsy wrote: David, please install the PHP package in cygwin (with the cygwin setup tool - it will not affect your normal PHP install), and try again. The file-entities script is ready to handle the PHP version installed by cygwin correctly. And it will generate the right /cygdrive path values then, which openjade will notice. I hope :) Goba
Re: [PHP-DOC] function.localtime
Hi, Here is the diff for the finished modifications to en/reference/datetime/functions/localtime.xml. This includes an added note from 2 of the comments added to the current entry and an example (it doesn't already have one). It has been validated. David ? localtime.xml.diff Index: localtime.xml === RCS file: /repository/phpdoc/en/reference/datetime/functions/localtime.xml,v retrieving revision 1.3 diff -u -r1.3 localtime.xml --- localtime.xml 29 Mar 2003 15:15:45 - 1.3 +++ localtime.xml 3 Apr 2005 18:43:22 - @@ -79,6 +79,56 @@ /listitem /itemizedlist /para +note + simpara + Months are from 0 (Jan) to 11 (Dec) and days of the week are from 0 (Sun) to 6 (Sat). + /simpara +/note +para + example + titlefunctiontime/function example/title + programlisting role=php +![CDATA[ +?php +$localtime = localtime(); +$localtime_assoc = localtime(time(), 1); +print_r($localtime); +print_r($localtime_assoc); +? +]] + /programlisting + example.outputs.similar; + screen +![CDATA[ +Array +( +[0] = 24 +[1] = 3 +[2] = 19 +[3] = 3 +[4] = 3 +[5] = 105 +[6] = 0 +[7] = 92 +[9] = 1 +) + +Array +( +[tm_sec] = 24 +[tm_min] = 3 +[tm_hour] = 19 +[tm_mday] = 3 +[tm_mon] = 3 +[tm_year] = 105 +[tm_wday] = 0 +[tm_yday] = 92 +[tm_isdst] = 1 +) +]] + /screen + /example +/para /refsect1 /refentry
Re: [PHP-DOC] Re: openjade/opensp with cygwin
Yeh, Apache and wget are there. But there is no PHP. David Gabor Hojtsy wrote: This says that Apache, PHP, etc. should be listed in the web category: http://www.kegel.com/php.html#demo2.cygwin Goba
Re: [PHP-DOC] Re: openjade/opensp with cygwin
Gabor Hojtsy wrote: Until then, please update your phpdoc checkout (I just made it simpler to go on with our tests :) and modify file-entities.php.in in the scripts folder to always set $cygwin_compiled to true. Then please try to ./configure and make test. Ok, I changed the $cygwin_compiled var so it was true and then did ./configure and afterwards ran make test. Exactly the same errors occurred as when running make html - cannot find the files.
Re: [PHP-DOC] Re: openjade/opensp with cygwin
Gabor Hojtsy wrote: Now the errors should contain /cygdrive path values. Are they? Goba No, they still have the C:/cygwin paths in them. This is using my Windows PHP (not the cygwin one).
Re: [PHP-DOC] function.localtime
Righto. I think I might use Jedit to do the editing in Windows and just generate the diffs and doing the CVS stuff using cygwin. Nano editor is good for small edits but not so good after a while imo. David anatoly techtonik wrote: ||*()*|| Hi, David. DM Is there anyone using native Windows tools to do PHP docs or does DM everyone just use Linux? I'm using native windows Far Manager + Colorer plugin for plain text stuff and Winmerge or Unired for unicode. Also I hate notepad. =) Sometimes Eclipse, but it is too heavy for my machine like any other java editor I've tried. t
Re: [PHP-DOC] Re: openjade/opensp with cygwin
Yeah, I did. And I also double checked the generated file-entities.php file to ensure the change was in that. Gabor Hojtsy wrote: Hum, the $cygwin_compiled = true; change in the file-entities.php.in file and the ./configure should have resulted in the cygwin stripper not being called. Are you sure you modified the .in file and rerun configure after that? Goba
Re: [PHP-DOC] Re: openjade/opensp with cygwin
Yep. $Id: file-entities.pgp.in,v 1.35 2005/04/03 18:47:41 goba Exp $ Gabor Hojtsy wrote: Yeah, I did. And I also double checked the generated file-entities.php file to ensure the change was in that. You do have file-entities.php.in 1.35 right? Goba
Re: [PHP-DOC] Re: openjade/opensp with cygwin
Could you generate the file-entities.ent file as normal, then do a check to see if it is using the cygwin jade and if so, do a mass replace on the strings in the file-entities.ent file? If I was just using PHP then I could do a mass str_replace on the file after reading it into an array, for example. But I don't know how the ./configure script works - it isn't something I've ever done (but it is interesting!). David Gabor Hojtsy wrote: Yep. $Id: file-entities.pgp.in,v 1.35 2005/04/03 18:47:41 goba Exp $ I have no idea at this point. The goal is to have the cygwin path values into the file-entities.ent file after all. If you can manage to find a way, then it might make things work. It would be great help afterwards for those coming after you, so they can easily set up the tools, without fiddling with anyhthing except cygwin (given they have PHP already set up). Goba
Re: [PHP-DOC] Re: openjade/opensp with cygwin
Gabor Hojtsy wrote: Open the file with a text editor, and get proper cygwin path values there, and see if openjade works. Goba That worked. I did a replace C:/ with /cygdrive/c/ using Wordpad, saved and ran make test and it was successful - no errors.
Re: [PHP-DOC] Re: openjade/opensp with cygwin
Gabor Hojtsy wrote: OK, updated configure.in to check for a windows jade setup, and file-entities.ent to only rewrite the cygwin values in that case. Please cvs update, autoconf(!), configure and then check again. Goba Did just that and it worked perfectly. The make test is now working fine with both jade.exe and the cygwin openjade. David
Re: [PHP-DOC] Re: openjade/opensp with cygwin
Yep, that worked fine also. Including the new additions: To install the minimal set of required packages select devel/autoconf, devel/automake, devel/make and doc/libxml2 along with components, which are selected in setup by default I think it is all fixed now :) David Gabor Hojtsy wrote: OK, updated configure.in to check for a windows jade setup, and file-entities.ent to only rewrite the cygwin values in that case. Please cvs update, autoconf(!), configure and then check again. Did just that and it worked perfectly. The make test is now working fine with both jade.exe and the cygwin openjade. OK, please start a make howto then, and see the results in the howto/html folder. If the HTML files look right (starting from index.html), then make html will probably also be fine (but the latter one takes a lot of time to complete). If you are interested, you can also try make html out. Goba
Re: [PHP-DOC] Re: openjade/opensp with cygwin
Gabor Hojtsy wrote: Where is openjade in that structure? devel/openjade? Goba text/openjade and text/opensp David
Re: [PHP-DOC] #32410 [Opn]: Documentation unclear for SoapHeader
I'm not really sure what the bug submitter is trying to do. My understanding is that he is trying to send a header in a soap request, but doesn't the example already show how to do that? Example 1. Some examples ?php $client = new SoapClient(null, array('location' = http://localhost/soap.php;, 'uri' = http://test-uri/;)); $client-__call(echoVoid, null, null, new SoapHeader('http://soapinterop.org/echoheader/', 'echoMeStringRequest', 'hello world')); ? http://de3.php.net/manual/en/function.soap-soapheader-construct.php If I am understanding this correctly, perhaps another example showing the creation of a soap header similar to the code Leonardo provided: $namespace = 'http://www.example.com'; $soap_headers = array( new SoapHeader($namespace, 'key', 5), new SoapHeader($namespace, 'lock', 'door')); Perhaps someone with more experience of soap might like to take over this one? :) Regards, David Mytton Managing Director - Olate Ltd http://www.olate.co.uk Leonardo Boshell wrote: Hi David, Ok. I'm not too familiar with SOAP (never needed to use it before) so I'll have to do some research into this before I do so. But does anyone have any examples for this function I could possibly use? I was asked recently to develop a program that used Google's AdWords API, which uses SOAP as the transport protocol. I'm attaching a piece of the PHP code I used in that program. It only shows how to send SOAP headers when acting as a client, but I guess it should be similar when acting as a server. Feel free to modify it to the needs of the manual. Leonardo B.
Re: [PHP-DOC] Re: openjade/opensp with cygwin
Gabor Hojtsy wrote: Thanks for your active participation in cleaning this stuff up, it was much needed. I hope others will also find this solution working around, especially now that two of you confirmed that this solution works. Yeah, it might as well be as easy as possible to get started on contributing to the docs. I'm glad my experiences helped :) Now to start looking at what else I can do... *goes to functions without examples* David
[PHP-DOC] Functions without examples - datetime
Hi, I'm having a look at the functions without examples to see if I can go and add some in. I was wondering what constitutes having examples. I used the datetime functions quite a bit and notice that the time() function is listed as not having examples, but going to www.php.net/time shows up an example. Looking at www.php.net/localtime - that clearly doesn't have any examples. So is the listing at http://www.phpdoc.info/meta/missing-examples.php wrong or does time() need more than 1 example to be counted? David Mytton
[PHP-DOC] function.localtime
Hi, I have just edited the function.localtime .xml file (attached) to include an example and also added a note about the value returned in tm_mday and tm_yday. Am I doing this right? If so, will someone with CVS write access will commit it? Thanks for the help whilst I'm learning this :) (I haven't tested/checked the XML since I haven't got the tools setup correctly yet) David ?xml version=1.0 encoding=iso-8859-1? !-- $Revision: 1.3 $ -- !-- splitted from ./en/functions/datetime.xml, last change in rev 1.10 -- refentry id=function.localtime refnamediv refnamelocaltime/refname refpurposeGet the local time/refpurpose /refnamediv refsect1 titleDescription/title methodsynopsis typearray/typemethodnamelocaltime/methodname methodparam choice=opttypeint/typeparameter timestamp /parameter/methodparam methodparam choice=opttypebool/typeparameter is_associative /parameter/methodparam /methodsynopsis para The functionlocaltime/function function returns an array identical to that of the structure returned by the C function call. The first argument to functionlocaltime/function is the timestamp, if this is not given the current time as returned from functiontime/function is used. The second argument to the functionlocaltime/function is the parameteris_associative/parameter, if this is set to 0 or not supplied than the array is returned as a regular, numerically indexed array. If the argument is set to 1 then functionlocaltime/function is an associative array containing all the different elements of the structure returned by the C function call to localtime. The names of the different keys of the associative array are as follows: itemizedlist listitem simpara tm_sec - seconds /simpara /listitem listitem simpara tm_min - minutes /simpara /listitem listitem simpara tm_hour - hour /simpara /listitem listitem simpara tm_mday - day of the month /simpara /listitem listitem simpara tm_mon - month of the year, starting with 0 for January /simpara /listitem listitem simpara tm_year - Years since 1900 /simpara /listitem listitem simpara tm_wday - Day of the week /simpara /listitem listitem simpara tm_yday - Day of the year /simpara /listitem listitem simpara tm_isdst - Is daylight savings time in effect /simpara /listitem /itemizedlist /para note simpara Months are from 0 (Jan) to 11 (Dec) and days of the week are from 0 (Sunday) to 6 (Saturday) /simpara /note para example titlefunctionlocaltime/function example/title programlisting role=php ![CDATA[ ?php $localtime = localtime(); $localtime_assoc = localtime(time(), 1); print_r($localtime); print_r($localtime_assoc); ? ]] /programlisting example.outputs.similar; screen ![CDATA[ Array ( [0] = 41 [1] = 19 [2] = 1 [3] = 3 [4] = 3 [5] = 105 [6] = 0 [7] = 92 [8] = 1 ) Array ( [tm_sec] = 41 [tm_min] = 19 [tm_hour] = 1 [tm_mday] = 3 [tm_mon] = 3 [tm_year] = 105 [tm_wday] = 0 [tm_yday] = 92 [tm_isdst] = 1 ) ]] /screen /example /refsect1 /refentry !-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:../../../../manual.ced sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --
Re: [PHP-DOC] Contributing
Where should I be heading then to get the right tools setup so I can check that I've done everything ok? I'm using Windows as my primary system. David Cornelia Boenigk wrote: Hi All It is somehow confusing ... Two days (?) ago there was an advice to go to http://wiki.phpdoc.info/DocSkel because the HOWTO is somewhat outdated. Now the advice to use the HOWTO at either php.net/dochowto or http://doc.php.net/php/dochowto/index.php ... Why is important stuff spread on different websites and which one contains the latest versions? In my opinion this doesn't make things easier. Especially for new people. Wouldn't it be better to put all doc-related stuff on one place. I think maintaining three sites is more effort than keeping track on one ;-) Regards Conni BTW, I don't understand what this means: http://wiki.phpdoc.info/DocSkel/MigrationStatus?v=d8i When migrating a reference, please separate your CVS commits : * a commit for whitespaces (remember that the new docs starts at col 0) * a commit for the actual migration
Re: [PHP-DOC] function.localtime
Right. Looks like I'm definitely going to need to get Cygwin setup then so I can do this properly. I just downloaded a couple of XML editor tools for Windows to see if they are any good but your docs recommend against that - using emacs or vi is probably the safest way. I created a path file before Philip sent this message using my Windows CVS client for a 3 line addition I tried. Is this anywhere near what I need to be outputting because if so, I might save myself some time if it is ok. But if not, I'll get cygwin and everything set up in the morning (2:30am now). Is there anyone using native Windows tools to do PHP docs or does everyone just use Linux? David Philip Olson wrote: Nope, there are a few things wrong, such as missing elements and tabulation. Install the tools so you can properly check the format of the docbook. We try to keep the format of the elements as follows: element element element And so forth. /element /element /element And instead of sending in complete xml files, you should send us a patch file. You can create a patch file using the cvs diff command, or by using the diff and patch facilities of your OS. Agreed, be very careful with whitespace. A patch should not contain whitespace changes. And as already mentioned above, show your unified diff instead so we can see what actually changed... diff -u file.xml Regards, Philip Index: en/reference/datetime/functions/localtime.xml === RCS file: /repository/phpdoc/en/reference/datetime/functions/localtime.xml,v retrieving revision 1.3 diff -u -r1.3 localtime.xml --- en/reference/datetime/functions/localtime.xml 29 Mar 2003 15:15:45 - 1.3 +++ en/reference/datetime/functions/localtime.xml 3 Apr 2005 01:24:29 - @@ -1,7 +1,7 @@ ?xml version=1.0 encoding=iso-8859-1? !-- $Revision: 1.3 $ -- !-- splitted from ./en/functions/datetime.xml, last change in rev 1.10 -- - refentry id=function.localtime + refentry id=function.localtime refnamediv refnamelocaltime/refname refpurposeGet the local time/refpurpose @@ -78,6 +78,11 @@ /simpara /listitem /itemizedlist + note + simpara + Months are from 0 (Jan) to 11 (Dec) and days of the week are from 0 (Sunday) to 6 (Saturday) + /simpara + /note /para /refsect1 /refentry
[PHP-DOC] Contributing
Hi, I am interested in contributing to the PHP Documentation. I have been using PHP for 2 years or so now, and would like to help out where ever possible. I e-mailed the PHP Internals list and they recommended that I post to the documentation list. How should I go about getting involved? David Mytton
Re: [PHP-DOC] Contributing
Read the fine howto: php.net/dochowto to make yourself somewhat familiar with the tools we use. Correct spelling errors, rewrite parts of the docs, solve doc bugs (bugs.php.net) etc. Yeah, I have been reading through that and will get started on it right away. I'll also go ahead and apply for a CVS account. David