Re: [PHP-DOC] Romanian build broken
Hi Stelian 2013/3/11 Stelian Mocanita : > Hello Hannes, > > Thank you for taking the time to fix it. For future reference, I followed > the instructions here: http://doc.php.net/php/dochowto/svn-checkout.php, > basically checking out https://svn.php.net/repository/phpdoc/modules/doc-it > phpdoc-ro. That looks wrong, I suppose it should be ../modules/doc-ro not doc-it which is the Italian translation. Also please note that we marked the Romanian documentation as inactive, but if you are reviving it then give us a hint and we'll re-enable it on php.net -- regards, Kalle Sommer Nielsen ka...@php.net
[PHP-DOC] Undocument PHP4
Howdy I think its time we consider looking at undocumenting PHP4 in the manual, and this year we're surpassing 5 years after the end of life (for critical updates). Perhaps keep the PHP4 > PHP5 migration guide however, but I think with the redesign of php.net coming up, its well overdue we start considering this, after all the old documentation is still available in SVN (yes it should be hard to find documentation on such an old and unsupported product). -- regards, Kalle Sommer Nielsen ka...@php.net
Re: [PHP-DOC] CHM Builds.
Hi Richard 2011/11/18 Richard Quadling : > Hello Hannes. > > When do the CHMs get pulled from oti1.php.net? Actually they are not pulled from OTI1, OTI1 will rsync them to the synchronization server directly when they are built. -- regards, Kalle Sommer Nielsen ka...@php.net
[PHP-DOC] Re: [PECL-DEV] libidn2 extension for php
2011/11/2 Pierre Joye : > Pecl's idn is php5 only. PHP 5.0, 5.1 where intl is not supported then? -- regards, Kalle Sommer Nielsen ka...@php.net
[PHP-DOC] Re: [DOC-CVS] svn: /phpdoc/en/trunk/reference/mysqli/mysqli/ real-escape-string.xml
Hi Peter 2011/9/22 Peter Cowburn : > Good question. Lets see what the phpdoc list thinks. :) I can't think off my head where we document other extensions behavior in comparison to the one the end user is reading about. What we need to do is to have a proper mysql -> mysqli migration guide, like Phil suggested. That will not only solve such an issue, but also help advocate the use of mysqli in favor of mysql in phpdoc. -- regards, Kalle Sommer Nielsen ka...@php.net
[PHP-DOC] Re: [DOC-DA] svn: /phpdoc/da/trunk/ bookinfo.xml
Hi Richard (and doc geeks) 2011/9/5 Richard Quadling : > http://docbook.org/ns/docbook"; xml:id="bookinfo"> > &frontpage.authors; > - &php.build-date; > + > &frontpage.editors; How would anyone mind if we added a timestamp here as well for all translation, like: H:i:s, j/n - Y (which in this case would be the danish notation for including time/date) I think its especially useful for the docs mirror to see when the online version was last built, in case the build was borked. -- regards, Kalle Sommer Nielsen ka...@php.net
Re: [PHP-DOC] Broken URL entities report
2011/8/23 Pierre Joye : > It is in the wiki, since ages. So no, not only knows it. Please do not > spread misleading info if you are not aware of the updates, thanks :) I'm only spreading the information I know, last time I checked the wiki it was quite outdated on the Windows part, but okay I'm not that active ;-) -- regards, Kalle Sommer Nielsen ka...@php.net
Re: [PHP-DOC] Broken URL entities report
2011/8/23 Hannes Magnusson : > Anyone knows which urls should be used for these now? I don't even know any of the Windows urls anymore, only Pierre does after the new pecl site was moved to use pecl2 -- regards, Kalle Sommer Nielsen ka...@php.net
Re: [PHP-DOC] SVN Account Request: breck
Hi Breck 2011/8/21 Breck Yunits : > Thanks Kalle! I'll delve into this issue a bit further and submit a > patch when I have the best solution. -Breck Sounds good, remember when replying to use the 'Reply-All' option so the rest of the mailing list can follow this. Happy coding! :) -- regards, Kalle Sommer Nielsen ka...@php.net
Re: [PHP-DOC] SVN Account Request: breck
Hi 2011/8/21 Breck Yunits : > Fix bugs in the documentation. On 9/21/10 Mark Skilbeck made a change to the > PHP documentation for the "header()" function. Specifically he made > this change: We don't hand out SVN accounts without patches, please contribute patches to either the bug tracker [1] as attachments, or directly into the online editor [2]. Fixing bugs is most likely the fastest way to get an SVN account voucher. Alternatively if you are a non native english speaker, you may as well contribute to the language of your origin to get a voucher. [1] http://bugs.php.net/ [2] http://edit.php.net/ -- regards, Kalle Sommer Nielsen ka...@php.net
Re: [PHP-DOC] Windows CHM build machine.
Hi 2011/8/12 Richard Quadling : > Hi. > > Just a note for those interested. It should have the option to "Manually choose which updates to install" enabled, so it won't just reboot, and then lets pick a date, say every monday at 3pm it should search so we don't get such interruptions again. -- regards, Kalle Sommer Nielsen ka...@php.net
Re: [PHP-DOC] SQLSRV and PDO_SQLSRV Documentation Patch
Hi Jonathan 2011/7/12 Jonathan Guerin : > Ok, we believe we have fixed the issues described, but are now running into a > commit problem: > > Commit failed (details follow): > Commit blocked by pre-commit hook (exit code 1) with output: > *** > Access denied: Insufficient karma for jguerin to > phpdoc/doc-base/trunk/entities/global.ent. > Contact phpdoc@lists.php.net for access. > > How can we push updates to the Global Entities file, as we need to add some > links in there? Philip will have to grant you karma, as currently your account does not have access to any part of the svn tree. -- regards, Kalle Sommer Nielsen ka...@php.net
Re: [PHP-DOC] DocGen, PHPDOC, PhD and namespaced extensions.
Hi Richard
2011/6/14 Richard Quadling :
> Do we want the namespace to be a sub directory or do we want name the
> '\' in the namespace translated to '_' or '-' or something like that?
I thought of the same thing a while back, and to keep the "style" that
we currently got, then how about doing it like:
"namespace.[class|interface]" as the directory name and
class/interface synopsis files, so if we have a simple structure like
this in a project:
namespace Project;
class database { }
class userapi { }
interface extension { }
We will have a phpdoc structure like the following (without including
the default files):
~/phpdoc/en/reference/project/
project.database.xml - (Project\database class synopsis)
project.userapi.xml - (Project\userapi class synopsis)
project.extension.xml - (Project\extension interface synopsis)
etc.
And for methods and implementations, we would have the following in
the same directory:
project.database/construct.xml
project.database/destruct.xml
project.userapi/login.xml
project.extension/getmetainfo.xml
etc.
I don't think this structure will collide with anything we currently
got, thoughts?
--
regards,
Kalle Sommer Nielsen
ka...@php.net
Re: [PHP-DOC] Weird PhD optimizations (10% !)
Hi 2011/5/25 Hannes Magnusson : > We could do shitloads of optimizations if we generated most of the > code, or moved some things into cpp macros, but it becomes so insanely > annoying to debug that I don't think its worth the benefits. Just a random thought; I use a preprocessor for generating documentation in one of my older projects which relies on the tokenizer extension to parse the source code. Since things like 'Reader::XMLNS_DOCBOOK" is most likely to only be used in such context we could infact have a preprocessor script to replace such constant values into their real values. But I think it boils down to the fact whether its sane to do so, but it might provide a nice value for people working on that on-the-move or for other projects that want to utilize PhD. -- regards, Kalle Sommer Nielsen ka...@php.net
[PHP-DOC] Re: Extended CHM redux?
Hi Richard 2011/2/18 Richard Quadling : > See http://svn.php.net/viewvc?view=revision&revision=308462 I can make this format build and everything on OTI1 during the weekend, all I would need is a name for the format so it can be pulled from the rsync server to phpweb. Bz2 won't be a problem, I'll build a copy on the box to use, but I keep thinking, wouldn't it be much better to depend on ext/bz2 instead? -- regards, Kalle Sommer Nielsen ka...@php.net
Re: [PHP-DOC] Re: [PHP-WEBMASTER] Errors in php help chm
Hi Philip 2011/2/16 Philip Olson : > Hello Richard, > > The bug remains open though, so I assume it's not fixed in SVN or in a PhD > release. Right? I'm unable to login into the Windows box this morning (it's > down?) but wonder which PhD version is being used there... I'm surprised we > don't mention the PhD version in the output somewhere. We use the latest release ready PhD version to generate the manual, the chm builder script is designed to upgrade PhD before the weekly builds is performed so if anything we would need a new PhD release I guess. -- regards, Kalle Sommer Nielsen ka...@php.net
Re: [PHP-DOC] Re: [DOC-CVS] svn: /phpdoc/en/trunk/reference/xml/functions/ xml-parse-into-struct.xml xml-set-character-data-handler.xml xml-set-default-handler.xml xml-set-element-handler.xml xml-set-
Hi Braian 2010/12/14 Braian Iván Monnier : > Hello Hannes > > Excuse me, but are there any policies to make commits to the En repository, > or can you give us advices about the things we have to keep in mind when > modifying the original documentation?? No there aren't anything that prevents you from altering the original content for things like if you found a typo, or other type of bug or think it could be improved some way or another. What Hannes implies here is that log messages should be more verbose so us the editors can see what you changed unlike translations that might not be so expressive in their commit log messages. -- regards, Kalle Sommer Nielsen ka...@php.net
Re: [PHP-DOC] Re: [DOC-CVS] svn: /phpdoc/doc-base/branches/gtk-docgen/scripts/docgen/ docgen.php
2010/11/17 Peter Cowburn : > On 17 November 2010 02:52, Justin Martin wrote: >> frozenfire Wed, 17 Nov 2010 02:52:49 + >> >> Revision: http://svn.php.net/viewvc?view=revision&revision=305431 >> >> Log: >> Very preliminary mod of docgen.php which uses the PHP-GTK sources to bypass >> lack of Reflection data. > > Is there any reason why these gtk-related changes cannot happen on trunk? > For now I think the idea was to get it working in its own branch and then merge it as it would be the most logical ;-) -- regards, Kalle Sommer Nielsen ka...@php.net
Re: [PHP-DOC] Problems with Romanian translation?
Hi Simion 2010/9/24 Simion Onea : > I found the error. The file "maxdb-get-metadata.xml" was missing a > line. This caused a chain of errors. > It is corrected now. The translation validates. I will make the CHM build script generate the romanian documentation so its sent to the rsync server for a test. Note to Philip; This makes all our active translations that have CHM versions build again :) -- regards, Kalle Sommer Nielsen ka...@php.net
Re: [PHP-DOC] Precompiled versions of PHP that can build docs?
2010/7/8 Anthony Bedford : > tony~/phpdoc/doc-base $ php configure.php > configure.php: $Id: configure.php 300704 2010-06-23 18:18:59Z philip $ > PHP version: 5.2.6 > > LibXML 2.7.4+ added a 'feature' to break things, typically namespace > related, and unfortunately we must require it. > For a few related details, see: > http://www.mail-archive.com/debian-bugs-d...@lists.debian.org/msg777646.html > Please recompile PHP with a LibXML version 2.7.4 or greater. Version > detected: 2.6.16 > Or, pass in --disable-libxml-check if doing so feels safe. Simply pass --disable-libxml-check, the docs can still validate and be built without libxml 2.7.4 :) -- regards, Kalle Sommer Nielsen ka...@php.net
[PHP-DOC] Re: [DOC-CVS] svn: /phpdoc/en/trunk/reference/ctype/functions/ ctype-digit.xml
Hi Mark 2010/6/27 Mark Wiesemann : > wiesemann Sun, 27 Jun 2010 19:25:36 + > > Revision: http://svn.php.net/viewvc?view=revision&revision=300784 > > Log: > - two typo fixes > - all other functions in the ctype chapter don't have the tag around > "string" => I think its better to fix the missing type tags instead of removing the current ones here -- regards, Kalle Sommer Nielsen ka...@php.net
[PHP-DOC] Re: [PHP-CVS] svn: /php/php-src/trunk/ NEWS ext/reflection/php_reflection.c ext/reflection/tests/ReflectionExtension_isPersistant.phpt ext/reflection/tests/ReflectionExtension_isTemporary.
2010/4/3 Hannes Magnusson : > 2010/3/30 Johannes Schlüter : >> johannes Tue, 30 Mar 2010 20:50:42 + >> >> Revision: http://svn.php.net/viewvc?view=revision&revision=297202 >> >> Log: >> Add ReflectionExtension::isTemporary() and >> ReflectionExtension::isPersistent(). > > Whattaheck is a temporary extension? > dl()ed? > > -Hannes Indeed, a persistent extension is an extension loaded via php.ini, temporary is via dl() =) -- regards, Kalle Sommer Nielsen ka...@php.net
Re: [PHP-DOC] Translating Internals ?
Hi 2010/2/25 Julien Pauli : >>> I heard that it's not actually recommended, as it's still moving >>> (talked about that with Johannes on #phpdoc) ; anyway I would like to, >>> at least for my language (Fr). I would love a better internals documentation, but if any documentation should take place it should start in phpdoc/en, I don't think other translations should start to develop the manual further alone when other translations can benefit for it too ;) But like Hannes said, documentation as you go wouldn't be bad. If you need it, then I can help you out with Windows specific parts of the code. -- regards, Kalle Sommer Nielsen ka...@php.net
[PHP-DOC] Re: [DOC-CVS] svn: /phd/trunk/ package.xml phpdotnet/phd/BuildOptionsParser.php phpdotnet/phd/functions.php
2010/1/13 Richard Quadling : > I've no problem with the default for coloured output on Windows be set > to false. It is just a case of adding -c on to my command line, but > disabling it completely means I've lost a useful feature of the > logging system. Well feel free to set it to false by default, I just saw this as the quickest for now, but if you want to re-enable it feel free to -- regrads, Kalle Sommer Nielsen ka...@php.net
Re: [PHP-DOC] #49535 [Opn->Asn]: mysqli::get_client_info/get_client_version are properties
Hi Anthony
2009/9/28 Anthony Bedford :
> Obviously, something is not right (the properties don't seem to have the
> correct info), or I am doing something wrong (more likely!). Can anyone spot
> the problem?
Thats because the properties is called 'client_info' and
'client_version', not prefixed with get as its procedural equal:
C:\php\six\Release_TS>php -r "$mysqli = new mysqli('localhost',
'root', ''); var_dump($mysqli->client_info, $mysqli->client_version);"
unicode(48) "mysqlnd 5.0.5-dev - 081106 - $Revision: 288379 $"
int(50005)
--
regrads,
Kalle Sommer Nielsen
ka...@php.net
Re: [PHP-DOC] Could anyone help me with the compilation of zh manual by PhD
Hi Haohappy 2009/9/25 Haohappy : > Hi all, > I've been translating the zh (Simplified Chinese) manual these days. > I had an issue when I was building the manual into HTML files by PhD. > These were what I did as following: > # cd /home/php_manual/svn/ > # svn co http://svn.php.net/repository/phpdoc/modules/doc-zh ./doc-zh > # /home/www/php5_3/bin/php doc-base/configure.php > --with-lang=zh --disable-segfault-error > Then I got the result: These errors occur because some areas of the manual, namely the OOP part have recently been changed and your manual links to documentation thats no longer located where it used to be located. You can solve it by copying the english source files over or better yet updating the translation of those files. -- regrads, Kalle Sommer Nielsen ka...@php.net
Re: [PHP-DOC] Hello phpdoc people and SPL ArrayObject patch
Hi Joris 2009/7/1 Joris van de Sande : > I will take your offer :). I will document the remaining class > methods. I will document the constants in the class synopsis xml file > (I already have the documentation for the constants). I will let you > know when it's done. > Juliette have just committed those docs without me knowing: http://news.php.net/php.doc.cvs/4304 So instead, you should document another class thats not documented within SPL instead, send it for review and then commit it. To generate a list of missing SPL docs, then have a look at the php script in "phpdoc/scripts/check-missing-spldocs.php". If you have any questions regrading this, feel free to email us back. -- regrads, Kalle Sommer Nielsen ka...@php.net
Re: [PHP-DOC] Hello phpdoc people and SPL ArrayObject patch
Hi Joris 2009/6/27 Joris van de Sande : > Hello phpdoc people, I am Joris and I want to start contributing to > the PHP (doc) project. Currently I am a professional PHP/web developer > who's programming in PHP on a daily base (at work and at home). I have > been thinking of contributing to the PHP project for a few months now > and I'm glad that I have found some time to write some documentation > for SPL last week. Actually I really started documenting after > attending Matthew's session called "Contribute" at the Dutch PHP > Conference! > Sorry for a late reply as this was meant to be sent ealier, but here goes. If your interested in getting a CVS account so you can commit directly to the docs, then heres a small offer for you :) 1) Document the remaining class methods + constants (should be documented in the class synopsis xml file) for arrayobject (theres some in CVS, but they are considered outdated) 2) Patch it up and reply with it to this thread, and we'll review it 3) When its ok'ed, then request an CVS account and commit 4) 5) Profit Remember to run `php configure.php` to validate that your change doesn't break the build, to test how your documents looks like, then the PhD docs[1] will give you a short intro to how thats done. If you have any questions, then let us know and we'll help you out in no time. Also if you like, then you can join our IRC channel [2] where most of us hang out. [1] http://wiki.php.net/doc/phd [2] irc://irc.efnet.org/php.pecl (#php.pecl on EFNET) -- regrads, Kalle Sommer Nielsen ka...@php.net
Re: [PHP-DOC] Hello phpdoc people and SPL ArrayObject patch
Hi Joris 2009/6/27 Joris van de Sande : > The patch can be found at: > http://devplace.nl/phpdoc/phpdoc.spl.arrayobject.20090624.diff Thanks alot for the patch ;), I've just committed this to CVS and it should show up within the next few hours at our docs mirror: http://docs.php.net/ -- regrads, Kalle Sommer Nielsen ka...@php.net
Re: [PHP-DOC] Suggested getIterator example
Hi 2009/6/23 Karoly Negyesi : > Hi, > > So I would like to add this but as this is a bit bigger and a bit > different than the usual examples, I thought I will ask first. All in all the examples look good, but I don't think the example para's should have been written like: "Instead of the following:" "You can use the much shorter:" I think they should be more descriptive, explaining what this does and then the source code comments can indicate, you might want to do this or that instead. > > Regards > > NK > -- regrads, Kalle Sommer Nielsen ka...@php.net
Re: [PHP-DOC] First attempt at contributing (SPL DirectoryIterator)
Hi 2009/6/10 Peter Cowburn : > Hi folks, > > This is my first attempt at contributing any documentation so things > *may* not be as you want them; I've done my best by reading the > literature available on producing docs and the changes appear to build > happily with phd. I'll attach a link to the diffs/new files as there > are quite a lot. Also, would a contributor be expected to edit things > like entities/file-entities.ent or other entities files (eg > en/reference/spl/entities.directoryiterator.xml) for new files added—I > haven't attached changes to any entity files because of not know what > needed to be done. > > So, the additions/changes are available at > https://gist.github.com/b7c0c2c8379c7c6679c6 Thats some kick ass stuff for SPL, ++$kudos ;) > > If anyone wants to discuss off-list (to help a new contributor out, > maybe?) I try to pop in to IRC (nick, salathe). If all goes well, I'd > like to continue with SPL-file-related docs. > > Regards, > Peter > -- regrads, Kalle Sommer Nielsen ka...@php.net
Re: [PHP-DOC] Implementation of the --package option in PhD
2009/5/28 Hannes Magnusson :
>
>> abstract class PhDFormatFactory {
>> abstract public function createXhtmlFormat();
>> abstract public function createBigXhtmlFormat();
>> abstract public function createPDFFormat();
>> abstract public function createManpageFormat();
>> abstract public function createPHPFormat();
>
> This feels a bit dangerous.
> What if we add a new format in later versions of PhD? That would break
> _all_ existing packages because they would get "Class foobar contains
> 1 abstract method and must therefore be declared abstract or implement
> the remaining methods (PhDFormatFactory::createNewFormat)".
>
> Maybe simply have the class abstract, but implementing dummy methods
> (trigger_error("This format is not supported by this package",
> E_USER_ERROR)) would solve it?
I think method overloading could come in handy here, its abit dirty
but it should do the job.
>
> -Hannes
>
--
regrads,
Kalle Sommer Nielsen
ka...@php.net
[PHP-DOC] Re: [PHP-CVS] cvs: php-src /ext/dba config.m4 dba.c dba_tcadb.c php_tcadb.h
Hi 2009/5/18 Scott MacVicar : > scottmac Mon May 18 20:21:39 2009 UTC > > Added files: > /php-src/ext/dba dba_tcadb.c php_tcadb.h > > Modified files: > /php-src/ext/dba config.m4 dba.c > Log: > Add support for tokyo cabinet, patch from Michael Maclean NEWS or [DOC] ? > > > -- > PHP CVS Mailing List (http://www.php.net/) > To unsubscribe, visit: http://www.php.net/unsub.php > -- Kalle Sommer Nielsen ka...@php.net
Re: [PHP-DOC] user comments of the future
Hi Daniel 2009/3/28 Daniel Convissor : > On Fri, Mar 27, 2009 at 09:51:21PM -0700, Philip Olson wrote: >> >> - http://www.djangobook.com/en/2.0/chapter01/ > > Sounds neat. BUT, it seems they've gotten too big for their britches. > It isn't working for me. I don't see any comment bubbles or have the > ability to click in the "gutter" to initiate a new comment. Yes the script doesn't seem to be compatible with Trident (IE) or Presto (Opera), meaning that it needs to be hacked to work correctly unless we write out own. > > Even if it was working, the whole thing requires JavaScript, limiting > availability of the comments in some situations. > > --Dan > > -- > T H E A N A L Y S I S A N D S O L U T I O N S C O M P A N Y > data intensive web and database programming > http://www.AnalysisAndSolutions.com/ > 4015 7th Ave #4, Brooklyn NY 11232 v: 718-854-0335 f: 718-854-0409 > -- Kalle Sommer Nielsen ka...@php.net
Re: [PHP-DOC] Re: [DOC-FR] First overview on Online PhpDocumentation Editor
Hi Yannick 2009/2/6 yannick : > Hi all, > > More news about PhpDocumentation Online Editor. > > I have made a lot of small corrections spotted by Jean-Sébastien (aka : > jsgoupil). Thanks for your test Jean-Sébastien ;) > > News : > > * change editor from codepress to codemirror (and had it some new > functionality) > > * When we try to close a tab witch contains a file witch have been > modified without saving it before, there is an alert witch tells us what > you want to do > > * when you start to modify a file, a red mark is added near the title > (and in the tab) > > * Add an icon for indent all the file, in one click (with one space) > > * synchronize scrollBars (or not) via a checkbox > > * add a "About" window witch contains credits and licence > > * add a config window where we can choose to enable scrollBars for > error module, for Needupdate module ; can choose to use a diff command > line or viewvc's php web site for Needupdate module. > > All of this change can be view in video here : > > http://keliglia.com/video/phpeditor_change_2009_02_06.ogv > > You can test my local copy here : > > http://ytorres.dyndns.org/ > > WARNING ! Keep in mind that actually, your cvs password is store in > plain text into database... > > Feedback greatly appreciate :) > > Regards, > > Yannick > > > Le jeudi 29 janvier 2009 à 00:08 +0100, yannick a écrit : >> Hi all, >> >> Some news about PhoDocumentation Online Editor. >> >> * I have finish the "error tools". This tool is a port of >> scripts/check-trans.php. I have work on all regex to perform best check. >> >> Actually, there is 54 different checks over all uptodate's files. >> >> You can see a video here : >> http://keliglia.com/video/phpeditor_error.ogv >> >> * I have added a tab "Open bugs from doc-XX" in the main page witch >> display all open bugs where we can find, for example, [FR] in title. >> >> You can see a video here : >> http://keliglia.com/video/phpeditor_bugs.ogv >> >> * I have do others minors changes & bugs correction. >> >> Video are big & server is slow please, be patient ;) >> >> I'm going now to work on "reviewed" & "old" files. >> >> For know, this tool is ready to be tested for update files & error >> corrections by every one who want to test it (and have a valid cvs >> account) in any language. Without being able to test it because theres only the "French" and "German" modules, then I was wondering about the cross browser support especially IE (since Im one the few) and would probably be using this handy tool for getting started on phpdoc-da with it if possible sometime. But over all its some really good work, looking forward to any updates on it :) >> >> All comment is *always* welcome :) >> >> Regards, >> >> Yannick -- Kalle Sommer Nielsen
[PHP-DOC] Fwd: [PHP-CVS] cvs: php-src(PHP_5_3) / NEWS /ext/sockets config.w32 php_sockets.h php_sockets_win.c php_sockets_win.h sockets.c /ext/standard streamsfuncs.c streamsfuncs.h /ext/standard/te
-- Forwarded message --
From: Kalle Sommer Nielsen
Date: 2009/1/23
Subject: [PHP-CVS] cvs: php-src(PHP_5_3) / NEWS /ext/sockets
config.w32 php_sockets.h php_sockets_win.c php_sockets_win.h sockets.c
/ext/standard streamsfuncs.c streamsfuncs.h
/ext/standard/tests/streams stream_socket_pair.phpt /win32 sockets.c
sockets.h /win32/build config.w32 config.w32.h.in
To: php-...@lists.php.net
kalle Fri Jan 23 15:49:50 2009 UTC
Added files: (Branch: PHP_5_3)
/php-src/win32 sockets.c sockets.h
Removed files:
/php-src/ext/socketsphp_sockets_win.c php_sockets_win.h
Modified files:
/php-srcNEWS
/php-src/ext/socketsconfig.w32 php_sockets.h sockets.c
/php-src/ext/standard streamsfuncs.c streamsfuncs.h
/php-src/ext/standard/tests/streams stream_socket_pair.phpt
/php-src/win32/buildconfig.w32 config.w32.h.in
Log:
MFH: Windows support for stream_socket_pair(), by moving the
socketpair() implementation from ext/sockets to win32/
Forgot to add the [DOC] tag here, so CC'd to phpdoc@
--
Kalle Sommer Nielsen
http://cvs.php.net/viewvc.cgi/php-src/NEWS?r1=1.2027.2.547.2.965.2.471&r2=1.2027.2.547.2.965.2.472&diff_format=u
Index: php-src/NEWS
diff -u php-src/NEWS:1.2027.2.547.2.965.2.471
php-src/NEWS:1.2027.2.547.2.965.2.472
--- php-src/NEWS:1.2027.2.547.2.965.2.471 Tue Jan 20 20:28:04 2009
+++ php-src/NEWSFri Jan 23 15:49:45 2009
@@ -43,6 +43,7 @@
- Added ICU support to SQLite3 when using the bundled version. (Scott)
- Added pixelation support in imagefilter(). (Takeshi Abe, Kalle)
- Added SplObjectStorage::addAll/removeAll. (Etienne)
+- Added Windows support for stream_socket_pair(). (Kalle)
- Re-added socket_create_pair() for Windows in sockets extension. (Kalle)
http://cvs.php.net/viewvc.cgi/php-src/ext/sockets/config.w32?r1=1.1.8.1&r2=1.1.8.2&diff_format=u
Index: php-src/ext/sockets/config.w32
diff -u php-src/ext/sockets/config.w32:1.1.8.1
php-src/ext/sockets/config.w32:1.1.8.2
--- php-src/ext/sockets/config.w32:1.1.8.1 Mon Jun 23 18:40:29 2008
+++ php-src/ext/sockets/config.w32 Fri Jan 23 15:49:48 2009
@@ -1,4 +1,4 @@
-// $Id: config.w32,v 1.1.8.1 2008/06/23 18:40:29 pajoye Exp $
+// $Id: config.w32,v 1.1.8.2 2009/01/23 15:49:48 kalle Exp $
// vim:ft=javascript
ARG_ENABLE("sockets", "SOCKETS support", "no");
@@ -6,7 +6,7 @@
if (PHP_SOCKETS != "no") {
if (CHECK_LIB("ws2_32.lib", "sockets", PHP_SOCKETS)
&& CHECK_HEADER_ADD_INCLUDE("winsock.h", "CFLAGS_SOCKETS")) {
- EXTENSION('sockets', 'sockets.c php_sockets_win.c');
+ EXTENSION('sockets', 'sockets.c');
AC_DEFINE('HAVE_SOCKETS', 1);
} else {
WARNING("sockets not enabled; libraries and headers not found");
http://cvs.php.net/viewvc.cgi/php-src/ext/sockets/php_sockets.h?r1=1.36.2.1.2.4.2.4&r2=1.36.2.1.2.4.2.5&diff_format=u
Index: php-src/ext/sockets/php_sockets.h
diff -u php-src/ext/sockets/php_sockets.h:1.36.2.1.2.4.2.4
php-src/ext/sockets/php_sockets.h:1.36.2.1.2.4.2.5
--- php-src/ext/sockets/php_sockets.h:1.36.2.1.2.4.2.4 Thu Jan 1 05:24:29 2009
+++ php-src/ext/sockets/php_sockets.h Fri Jan 23 15:49:48 2009
@@ -22,7 +22,7 @@
#ifndef PHP_SOCKETS_H
#define PHP_SOCKETS_H
-/* $Id: php_sockets.h,v 1.36.2.1.2.4.2.4 2009/01/01 05:24:29 kalle Exp $ */
+/* $Id: php_sockets.h,v 1.36.2.1.2.4.2.5 2009/01/23 15:49:48 kalle Exp $ */
#if HAVE_SOCKETS
@@ -43,7 +43,7 @@
PHP_FUNCTION(socket_select);
PHP_FUNCTION(socket_create_listen);
-#if defined(HAVE_SOCKETPAIR) || defined(PHP_WIN32)
+#ifdef PHP_WIN32
PHP_FUNCTION(socket_create_pair);
#endif
PHP_FUNCTION(socket_accept);
@@ -84,6 +84,13 @@
int blocking;
} php_socket;
+#ifdef PHP_WIN32
+struct sockaddr_un {
+ short sun_family;
+ charsun_path[108];
+};
+#endif
+
/* Prototypes */
#ifdef ilia_0 /* not needed, only causes a compiler warning */
static int php_open_listen_sock(php_socket **php_sock, int port, int backlog
TSRMLS_DC);
http://cvs.php.net/viewvc.cgi/php-src/ext/sockets/sockets.c?r1=1.171.2.9.2.14.2.13&r2=1.171.2.9.2.14.2.14&diff_format=u
Index: php-src/ext/sockets/sockets.c
diff -u php-src/ext/sockets/sockets.c:1.171.2.9.2.14.2.13
php-src/ext/sockets/sockets.c:1.171.2.9.2.14.2.14
--- php-src/ext/sockets/sockets.c:1.171.2.9.2.14.2.13 Thu Jan 1 05:24:29 2009
+++ php-src/ext/sockets/sockets.c Fri Jan 23 15:49:48 2009
@@ -19,7 +19,7 @@
+------+
*/
-/* $Id: sockets.c,v 1.171.2.9.2.14.2.13 2009/01/01 05:24:29 kalle Exp $ */
+/* $Id: sockets.c,v 1.171.2.9.2.14.2.14 2009/01/23 15:49:48 kalle Exp $ */
#ifdef HAVE_CONFIG_H
#include "config.h"
@@ -39,8 +
Re: [PHP-DOC] Problem while commiting
2009/1/21 Rafael Jaques : > Well... It's a problem then.. > > Because I'm acessing from docs.php.net > :( > You can generate a copy in around 2 minutes to check for yourself with PhD ;) -- Kalle Sommer Nielsen
Re: [PHP-DOC] Problem while commiting
Hi Rafael 2009/1/21 Rafael Jaques : > Hello there! > > I made some changes on parts of the manual in pt-BR yesterday.. Then I > commited.. > But the change don't took place! > > Is there anything else that I have to do or just wait? The "real" documentation on the www.php.net server / mirrors is updated once a week (Friday or Sunday I think it is), however the special docs mirror: http://docs.php.net/ is updated several times a day (if the translation builds ofcourse) :) > > Thanks! :) > > -- > Um abraço, > ::Rafael Jaques > ::PHP - WebDeveloper > ::Colunista MX Studio > ::Linux User: #422354 > ::http://www.phpit.com.br/ > ::"Se confessarmos os nossos pecados, ele é fiel e justo para nos perdoar os > pecados, e nos purificar de toda a injustiça." (1 João 1:9) > ::Com o Grêmio, onde o Grêmio estiver > ::There is no place like 127.0.0.1 :) > -- Kalle Sommer Nielsen
Re: [PHP-DOC] Fwd: [PHP-WEBMASTER] Feedback PHP.net
Den 13/01/2009 kl. 12.12 skrev "Hannes Magnusson" >: -- Forwarded message -- From: Daniel Cottrell Date: Tue, Jan 13, 2009 at 10:18 Subject: RE: [PHP-WEBMASTER] Feedback PHP.net To: Hannes Magnusson Hi. If you want my advice I'd say Georgia's quite nice. Afair then georgia isnt a monospace font Alternatively I'd use anything with uniform character widths such as Terminal, Courier, Courier New or Lucida Console. Courier new and lucida console is in the fallback list, plus most browsers will fallback to just courier when its a monospace font. I found this list of fonts and availabilities which might be useful for sites which get big hits: http://www.codestyle.org/css/font-family/sampler-WindowsResultsFull.shtml Regards, Dan -Original Message- From: Hannes Magnusson [mailto:hannes.magnus...@gmail.com] Sent: 13 January 2009 07:59 To: Daniel Cottrell; PHP Documentation ML Subject: Re: [PHP-WEBMASTER] Feedback PHP.net Is there any other font you would recommend using? -Hannes On Mon, Jan 12, 2009 at 17:23, Daniel Cottrell wrote: Thanks for getting back to me so quickly. I did a couple of tests and it's the base font Consolas which I don't like. Sorry to be a nag. I personally love consolas, and would like to keep it. Regards, Dan -K
Re: [PHP-DOC] A small suggestion to the CSS
Hi Nilgün
2009/1/8 Nilgün Belma Bugüner :
> 08 Ocak 2009 Perşembe 06:50 sularında, Kalle Sommer Nielsen şunları yazmıştı:
>> Hello
>>
>> 2009/1/7 Keryx Web :
>> > As the title says:
>> >
>> > Line 12-14:
>> >
>> > code, pre, tt {
>> >font-family: Consolas, "Courier New", Courier, monospace;
>> > }
>> >
>> > Added Consolas, which will benefit anyone using Vista, Offive 2007 or have
>> > downloaded the fonts, perhaps through the ppt-viewer.
>>
>> Consolas is also downloadable with Visual Studio[1] and it wouldn't
>> surprise me if newever SP's to VS includes it. But for the font-family
>> I would set Monaco as another fallback:
>>
>> font-family: Consolas, Monaco, "Courier New", Courier, monospace;
>>
>> >
>> > Consolas really is a superb monospace font ad it is becoming ubiquitous.
>> > Courier New is one of the ugliest in existence.
>> >
>> > A nice font for Linux might be DejaVu Sans Mono, but other are perhaps more
>> > qualified to recommend one.
>
> For Linux:
>
> code, pre, tt {
> font-family: Consolas, Monaco, "DejaVu Sans Mono", "Courier New", Courier,
> monospace;
> }
>
> and a suggestion:
>
> tt.parameter {
> font-style: italic;
> }
I was wondering about that one the other day, did someone remove it or
what? Because it used to be like that
>
> Nilgün
>
>
>
>
--
Kalle Sommer Nielsen
Re: [PHP-DOC] A small suggestion to the CSS
Hello
2009/1/7 Keryx Web :
> As the title says:
>
> Line 12-14:
>
> code, pre, tt {
>font-family: Consolas, "Courier New", Courier, monospace;
> }
>
> Added Consolas, which will benefit anyone using Vista, Offive 2007 or have
> downloaded the fonts, perhaps through the ppt-viewer.
Consolas is also downloadable with Visual Studio[1] and it wouldn't
surprise me if newever SP's to VS includes it. But for the font-family
I would set Monaco as another fallback:
font-family: Consolas, Monaco, "Courier New", Courier, monospace;
>
> Consolas really is a superb monospace font ad it is becoming ubiquitous.
> Courier New is one of the ugliest in existence.
>
> A nice font for Linux might be DejaVu Sans Mono, but other are perhaps more
> qualified to recommend one.
>
>
> Lars Gunther
>
[1]
http://www.microsoft.com/Downloads/details.aspx?familyid=22E69AE4-7E40-4807-8A86-B3D36FAB68D3&displaylang=en
--
Kalle Sommer Nielsen
[PHP-DOC] Re: [PHP-CVS] cvs: php-src(PHP_5_3) /ext/standard dns_win32.c
Hi Pierre 2009/1/7 Pierre-Alain Joye : > pajoye Tue Jan 6 23:23:28 2009 UTC > > Modified files: (Branch: PHP_5_3) >/php-src/ext/standard dns_win32.c > Log: > - [DOC] VC6 does not have NAPTR > How do you want this to be written? Like how does it affect the user using official builds (assuming its still gonna be VC6) ect.? -- Kalle Sommer Nielsen
[PHP-DOC] Re: [PHP-CVS] cvs: php-src(PHP_5_3) / NEWS /ext/sockets php_sockets.h sockets.c
Hi 2009/1/1 Pierre Joye : > hi! > > On Thu, Jan 1, 2009 at 7:31 PM, Kalle Sommer Nielsen wrote: > >> Because of stream_socket_pair(), and then it would only work if >> ext/sockets was built too, so unless we move it into the core and >> export it then it should be like that. > > Does it even work? I would not enable again this function without > first having tests for it. There is certainly reasons why it was > disabled (well, ext/socket is a reason already...). Like I just said on IRC, it was Jani that added a magic define back around the time 5.1 was released, which Windows didn't have and it was disabled: http://cvs.php.net/viewvc.cgi/php-src/ext/sockets/sockets.c?r1=1.190&r2=1.191 > > Cheers, > -- > Pierre > > http://blog.thepimp.net | http://www.libgd.org > -- Kalle Sommer Nielsen
[PHP-DOC] Re: [PHP-CVS] cvs: php-src(PHP_5_3) / NEWS /ext/sockets php_sockets.h sockets.c
2009/1/1 Hannes Magnusson : > On Thu, Jan 1, 2009 at 06:24, Kalle Sommer Nielsen wrote: >> kalle Thu Jan 1 05:24:30 2009 UTC >> >> Modified files: (Branch: PHP_5_3) >>/php-srcNEWS >>/php-src/ext/socketsphp_sockets.h sockets.c >> Log: >> MFH: >> [DOC] Renable socket_create_pair() on Windows >> >> # ext/sockets have its own implementation of socketpair(), perhaps we >> should move it >> # to the core. This will make stream_socket_pair() available on Windows >> aswell >> >> http://cvs.php.net/viewvc.cgi/php-src/NEWS?r1=1.2027.2.547.2.965.2.431&r2=1.2027.2.547.2.965.2.432&diff_format=u >> Index: php-src/NEWS >> diff -u php-src/NEWS:1.2027.2.547.2.965.2.431 >> php-src/NEWS:1.2027.2.547.2.965.2.432 >> --- php-src/NEWS:1.2027.2.547.2.965.2.431 Wed Dec 31 15:45:59 2008 >> +++ php-src/NEWSThu Jan 1 05:24:29 2009 >> @@ -11,6 +11,7 @@ >> - Changed opendir(), dir() and scandir() to use default context when no >> context >> argument is passed. (Sara) >> - Changed open_basedir to allow tightening in runtime contexts. (Sara) >> +- Re-enabled socket_create_pair() on Windows (Kalle) >> >> - Added json_last_error() to return any error information from >> json_decode(). >> (Scott) >> http://cvs.php.net/viewvc.cgi/php-src/ext/sockets/php_sockets.h?r1=1.36.2.1.2.4.2.3&r2=1.36.2.1.2.4.2.4&diff_format=u >> Index: php-src/ext/sockets/php_sockets.h >> diff -u php-src/ext/sockets/php_sockets.h:1.36.2.1.2.4.2.3 >> php-src/ext/sockets/php_sockets.h:1.36.2.1.2.4.2.4 >> --- php-src/ext/sockets/php_sockets.h:1.36.2.1.2.4.2.3 Wed Dec 31 11:15:43 >> 2008 >> +++ php-src/ext/sockets/php_sockets.h Thu Jan 1 05:24:29 2009 >> @@ -22,7 +22,7 @@ >> #ifndef PHP_SOCKETS_H >> #define PHP_SOCKETS_H >> >> -/* $Id: php_sockets.h,v 1.36.2.1.2.4.2.3 2008/12/31 11:15:43 sebastian Exp >> $ */ >> +/* $Id: php_sockets.h,v 1.36.2.1.2.4.2.4 2009/01/01 05:24:29 kalle Exp $ */ >> >> #if HAVE_SOCKETS >> >> @@ -43,7 +43,7 @@ >> >> PHP_FUNCTION(socket_select); >> PHP_FUNCTION(socket_create_listen); >> -#ifdef HAVE_SOCKETPAIR >> +#if defined(HAVE_SOCKETPAIR) || defined(PHP_WIN32) > > Why don't you define HAVE_SOCKETPAIR in config.w32 rather then messing > around with these kind of workarounds? > Because of stream_socket_pair(), and then it would only work if ext/sockets was built too, so unless we move it into the core and export it then it should be like that. > -Hannes > -- Kalle Sommer Nielsen
[PHP-DOC] cvs: php-src(PHP_5_3) / NEWS /ext/sockets php_sockets.h sockets.c
kalle Thu Jan 1 05:24:30 2009 UTC
Modified files: (Branch: PHP_5_3)
/php-srcNEWS
/php-src/ext/socketsphp_sockets.h sockets.c
Log:
MFH:
[DOC] Renable socket_create_pair() on Windows
# ext/sockets have its own implementation of socketpair(), perhaps we should
move it
# to the core. This will make stream_socket_pair() available on Windows aswell
http://cvs.php.net/viewvc.cgi/php-src/NEWS?r1=1.2027.2.547.2.965.2.431&r2=1.2027.2.547.2.965.2.432&diff_format=u
Index: php-src/NEWS
diff -u php-src/NEWS:1.2027.2.547.2.965.2.431
php-src/NEWS:1.2027.2.547.2.965.2.432
--- php-src/NEWS:1.2027.2.547.2.965.2.431 Wed Dec 31 15:45:59 2008
+++ php-src/NEWSThu Jan 1 05:24:29 2009
@@ -11,6 +11,7 @@
- Changed opendir(), dir() and scandir() to use default context when no context
argument is passed. (Sara)
- Changed open_basedir to allow tightening in runtime contexts. (Sara)
+- Re-enabled socket_create_pair() on Windows (Kalle)
- Added json_last_error() to return any error information from json_decode().
(Scott)
http://cvs.php.net/viewvc.cgi/php-src/ext/sockets/php_sockets.h?r1=1.36.2.1.2.4.2.3&r2=1.36.2.1.2.4.2.4&diff_format=u
Index: php-src/ext/sockets/php_sockets.h
diff -u php-src/ext/sockets/php_sockets.h:1.36.2.1.2.4.2.3
php-src/ext/sockets/php_sockets.h:1.36.2.1.2.4.2.4
--- php-src/ext/sockets/php_sockets.h:1.36.2.1.2.4.2.3 Wed Dec 31 11:15:43 2008
+++ php-src/ext/sockets/php_sockets.h Thu Jan 1 05:24:29 2009
@@ -22,7 +22,7 @@
#ifndef PHP_SOCKETS_H
#define PHP_SOCKETS_H
-/* $Id: php_sockets.h,v 1.36.2.1.2.4.2.3 2008/12/31 11:15:43 sebastian Exp $ */
+/* $Id: php_sockets.h,v 1.36.2.1.2.4.2.4 2009/01/01 05:24:29 kalle Exp $ */
#if HAVE_SOCKETS
@@ -43,7 +43,7 @@
PHP_FUNCTION(socket_select);
PHP_FUNCTION(socket_create_listen);
-#ifdef HAVE_SOCKETPAIR
+#if defined(HAVE_SOCKETPAIR) || defined(PHP_WIN32)
PHP_FUNCTION(socket_create_pair);
#endif
PHP_FUNCTION(socket_accept);
http://cvs.php.net/viewvc.cgi/php-src/ext/sockets/sockets.c?r1=1.171.2.9.2.14.2.12&r2=1.171.2.9.2.14.2.13&diff_format=u
Index: php-src/ext/sockets/sockets.c
diff -u php-src/ext/sockets/sockets.c:1.171.2.9.2.14.2.12
php-src/ext/sockets/sockets.c:1.171.2.9.2.14.2.13
--- php-src/ext/sockets/sockets.c:1.171.2.9.2.14.2.12 Wed Dec 31 11:15:43 2008
+++ php-src/ext/sockets/sockets.c Thu Jan 1 05:24:29 2009
@@ -19,7 +19,7 @@
+--+
*/
-/* $Id: sockets.c,v 1.171.2.9.2.14.2.12 2008/12/31 11:15:43 sebastian Exp $ */
+/* $Id: sockets.c,v 1.171.2.9.2.14.2.13 2009/01/01 05:24:29 kalle Exp $ */
#ifdef HAVE_CONFIG_H
#include "config.h"
@@ -223,7 +223,7 @@
ZEND_ARG_INFO(0, optval)
ZEND_END_ARG_INFO()
-#ifdef HAVE_SOCKETPAIR
+#if defined(HAVE_SOCKETPAIR) || defined(PHP_WIN32)
ZEND_BEGIN_ARG_INFO_EX(arginfo_socket_create_pair, 0, 0, 4)
ZEND_ARG_INFO(0, domain)
ZEND_ARG_INFO(0, type)
@@ -254,7 +254,7 @@
PHP_FE(socket_select, arginfo_socket_select)
PHP_FE(socket_create, arginfo_socket_create)
PHP_FE(socket_create_listen,arginfo_socket_create_listen)
-#ifdef HAVE_SOCKETPAIR
+#if defined(HAVE_SOCKETPAIR) || defined(PHP_WIN32)
PHP_FE(socket_create_pair, arginfo_socket_create_pair)
#endif
PHP_FE(socket_accept, arginfo_socket_accept)
@@ -1867,7 +1867,7 @@
}
/* }}} */
-#ifdef HAVE_SOCKETPAIR
+#if defined(HAVE_SOCKETPAIR) || defined(PHP_WIN32)
/* {{{ proto bool socket_create_pair(int domain, int type, int protocol, array
&fd) U
Creates a pair of indistinguishable sockets and stores them in fds. */
PHP_FUNCTION(socket_create_pair)
[PHP-DOC] Re: [DOC-CVS] cvs: phd(MAIN) /themes/php chmsource.php
2008/12/26 Kalle Sommer Nielsen : > 2008/12/25 Hannes Magnusson : >> I've never used TortoriseCVS, I think Kalle has. >> Kalle; could you write up a small "howto"? > > I added a list item to the TortoiseCVS howto for quick how to checkout > a specific branch. Whoops forgot the link: http://wiki.php.net/doc/scratchpad/howto#quick_guide_for_improving_the_existing_php_documentation :) -- Kalle Sommer Nielsen
[PHP-DOC] Re: [DOC-CVS] cvs: phd(MAIN) /themes/php chmsource.php
2008/12/25 Hannes Magnusson : > I've never used TortoriseCVS, I think Kalle has. > Kalle; could you write up a small "howto"? I added a list item to the TortoiseCVS howto for quick how to checkout a specific branch. > > -Hannes > regrads -- Kalle Sommer Nielsen
Re: [PHP-DOC] Some grammar corrections to reference/json/constants.xml
Hi Den 24/12/2008 kl. 13.19 skrev "Simion Onea" : Hi! I'd like to commit some corrections to reference/json/constants.xml . Most of them concern the grammar. So, I'd like to ask native English speakers to review my proposals below and to confirm whether they are ok. Regards, Simion. I wrote this and I know my grammar is pretty bad. But thanks for the notice, I will commit tomorrow when I am back home. Merry Christmas, - Kalle
[PHP-DOC] Re: [PHP-CVS] cvs: php-src /ext/standard array.c
2008/12/15 Andrei Zmievski : > Where do I edit the doc stuff again? > Do a checkout of the 'phpdoc' repo, inside the /en/ directory theres the english translation files. /en/language/ -- for language specific features /en/reference/ -- for references for extensions, eg. array, json ect. On the note, I updated the docs for array_unique() a few days ago :) -- Kalle Sommer Nielsen
[PHP-DOC] Re: [PHP-CVS] cvs: php-src /ext/standard array.c
2008/12/12 Andrei Zmievski : > andrei Fri Dec 12 19:19:04 2008 UTC > > Modified files: >/php-src/ext/standard array.c > Log: > Add sort flags parameter to array_unique(). > > > http://cvs.php.net/viewvc.cgi/php-src/ext/standard/array.c?r1=1.467&r2=1.468&diff_format=u Guess it should have [DOC], cc'ed to phpdoc@ =) -- Kalle Sommer Nielsen
Re: [PHP-DOC] [RFC] Updates to translations
2008/12/4 Hannes Magnusson <[EMAIL PROTECTED]>: > On Thu, Dec 4, 2008 at 07:20, Kalle Sommer Nielsen <[EMAIL PROTECTED]> wrote: >> 1) Translation bugs >> Theres many translation bugs reported [1] reported to the bug tracker >> and I don't think that many translators check for bugs in there. So I >> propose we add a link to the docweb site for when you're focusing on a >> specific translation to eg. say: >> >> Project (documentation) bugs >> 53 open bugs >> 4 open translation bugs > > Sounds good. > > When I browse these bugs I tend to prefix the titles with [LANG] to > make it easier for translators to identify bugs in their languages. > > >> Aswell as sending a perhaps monthly email to their mailing list, like >> the bug summary being sent to internals. > > To all ~30 lists? I don't think thats gonna help. > > >> 2) Many of the reported translation bugs as said above are related to >> outdated versions of a file, I think we should put a notice on the >> manual pages if a page is outdated so people don't miss information or >> features that may be useful to them aswel as a link to the english >> version of the page. > > There is already a feature request for that behaviour, but due to our > entity include magic PhD has no chance of figuring out which page is > what, and therefore no chance of comparing file revisions. > > Using a revision attribute (like proposed last year, and again > recently) on the root elements of all chunks would however possibly > make it possible. > PhD could read the revision attribute of all chunks and register the > revision to the xml:id, then when building translations it could > compare those revisions and mark the xml:id/chunk as outdated (i.e. > pregenerate "this page is outdated" into the header or something). How much would be needed for this? I know that revcheck probably will break aswell as all translations. But from your point of view would it be reasonable to make that change? > > -Hannes > -- Kalle Sommer Nielsen
Re: [PHP-DOC] [RFC] Updates to translations
2008/12/4 Philip Olson <[EMAIL PROTECTED]>: >> 1) Translation bugs >> Theres many translation bugs reported [1] reported to the bug tracker >> and I don't think that many translators check for bugs in there. So I >> propose we add a link to the docweb site for when you're focusing on a >> specific translation to eg. say: >> >> Project (documentation) bugs >> 53 open bugs >> 4 open translation bugs >> >> Aswell as sending a perhaps monthly email to their mailing list, like >> the bug summary being sent to internals. > > Unfortunately our bug system is not equipped for this task so the coding and > maintaining of this currently wouldn't be the most fun... but it's a fine > idea and certainly doable. > > A few options that come to mind: > - Add new feature to bugs web, which would involve changes to the db schema > - Parse the subjects on the docweb server (via RSS downloaded from bugs web) > - Add slow queries on bugs web that parses the subject (not a good idea) > - Add new "Type of Bug" for each language (not a good idea) > - ... If the bug system was modified to return a serialized string of the search results aswell as allowing wildcards for bug title it could work pretty smooth. Then we could filter out bugs that matches: [$iso_lang_code] * > > Note: We've been pretty good about maintaining [LANG] in subjects for the > translation bugs. > >> 2) Many of the reported translation bugs as said above are related to >> outdated versions of a file, I think we should put a notice on the >> manual pages if a page is outdated so people don't miss information or >> features that may be useful to them aswel as a link to the english >> version of the page. > > This is a good idea and on the table, specifically the following bug report: > > http://bugs.php.net/44903 I like Hannes' suggestion on this. > > Regards, > Philip > -- Kalle Sommer Nielsen
[PHP-DOC] [RFC] Updates to translations
Right So I had this idea for sometime now, its actually two ideas for translations of the manual, which is as follows: 1) Translation bugs Theres many translation bugs reported [1] reported to the bug tracker and I don't think that many translators check for bugs in there. So I propose we add a link to the docweb site for when you're focusing on a specific translation to eg. say: Project (documentation) bugs 53 open bugs 4 open translation bugs Aswell as sending a perhaps monthly email to their mailing list, like the bug summary being sent to internals. 2) Many of the reported translation bugs as said above are related to outdated versions of a file, I think we should put a notice on the manual pages if a page is outdated so people don't miss information or features that may be useful to them aswel as a link to the english version of the page. What are your thoughts on these? -- Kalle Sommer Nielsen
Re: [PHP-DOC] PHP French Doc: stuff to be commited
2008/11/20 Guillaume Plessis <[EMAIL PROTECTED]>: >> Theres one more french translation bug, thats been standing for a >> small while if you could take care of that one too now: >> http://bugs.php.net/bug.php?id=46045 > > Fixed :) Thanks :) > > --- > Guillaume Plessis > > -- Kalle Sommer Nielsen
Re: [PHP-DOC] PHP French Doc: stuff to be commited
Hi Guillaume 2008/11/20 Guillaume Plessis <[EMAIL PROTECTED]>: > Hi Mark, > > Thanks for this reminder. I just fixed this two bugs in CVS. Theres one more french translation bug, thats been standing for a small while if you could take care of that one too now: http://bugs.php.net/bug.php?id=46045 > > Best regards. > > --- > Guillaume Plessis > > > Le 20 nov. 08 à 07:28, Mark Karpeles a écrit : > >> Got two fixes for the french doc (pretty old fixes too) for stuff that >> didn't make sense: >> >> http://bugs.php.net/46073 >> http://bugs.php.net/46563 >> >> I didn't make patches for those as they are minor changes and I believed >> they would be fixed quickly (as it was done before), however the first >> one is now 2 months old. >> >> So I'm either asking if a french phpdoc maintainer here can review/do >> the changes to the appropriates files (and maybe add "quoted-printable" >> to TRADUCTIONS.txt?), or grant me karma (acct "magicaltux") on phpdoc-fr >> to fix those problems. > > Regrads -- Kalle Sommer Nielsen
Re: [PHP-DOC] Categorizing SPL
2008/11/14 Hannes Magnusson <[EMAIL PROTECTED]>: > Hi all > > What do you all think about categorizing SPL? > > Browsing ~50 classes and exceptions and 7 interfaces is a lot.. > > I'd like to move Iterators into its own , Exceptions (when they > get committed) into one, and datastructures into one. > That leaves SplFileInfo and ArrayObject (maybe others) free standing, > plus another "container" for functions. > > That change will probably kill of translations that have translated > datastructures.xml (as that file will become a container () for > the datastructure classes)... > > -Hannes > Categorizing would be nice indeed, especially now the SPL docs gets some love. But I'm a +1 for doing this. -- Kalle Sommer Nielsen
Re: [PHP-DOC] SplFileInfo docs
2008/11/14 Brett Bieber <[EMAIL PROTECTED]>: > Greetings, > > I'd like to help contribute to the php manual, and I've started some > work documenting various Spl classes – and hope to have a lot more in > the future. For the classes that aren't in phpdoc already I ran the > skeleton doc generator to just get the basic files. I've prepared this > patch for SplFileInfo, to which I've added some examples and > explanations to… but I figured I should share this before I got too > far. > > http://paste2.org/p/101476 > > I hope I'm documenting things correctly, but I'd be happy to make any > adjustments if necessary. > > Thanks for your consideration. > > -- > Brett Bieber > Great job Brett! Thanks for looking out for the SPL docs. -- Kalle Sommer Nielsen
Re: [PHP-DOC] Automatic documentation generation for the Romanian language
2008/11/9 Kalle Sommer Nielsen <[EMAIL PROTECTED]>: > Hi Simion > > 2008/11/9 Simion Onea <[EMAIL PROTECTED]>: >> Hi! >> >> I have noticed that the Romanian version of the documentation on >> http://www.php.net/manual/ro/ and http://docs.php.net/manual/ro/ >> hadn't been updated for a long time. As I remember from previous >> discussions there should be an automatic process building the active >> translations four times a day. Is it working for the Romanian >> translation? Or maybe something's wrong with the translation? Please >> inform me if so. > > The reason why the romanian translation may not be updated can be > because of a build error. Eg. one of the translators havn't checked > the markup before a commit which will cause the translation not to be > updated. > > Documentation are built four times a day on our special doc mirror at: > http://docs.php.net/ > > And the actual documentation is rsynced once a week to the mirrors. > >> >> Best regards, >> Simion Onea. >> Right that was just me with a wrong configure line. I've fixed the build and the Romanian translation should start build shortly again. Regrads -- Kalle Sommer Nielsen
Re: [PHP-DOC] Automatic documentation generation for the Romanian language
2008/11/9 Kalle Sommer Nielsen <[EMAIL PROTECTED]>: > Hi Simion > > 2008/11/9 Simion Onea <[EMAIL PROTECTED]>: >> Hi! >> >> I have noticed that the Romanian version of the documentation on >> http://www.php.net/manual/ro/ and http://docs.php.net/manual/ro/ >> hadn't been updated for a long time. As I remember from previous >> discussions there should be an automatic process building the active >> translations four times a day. Is it working for the Romanian >> translation? Or maybe something's wrong with the translation? Please >> inform me if so. > > The reason why the romanian translation may not be updated can be > because of a build error. Eg. one of the translators havn't checked > the markup before a commit which will cause the translation not to be > updated. > > Documentation are built four times a day on our special doc mirror at: > http://docs.php.net/ > > And the actual documentation is rsynced once a week to the mirrors. > Just did a configure on the phpdoc-ro, and it configures fine, I've cc'ed Hannes as probably have a better explanation on whats going on. Regrads -- Kalle Sommer Nielsen
Re: [PHP-DOC] Automatic documentation generation for the Romanian language
Hi Simion 2008/11/9 Simion Onea <[EMAIL PROTECTED]>: > Hi! > > I have noticed that the Romanian version of the documentation on > http://www.php.net/manual/ro/ and http://docs.php.net/manual/ro/ > hadn't been updated for a long time. As I remember from previous > discussions there should be an automatic process building the active > translations four times a day. Is it working for the Romanian > translation? Or maybe something's wrong with the translation? Please > inform me if so. The reason why the romanian translation may not be updated can be because of a build error. Eg. one of the translators havn't checked the markup before a commit which will cause the translation not to be updated. Documentation are built four times a day on our special doc mirror at: http://docs.php.net/ And the actual documentation is rsynced once a week to the mirrors. > > Best regards, > Simion Onea. > -- Kalle Sommer Nielsen
[PHP-DOC] Re: [PEAR-DOC] [PECL-BUG] Doc #14846 [Opn->Csd]: PHP 5.26 doesn´t include PEAR
2008/11/5 Hannes Magnusson <[EMAIL PROTECTED]>: > On Wed, Nov 5, 2008 at 08:41, <[EMAIL PROTECTED]> wrote: >> Edit report at http://pecl.php.net/bugs/bug.php?id=14846&edit=1 >> >> ID: 14846 >> Updated by: [EMAIL PROTECTED] >> Reported By: fabian dot arocena at gmail dot com >> -Status: Open >> +Status: Closed >> Id: 14846 >> Type: Documentation Problem >> Package: Documentation >> Operating System: Windows XPx64 >> PHP Version: 5.2.6 >> -Assigned To: >> +Assigned To: kalle >> New Comment: >> >> You will need to execute the phar included like: >> C:\PHP\PEAR\>php go-pear.phar >> >> And the PEAR installation will begin, also note that this is the PECL >> bug tracker not, the PEAR bug tracker which can be found at: >> http://pear.php.net/ >> > > This is one of the weirdest bug mails I have seen. > 1) PECL bug reports are usually not sent to any mailinglist > 2) PECL has no relations to PEAR anymore so why this is sent to > pear-doc@ is a total WTF > 3) PECL docs are maintained on php.net > 4) phpdoc guys usually don't have PECL accounts That last one is because I also got a PEAR/PECL account :) > > > Shouldn't that type/category be removed from the PECL bugtracker and a > note added "doc bug reports should be filed at http://bugs.php.net";? > > -Hannes > -- Kalle Sommer Nielsen
Re: [PHP-DOC] ini directives in chm index
2008/10/24 Rudy Nappée <[EMAIL PROTECTED]>: >> On Fri, Oct 24, 2008 at 09:46, Christian Weiske <[EMAIL PROTECTED]> >> wrote: >>> >>> Hello Hannes, >>> >>> >>>> > I'd really like to have all the config ini directives listed >>>> > in the windows chm index - that would make finding them a lot easier. >>>> Are you saying that ini.xml (http://php.net/ini) is not in the PhD >>>> generated CHM? >>> >>> I mean the name of every single directive should be in the /index/ (2nd >>> tab, after the big toc). >>> >> >> Rudy, could you look into it? > > Done. Now, every single directive are in the CHM index (all the > varlistentries which have a xml:id actually). Kudos, <3 Rudy > -- Kalle Sommer Nielsen
Re: [PHP-DOC] Documenting new extension (inotify)
Hi Arnaud 2008/10/24 Arnaud Le Blanc <[EMAIL PROTECTED]>: > Hi, > > I would like to document my extension, I did a checkout of phpdoc, added > required files [1], modified manual.xml.in to add reference.inotify.book in > the filesystem category, and verified the changes by generating a local > documentation. The code looks good, I noticed that your revision numbers are very different, I would suggest starting at 1.0, then they will become 1.1 at checkin and easier to keep up to date for translators, not that it matters that much with the documentation tools but anyway. Else I don't see anything more needed than a review from either Philip or Hannes before checkin. > > Can I commit that or are there anything to do to before ? > > [1] http://arnaud.lb.s3.amazonaws.com/inotify-reference.tar.gz > > Regards, > > Arnaud > > -- Kalle Sommer Nielsen
[PHP-DOC] cvs: php-src(PHP_5_3) / NEWS /ext/standard syslog.c /win32/build registersyslog.php
kalle Wed Oct 15 18:41:58 2008 UTC
Modified files: (Branch: PHP_5_3)
/php-srcNEWS
/php-src/ext/standard syslog.c
/php-src/win32/buildregistersyslog.php
Log:
[DOC] Deprecate define_syslog_variables() in 5.3
http://cvs.php.net/viewvc.cgi/php-src/NEWS?r1=1.2027.2.547.2.965.2.344&r2=1.2027.2.547.2.965.2.345&diff_format=u
Index: php-src/NEWS
diff -u php-src/NEWS:1.2027.2.547.2.965.2.344
php-src/NEWS:1.2027.2.547.2.965.2.345
--- php-src/NEWS:1.2027.2.547.2.965.2.344 Tue Oct 14 19:03:36 2008
+++ php-src/NEWSWed Oct 15 18:41:57 2008
@@ -14,6 +14,8 @@
(Keisial at gmail dot com, Greg)
- Added support for using compressed connections with PDO_mysql. (Johannes)
+- Deprecated define_syslog_variables(). (Kalle)
+
- Fixed bug causing the algorithm parameter of mhash() to be modified. (Scott)
- Fixed bug #46238 (Segmentation fault on static call with empty string
method).
http://cvs.php.net/viewvc.cgi/php-src/ext/standard/syslog.c?r1=1.49.2.3.2.2.2.3&r2=1.49.2.3.2.2.2.4&diff_format=u
Index: php-src/ext/standard/syslog.c
diff -u php-src/ext/standard/syslog.c:1.49.2.3.2.2.2.3
php-src/ext/standard/syslog.c:1.49.2.3.2.2.2.4
--- php-src/ext/standard/syslog.c:1.49.2.3.2.2.2.3 Mon Mar 10 22:12:36 2008
+++ php-src/ext/standard/syslog.c Wed Oct 15 18:41:57 2008
@@ -16,7 +16,7 @@
+--+
*/
-/* $Id: syslog.c,v 1.49.2.3.2.2.2.3 2008/03/10 22:12:36 felipe Exp $ */
+/* $Id: syslog.c,v 1.49.2.3.2.2.2.4 2008/10/15 18:41:57 kalle Exp $ */
#include "php.h"
@@ -207,6 +207,8 @@
return;
}
+ php_error_docref(NULL TSRMLS_CC, E_DEPRECATED, "define_syslog_variables
is deprecated, please use the syslog constants instead");
+
if (!BG(syslog_started)) {
start_syslog(TSRMLS_C);
}
http://cvs.php.net/viewvc.cgi/php-src/win32/build/registersyslog.php?r1=1.2&r2=1.2.6.1&diff_format=u
Index: php-src/win32/build/registersyslog.php
diff -u php-src/win32/build/registersyslog.php:1.2
php-src/win32/build/registersyslog.php:1.2.6.1
--- php-src/win32/build/registersyslog.php:1.2 Thu Aug 5 12:15:17 2004
+++ php-src/win32/build/registersyslog.php Wed Oct 15 18:41:57 2008
@@ -1,45 +1,44 @@
-
+
[PHP-DOC] cvs: php-src / NEWS php.ini-dist php.ini-recommended /ext/standard basic_functions.c basic_functions.h php_ext_syslog.h syslog.c /main main.c /win32/build registersyslog.php
kalle Wed Oct 15 18:41:18 2008 UTC
Modified files:
/php-srcNEWS php.ini-dist php.ini-recommended
/php-src/ext/standard basic_functions.c basic_functions.h
php_ext_syslog.h syslog.c
/php-src/main main.c
/php-src/win32/buildregistersyslog.php
Log:
[DOC] Remove define_syslog_variables() and define_syslog_variables ini option
http://cvs.php.net/viewvc.cgi/php-src/NEWS?r1=1.2167&r2=1.2168&diff_format=u
Index: php-src/NEWS
diff -u php-src/NEWS:1.2167 php-src/NEWS:1.2168
--- php-src/NEWS:1.2167 Mon Sep 1 09:02:22 2008
+++ php-src/NEWSWed Oct 15 18:41:17 2008
@@ -24,6 +24,8 @@
options. (Pierre)
. Changed get_magic_quotes_gpc(), get_magic_quotes_runtime to always return
false and set_magic_quotes_runtime() to raise an E_CORE_ERROR.
+ . "define_syslog_variables" ini option and define_syslog_variables()
+(Kalle)
- Removed support for "continue" and "break" operators with non-constant
operands. (Dmitry)
- Removed Freetype 1.x and GD 1.x support from GD extension. (Pierre)
http://cvs.php.net/viewvc.cgi/php-src/php.ini-dist?r1=1.279&r2=1.280&diff_format=u
Index: php-src/php.ini-dist
diff -u php-src/php.ini-dist:1.279 php-src/php.ini-dist:1.280
--- php-src/php.ini-dist:1.279 Thu Aug 28 05:31:15 2008
+++ php-src/php.ini-distWed Oct 15 18:41:17 2008
@@ -648,12 +648,6 @@
;phar.require_hash = On
;phar.cache_list =
-[Syslog]
-; Whether or not to define the various syslog variables (e.g. $LOG_PID,
-; $LOG_CRON, etc.). Turning it off is a good idea performance-wise. In
-; runtime, you can define these variables by calling define_syslog_variables().
-define_syslog_variables = Off
-
[mail function]
; For Win32 only.
SMTP = localhost
http://cvs.php.net/viewvc.cgi/php-src/php.ini-recommended?r1=1.229&r2=1.230&diff_format=u
Index: php-src/php.ini-recommended
diff -u php-src/php.ini-recommended:1.229 php-src/php.ini-recommended:1.230
--- php-src/php.ini-recommended:1.229 Thu Aug 28 05:31:15 2008
+++ php-src/php.ini-recommended Wed Oct 15 18:41:17 2008
@@ -685,12 +685,6 @@
;phar.require_hash = On
;phar.cache_list =
-[Syslog]
-; Whether or not to define the various syslog variables (e.g. $LOG_PID,
-; $LOG_CRON, etc.). Turning it off is a good idea performance-wise. In
-; runtime, you can define these variables by calling define_syslog_variables().
-define_syslog_variables = Off
-
[mail function]
; For Win32 only.
SMTP = localhost
http://cvs.php.net/viewvc.cgi/php-src/ext/standard/basic_functions.c?r1=1.929&r2=1.930&diff_format=u
Index: php-src/ext/standard/basic_functions.c
diff -u php-src/ext/standard/basic_functions.c:1.929
php-src/ext/standard/basic_functions.c:1.930
--- php-src/ext/standard/basic_functions.c:1.929Sun Aug 31 00:19:20 2008
+++ php-src/ext/standard/basic_functions.c Wed Oct 15 18:41:18 2008
@@ -17,7 +17,7 @@
+--+
*/
-/* $Id: basic_functions.c,v 1.929 2008/08/31 00:19:20 jani Exp $ */
+/* $Id: basic_functions.c,v 1.930 2008/10/15 18:41:18 kalle Exp $ */
#include "php.h"
#include "php_streams.h"
@@ -2886,9 +2886,6 @@
/* }}} */
/* {{{ syslog.c */
#ifdef HAVE_SYSLOG_H
-static
-ZEND_BEGIN_ARG_INFO(arginfo_define_syslog_variables, 0)
-ZEND_END_ARG_INFO()
static
ZEND_BEGIN_ARG_INFO(arginfo_openlog, 0)
@@ -3702,7 +3699,6 @@
PHP_FE(openlog,
arginfo_openlog)
PHP_FE(syslog,
arginfo_syslog)
PHP_FE(closelog,
arginfo_closelog)
- PHP_FE(define_syslog_variables,
arginfo_define_syslog_variables)
#endif
/* functions from lcg.c */
http://cvs.php.net/viewvc.cgi/php-src/ext/standard/basic_functions.h?r1=1.164&r2=1.165&diff_format=u
Index: php-src/ext/standard/basic_functions.h
diff -u php-src/ext/standard/basic_functions.h:1.164
php-src/ext/standard/basic_functions.h:1.165
--- php-src/ext/standard/basic_functions.h:1.164Sat May 24 14:36:16 2008
+++ php-src/ext/standard/basic_functions.h Wed Oct 15 18:41:18 2008
@@ -17,7 +17,7 @@
+--+
*/
-/* $Id: basic_functions.h,v 1.164 2008/05/24 14:36:16 pajoye Exp $ */
+/* $Id: basic_functions.h,v 1.165 2008/10/15 18:41:18 kalle Exp $ */
#ifndef BASIC_FUNCTIONS_H
#define BASIC_FUNCTIONS_H
@@ -200,7 +200,6 @@
zend_bool mt_rand_is_seeded; /* Whether mt_rand() has been seeded */
Re: [PHP-DOC] Minor patch to fix typo
Hi 2008/10/9 Anthony Bedford <[EMAIL PROTECTED]>: > Hi, > > here's a small patch that just fixes a simple typo. > > Thanks, > Tony > > Index: data-seek.xml > === > RCS file: /repository/phpdoc/en/reference/mysqli/mysqli_stmt/data-seek.xml,v > retrieving revision 1.3 > diff -u -r1.3 data-seek.xml > --- data-seek.xml 2 Jan 2008 15:22:51 - 1.3 > +++ data-seek.xml 9 Oct 2008 13:57:32 - > @@ -4,7 +4,7 @@ > > mysqli_stmt::data_seek > mysqli_stmt_data_seek > - Seeks to an arbitray row in statement result set > + Seeks to an arbitrary row in statement result > set > > > > > Fixed in cvs -- Kalle Sommer Nielsen
[PHP-DOC] Re: [PHP-DEV] Re: [PHP-DOC] Re: [PHP-DEV] Re: [PHP-DOC] [DOC] Commit messages dead?
2008/10/2 Hannes Magnusson <[EMAIL PROTECTED]>: > On Thu, Oct 2, 2008 at 03:57, Kalle Sommer Nielsen <[EMAIL PROTECTED]> wrote: >> Hi Hannes >> >> 2008/10/1 Hannes Magnusson <[EMAIL PROTECTED]>: >>> 1) cvs -d:pserver:[EMAIL PROTECTED]/repository co phpdoc >>> 1b) cd phpdoc >>> 2) php configure.php >>> 3) pear channel-discover doc.php.net && pear install doc.php.net/phd-beta >> >> Actually this isn't always as easy on Windows, mainly because the >> go-pear seems to not like Windows at all, I still havn't been able to >> install pear with go-pear. > > Why not? Getting any errors? I thought it was installed by default by > the installer? I do not use the installer, I simply just extra php to the folder I want to use it from. When I use: C:\PHP_5_2\>go-pear It asks me to install a system or local wide install, then it comes up with some configuratives where the path to CLI php.exe always is missing. If I press Enter to continue it just shows the same list of paths, if I type all after have configured path 12 (to CLI php.exe), it will end up with this error: 1-12, 'all' or Enter to continue: all Installation base ($prefix) [Inputfejl: Der er ikke noget filtypenavn i "C:\Users\Kalle".] : (Input error: There is no filetype name in "C:\Users\Kalle") I guess its because the installer doesn't support folders with spaces as the directory is called "C:\Users\Kalle Sommer Nielsen\" So you cannot get further or atleast I can't because my username has spaces. I had to edit the phd.bat manually to make it work, not that it was any major but anyway. > > -Hannes > -- Kalle Sommer Nielsen
[PHP-DOC] Re: [PHP-DEV] Re: [PHP-DOC] Re: [PHP-DEV] Re: [PHP-DOC] [DOC] Commit messages dead?
Hi Hannes 2008/10/1 Hannes Magnusson <[EMAIL PROTECTED]>: > On Wed, Oct 1, 2008 at 20:03, Stanislav Malyshev <[EMAIL PROTECTED]> wrote: >> >> On Wed, Oct 1, 2008 at 19:17, Elizabeth M Smith <[EMAIL PROTECTED]> wrote: >>> >>> tools). Writing in XML is not a natural thing. An online interface >>> where people can edit docs would seriously boost people helping out. >>> Why do you think there are so many user notes in the PHP manual ;) >> >> I think a web-based tool that would allow to generate standard docbook pages >> (at least most primitive ones) and allow to edit certain sections while >> supporting some basic stuff like paragraphs, links, styles (italic, bold) >> etc. would be a HUGE help. I can write docbook and have experience with it >> and I still find it annoying and hard to remember all the details, I can >> only imagine how intimidating it appears to a newbie. > > You were extremely unlucky when you wrote the intl docs, sorry for that! :) > > Now we do however have skeletons for 99% cases, and even a 5minutes > tutorial on howto document exceptions[1]. > NOTE: Most of the 5minutes are spent explaining how to build the docs. > > > Sure, an online editing tool would be great but I don't think that is > a realistic expectation for the time being. I'd rather want PHP5.3 > documented before its release then someone spending all their time on > weird dirty mixed application that will probably not be ready until > PHP6. > > > >>> Why do you think there are so many user notes in the PHP manual ;) > > Speaking of which, we do also need volunteers to review them. > If you login to php.net (via bugsweb or > http://master.php.net/manage/users.php) you'll see three boxes > above(to the right) of all user notes: > 1) Edit (rarely used, mostly just to add tags for syntax > highlighting if people missed them > 2) Reject the note (questions and stuff like that) > 3) Delete (wtf notes, bad code/advise, huge code...) > > _EVERYONE_ with a php.net account can do that and it would be greatly > appreciated if people would remove the horror notes when they > encounter them. It would even be more appreciated if extension > maintainers regularly review the notes attached to their extensions > (currently Derick is prettymuch the online who does that). > >>> However...you will have to wade through the bad docs too. And I have no >>> solution for dealing with the "three million tools" issues. > > I don't understand this argument. > All you need for building and view the documentations are 4things: CVS > client, PHP, text editor and a browser. All of which you have > installed already if you have any interest in PHP at all. > > To build and view the docs follow these 6steps for the first time, > after you follow it once you only have to repeat 3 of the steps > > 1) cvs -d:pserver:[EMAIL PROTECTED]/repository co phpdoc > 1b) cd phpdoc > 2) php configure.php > 3) pear channel-discover doc.php.net && pear install doc.php.net/phd-beta Actually this isn't always as easy on Windows, mainly because the go-pear seems to not like Windows at all, I still havn't been able to install pear with go-pear. To install PhD I had to manually edit the phd.bat for it to work. > 4) phd -d .manual.xml -t chunkedhtml > 5) firefox html/index.html > 6) notepad en/reference/spl/spl/book.xml > > Now repeat step 2, 4, and 5 after each change you make with you text editor. > > If you can install PHP on your operating system then you can build the > docs and contribute. > > -Hannes > > [1] http://doc.php.net/php/dochowto/article.thequicky.exceptions.php > > -- > PHP Internals - PHP Runtime Development Mailing List > To unsubscribe, visit: http://www.php.net/unsub.php > > -- Kalle Sommer Nielsen
Re: [PHP-DOC] Windows doc
Hi 2008/8/24 Kalle Sommer Nielsen <[EMAIL PROTECTED]> > > > 2008/8/24 Hannes Magnusson <[EMAIL PROTECTED]> > > On Sun, Aug 24, 2008 at 05:24, Kalle Sommer Nielsen <[EMAIL PROTECTED]> >> wrote: >> > >> > >> > 2008/8/23 Hannes Magnusson <[EMAIL PROTECTED]> >> >> >> >> On Tue, Jul 29, 2008 at 21:02, Guillaume Rossolini >> >> <[EMAIL PROTECTED]> wrote: >> >> > Hi, >> >> > >> >> > On the Windows Todo Wiki, there is one item that caught my eye [1]. >> So >> >> > I >> >> > set about updating the following page: PECL for Windows users [2]. >> >> > >> >> > Unfortunately, I now have to let that task for the moment and focus >> on >> >> > my >> >> > own work. I am therefore sending you what I have written so far [3] >> so >> >> > that >> >> > you can use it, improve it and maybe convert it to docbook... From >> what >> >> > I >> >> > have seen, this XML format is quite close to DocBook so that >> shouldn't >> >> > be >> >> > too much of a problem. >> >> > >> >> > I hope it helps. >> >> > >> >> > Best regards, >> >> > Guillaume Rossolini >> >> > >> >> > >> >> > [1] http://wiki.php.net/internals/windows/todo >> >> > [2] http://fr3.php.net/manual/en/install.pecl.windows.php >> >> > [2] http://g-rossolini.developpez.com/tmp/php-wiki/ >> >> >> >> Richard, Kalle.. could either of you take this on? >> > >> > >> > Hi Hannes, Guillaume >> > >> > I created this patch which converts the text on that page to docbook: >> > http://phpfi.com/346717 >> > >> > I also added a new entity called url.pecl.submit which links to the >> submit >> > new pecl package form, I couldn't >> > find a page that stated more info about releasing packages so I thought >> that >> > would be the best. >> >> Looks great, thank you! > > > No problem, I will commit it once I've fixed a few missing markups on it. > > >> >> >> -Hannes >> > > > > -- > Kalle Sommer Nielsen > I've just reviewed my patched and committed it to cvs :) -- Kalle Sommer Nielsen
Re: [PHP-DOC] Windows doc
2008/8/24 Hannes Magnusson <[EMAIL PROTECTED]> > On Sun, Aug 24, 2008 at 05:24, Kalle Sommer Nielsen <[EMAIL PROTECTED]> > wrote: > > > > > > 2008/8/23 Hannes Magnusson <[EMAIL PROTECTED]> > >> > >> On Tue, Jul 29, 2008 at 21:02, Guillaume Rossolini > >> <[EMAIL PROTECTED]> wrote: > >> > Hi, > >> > > >> > On the Windows Todo Wiki, there is one item that caught my eye [1]. > So > >> > I > >> > set about updating the following page: PECL for Windows users [2]. > >> > > >> > Unfortunately, I now have to let that task for the moment and focus on > >> > my > >> > own work. I am therefore sending you what I have written so far [3] > so > >> > that > >> > you can use it, improve it and maybe convert it to docbook... From > what > >> > I > >> > have seen, this XML format is quite close to DocBook so that shouldn't > >> > be > >> > too much of a problem. > >> > > >> > I hope it helps. > >> > > >> > Best regards, > >> > Guillaume Rossolini > >> > > >> > > >> > [1] http://wiki.php.net/internals/windows/todo > >> > [2] http://fr3.php.net/manual/en/install.pecl.windows.php > >> > [2] http://g-rossolini.developpez.com/tmp/php-wiki/ > >> > >> Richard, Kalle.. could either of you take this on? > > > > > > Hi Hannes, Guillaume > > > > I created this patch which converts the text on that page to docbook: > > http://phpfi.com/346717 > > > > I also added a new entity called url.pecl.submit which links to the > submit > > new pecl package form, I couldn't > > find a page that stated more info about releasing packages so I thought > that > > would be the best. > > Looks great, thank you! No problem, I will commit it once I've fixed a few missing markups on it. > > > -Hannes > -- Kalle Sommer Nielsen
Re: [PHP-DOC] Windows doc
2008/8/23 Hannes Magnusson <[EMAIL PROTECTED]> > On Tue, Jul 29, 2008 at 21:02, Guillaume Rossolini > <[EMAIL PROTECTED]> wrote: > > Hi, > > > > On the Windows Todo Wiki, there is one item that caught my eye [1]. So I > > set about updating the following page: PECL for Windows users [2]. > > > > Unfortunately, I now have to let that task for the moment and focus on my > > own work. I am therefore sending you what I have written so far [3] so > that > > you can use it, improve it and maybe convert it to docbook... From what > I > > have seen, this XML format is quite close to DocBook so that shouldn't be > > too much of a problem. > > > > I hope it helps. > > > > Best regards, > > Guillaume Rossolini > > > > > > [1] http://wiki.php.net/internals/windows/todo > > [2] http://fr3.php.net/manual/en/install.pecl.windows.php > > [2] http://g-rossolini.developpez.com/tmp/php-wiki/ > > Richard, Kalle.. could either of you take this on? Hi Hannes, Guillaume I created this patch which converts the text on that page to docbook: http://phpfi.com/346717 I also added a new entity called url.pecl.submit which links to the submit new pecl package form, I couldn't find a page that stated more info about releasing packages so I thought that would be the best. > > > -Hannes > Kalle Sommer Nielsen
[PHP-DOC] cvs: php-src(PHP_5_3) / NEWS /ext/standard config.w32
kalle Thu May 22 22:06:15 2008 UTC
Modified files: (Branch: PHP_5_3)
/php-srcNEWS
/php-src/ext/standard config.w32
Log:
[DOC] enable inet_pton() and inet_ntop() on Windows
http://cvs.php.net/viewvc.cgi/php-src/NEWS?r1=1.2027.2.547.2.965.2.182&r2=1.2027.2.547.2.965.2.183&diff_format=u
Index: php-src/NEWS
diff -u php-src/NEWS:1.2027.2.547.2.965.2.182
php-src/NEWS:1.2027.2.547.2.965.2.183
--- php-src/NEWS:1.2027.2.547.2.965.2.182 Sun May 18 22:07:23 2008
+++ php-src/NEWSThu May 22 22:06:14 2008
@@ -107,6 +107,7 @@
behavior. (Stas)
- Added forward_static_call(_array) to complete LSB. (Mike Lively)
- Added native support for asinh(), acosh(), atanh(), log1p() and expm1()
(Kalle)
+- inet_pton() and inet_ntop() is now available on Windows platforms (Kalle)
- Improved PHP runtime speed and memory usage:
. Use IS_CV for direct access to $this variable. (Dmitry)
http://cvs.php.net/viewvc.cgi/php-src/ext/standard/config.w32?r1=1.4.2.2.2.1.2.1&r2=1.4.2.2.2.1.2.2&diff_format=u
Index: php-src/ext/standard/config.w32
diff -u php-src/ext/standard/config.w32:1.4.2.2.2.1.2.1
php-src/ext/standard/config.w32:1.4.2.2.2.1.2.2
--- php-src/ext/standard/config.w32:1.4.2.2.2.1.2.1 Fri Oct 5 15:00:08 2007
+++ php-src/ext/standard/config.w32 Thu May 22 22:06:15 2008
@@ -1,8 +1,11 @@
// vim:ft=javascript
-// $Id: config.w32,v 1.4.2.2.2.1.2.1 2007/10/05 15:00:08 jani Exp $
+// $Id: config.w32,v 1.4.2.2.2.1.2.2 2008/05/22 22:06:15 kalle Exp $
ARG_WITH("config-file-scan-dir", "Dir to check for additional php ini files",
"");
+
AC_DEFINE("PHP_CONFIG_FILE_SCAN_DIR", PHP_CONFIG_FILE_SCAN_DIR);
+AC_DEFINE("HAVE_INET_PTON", 1);
+AC_DEFINE("HAVE_INET_NTOP", 1);
CHECK_HEADER_ADD_INCLUDE("timelib_config.h", "CFLAGS_STANDARD",
"ext/date/lib");
[PHP-DOC] cvs: php-src(PHP_5_3) / NEWS /ext/standard basic_functions.c math.c php_math.h /ext/standard/tests/math acosh_basic.phpt acosh_error.phpt acosh_variation.phpt asinh_basic.phpt asinh_error.
kalle Mon May 5 07:29:42 2008 UTC Modified files: (Branch: PHP_5_3) /php-srcNEWS /php-src/ext/standard basic_functions.c math.c php_math.h /php-src/ext/standard/tests/mathacosh_basic.phpt acosh_error.phpt acosh_variation.phpt asinh_basic.phpt asinh_error.phpt asinh_variation.phpt atanh_basic.phpt atanh_error.phpt atanh_variation.phpt Log: Merge PHP_5_3 - Implemented Windows support for asinh(), acosh(), atanh(), log1p() and expm1() [DOC] Merge_5_3 http://cvs.php.net/viewvc.cgi/php-src/NEWS?r1=1.2027.2.547.2.965.2.173&r2=1.2027.2.547.2.965.2.174&diff_format=u Index: php-src/NEWS diff -u php-src/NEWS:1.2027.2.547.2.965.2.173 php-src/NEWS:1.2027.2.547.2.965.2.174 --- php-src/NEWS:1.2027.2.547.2.965.2.173 Sun May 4 20:52:36 2008 +++ php-src/NEWSMon May 5 07:29:41 2008 @@ -1,4 +1,4 @@ -PHPNEWS +PHP NEWS ||| ?? ??? 20??, PHP 5.3.0 - Removed the experimental RPL (master/slave) functions from mysqli. (Andrey) @@ -106,6 +106,7 @@ - Added request_order INI variable to control specifically $_REQUEST behavior. (Stas) - Added forward_static_call(_array) to complete LSB. (Mike Lively) +- Added Windows support for asinh(), acosh(), atanh(), log1p() and expm1() (Kalle) - Improved PHP runtime speed and memory usage: . Lazy EG(active_symbol_table) initialization. (Dmitry) http://cvs.php.net/viewvc.cgi/php-src/ext/standard/basic_functions.c?r1=1.725.2.31.2.64.2.29&r2=1.725.2.31.2.64.2.30&diff_format=u Index: php-src/ext/standard/basic_functions.c diff -u php-src/ext/standard/basic_functions.c:1.725.2.31.2.64.2.29 php-src/ext/standard/basic_functions.c:1.725.2.31.2.64.2.30 --- php-src/ext/standard/basic_functions.c:1.725.2.31.2.64.2.29 Mon Apr 21 14:32:57 2008 +++ php-src/ext/standard/basic_functions.c Mon May 5 07:29:41 2008 @@ -18,7 +18,7 @@ +--+ */ -/* $Id: basic_functions.c,v 1.725.2.31.2.64.2.29 2008/04/21 14:32:57 iliaa Exp $ */ +/* $Id: basic_functions.c,v 1.725.2.31.2.64.2.30 2008/05/05 07:29:41 kalle Exp $ */ #include "php.h" #include "php_streams.h" @@ -1933,26 +1933,20 @@ ZEND_ARG_INFO(0, number) ZEND_END_ARG_INFO() -#ifdef HAVE_ASINH static ZEND_BEGIN_ARG_INFO(arginfo_asinh, 0) ZEND_ARG_INFO(0, number) ZEND_END_ARG_INFO() -#endif -#ifdef HAVE_ACOSH static ZEND_BEGIN_ARG_INFO(arginfo_acosh, 0) ZEND_ARG_INFO(0, number) ZEND_END_ARG_INFO() -#endif -#ifdef HAVE_ATANH static ZEND_BEGIN_ARG_INFO(arginfo_atanh, 0) ZEND_ARG_INFO(0, number) ZEND_END_ARG_INFO() -#endif static ZEND_BEGIN_ARG_INFO(arginfo_pi, 0) @@ -1984,19 +1978,15 @@ ZEND_ARG_INFO(0, number) ZEND_END_ARG_INFO() -#if !defined(PHP_WIN32) && !defined(NETWARE) static ZEND_BEGIN_ARG_INFO(arginfo_expm1, 0) ZEND_ARG_INFO(0, number) ZEND_END_ARG_INFO() -# ifdef HAVE_LOG1P static ZEND_BEGIN_ARG_INFO(arginfo_log1p, 0) ZEND_ARG_INFO(0, number) ZEND_END_ARG_INFO() -# endif -#endif /* !defined(PHP_WIN32) && !defined(NETWARE) */ static ZEND_BEGIN_ARG_INFO_EX(arginfo_log, 0, 0, 1) @@ -3291,23 +3281,10 @@ PHP_FE(sinh, arginfo_sinh) PHP_FE(cosh, arginfo_cosh) PHP_FE(tanh, arginfo_tanh) - -#ifdef HAVE_ASINH PHP_FE(asinh, arginfo_asinh) -#endif -#ifdef HAVE_ACOSH PHP_FE(acosh, arginfo_acosh) -#endif -#ifdef HAVE_ATANH - PHP_FE(atanh, arginfo_atanh) -#endif -#if !defined(PHP_WIN32) && !defined(NETWARE) PHP_FE(expm1, arginfo_expm1) -# ifdef HAVE_LOG1P PHP_FE(log1p,
[PHP-DOC] cvs: php-src /ext/standard basic_functions.c math.c php_math.h /ext/standard/tests/math acosh_basic.phpt acosh_error.phpt acosh_variation.phpt asinh_basic.phpt asinh_error.phpt asinh_variat
kalle Mon May 5 06:28:03 2008 UTC Modified files: /php-src/ext/standard basic_functions.c math.c php_math.h /php-src/ext/standard/tests/mathacosh_basic.phpt acosh_error.phpt acosh_variation.phpt asinh_basic.phpt asinh_error.phpt asinh_variation.phpt atanh_basic.phpt atanh_error.phpt atanh_variation.phpt Log: Implemented Windows support for asinh(), acosh(), atanh(), log1p() and expm1() + removed Windows check on tests [DOC] Windows support for asinh(), acosh(), atanh(), log1p() and expm1() http://cvs.php.net/viewvc.cgi/php-src/ext/standard/basic_functions.c?r1=1.896&r2=1.897&diff_format=u Index: php-src/ext/standard/basic_functions.c diff -u php-src/ext/standard/basic_functions.c:1.896 php-src/ext/standard/basic_functions.c:1.897 --- php-src/ext/standard/basic_functions.c:1.896Tue Apr 15 09:02:16 2008 +++ php-src/ext/standard/basic_functions.c Mon May 5 06:28:03 2008 @@ -17,7 +17,7 @@ +--+ */ -/* $Id: basic_functions.c,v 1.896 2008/04/15 09:02:16 jani Exp $ */ +/* $Id: basic_functions.c,v 1.897 2008/05/05 06:28:03 kalle Exp $ */ #include "php.h" #include "php_streams.h" @@ -1923,26 +1923,20 @@ ZEND_ARG_INFO(0, number) ZEND_END_ARG_INFO() -#ifdef HAVE_ASINH static ZEND_BEGIN_ARG_INFO(arginfo_asinh, 0) ZEND_ARG_INFO(0, number) ZEND_END_ARG_INFO() -#endif -#ifdef HAVE_ACOSH static ZEND_BEGIN_ARG_INFO(arginfo_acosh, 0) ZEND_ARG_INFO(0, number) ZEND_END_ARG_INFO() -#endif -#ifdef HAVE_ATANH static ZEND_BEGIN_ARG_INFO(arginfo_atanh, 0) ZEND_ARG_INFO(0, number) ZEND_END_ARG_INFO() -#endif static ZEND_BEGIN_ARG_INFO(arginfo_pi, 0) @@ -1974,19 +1968,15 @@ ZEND_ARG_INFO(0, number) ZEND_END_ARG_INFO() -#if !defined(PHP_WIN32) && !defined(NETWARE) static ZEND_BEGIN_ARG_INFO(arginfo_expm1, 0) ZEND_ARG_INFO(0, number) ZEND_END_ARG_INFO() -# ifdef HAVE_LOG1P static ZEND_BEGIN_ARG_INFO(arginfo_log1p, 0) ZEND_ARG_INFO(0, number) ZEND_END_ARG_INFO() -# endif -#endif /* !defined(PHP_WIN32) && !defined(NETWARE) */ static ZEND_BEGIN_ARG_INFO_EX(arginfo_log, 0, 0, 1) @@ -3330,23 +3320,11 @@ PHP_FE(sinh, arginfo_sinh) PHP_FE(cosh, arginfo_cosh) PHP_FE(tanh, arginfo_tanh) - -#ifdef HAVE_ASINH PHP_FE(asinh, arginfo_asinh) -#endif -#ifdef HAVE_ACOSH PHP_FE(acosh, arginfo_acosh) -#endif -#ifdef HAVE_ATANH PHP_FE(atanh, arginfo_atanh) -#endif -#if !defined(PHP_WIN32) && !defined(NETWARE) PHP_FE(expm1, arginfo_expm1) -# ifdef HAVE_LOG1P PHP_FE(log1p, arginfo_log1p) -# endif -#endif - PHP_FE(pi, arginfo_pi) PHP_FE(is_finite, arginfo_is_finite) PHP_FE(is_nan, arginfo_is_nan) http://cvs.php.net/viewvc.cgi/php-src/ext/standard/math.c?r1=1.144&r2=1.145&diff_format=u Index: php-src/ext/standard/math.c diff -u php-src/ext/standard/math.c:1.144 php-src/ext/standard/math.c:1.145 --- php-src/ext/standard/math.c:1.144 Mon Dec 31 07:12:16 2007 +++ php-src/ext/standard/math.c Mon May 5 06:28:03 2008 @@ -19,7 +19,7 @@ +--+ */ -/* $Id: math.c,v 1.144 2007/12/31 07:12:16 sebastian Exp $ */ +/* $Id: math.c,v 1.145 2008/05/05 06:28:03 kalle Exp $ */ #include "php.h" #include "php_ma
Re: [PHP-DOC] [PATCH] Moving the timezone appendix
Hey Hannes Quoting Hannes Magnusson <[EMAIL PROTECTED]>: Hi all I'd like to move the timezone appendix into the datetime extension docs.. Any objections? -Hannes Go for it ;) Kalle
