[PHP-DOC] PHP Manual - Contribution
Hello, My name is Evan and I am a technical writer that works for Rackspace Hosting. This week I was using the online php manual to assist a customer with a PHP script. While looking through the online documentation I came across a section providing instructions on Installing on Cloud Computing Platforms. To my dismay Rackspace did not have a presence on this page. I am interesting in writing content for the manual that would fill this gape. The content would add Rackspace to the list of available cloud providers and provide links to our product information and PHP SDK. I read the getting_started section and noticed the first step was to introduce myself. I wanted to get this portion started while I got to work on cloning the book and beginning to include my content. Consider this my Hello fellow tech writers! I look forward to working with you all. Let me know if you have any questions/comments/concerns. If not I will get to work on cutting a build in the coming days. Link Referenced - http://www.php.net/manual/en/install.cloud.php Thanks! Evan Nabors Rackspace::Cloud('Product Evangelist')
Re: [PHP-DOC] PHP Manual - Contribution
Hi Evan, On 3 June 2013 20:04, Evan Nabors evan.nab...@rackspace.com wrote: Hello, My name is Evan and I am a technical writer that works for Rackspace Hosting. Nice to meet you. This week I was using the online php manual to assist a customer with a PHP script. While looking through the online documentation I came across a section providing instructions on Installing on Cloud Computing Platforms. To my dismay Rackspace did not have a presence on this page. I am interesting in writing content for the manual that would fill this gape. The content would add Rackspace to the list of available cloud providers and provide links to our product information and PHP SDK. All gapes must be filled! I look forward to your contribution. I read the getting_started section and noticed the first step was to introduce myself. I wanted to get this portion started while I got to work on cloning the book and beginning to include my content. Consider this my Hello fellow tech writers! I look forward to working with you all. Let me know if you have any questions/comments/concerns. If not I will get to work on cutting a build in the coming days. Similarly, if you have any questions/comments/concerns then feel free to ask us. Link Referenced - http://www.php.net/manual/en/install.cloud.php Thanks! Evan Nabors Rackspace::Cloud('Product Evangelist')
Re: [PHP-DOC] PHP Manual - Contribution
On Mon, Jun 3, 2013 at 1:49 PM, Evan Nabors evan.nab...@rackspace.comwrote: Hello, My name is Evan and I am a technical writer that works for Rackspace Hosting. This week I was using the online php manual to assist a customer with a PHP script. While looking through the online documentation I came across a section providing instructions on Installing on Cloud Computing Platforms. To my dismay Rackspace did not have a presence on this page. I am interesting in writing content for the manual that would fill this gape. The content would add Rackspace to the list of available cloud providers and provide links to our product information and PHP SDK. I read the getting_started section and noticed the first step was to introduce myself. I wanted to get this portion started while I got to work on cloning the book and beginning to include my content. Consider this my Hello fellow tech writers! I look forward to working with you all. Let me know if you have any questions/comments/concerns. If not I will get to work on cutting a build in the coming days. Link Referenced - http://www.php.net/manual/en/install.cloud.phphttp://www.php.net/manual/en/install..cloud.php +1 on this. This part of the manual is lacking in every way. Not just for Rackspace, but even the existing services just point to the vendor documentation. It would be nice to provide some actual meaty content here from the vendors. Thanks! Evan Nabors Rackspace::Cloud('Product Evangelist')
[PHP-DOC] PHP Manual is broken in spanish translation.
I'm receiving several emails, indicating: [DOC-ES] This PHP Manual build is broken. A week ago I receive these emails. I tried to contact administrators via Facebook, email, but I have not received a response. Can anyone tell me how to fix this message?. From the online editor I see no option to do this. I guess I have not level / karma enough to make such changes. A greeting and thanks. Jesús Ruiz jesusr...@php.net jesusruiz2...@gmail.com
Re: [PHP-DOC] PHP Manual is broken in spanish translation.
Fixed. -Hannes On Tue, May 21, 2013 at 5:54 PM, Jesús Ruiz García jesusruiz2...@gmail.com wrote: I'm receiving several emails, indicating: [DOC-ES] This PHP Manual build is broken. A week ago I receive these emails. I tried to contact administrators via Facebook, email, but I have not received a response. Can anyone tell me how to fix this message?. From the online editor I see no option to do this. I guess I have not level / karma enough to make such changes. A greeting and thanks. Jesús Ruiz jesusr...@php.net jesusruiz2...@gmail.com
Re: [PHP-DOC] PHP Manual in Uzbek
Hello, Tulkin! I'll cite the default answer to this kind of request by Hannes Magnusson: Translating the manual into a new language is not a trivial work. You should start with finding several people to help you work on it, and then review the massive workload. We have plenty of dead translations, and are not very keen on having yet another one.. So if you're not confident enough that you can carry the workload and don't have several like-minded persons then it won't work. Documentation size is about 1 files and 20mb and it's constantly updating so it's really task for 4-5 people. 2012/9/3 Tulkin Yusupov y.tul...@gmail.com: Hi, I'm Tulkin Yusupov. I'm PHP developer and active stuff in Uzbek network community. And also, I have some experience in translation from English into Uzbek language. I really want to start translating PHP Docs into Uzbek. How can I start to translate? Thanks in advance, Tulkin Yusupov -- Regards, Shein Alexey
Re: [PHP-DOC] PHP Manual in Uzbek
On Tue, Sep 4, 2012 at 10:14 AM, Alexey Shein con...@gmail.com wrote: 2012/9/4 Tulkin Yusupov y.tul...@gmail.com: Hello, Alexey! Thank you for answer. So, I've kind of people that help to translate. What should we do? Please, give us instruction, we will start translate. You should wait for approvement from Hannes Magnusson or Philip Olson (I CC'ed them to this letter). While you're waiting you can read about phpdoc build system, if you speak Russian (it seems you are), you can read these articles: http://habrahabr.ru/post/125348/ and http://habrahabr.ru/blogs/php/125341/. Also check out https://edit.php.net and articles (in English) in this section: https://wiki.php.net/doc On Tue, Sep 4, 2012 at 1:45 PM, Alexey Shein con...@gmail.com wrote: Hello, Tulkin! I'll cite the default answer to this kind of request by Hannes Magnusson: Translating the manual into a new language is not a trivial work. You should start with finding several people to help you work on it, and then review the massive workload. We have plenty of dead translations, and are not very keen on having yet another one.. So if you're not confident enough that you can carry the workload and don't have several like-minded persons then it won't work. Documentation size is about 1 files and 20mb and it's constantly updating so it's really task for 4-5 people. 2012/9/3 Tulkin Yusupov y.tul...@gmail.com: Hi, I'm Tulkin Yusupov. I'm PHP developer and active stuff in Uzbek network community. And also, I have some experience in translation from English into Uzbek language. I really want to start translating PHP Docs into Uzbek. How can I start to translate? I don't really have any good pointers for you.. If you really think you can make it I guess you should start by translating the language-defs.ent and language-snippets.ent files.. After that you may want to start on things that doesn't change to much, and if pretty fundemental.. like http://svn.php.net/repository/phpdoc/en/trunk/reference/strings/ If that works out, we can create a new module for you and give couple of people svn accounts maybe... -Hannes
[PHP-DOC] PHP Manual in Uzbek
Hi, I'm Tulkin Yusupov. I'm PHP developer and active stuff in Uzbek network community. And also, I have some experience in translation from English into Uzbek language. I really want to start translating PHP Docs into Uzbek. How can I start to translate? Thanks in advance, Tulkin Yusupov
Re: [PHP-DOC] php manual in hindi
On Fri, Apr 20, 2012 at 05:50, Anil jangir anil.jangir...@gmail.com wrote: Hi, I'm looking for PHP manual in my native language HINDI. can you provide me. We do not have anyone working on hindi translation. -Hannes
Re: [PHP-DOC] php manual in pdf
On Jul 22, 2011, at 2:32 PM, Dennis wrote: Hello Guys. Please, make php manual also available in pdf, so ppl are able to read it in their readers. Maybe you should have 2 version, just a manual and a manual with user notes. Greetings Dennis, Although buggy[1], there are now PDF builds here: - http://doc.php.net/downloads/pdf/ - http://doc.php.net/downloads/pdf/split/ I'm not sure how useful a 30+ MB PDF file is, but they now exist. And split/ contains per book/section PDFs. As for adding user notes to the PDF, not sure about that. Enjoy :) Regards, Philip [1] https://bugs.php.net/search.php?search_for=pdfcmd=displaypackage_name%5B%5D=Doc+Build+problem
[PHP-DOC] php manual in pdf
Hello Guys. Please, make php manual also available in pdf, so ppl are able to read it in their readers. Maybe you should have 2 version, just a manual and a manual with user notes. Thanks. Dennis.
[PHP-DOC] PHP Manual
Hi! I want to point out an idiotism in your documentation. For a beginner in PHP, this can (will) be totally confusing: On page 1586 of the PHP Manual (Published 03-06-2003), it is first said: 'There is no installation needed to use these functions; they are part of the PHP core.' and latter on it is said: 'Where the sendmail program can be found...' Do you UNDERSTAND the absolute contradiction between these 2 statements. In the first one, you claim that a web site operating solely with PHP CAN send emails regardless of anything else. In the second statement, you defeat the first statement by saying that in fact it CAN'T... Respectfully, Alain Renaud Webmaster _ Jeux Messenger : mettez vos amis au défi! http://go.microsoft.com/?linkid=9734397
Re: [PHP-DOC] PHP Manual
Hello Alain, Thanks for pointing it out. Please report this is as a Documentation Bug at http://bugs.php.net/, so it can be tracked and discussed individually. On your bug report, please add the fixes you think would look good. Cheers, Thiago Henrique Pojda On Mon, Jun 14, 2010 at 6:19 PM, Alain Renaud renaud_al...@hotmail.comwrote: Hi! I want to point out an idiotism in your documentation. For a beginner in PHP, this can (will) be totally confusing: On page 1586 of the PHP Manual (Published 03-06-2003), it is first said: 'There is no installation needed to use these functions; they are part of the PHP core.' and latter on it is said: 'Where the sendmail program can be found...' Do you UNDERSTAND the absolute contradiction between these 2 statements. In the first one, you claim that a web site operating solely with PHP CAN send emails regardless of anything else. In the second statement, you defeat the first statement by saying that in fact it CAN'T... Respectfully, Alain Renaud Webmaster -- Découvrez comment échanger avec vos vrais amis. Découvrez comment!http://go.microsoft.com/?linkid=9734392
Re: [PHP-DOC] PHP Manual
On Jun 14, 2010, at 2:19 PM, Alain Renaud wrote: Hi! I want to point out an idiotism in your documentation. For a beginner in PHP, this can (will) be totally confusing: On page 1586 of the PHP Manual (Published 03-06-2003), it is first said: A lot of updates and changes have taken place since 2003, so I highly suggest you read a newer version of the PHP Manual. 'There is no installation needed to use these functions; they are part of the PHP core.' and latter on it is said: 'Where the sendmail program can be found...' Do you UNDERSTAND the absolute contradiction between these 2 statements. In the first one, you claim that a web site operating solely with PHP CAN send emails regardless of anything else. In the second statement, you defeat the first statement by saying that in fact it CAN'T... I agree, but we don't intentionally claim that PHP can send emails regardless of anything else. It's attempting to say that you don't need to install a foo_mail or mail_bar extensions, but rather, these exist in PHP core. The installation requirements section will hopefully clear it up: - http://php.net/mail.requirements However, the contradiction comes into play when compared to the documentation (in the requirements section) that sendmail is required for these functions to exist, and for that I urge you to file a bug report. - http://bugs.php.net/ The wording is generic in nature (as an entity inserted into many other sections) but ext/mail is a unique. I think it's a little odd that mail() can be undefined due to compile time circumstances but it is what it is. Thank you for helping evaluate this topic. Regards, Philip
[PHP-DOC] PHP Manual in Bahasa Indonesia
Hi all, Is there any PHP manual translation in Bahasa Indonesia now? Best regards, Sony AK http://www.sony-ak.com
Re: [PHP-DOC] PHP Manual (fwd)
On Thu, Jul 2, 2009 at 00:12, ~`~Suzie~`~suzzi...@yahoo.com wrote: Sorry to bother you again. I tried installing php 5.2 but I'm about as dumb as a box of rocks when it comes to this kind of stuff...lol. In your reply you offered to send a pdf of the instruction manual. I was just wondering instead of sending it to me if there was any way you could just send it directly to the computer lab director at the correctional facility. That way they could get it alot sooner as I know they are trying to get the lab up and running as soon as possible. His mailing address is: [snip address] This would help us all out and really help the inmates also. I thank you so much for your help with this. Also if you need help paying for the postage please let me know asap and I promise I will send it out to you the same day. I really don't want you to have to go out of your way or have to pay for any expenses for this little project. I didn't mean literally send it via regular (snail-)mail. I meant via e-mail. I cannot print out few thousands pages and send it oversees. Sorry. Like I said before, you can download offline version of the manual at http://php.net/download-docs.php We do not offer the manual in a book or pre-printed versions. -Hannes
[PHP-DOC] PHP Manual (fwd)
-- Forwarded message -- Date: Wed, 1 Jul 2009 11:49:00 -0700 (PDT) From: ~`~Suzie~`~ suzzi...@yahoo.com To: secur...@php.net X-Bogosity: Yes, tests=bogofilter, spamicity=0.812199, version=1.2.0 Subject: PHP Manual Hello my name is Suzie Symes, I am writing to ask a real quick question that won't take up much of your time. My son is currently incarserated in a kansas faciltiy. They are starting up a computer lab and they have asked him to help with this project as he has an extesive computer programing background. He has asked me to download your php manual as they do not have access to the internet there. When I went to the site and downloaded the manual it takes me back to the online manual. He is really wanting to use your manual and I was just wondering if there is a link to maybe a PDF version or if it would be possible for me to copy and paste the information into a word document that I can burn to a cd and mail to them. I am asking because I do not want to violate any copyright laws concerning your online manual. This would just be used by the inmates who want to learn php programing in the facilty. I thank you for your time, Suzie Life is not measured by the breaths we take, but by the moments that take our breath away.
Re: [PHP-DOC] PHP Manual (fwd)
On Wed, Jul 1, 2009 at 23:18, Derick Rethansder...@php.net wrote: -- Forwarded message -- Date: Wed, 1 Jul 2009 11:49:00 -0700 (PDT) From: ~`~Suzie~`~ suzzi...@yahoo.com To: secur...@php.net X-Bogosity: Yes, tests=bogofilter, spamicity=0.812199, version=1.2.0 Subject: PHP Manual Hello my name is Suzie Symes, I am writing to ask a real quick question that won't take up much of your time. My son is currently incarserated in a kansas faciltiy. They are starting up a computer lab and they have asked him to help with this project as he has an extesive computer programing background. He has asked me to download your php manual as they do not have access to the internet there. When I went to the site and downloaded the manual it takes me back to the online manual. He is really wanting to use your manual and I was just wondering if there is a link to maybe a PDF version or if it would be possible for me to copy and paste the information into a word document that I can burn to a cd and mail to them. I am asking because I do not want to violate any copyright laws concerning your online manual. This would just be used by the inmates who want to learn php programing in the facilty. I thank you for your time, Suzie The PDF version of the manual is 11mb. I can send you a copy if you want. Furthermore, we do provide various formats of the manual so you can download it however you'd like, see: http://php.net/download-docs.php For the record, these PDFs will be available to download in the near future, but until then you can build them yourself quite easily - all you need is PHP5.2 and then run the following commands: $ pecl install haru $ pear channel-discover doc.php.net $ pear install doc.php.net/phd-beta $ cvs -d:pserver:cvsr...@cvs.php.net/repository login (the password is phpfi) $ cvs -d:pserver:cvsr...@cvs.php.net/repository co phpdoc $ cd phpdoc $ php configure.php $ phd -f pdf -t phppdf -d .manual.xml Now open the newly created pdf folder :) If you'd like a big fat one PDF file then use phpbigpdf rather then phppdf -Hannes
Re: [PHP-DOC] PHP Manual (fwd)
The PDF version of the manual is 11mb. I can send you a copy if you want. Furthermore, we do provide various formats of the manual so you can download it however you'd like, see: http://php.net/download-docs.php snip I don't consider the PDF build ready yet nor is it worth using. Instead, the CHM version should work fine for offline use (or HTML version, depending on usage). The single PDF has about 11,000 pages with many containing a single line. Here's an open bug report about it: Doc Bug #48440 -- PDF formatting - http://bugs.php.net/48440 Mine (php_manual_en.pdf) is 27 MB so maybe I did something wrong (Hannes, how did you manage building a 11 MB file?) Regards, Philip
[PHP-DOC] PHP Manual License
A project of the Web Application Security Consortium is to try to classify and define security threats. For one of the definitions, we would like to possibly quote relevant parts of the PHP manual, but the license is a little unclear. I'm hoping someone can help clarify. At the bottom of each page, there is a copyright notice: Copyright © 2001-2009 The PHP Group All rights reserved. In the license FAQ (http://php.net/license/index.php#doc-lic), there is the following statement: The PHP manual text is covered by the Creative Commons Attribution 3.0 License, copyright (c) the PHP Documentation Group. We believe in spirit that the manual is covered by the CC license, and we can therefore use the details of that to guide us. However, the fact that this is only mentioned on one page, and a seemingly conflicting copyright and license statement exists on the actual manual pages, gives us pause. Thanks for any clarification you can offer. Chris
Re: [PHP-DOC] PHP Manual License
Chris, The copyright appears on all php.net pages, which leads me to believe that the website itself is copyrighted with all rights reserved. I downloaded a copy of the manual, and it is distributed with the following: Copyright (c) 1997 - 2009 by the PHP Documentation Group. This material may be distributed only subject to the terms and conditions set forth in the Creative Commons Attribution 3.0 Creative Commons Attribution 3.0 license/a is distributed with this manual. The latest version is presently available at http://creativecommons.org/licenses/by/3.0/; This leads me to believe that the manual is subject to the Creative Commons Attribution 3.0 license, while the website itself (design, images, layout, and non-manual text) is under a stronger copyright. Brandon On Mon, Jan 5, 2009 at 1:20 PM, Chris Shiflett shifl...@php.net wrote: A project of the Web Application Security Consortium is to try to classify and define security threats. For one of the definitions, we would like to possibly quote relevant parts of the PHP manual, but the license is a little unclear. I'm hoping someone can help clarify. At the bottom of each page, there is a copyright notice: Copyright (c) 2001-2009 The PHP Group All rights reserved. In the license FAQ (http://php.net/license/index.php#doc-lic), there is the following statement: The PHP manual text is covered by the Creative Commons Attribution 3.0 License, copyright (c) the PHP Documentation Group. We believe in spirit that the manual is covered by the CC license, and we can therefore use the details of that to guide us. However, the fact that this is only mentioned on one page, and a seemingly conflicting copyright and license statement exists on the actual manual pages, gives us pause. Thanks for any clarification you can offer. Chris
Re: [PHP-DOC] PHP Manual License
Good afternoon, Chris On Mon, Jan 5, 2009 at 13:20, Chris Shiflett shifl...@php.net wrote: A project of the Web Application Security Consortium is to try to classify and define security threats. For one of the definitions, we would like to possibly quote relevant parts of the PHP manual, but the license is a little unclear. I'm hoping someone can help clarify. Not a problem at all. At the bottom of each page, there is a copyright notice: Copyright (c) 2001-2009 The PHP Group All rights reserved. This is for the content of the website as a whole, including imagery and opinions expressed therein. In the license FAQ (http://php.net/license/index.php#doc-lic), there is the following statement: The PHP manual text is covered by the Creative Commons Attribution 3.0 License, copyright (c) the PHP Documentation Group. We believe in spirit that the manual is covered by the CC license, and we can therefore use the details of that to guide us. However, the fact that this is only mentioned on one page, and a seemingly conflicting copyright and license statement exists on the actual manual pages, gives us pause. Correct. While the general website and content of such are Copyrighted by the PHP Group, the documentation is actually licensed wholly under the CCA3U license. The easiest way of explaining this is as follows: We hold a Copyright on all content of the php.net website AND ALSO serve content for the official manual as a public service to the development community. While we host and maintain the official documentation, others are free to use and reuse it. So you're perfectly within your rights, granted by the license, to quote it, republish it, etc., as long as you (a) acknowledge that it was originally written by the PHP Group; (b) that the PHP Group neither endorses nor is associated with you, your projects or services, etc.; and (c) [optionally] provide a link to or description of how the end-user may obtain access to the original works. Any other questions, please let us know. Thanks! -- /Daniel P. Brown daniel.br...@parasane.net || danbr...@php.net http://www.parasane.net/ || http://www.pilotpig.net/ Unadvertised dedicated server deals, too low to print - email me to find out!
Re: [PHP-DOC] PHP Manual License
On Mon, Jan 5, 2009 at 13:29, Brandon Savage bran...@brandonsavage.net wrote: [snip!] This leads me to believe that the manual is subject to the Creative Commons Attribution 3.0 license, while the website itself (design, images, layout, and non-manual text) is under a stronger copyright. ?php $brandon = hitOnHead($obj-Nail); ? ;-P -- /Daniel P. Brown daniel.br...@parasane.net || danbr...@php.net http://www.parasane.net/ || http://www.pilotpig.net/ Unadvertised dedicated server deals, too low to print - email me to find out!
Re: [PHP-DOC] PHP Manual License
On Mon, Jan 5, 2009 at 19:20, Chris Shiflett shifl...@php.net wrote: A project of the Web Application Security Consortium is to try to classify and define security threats. For one of the definitions, we would like to possibly quote relevant parts of the PHP manual, but the license is a little unclear. I'm hoping someone can help clarify. At the bottom of each page, there is a copyright notice: Copyright (c) 2001-2009 The PHP Group All rights reserved. Clicking on the copyright notice in the footer should make it obvious what that statements covers. this is only mentioned on one page, and a seemingly conflicting copyright http://www.php.net/manual/en/ click on the copyright link (right below the author list), or do like Brandon did, download the manual (http://php.net/download-docs). All ideas to make these sort of issues more obvious are welcomed. -Hannes
Re: [PHP-DOC] PHP Manual License
On Jan 5, 2009, at 14:49, Hannes Magnusson wrote: A project of the Web Application Security Consortium is to try to classify and define security threats. For one of the definitions, we would like to possibly quote relevant parts of the PHP manual, but the license is a little unclear. I'm hoping someone can help clarify. At the bottom of each page, there is a copyright notice: Copyright (c) 2001-2009 The PHP Group All rights reserved. Clicking on the copyright notice in the footer should make it obvious what that statements covers. The code, text, PHP logo, and graphical elements on this website and the mirror websites (the Site) are Copyright © 2001-2009 The PHP Group. All rights reserved. The manual is text, so I think this statement is part of the concern, not part of the clarification. http://www.php.net/manual/en/ click on the copyright link (right below the author list), or do like Brandon did, download the manual (http://php.net/download-docs). All ideas to make these sort of issues more obvious are welcomed. The intent is clear, and thanks for the reassurance. I'm not sure intent matters in legal affairs, and the lack of precision is still likely to concern some people, but I'll pass this information along and let someone else worry about it. :-) I'm not a lawyer, else I would happily offer advice about how to make these statements more precise. I do not think something can be copyrighted by multiple entities, so that is probably the primary issue. (Perhaps a related issue is whether the PHP Documentation Group is a legal entity. IBM had paperwork for PDO that said that the PHP Group was effectively a common law entity, but I'm not sure the same has been or even can be done for the PHP Documentation Group.) A single copyright holder can distribute something under multiple licenses, so I don't think the all rights reserved and CC license conflict. Again, this isn't my area of expertise; I'm just trying to act as a responsible conduit. Thanks again, Chris
Re: [PHP-DOC] php manual version information
On Wed, Jun 11, 2008 at 05:26, Philip Olson [EMAIL PROTECTED] wrote: 1. How should we store the version information? A. Store version information within each functions file B. ... within each extensions directory (version.xml files per extension) C. ... within one huge version.xml file (as currently done) D. ... I think the existing script is very useful, the only annoying thing is initializing the database and needing to running _after_ each release (i.e. we can't gather 5.3.0 version info because there is no such tag). I think the way to go is using the php script for the initial info, spread it into multiple files (one per extension) and then manually override any obvious bogus information.. Its much easier to spot, and fix, wrong versioninfo when chunked into multiple files - and since noone will be remember to manually update all versioninfo in 5years it is good to have the script around.. -Hannes
[PHP-DOC] php manual version information
Hello everyone, Let's talk about our function versioning information, you know, the part about when a function is available in PHP (or PECL). Past situation (~2002-2007): - CVS module named functable - Written in awk - Few knew how it worked - No PECL information Current situation (2008): - phpdoc/scripts/functable.php - It generates phpdoc/phpbook/phpbook-xsl/version.xml - Essentially a port of awk functable to PHP - Eliminated PHP 3 version info - Requires an SQLite database - Relies on function prototypes in source Problems and considerations: - A lot of functions are missing version information - Typically we must manually update the generated version.xml - Some functions go in and out of PECL, or are in both - Prototypes get fixed but it's too late for our system - Our system rechecks every PHP release The system scours the PHP sources by checking out every release (tag) from CVS (since PHP 4.0.0) then determines when: - A function became available in PHP or PECL - A function was removed from PHP or PECL - So basically when the function existed Let's now reconsider this entire process and fix it. There are several questions: 1. How should we store the version information? A. Store version information within each functions file B. ... within each extensions directory (version.xml files per extension) C. ... within one huge version.xml file (as currently done) D. ... This email is getting too long so I'll stop here. Please provide input on this situation in the form of questions, answers, comments, anything... for example you might ask Since a functions born date never changes, why not hardcode it within the functions docs? and I agree but wonder if we're missing something here. Like, would it cause problems for translators? Comments? And on a related note, the following will show you what's missing version information: $ cd phpdoc $ php configure.php $ phd --docbook .manual.xml --theme bightml --verbose VERBOSE_NOVERSION Regards, Philip
[PHP-DOC] php manual as txt
Hi, I've been looking for a php manual as plain txt that could be included within the VIM help system. So far it seems that there have been a few efforts on this, but no one found it's way in the official PHP CVS. Tobias Schlitt[1] wrote about a script phpm[2] from Harald Eide, which isn't available online anymore. Tobias contacted the author several times without any response. phpm was based on a script still available via archive.org[3]. It would be very fine to have a .txt version of the php manual available via CVS (or better SVN ;-) ). This way one could check it out directly in the right directory with an update mechanism included. I'd be disposed to work on this feature, but would need some guidance before: a) What would be the best way: XSLT or a PHP script? b) How to hook into the make mechanism (if necessary)? Cheers, Thomas Koch [1] http://schlitt.info/applications/blog/index.php?/archives/331-Comfortable-PHP-editing-with-VIM-3.html [2] http://phpvolcano.com/blog/index.php?/archives/170-phpm-update-and-new-wiki-section.html [3] http://web.archive.org/web/20060219005227/http://www.phpvolcano.com/articles/manual/index.php
Re: [PHP-DOC] php manual as txt
On 6/16/07, Thomas Koch [EMAIL PROTECTED] wrote: Hi, I've been looking for a php manual as plain txt that could be included within the VIM help system. So far it seems that there have been a few I don't believe that you want the complete manual in .txt format, you are probably looking for http://cvs.php.net/viewvc.cgi/phpdoc/funcsummary.txt?view=markup or you could build it yourself if you like: cvs -d:pserver:[EMAIL PROTECTED]/repository co phpdoc cd phpdoc autoconf ./configure make funcsummary.txt -Hannes
[PHP-DOC] php manual translation in italian
Dear friends, Thanks for answering me. I wasn't sure about the italian team address, which now I got in full. As suggested by Darvin, I visited Simone Cortesi's site for guidelines about translation. I shall contact Darvin in a short time for operational details. Hoping to be helpful to the whole community. Andrea Paramithiotti __ Tiscali ADSL libera la velocita'! Attiva Senza Canone entro il 14 giugno: navighi a 1,5 euro l'ora per i primi 3 mesi,se scegli il modem e' tuo in comodato gratuito e in piu' hai gratis SuperMail per 12 mesi. Non aspettare, attivala subito! http://abbonati.tiscali.it/adsl/prodotti/640Kbps/
[PHP-DOC] PHP Manual - PDF Format?
Is there a PDF format somewhere of the manual so I can print it out all at once? Wayne Stevens BMC Software, Inc [EMAIL PROTECTED] (800) 537-1813 ...OLE_Obj... === BMC Software Proactive Notification will inform you via email of issues related to BMC Software products, such as the provision of flashes, technical bulletins, product upgrades and release notes. Access Hint: Go to http://www.bmc.com/support.html. Select Proactive Notification and enter your support login and password. If you do not have one, you may obtain one by clicking on First time users and completing the form presented. Once you've received confirmation of your login and password for the Technical Support Web page, select Proactive Notification. Fill out the subscription form for Proactive Notification and select all products of interest. We will then notify you via email as new information is released. ===
Re: [PHP-DOC] PHP Manual - PDF Format?
The PHP manual is not currently avaliable in PDF format. It will be avaliable in the near future. If you really want a PDF version of the manual, you may compile it yourself throught the CVS XML sources. When we have oficial PDF files, they will be avaliable in the php.net website. Nuno Lopes - Original Message - Is there a PDF format somewhere of the manual so I can print it out all at once? Wayne Stevens BMC Software, Inc [EMAIL PROTECTED] (800) 537-1813 ...OLE_Obj...
Re: [PHP-DOC] PHP manual translation
2. I have Openjade installed so, do I need Jade now? If you have OpenJade, you don't need Jade. 3. Is there any tool that could verify whether I have set up the environment correctly? /like one in OpenOffice Localization project!/ No. Just try to do a CVS checkout of phpdoc and then do autoconf ./configure make test and see if it works. Nuno
Re: [PHP-DOC] PHP manual translation
1. Do I need to run rpm -Uhv jade-1.2.x-y.src.rpm again? Actually I did try but the previous error remains. /I thought I need to SETENV or something! for scrollkeeper if so how could I do it? I am rather new to *nix world./ 2. I have Openjade installed so, do I need Jade now? No (and this means No for the first question too). 3. Is there any tool that could verify whether I have set up the environment correctly? /like one in OpenOffice Localization project!/ If you can do a 'make test', then your system is set up fine. Goba
[PHP-DOC] PHP manual translation
Hi all, I have a little confusion about Jade and OpenJade, HOWTO http://www.php.net/manual/howto/chapter-tools.html says that I need either Jade or Openjade but not both. I have downloaded jade-1.2.x-y.src.rpm jadetex-2.x-y.src.rpm psgml-1.2.x-y.src.rpm sgml-common-0.1-3.src.rpm from http://public.planetmirror.com/pub/sourceware/docbook-tools/docware/SRPM S/ but when I try to install Jade (rpm -Uhv jade-1.2.x-y.src.rpm) it gives an error: Failed dependencies, openjade is needed by (installed) scrollkeeper-0.3.11-3 after this error I have downloaded Openjade from openjade.sourceforge.net and got it installed. Now my questions are: 1. Do I need to run rpm -Uhv jade-1.2.x-y.src.rpm again? Actually I did try but the previous error remains. /I thought I need to SETENV or something! for scrollkeeper if so how could I do it? I am rather new to *nix world./ 2. I have Openjade installed so, do I need Jade now? 3. Is there any tool that could verify whether I have set up the environment correctly? /like one in OpenOffice Localization project!/ Please give me your invaluable advices. Regards, Purvee
[PHP-DOC] php manual
php manual? ,,.
Re: [PHP-DOC] php manual
On Mon, 23 Jun 2003, Bayman wrote: ÇëÎÊÎÒ¿ÉÒԲμÓphp manualµÄ·Ò빤×÷Âð? ÎÒÊÇÖØÇì´óѧ´óÈý±¾¿ÆѧÉú,¹ã¶«ÈË,Ó¢ÓïËļ¶. You should write the Chinese lists in Chinese, not the English list. Traditional: [EMAIL PROTECTED] Simplified: [EMAIL PROTECTED] Regards, Philip -- PHP Documentation Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php
Re: [PHP-DOC] php manual
ID [EMAIL PROTECTED] = |Cui Yan | |Email:[EMAIL PROTECTED] | | [EMAIL PROTECTED] | |OICQ:80532 | | Happy,It's nice to be Happy | = From: "Bayman" <[EMAIL PROTECTED]> To: <[EMAIL PROTECTED]> Subject: [PHP-DOC] php manual Date: Mon, 23 Jun 2003 10:16:49 +0800 php manual? ,,. MSN Hotmail -- PHP Documentation Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php
Re: [PHP-DOC] PHP manual typos, part 2
I've fixed most of them, but I'm not sure about cyrus_unbind() and sleep() so I didn't change them. Thanks for your help, Sander On Wed, Jun 26, 2002 at 01:10:37PM +, Paul Hudson wrote: Here's another list of minor typos in the English documentation. I still need someone to commit these changes on my behalf, so if you've got CVS access and five minutes on your hands...? :) Thanks, --Paul -- Changes: http://uk.php.net/manual/en/faq.html.php PHP and HTML interact a lot: PHP generate HTML, and HTML has informations that will be sent to PHP. - PHP and HTML interact a lot: PHP can generate HTML, and HTML can pass information to PHP. What encodings/decodings do I need when I pass a value on via a form? And via an URL? - What encoding/decoding do I need when I pass a value through a form/URL? (two instances) htmlspecialchars the the whole value - htmlspecialchars the whole value interpret the html escaped symbols - HTML Use it's numerical form element id instead - use its numerical form element ID instead http://uk.php.net/manual/en/ref.mnogo.php These functions allow you to access mnoGoSearch - allow you to access the mnoGoSearch you must compile php with mnogosearch - PHP the path to mnogosearch, php will look for mnogosearch - PHP ftp archive search, news articles - FTP php contains built-in mysql access library - PHP contains a built-in MySQL access library You need at least 3.1.10 version of mnoGoSearch installed to use these functions. - You need at least version 3.1.10 of mnoGoSearch installed in order to use these functions. and can work only with generic mysql libraries - MySQL with mysql, during php configuration - PHP http://uk.php.net/manual/en/language.references.php References are a means in PHP to access the same - References in PHP are a means to access the same http://uk.php.net/manual/en/ref.oci8.php make sure that you have set up your oracle environment - Oracle http://uk.php.net/manual/en/ref.cyrus.php Authenticate agaings a Cyrus IMAP server - against Close connection to a cyrus server - to a Cyrus IMAP server Unbind ... - presumably Unbind callbacks for a Cyrus IMAP connection? http://uk.php.net/manual/en/ref.mssql.php procedure on a MS-SQL server - MS SQL http://uk.php.net/manual/en/ref.ovrimos.php in PHP just compile php with - just compile PHP with This will just connect to SQL Server. - This will just connect to an Ovrimos SQL server http://uk.php.net/manual/en/ref.misc.php Generate a unique id - ID http://uk.php.net/manual/en/ref.misc.php Delay execution - Pause execution, I think, is what is meant _ Get your FREE download of MSN Explorer at http://explorer.msn.com/intl.asp. -- PHP Documentation Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php -- PHP Documentation Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php
[PHP-DOC] PHP manual typos, part 3
Here's a third set of typographical errors in the PHP English documentation. Could someone with CVS access please commit them for me? What does it take for me to get sufficient privileges to be able to commit changes like these myself?Also, now that I've pretty much finished with the typos, I'd like to move on and edit the main manual text itself - perhaps to add some clarity in places, or just to add more examples where they are thin on the ground.Should I submit that sorta thing to this list also? Thanks, --Paul - http://uk.php.net/manual/en/ref.ccvs.php allowing you to directly work with - allowing you to work directly with PHP Will attempt to look in the - PHP will http://uk.php.net/manual/en/ref.muscat.php any memory back to php - PHP api - API (multiple) http://uk.php.net/manual/en/ref.domxml.php The domxml extension has been overhauled in PHP Version 4.3.0 in favour of a better compliance of the DOM standard - The domxml extension has been overhauled in PHP 4.3.0 to provide better compliance with the DOM standard There a quite some functions which do not fit - There are quite a few functions that do not fit Deprecated functions and its replacements - Deprecated functions and their replacements require a xml require an XML http://uk.php.net/manual/en/ref.aspell.php use spell-checking capabilities in php - PHP http://uk.php.net/manual/en/ref.msql.php you must compile php with msql - PHP http://www.php.net/manual/en/faq.databases.php construct your tables in access - Access http://www.php.net/manual/en/function.getimagesize.php Some Programs use these APP markers to embedd text - Some programs use these APP markers to embed text A very common one in to embed - A very common use is to embed http://uk.php.net/manual/en/function.iptcparse.php This is an image function - how come it is listed in misc. rather than in image functions? Could at least a link be placed somewhere in the image section? Or in http://www.php.net/manual/en/function.iptcembed.php, which *is* under images? :) http://www.php.net/manual/en/function.imagecopy.php Just to make the function definition a little more obvious to the reader... int imagecopy ( resource dst_im, resource src_im, int dst_x, int dst_y, int src_x, int src_y, int src_w, int src_h) Copy a part of src_im onto dst_im starting at the x,y coordinates src_x, src_y with a width of src_w and a height of src_h. The portion defined will be copied onto the x,y coordinates, dst_x and dst_y. - int imagecopy ( resource dest_image, resource source_image, int dest_x, int dest_y, int source_x, int source_y, int source_width, int source_height) Copy a part of source_image onto dest_image starting at the x,y coordinates source_x, source_y with a width of source_width and a height of source_height. The portion defined will be copied onto the x,y coordinates, dest_x and dest_y. http://uk.php.net/manual/en/ref.snmp.php including their respective object id withing the specified - including their respective object ID within the specified http://uk.php.net/manual/en/ref.iconv.php Iconv library function converts files between various encoded character sets - The iconv library functions convert files between various character sets encodings. http://uk.php.net/manual/en/ref.pfpro.php These functions have been added in PHP 4.0.2. - These functions were added in PHP 4.0.2. http://uk.php.net/manual/en/ref.wddx.php which comes with apache 1.3.7 or higher - Apache _ Chat with friends online, try MSN Messenger: http://messenger.msn.com -- PHP Documentation Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php
Re: [PHP-DOC] PHP manual typos, part 3
On Sun, 30 Jun 2002, Paul Hudson wrote: Here's a third set of typographical errors in the PHP English documentation. Could someone with CVS access please commit them for me? What does it take for me to get sufficient privileges to be able to commit changes like these myself?Also, now that I've pretty much finished with the typos, I'd like to move on and edit the main manual text itself - perhaps to add some clarity in places, or just to add more examples where they are thin on the ground.Should I submit that sorta thing to this list also? It would be much better if you got CVS access yourself ... saves a lot of double time: http://www.php.net/cvs-php.php Derick http://uk.php.net/manual/en/ref.ccvs.php allowing you to directly work with - allowing you to work directly with PHP Will attempt to look in the - PHP will http://uk.php.net/manual/en/ref.muscat.php any memory back to php - PHP api - API (multiple) http://uk.php.net/manual/en/ref.domxml.php The domxml extension has been overhauled in PHP Version 4.3.0 in favour of a better compliance of the DOM standard - The domxml extension has been overhauled in PHP 4.3.0 to provide better compliance with the DOM standard There a quite some functions which do not fit - There are quite a few functions that do not fit Deprecated functions and its replacements - Deprecated functions and their replacements require a xml require an XML http://uk.php.net/manual/en/ref.aspell.php use spell-checking capabilities in php - PHP http://uk.php.net/manual/en/ref.msql.php you must compile php with msql - PHP http://www.php.net/manual/en/faq.databases.php construct your tables in access - Access http://www.php.net/manual/en/function.getimagesize.php Some Programs use these APP markers to embedd text - Some programs use these APP markers to embed text A very common one in to embed - A very common use is to embed http://uk.php.net/manual/en/function.iptcparse.php This is an image function - how come it is listed in misc. rather than in image functions? Could at least a link be placed somewhere in the image section? Or in http://www.php.net/manual/en/function.iptcembed.php, which *is* under images? :) http://www.php.net/manual/en/function.imagecopy.php Just to make the function definition a little more obvious to the reader... int imagecopy ( resource dst_im, resource src_im, int dst_x, int dst_y, int src_x, int src_y, int src_w, int src_h) Copy a part of src_im onto dst_im starting at the x,y coordinates src_x, src_y with a width of src_w and a height of src_h. The portion defined will be copied onto the x,y coordinates, dst_x and dst_y. - int imagecopy ( resource dest_image, resource source_image, int dest_x, int dest_y, int source_x, int source_y, int source_width, int source_height) Copy a part of source_image onto dest_image starting at the x,y coordinates source_x, source_y with a width of source_width and a height of source_height. The portion defined will be copied onto the x,y coordinates, dest_x and dest_y. http://uk.php.net/manual/en/ref.snmp.php including their respective object id withing the specified - including their respective object ID within the specified http://uk.php.net/manual/en/ref.iconv.php Iconv library function converts files between various encoded character sets - The iconv library functions convert files between various character sets encodings. http://uk.php.net/manual/en/ref.pfpro.php These functions have been added in PHP 4.0.2. - These functions were added in PHP 4.0.2. http://uk.php.net/manual/en/ref.wddx.php which comes with apache 1.3.7 or higher - Apache _ Chat with friends online, try MSN Messenger: http://messenger.msn.com -- PHP Documentation Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php --- Did I help you? http://www.derickrethans.nl/link.php?url=giftlist Frequent ranting: http://www.derickrethans.nl/ --- PHP: Scripting the Web - [EMAIL PROTECTED] All your branches are belong to me! SRM: Script Running Machine - www.vl-srm.net --- -- PHP Documentation Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php
Re: [PHP-DOC] PHP manual typos, part 3
At 11.58 30/06/02 +, Paul Hudson wrote: Here's a third set of typographical errors in the PHP English documentation. Could someone with CVS access please commit them for me? I will commit all these changes in less than 2 hours. -- http://cortesi.com/ blog * photos * PHP in italian did I help you? http://cortesi.com/wishlist.php -- PHP Documentation Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php
Re: [PHP-DOC] PHP manual typos, part 3
Derick, It would be much better if you got CVS access yourself ... saves a lot of double time Thanks for the tip - I've just applied :) --Paul _ MSN Photos is the easiest way to share and print your photos: http://photos.msn.com/support/worldwide.aspx -- PHP Documentation Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php
[PHP-DOC] PHP manual typos, part 2
Here's another list of minor typos in the English documentation. I still need someone to commit these changes on my behalf, so if you've got CVS access and five minutes on your hands...? :) Thanks, --Paul -- Changes: http://uk.php.net/manual/en/faq.html.php PHP and HTML interact a lot: PHP generate HTML, and HTML has informations that will be sent to PHP. - PHP and HTML interact a lot: PHP can generate HTML, and HTML can pass information to PHP. What encodings/decodings do I need when I pass a value on via a form? And via an URL? - What encoding/decoding do I need when I pass a value through a form/URL? (two instances) htmlspecialchars the the whole value - htmlspecialchars the whole value interpret the html escaped symbols - HTML Use it's numerical form element id instead - use its numerical form element ID instead http://uk.php.net/manual/en/ref.mnogo.php These functions allow you to access mnoGoSearch - allow you to access the mnoGoSearch you must compile php with mnogosearch - PHP the path to mnogosearch, php will look for mnogosearch - PHP ftp archive search, news articles - FTP php contains built-in mysql access library - PHP contains a built-in MySQL access library You need at least 3.1.10 version of mnoGoSearch installed to use these functions. - You need at least version 3.1.10 of mnoGoSearch installed in order to use these functions. and can work only with generic mysql libraries - MySQL with mysql, during php configuration - PHP http://uk.php.net/manual/en/language.references.php References are a means in PHP to access the same - References in PHP are a means to access the same http://uk.php.net/manual/en/ref.oci8.php make sure that you have set up your oracle environment - Oracle http://uk.php.net/manual/en/ref.cyrus.php Authenticate agaings a Cyrus IMAP server - against Close connection to a cyrus server - to a Cyrus IMAP server Unbind ... - presumably Unbind callbacks for a Cyrus IMAP connection? http://uk.php.net/manual/en/ref.mssql.php procedure on a MS-SQL server - MS SQL http://uk.php.net/manual/en/ref.ovrimos.php in PHP just compile php with - just compile PHP with This will just connect to SQL Server. - This will just connect to an Ovrimos SQL server http://uk.php.net/manual/en/ref.misc.php Generate a unique id - ID http://uk.php.net/manual/en/ref.misc.php Delay execution - Pause execution, I think, is what is meant _ Get your FREE download of MSN Explorer at http://explorer.msn.com/intl.asp. -- PHP Documentation Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php
[PHP-DOC] PHP manual typos, take 2
Couple more minor typos in the English documentation. I don't have access to change this myself, so if you have 5 minutes + CVS Access, please could you commit these? :) Thanks, --Paul --- Changes: http://uk.php.net/manual/en/faq.html.php PHP and HTML interact a lot: PHP generate HTML, and HTML has informations that will be sent to PHP. - PHP and HTML interact a lot: PHP can generate HTML, and HTML can pass information to PHP. What encodings/decodings do I need when I pass a value on via a form? And via an URL? - What encoding/decoding do I need when I pass a value through a form/URL? (two instances) htmlspecialchars the the whole value - htmlspecialchars the whole value interpret the html escaped symbols - HTML Use it's numerical form element id instead - use its numerical form element ID instead http://uk.php.net/manual/en/ref.mnogo.php These functions allow you to access mnoGoSearch - allow you to access the mnoGoSearch you must compile php with mnogosearch - PHP the path to mnogosearch, php will look for mnogosearch - PHP ftp archive search, news articles - FTP php contains built-in mysql access library - PHP contains a built-in MySQL access library You need at least 3.1.10 version of mnoGoSearch installed to use these functions. - You need at least version 3.1.10 of mnoGoSearch installed in order to use these functions. and can work only with generic mysql libraries - MySQL with mysql, during php configuration - PHP http://uk.php.net/manual/en/language.references.php References are a means in PHP to access the same - References in PHP are a means to access the same http://uk.php.net/manual/en/ref.oci8.php make sure that you have set up your oracle environment - Oracle http://uk.php.net/manual/en/ref.cyrus.php Authenticate agaings a Cyrus IMAP server - against Close connection to a cyrus server - to a Cyrus IMAP server Unbind ... - presumably Unbind callbacks for a Cyrus IMAP connection? http://uk.php.net/manual/en/ref.mssql.php procedure on a MS-SQL server - MS SQL http://uk.php.net/manual/en/ref.ovrimos.php in PHP just compile php with - just compile PHP with This will just connect to SQL Server. - This will just connect to an Ovrimos SQL server http://uk.php.net/manual/en/ref.misc.php Generate a unique id - ID http://uk.php.net/manual/en/ref.misc.php Delay execution - Pause execution, I think, is what is meant --- _ Get your FREE download of MSN Explorer at http://explorer.msn.com/intl.asp. -- PHP Documentation Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php
[PHP-DOC] PHP manual typos
A small hunt through the English version of the manual turned up quite a few minor typographical errors scattered around - I've noted down the ones I found, and have included them below. I don't have any sort of CVS access for the documentation, so I need someone to commit these changes for me :) I don't claim that this is a definitive list of typos, but it's a good start :) Thanks, --Paul --- http://uk.php.net/manual/en/ref.mysql.php: Runtime Configuration: Wether to allow persistent connections to MySQL. - Whether Resource types: second a resource which helds the result of a query. - holds http://uk.php.net/manual/en/function.mysql-insert-id.php mysql_insert_id -- Get the id generated from the previous INSERT operation - ID http://uk.php.net/manual/en/function.mysql-thread-id.php Several places, id - ID http://uk.php.net/manual/en/function.mysql-stat.php you have to use the SHOW STATUS sql command. - SQL http://uk.php.net/manual/en/function.mysql-drop-db.php is deprecated. It is prefarable to use - preferable http://uk.php.net/manual/en/function.mysql-list-fields.php retrieves information about the given tablename - table name http://uk.php.net/manual/en/features.file-upload.php So don't count on it that the browser obeys you wish! - your wish http://uk.php.net/manual/en/features.commandline.php Note: This directives cannot be initialzied with another value - Note: These directives cannot be initialized with another value The ease the operating in the shell environment (not sure what is meant here, but ...) To ease working in the shell environment You do not need to explicitely close these streams - explicitly provided by the PHP binary can be queryied anytime - queried any time Like every shell application not only the PHP binary - remove not only, and add a comma after application You can write a script which's first line starts - script where the first line starts http://uk.php.net/manual/en/ref.dbplus.php db++, made by the german company - German additional language interface it is not really a SQL - additional language interface, it is not really a SQL _ Chat with friends online, try MSN Messenger: http://messenger.msn.com
Re: [PHP-DOC] PHP manual typos
Hello, I'm on it now... Derick On Fri, 21 Jun 2002, Paul Hudson wrote: A small hunt through the English version of the manual turned up quite a few minor typographical errors scattered around - I've noted down the ones I found, and have included them below. I don't have any sort of CVS access for the documentation, so I need someone to commit these changes for me :) I don't claim that this is a definitive list of typos, but it's a good start :) Thanks, --Paul --- http://uk.php.net/manual/en/ref.mysql.php: Runtime Configuration: Wether to allow persistent connections to MySQL. - Whether Resource types: second a resource which helds the result of a query. - holds http://uk.php.net/manual/en/function.mysql-insert-id.php mysql_insert_id -- Get the id generated from the previous INSERT operation - ID http://uk.php.net/manual/en/function.mysql-thread-id.php Several places, id - ID http://uk.php.net/manual/en/function.mysql-stat.php you have to use the SHOW STATUS sql command. - SQL http://uk.php.net/manual/en/function.mysql-drop-db.php is deprecated. It is prefarable to use - preferable http://uk.php.net/manual/en/function.mysql-list-fields.php retrieves information about the given tablename - table name http://uk.php.net/manual/en/features.file-upload.php So don't count on it that the browser obeys you wish! - your wish http://uk.php.net/manual/en/features.commandline.php Note: This directives cannot be initialzied with another value - Note: These directives cannot be initialized with another value The ease the operating in the shell environment (not sure what is meant here, but ...) To ease working in the shell environment You do not need to explicitely close these streams - explicitly provided by the PHP binary can be queryied anytime - queried any time Like every shell application not only the PHP binary - remove not only, and add a comma after application You can write a script which's first line starts - script where the first line starts http://uk.php.net/manual/en/ref.dbplus.php db++, made by the german company - German additional language interface it is not really a SQL - additional language interface, it is not really a SQL _ Chat with friends online, try MSN Messenger: http://messenger.msn.com --- Did I help you? http://www.derickrethans.nl/link.php?url=giftlist Frequent ranting: http://www.derickrethans.nl/ --- PHP: Scripting the Web - [EMAIL PROTECTED] All your branches are belong to me! SRM: Script Running Machine - www.vl-srm.net ---
Re: [PHP-DOC] PHP manual typos
On Fri, 21 Jun 2002 [EMAIL PROTECTED] wrote: Hello, I'm on it now... All fixed in CVS now, the changes will show up on the site in a few days. Derick On Fri, 21 Jun 2002, Paul Hudson wrote: A small hunt through the English version of the manual turned up quite a few minor typographical errors scattered around - I've noted down the ones I found, and have included them below. I don't have any sort of CVS access for the documentation, so I need someone to commit these changes for me :) I don't claim that this is a definitive list of typos, but it's a good start :) Thanks, --Paul --- http://uk.php.net/manual/en/ref.mysql.php: Runtime Configuration: Wether to allow persistent connections to MySQL. - Whether Resource types: second a resource which helds the result of a query. - holds http://uk.php.net/manual/en/function.mysql-insert-id.php mysql_insert_id -- Get the id generated from the previous INSERT operation - ID http://uk.php.net/manual/en/function.mysql-thread-id.php Several places, id - ID http://uk.php.net/manual/en/function.mysql-stat.php you have to use the SHOW STATUS sql command. - SQL http://uk.php.net/manual/en/function.mysql-drop-db.php is deprecated. It is prefarable to use - preferable http://uk.php.net/manual/en/function.mysql-list-fields.php retrieves information about the given tablename - table name http://uk.php.net/manual/en/features.file-upload.php So don't count on it that the browser obeys you wish! - your wish http://uk.php.net/manual/en/features.commandline.php Note: This directives cannot be initialzied with another value - Note: These directives cannot be initialized with another value The ease the operating in the shell environment (not sure what is meant here, but ...) To ease working in the shell environment You do not need to explicitely close these streams - explicitly provided by the PHP binary can be queryied anytime - queried any time Like every shell application not only the PHP binary - remove not only, and add a comma after application You can write a script which's first line starts - script where the first line starts http://uk.php.net/manual/en/ref.dbplus.php db++, made by the german company - German additional language interface it is not really a SQL - additional language interface, it is not really a SQL _ Chat with friends online, try MSN Messenger: http://messenger.msn.com --- Did I help you? http://www.derickrethans.nl/link.php?url=giftlist Frequent ranting: http://www.derickrethans.nl/ --- PHP: Scripting the Web - [EMAIL PROTECTED] All your branches are belong to me! SRM: Script Running Machine - www.vl-srm.net --- --- Did I help you? http://www.derickrethans.nl/link.php?url=giftlist Frequent ranting: http://www.derickrethans.nl/ --- PHP: Scripting the Web - [EMAIL PROTECTED] All your branches are belong to me! SRM: Script Running Machine - www.vl-srm.net ---
[PHP-DOC] PHP manual translation in Romanian
Hello, friends ! My name is Iancu Miron and, as you can see from my attached vcard, I'm a physician with informatics background. I have strong knowledge of PHP and I'm building a PHP application for the F. Edward Hebert School of Medicine at the Uniformed Services University of Health Sciences in Bethesda, Maryland, USA (http://www.usuhs.mil/medschool/schoolmed.html). This will be an online course curriculum. Since I haven't seen any romanian version of PHP manual, I was curious whether you're interested in me translating it. My proposal is to be involved in such a project. Please let me know whether this is possible, desirable and, if so, what are the next steps I should take in order to accomplish this mission. Thank you. Yours, Miron Iancu, MD, PhD, FAAEM Emergency Medicine Medical Informatics Pictor Tattarascu str. 8 74411 Bucharest 3 Romania v: (+401) 3244390 m:(+4093) 194099 http://tom.dnt.ro/ BEGIN:VCARD VERSION:2.1 N:Iancu;Tom FN:Tom Iancu (E-mail) TITLE:Emergency medicine Physician EMAIL;PREF;INTERNET:[EMAIL PROTECTED] REV:20020208T130314Z END:VCARD
[PHP-DOC] PHP manual in an XML format?
Hey there! I wonder where you can find the PHP manual in one single XML file? Anyone who wants to enlight me on this one? =) Regards Fredrik Johansson
Re: [PHP-DOC] PHP manual in an XML format?
Fredrik wrote: I wonder where you can find the PHP manual in one single XML file? Anyone who wants to enlight me on this one? =) we are talking about eventualy splitting it even more as some of the files are getting big enough so that you get lost when trying to edit them or when you attempt to track the changelog for these, and you want all the 5+MB in a single file? why? besides that you can always use a simple copying stylesheet with xslt, that should give you a single file although i do not know how to control which entites to resolve and which to copy verbatim so if you need a single file as your processing tools can't handle includes via SYSTEM entities then this is the way to go, although i'd suggest to switch to other tools as anything that doesn't support includes will most likely also have other weaknesses but if you want to edit the xml then you should definetly work on the files 'as is' as their is no way to merge back your changes as soon as you've merged the files into a single one -- Hartmut Holzgraefe [EMAIL PROTECTED] http://www.six.de +49-711-99091-77
Re: [PHP-DOC] PHP manual in an XML format?
From: Hartmut Holzgraefe [EMAIL PROTECTED] I wonder where you can find the PHP manual in one single XML file? Anyone who wants to enlight me on this one? =) we are talking about eventualy splitting it even more as some of the files are getting big enough so that you get lost when trying to edit them or when you attempt to track the changelog for these, and you want all the 5+MB in a single file? why? Please don´t make such megapatches. If you split the languages into different repositories, do it in single steps. -Egon
Fw: [PHP-DOC] php manual on php.net
Hi! Somebody please read this, and correct the errors. Maybe Hatmut or any other script wizard people can help us :) In http://www.php.net/manual/ja/build-ja.log, there is a error message, creating manual.xml SP_ENCODING=XML SP_CHARSET_FIXED=YES SGMLSCMD -i lang-ja -s /local/mirror/phpdoc/phpdocxml.dcl manual.xml /bin/sh: SGMLSCMD: command not found make: *** [test] Error 127 I found all html manual making process for any other encoding except for ISO-8859-1 was failed for the same error. This script works fine in my cygwin environment. In configure.in , UTF-8) JADE=SP_ENCODING=XML SP_CHARSET_FIXED=YES $JADEPATH NSGMLS=SP_ENCODING=XML SP_CHARSET_FIXED=YES $NSGMLSCMD ;; big5) JADE=SP_ENCODING=big5 SP_CHARSET_FIXED=YES $JADEPATH NSGMLS=SP_ENCODING=big5 SP_CHARSET_FIXED=YES $NSGMLSCMD ;; ISO-8859-2) JADE=SP_ENCODING=ISO-8859-2 $JADEPATH NSGMLS=SP_ENCODING=ISO-8859-2 $NSGMLSCMD HTMLHELP_ENCODING=windows-1250 I beleave there is a problem in the shell script code, but I don't know how to fix it. On Fri, 29 Jun 2001 18:32:40 +0200 Hojtsy Gabor [EMAIL PROTECTED] wrote: Hojtsy I updated the japanese version of php manual, but php manual on Hojtsy http://www.php.net/manual/ja is not updated since Sun,17,July. Hojtsy Is there any problem to make html manual? Hojtsy Hojtsy And currently, default_charset is set to iso-8859-1 on simply formatted Hojtsy versions of php manual, http://www.php.net:8000/manual/ja/html/ . Hojtsy Hojtsy Because japanese manual is encoded in utf-8, browser should be confused. Hojtsy Hojtsy You can see the update log here: Hojtsy http://www.php.net/manual/ja/build-ja.log Hojtsy Check if you see any errors there. Hojtsy Hojtsy Goba -- Rui Hirokawa [EMAIL PROTECTED] [EMAIL PROTECTED]
Re: [PHP-DOC] php manual on php.net
I updated the japanese version of php manual, but php manual on http://www.php.net/manual/ja is not updated since Sun,17,July. Is there any problem to make html manual? And currently, default_charset is set to iso-8859-1 on simply formatted versions of php manual, http://www.php.net:8000/manual/ja/html/ . Because japanese manual is encoded in utf-8, browser should be confused. You can see the update log here: http://www.php.net/manual/ja/build-ja.log Check if you see any errors there. Goba
[PHP-DOC] php manual on php.net
I updated the japanese version of php manual, but php manual on http://www.php.net/manual/ja is not updated since Sun,17,July. Is there any problem to make html manual? And currently, default_charset is set to iso-8859-1 on simply formatted versions of php manual, http://www.php.net:8000/manual/ja/html/ . Because japanese manual is encoded in utf-8, browser should be confused. -- Rui Hirokawa [EMAIL PROTECTED] [EMAIL PROTECTED]
[PHP-DOC] PHP Manual and DocBook/DSSSL setup.
[I've used follow up by mistake previously Sorry for posting again] Anyway, I'm getting following warnings. (make html seems working, though) C:\cygwin\usr\local\jade\jade.exe:c:/cygwin/usr/local/lib/docbook/ent/iso-lat1.e nt:28:19:E: "X00E8" is not a function name C:\cygwin\usr\local\jade\jade.exe:c:/cygwin/usr/local/lib/docbook/ent/iso-lat2.e nt:108:18:E: "X016B" is not a function name I use DocBook DTD 4.1.12, DSSL 1.64. I must miss something. Could you give me what should I look into? Thank you. -- Yasuo Ohgaki
Re: [PHP-DOC] PHP Manual and DocBook/DSSSL setup.
Yasuo Ohgaki wrote: C:\cygwin\usr\local\jade\jade.exe:c:/cygwin/usr/local/lib/docbook/ent/iso-lat1.e nt:28:19:E: "X00E8" is not a function name C:\cygwin\usr\local\jade\jade.exe:c:/cygwin/usr/local/lib/docbook/ent/iso-lat2.e nt:108:18:E: "X016B" is not a function name Search the archives in the future, this problem was discussed here few days ago: DSSSL stylesheets need SGML version of ISO entities, but if you use XML version of DocBook you do not have them in catalog path. Just grab file http://www.oasis-open.org/cover/ISOEnts.zip and unzip it somewhere. Create new catalog file in this directory and name it, e.g. isoent.cat. This file should contain following: PUBLIC "ISO 8879:1986//ENTITIES Diacritical Marks//EN" "isodia" PUBLIC "ISO 8879:1986//ENTITIES Numeric and Special Graphic//EN" "isonum" PUBLIC "ISO 8879:1986//ENTITIES Publishing//EN" "isopub" PUBLIC "ISO 8879:1986//ENTITIES General Technical//EN" "isotech" PUBLIC "ISO 8879:1986//ENTITIES Added Latin 1//EN" "isolat1" PUBLIC "ISO 8879:1986//ENTITIES Added Latin 2//EN" "isolat2" PUBLIC "ISO 8879:1986//ENTITIES Greek Letters//EN" "isogrk1" PUBLIC "ISO 8879:1986//ENTITIES Monotoniko Greek//EN" "isogrk2" PUBLIC "ISO 8879:1986//ENTITIES Greek Symbols//EN" "isogrk3" PUBLIC "ISO 8879:1986//ENTITIES Alternative Greek Symbols//EN" "isogrk4" PUBLIC "ISO 8879:1986//ENTITIES Added Math Symbols: Arrow Relations//EN" "isoamsa" PUBLIC "ISO 8879:1986//ENTITIES Added Math Symbols: Binary Operators//EN" "isoamsb" PUBLIC "ISO 8879:1986//ENTITIES Added Math Symbols: Delimiters//EN" "isoamsc" PUBLIC "ISO 8879:1986//ENTITIES Added Math Symbols: Negated Relations//EN" "isoamsn" PUBLIC "ISO 8879:1986//ENTITIES Added Math Symbols: Ordinary//EN" "isoamso" PUBLIC "ISO 8879:1986//ENTITIES Added Math Symbols: Relations//EN" "isoamsr" PUBLIC "ISO 8879:1986//ENTITIES Box and Line Drawing//EN" "isobox" PUBLIC "ISO 8879:1986//ENTITIES Russian Cyrillic//EN" "isocyr1" PUBLIC "ISO 8879:1986//ENTITIES Non-Russian Cyrillic//EN" "isocyr2" Finally modify your SGML_CATALOG_FILES. You should have at least three catalog files referenced here: catalog for Jade, catalog for ISO entities and XML DocBook catalog. These files must be mentioned in this particular order. - Jirka Kosek e-mail: [EMAIL PROTECTED] http://www.kosek.cz
Re: [PHP-DOC] php manual in man format
Derik! I just added this script as make_man.php to the phpdoc cvs tree, so that others can easily modify it. Have you tested it, or just uploaded into phpdoc? Goba ... . . . . . Editor of the Hungarian PHP manual, Admin of the Hungarian PHP mirror
RE: [PHP-DOC] php manual in man format
Derik! I just added this script as make_man.php to the phpdoc cvs tree, so that others can easily modify it. Have you tested it, or just uploaded into phpdoc? Goba Derick tested this before he commited it. - James
Re: [PHP-DOC] php manual in man format
On Sat, 14 Apr 2001, Hojtsy Gabor wrote: Derik! I just added this script as make_man.php to the phpdoc cvs tree, so that others can easily modify it. Have you tested it, or just uploaded into phpdoc? I tested it too, it has some strange messages, but it works for me too (tm) Derick - PHP: Scripting the Web - www.php.net - [EMAIL PROTECTED] SRM: Site Resource Manager - www.vl-srm.net - JDI Media Solutions - www.jdimedia.nl - [EMAIL PROTECTED] Boulevard Heuvelink 102 - 6828 KT Arnhem - The Netherlands -
Re: [PHP-DOC] php manual in man format
Hi all, I had no luck with the programs some people on this list suggested :-( and since I'm too lazy to do it in two steps, I wrote a php script with some regexp matching to extract what I needed. It's not perfect, it gives a few screens of warnings when run, but It Works For Me(tm). I now have 1825 manpages. I have prepended every file with php_ to make the distinction between other commands/functions and the php functions, people who don't want that can change the script (it's a very simple script). Suggestions to handle this would be welcome. Also, I put section 7 in the header of the pages, I'm not sure how correct this is, I guess it's ok. One thing that is not so nice in this script is how sample code is displayed; I run code parts through indent but it doesn't handle php tags and html tags very well, and newlines are mostly lost in the man page. If someone would want to spend some time hacking indent to support php, I would appreciate a mail on where to get that modified version :-) cheers, roel On Sun, Apr 08, 2001 at 08:14:05PM +0200, Roel Vanhout wrote: Hi, Is there a way to get the php manual in man format? afaik there is no groff backend for jade, but has someone maybe written something else? I've tried to make a perl script to convert the xml source to man, but the structure of the documents is too complex to handle easily :-( Thanks. cheers, roel #!/usr/bin/php -q ?php /* * Script to convert (most of the) php documentation from docbook to unix man format. * Roel Vanhout - [EMAIL PROTECTED] - 20010413 * No long license statements here - do whatever you want. */ $lang = 'en'; $file = `cat \`find phpdoc/$lang | grep .xml\``; $file = str_replace("\n", '', $file); // First get everything in refentry/refentry tags preg_match_all('/refentry.*?\/refentry/', $file, $refentries); $functions = array(); $i = 0; foreach($refentries[0] as $refentry) { preg_match('/refname(.*)\/refname/', $refentry, $matches); $functions[$i]['name'] = $matches[1]; preg_match('/refpurpose(.*)\/refpurpose/', $refentry, $matches); $functions[$i]['shortdesc'] = $matches[1]; preg_match('/funcprototype(.*)\/funcprototype/', $refentry, $matches); $funcprototype = $matches[1]; preg_match('/funcdef(.*)\/funcdef/', $funcprototype, $matches); $functions[$i]['prototype'] = $matches[1]; $functions[$i]['prototype'] = preg_replace('/.*?/', '', $functions[$i]['prototype']); $functions[$i]['prototype'] .= '('; preg_match_all('/paramdef.*?\/paramdef/', $funcprototype, $matches); foreach($matches[0] as $param) { $param = preg_replace('/\s{2,}/', ' ', $param); $functions[$i]['prototype'] .= preg_replace('/.*?/', '', $param); $functions[$i]['prototype'] .= ', '; } $functions[$i]['prototype'] = substr($functions[$i]['prototype'], 0, strrpos($functions[$i]['prototype'], ',')); $functions[$i]['prototype'] .= ')'; $y = 0; preg_match_all('/para.*?\/para/', $refentry, $matches); foreach($matches[0] as $paragraph) { /* Put every paragraph literally in the man page. Whoever has an idea to do this better, feel free to do so :-) */ if(preg_match('/example/', $paragraph)) { // If this paragraph has an example, do some special formatting. preg_match('/title(.*)\/title/', $paragraph, $tmp); $functions[$i]['example'] = $tmp[1]; $functions[$i]['example'] = preg_replace('/\s{2,}/', ' ', $functions[$i]['example']); $functions[$i]['example'] = preg_replace('/.*?/', '', $functions[$i]['example']); $functions[$i]['example'] .= "\n\n"; preg_match('/programlisting.*?(.*)\/programlisting/', $paragraph, $tmp); $programlisting = $tmp[1]; // Hmm, no function for this? $programlisting = str_replace('lt;', '', $programlisting); $programlisting = str_replace('gt;', '', $programlisting); $programlisting = str_replace('quot;', '"', $programlisting); $programlisting = str_replace('amp;', '', $programlisting); $programlisting = str_replace('nbsp;', ' ', $programlisting); $programlisting = str_replace('sp;', ' ', $programlisting); $functions[$i]['example'] .= `echo '$programlisting' | indent -kr` . "\n\n"; } elseif(preg_match('/See also/', $paragraph)) { $functions[$i]['seealso'] = preg_replace('/.*?/', '', $paragraph); $functions[$i]['seealso'] = preg_replace('/See also:/', '', $functions[$i]['seealso']); $functions[$i]['seealso'] = preg_replace('/\s{2,}/', ' ', $functions[$i]['seealso']); } else { // Nothing special, just put it in. $functions[$i]['paragraph'][$y] = preg_replace('/.*?/', '', $paragraph); $functions[$i]['paragraph'][$y] = preg_replace('/\s{2,}/', ' ', $functions[$i]['paragraph'][$y]);
Re: [PHP-DOC] php manual in man format
[Cced to [EMAIL PROTECTED] who's looked into docbook - man before ] Roel Vanhout wrote: Is there a way to get the php manual in man format? Take a look at http://docbook2x.sourceforge.net/ Last time I tried, it didn't work with the PHPdoc manual.xml (and fiddly to install) - there have been some releases since then, so try again if you want. Stig's suggestion of an intermediary output format is a much better idea. You might be able to get away with the SGML/HTML output from Jade, and make use of HTML::FormatNroff from CPAN to do the html - roff conversion. If you make any headway on this, I'd love to hear it! Anil
Re: [PHP-DOC] PHP Manual translation into polish
Hi! I come from Poland, I'm 27 years old. I've got over 3 years experience developing PHP applications and I know it quite well I would say (before that I was programming in Pascal, Delphi Visual Basic). For almost 2 years from now on, I've been living and working in Germany as PHP Developer, however I use english as my "working" language. I'm writting this e-mail because I would like to contribute to translation of the PHP Manual into polish. Please read the readme file for the new translations. You can find it at: http://cvs.php.net/ clicking the phpdoc link and then README.translations You'll need a CVS account to do this. Visit http://www.php.net/cvs-php.php to see how you can get one. Goba ... . . . . . Editor of the Hungarian PHP manual, Admin of the Hungarian PHP mirror
Re: [PHP-DOC] PHP manual
On Tue, Jan 30, 2001 at 07:51:43PM -0500, David Elrom wrote: Why r we using TeX ? why not some other XML format ? If you want a printed manual, DocBook uses a TeX backend. TeX is better than every XML style shit. -Egon PS: I have read something about Donald E. Knuth the last day. He is now 63 years old. -- http://www.linuxtag.de/ http://php.net/books.php http://www.concert-band.de/ http://www.php-buch.de/
Re: [PHP-DOC] PHP manual
On Wed, 31 Jan 2001 [EMAIL PROTECTED] wrote: On Tue, Jan 30, 2001 at 07:51:43PM -0500, David Elrom wrote: Why r we using TeX ? why not some other XML format ? If you want a printed manual, DocBook uses a TeX backend. TeX is better than every XML style shit. To be more precise, we use DocBook XML format and then convert it to TeX to get a printable version. To be even more precise, the TeX format is then converted to printable/vievable versions. This is currently the best way to do it. XSL/XSLT maybe the future, maybe not, but we ain't there yet... -- Jouni