Re: [PHP-DOC] Improving User Notes In The Manual -- First Steps

2012-09-10 Thread Daniel Convissor
Hi Sherif: I like the idea of flagging a comment. Voting down can take too long to produce results. Particularly if a lousy note is way down on the bottom (chronologically or vote wise) of a page with a lot of comments, so few people get that far to add their additional down vote. I haven't loo

Re: [PHP-DOC] Re: [PHP-WEBMASTER] User notes

2012-09-02 Thread Daniel Convissor
Hola: On Fri, Aug 31, 2012 at 11:16:39AM +0100, Hannes Magnusson wrote: > The only advantage I see is the 'upvoting' - which shouldn't be all > that hard to implement. +1 (pun intended) --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

Re: [PHP-DOC] ext/mysql updates (~deprecated)

2012-04-22 Thread Daniel Convissor
Hi Hannes: > How about something along this way: http://imagebin.org/209085 The patch is a bunch of great work. My only concern is that floating objects tend to cause problems. Covering up desired content being the biggest of them, especially for users that CTRL++ to zoom in a bunch to make thin

Re: [PHP-DOC] Re: Git migration & revcheck tag

2012-03-26 Thread Daniel Convissor
Hola: On Sat, Mar 03, 2012 at 07:15:45PM -0500, Daniel Convissor wrote: > Hi Folks: > > > > About Git migration : how are we deal with the revcheck tag ? > > > > I don't know much about it, but git supports keywords. You can have an > > $Id$ field that is

Re: [PHP-DOC] Re: Git migration & revcheck tag

2012-03-03 Thread Daniel Convissor
Hi Folks: > > About Git migration : how are we deal with the revcheck tag ? > > I don't know much about it, but git supports keywords. You can have an > $Id$ field that is replaced by the sha1. I think the best we can do is a date keyword tag. They're discussed at http://progit.org/book/ch7-2.h

Re: [PHP-DOC] Done with PhD for now, patch for php.net CSS

2012-02-09 Thread Daniel Convissor
Hi Alexey and Hannes: The CSS changes look good. Can the CSS please be tweaked to put the comma separated items on separate lines? That provides consistency and makes it easier to read. Thanks, --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 int

Re: [PHP-DOC] Extension changelogs

2012-02-01 Thread Daniel Convissor
Hi Folks: I like the idea of the following structure: News: rough, text only list Upgrading: nicely formatted with links. Possibly a tad more detail. Extension Changelog: like upgrading, for this particular ext alone. I'm wondering, would the following be possible for the upgrading/extension cha

Re: [PHP-DOC] About to move from Windows to a Mac.

2011-12-20 Thread Daniel Convissor
On Fri, Dec 02, 2011 at 08:16:29AM -0800, Philip Olson wrote: > > $ pear install doc.php.net/pman > $ pman strlen I recently got around to installing pman and am very happy. Many thanks to Hannes for putting it together. --Dan

Re: [PHP-DOC] Re: [DOC-CVS] svn: /phpdoc/en/trunk/reference/mysqli/mysqli/ real-escape-string.xml

2011-09-22 Thread Daniel Convissor
On Thu, Sep 22, 2011 at 03:42:46PM +0100, Peter Cowburn wrote: > On 22 September 2011 15:39, Hannes Magnusson > wrote: > > That is true with all the mysql[i]_*() functions. > > mysql_ takes the (optional) link identifier as the latter parameter, > > while the mysqli_ ones require it - and it is t

Re: [PHP-DOC] Patch for __destruct page

2011-09-20 Thread Daniel Convissor
Hi Folks: On Mon, Sep 19, 2011 at 03:01:57PM +0200, Nikita Popov wrote: > I think the "when that object is explicitly destroyed" part should be > removed altogether. Objects are destroyed if there are no more > references, not when there are no more references AND you explicitly > destroy them. +

Re: [PHP-DOC] SVN commit error

2011-08-25 Thread Daniel Convissor
Hi Adam: On Thu, Aug 25, 2011 at 02:36:12PM +0200, Adam Major wrote: > > We trying commit files to repository polish manual translation but we > get command error for example: > > Command: Commit > Error: access to > '/repository/!svn/act/031fd653-4034-0846-a4b7-5a0a41fd6d86' forbidden Does fol

Re: [PHP-DOC] expanding the security section in the documentation

2011-04-26 Thread Daniel Convissor
Hi Hannes: On Fri, Apr 22, 2011 at 10:08:20AM +0200, Hannes Magnusson wrote: > There was at some point discussion about merging the > http://phpsec.org/ doc into the manual, but I think that went nowhere > as those peeps didn't want to play ball. As one of the people there, I don't see a problem

Re: [PHP-DOC] Official movement to clean old PHP versions from the documentation

2011-01-27 Thread Daniel Convissor
Hi Folks: A quick reminder that one thing that seemed to be agreed upon during the last discussion is that mentions of older versions in the text (like "available since") should be moved to the change log on the given page. Thanks, --Dan -- T H E A N A L Y S I S A N D S O L U T I O N S

Re: [PHP-DOC] Mixed function syntax style used for mysqli section

2010-11-22 Thread Daniel Convissor
Hi ulf: > is there any style guide or other reason why, for example, the Table of > Contents at http://www.php.net/manual/en/class.mysqli.php mixes function > syntax style ? The mysqli documentation needs to be cleaned up. There was a thread entitled "improving object oriented / procedural

Re: [PHP-DOC] [Patch] - Per Package CLI Options in PhD

2010-08-24 Thread Daniel Convissor
Hi Moacir: On Sat, Aug 21, 2010 at 02:24:40AM -0400, Moacir de Oliveira wrote: > Some options in PhD are specific for rendering the PHP Manual (--notoc, > --lang). These options make no effect if used with the other packages, so > would be interesting extract them from the core of PhD and impleme

Re: [PHP-DOC] Initial documentation draft for PECL/mysqlnd_qc

2010-07-10 Thread Daniel Convissor
Hi Ulf: On Thu, Jul 08, 2010 at 04:45:38PM +0200, Ulf Wendel wrote: > > I've drafted some initial documentation for PECL/mysqlnd_qc. Excellent, thanks! I just took a very quick look and have some coding standards feedback: * Nesting is one space per level, you're generally using two, but some

Re: [PHP-DOC] Re: Error when compiling PHP manual.

2010-05-27 Thread Daniel Convissor
Hi Richard: On Tue, May 25, 2010 at 12:08:17PM +0100, Richard Quadling wrote: > > In the event that the xpointer evaluation doesn't return anything, the > "XPointer evaluation failed" warning is always thrown and the > xfallback kicks in. If there's nothing for a query to find, why is the query

Re: [PHP-DOC] proposal: documenting trunk

2010-05-19 Thread Daniel Convissor
Hi Philip: > Nobody knows if/when PHP 5.4 or PHP 6 will exist, yet commits are happening > in php-src/ trunk. We need to figure out how to document this stuff in such a > way that we: ... > Here's a proposal that may work, please critique: Looks good. Thanks for thinking about this stuff. --D

Re: [PHP-DOC] improving object oriented / procedural combinations

2010-05-14 Thread Daniel Convissor
Folks: On Sun, Apr 25, 2010 at 10:10:28PM -0400, Daniel Convissor wrote: > STATIC > -- > DocBook: > >foo > > public > static > int > bar > > ... snip ... > OBJECT > -- > DocBook: > >foo >

Re: [PHP-DOC] expanded versus chunked manual pages

2010-05-14 Thread Daniel Convissor
Heya: On Wed, May 12, 2010 at 01:49:25PM -0700, Philip Olson wrote: > > There's been talk of allowing expanded pages within the documentation. > For example, this page: > - http://php.net/manual/en/reference.pcre.pattern.syntax.php Oh, wow! Hadn't seen the new layout. Sorry to get off on a t

[PHP-DOC] Re: [DOC-CVS] svn: /phpdoc/en/trunk/reference/datetime/datetime/ construct.xml

2010-05-08 Thread Daniel Convissor
Hi Folks: On Wed, May 05, 2010 at 10:40:17AM +0200, Hannes Magnusson wrote: > > Wouldn't it be better to have just quick'n'dirty examples on these > pages and then create a "best practice" or "advanced examples" > chapter? I was wondering this. My thought was it seemed clearer to have one exam

[PHP-DOC] Re: [DOC-CVS] svn: /phpdoc/en/trunk/reference/datetime/datetime/ construct.xml

2010-05-08 Thread Daniel Convissor
Hi Derick: On Wed, May 05, 2010 at 10:45:32AM +0100, Derick Rethans wrote: > On Wed, 5 May 2010, Daniel Convissor wrote: > > > Modified: phpdoc/en/trunk/reference/datetime/datetime/construct.xml > > === >

[PHP-DOC] Re: [DOC-CVS] svn: /phpdoc/en/trunk/reference/datetime/datetime/ modify.xml

2010-05-08 Thread Daniel Convissor
Hi Derick: On Wed, May 05, 2010 at 10:47:32AM +0100, Derick Rethans wrote: > On Wed, 5 May 2010, Daniel Convissor wrote: > > > Revision: http://svn.php.net/viewvc?view=revision&revision=299008 > > > > Log: > > Add example of how adding months can be problematic

Re: [PHP-DOC] Re: [DOC-CVS] svn: /phpdoc/en/trunk/reference/datetime/datetime/ add.xml modify.xml setdate.xml setisodate.xml settime.xml settimestamp.xml settimezone.xml sub.xml

2010-05-08 Thread Daniel Convissor
Hi Folks: On Wed, May 05, 2010 at 10:31:15AM +0200, Hannes Magnusson wrote: > > None of our docs mention this (see intl and mysqli for example). > > It is clearly expected behavior and is documented in the oo chapters. Just because a function takes an object as a parameter does not mean the fu

[PHP-DOC] Re: [DOC-CVS] svn: /phpdoc/en/trunk/reference/datetime/datetime/ createfromformat.xml gettimestamp.xml settimestamp.xml

2010-05-05 Thread Daniel Convissor
Hi Peter: On Wed, May 05, 2010 at 09:02:57AM +0100, Peter Cowburn wrote: > On 5 May 2010 01:51, Daniel Convissor wrote: > > danielc ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ?Wed, 05 May 2010 00:51:18 + > > > > Revision: http://svn.php.net/viewvc?view=revision&revision=29

Re: [PHP-DOC] Re: [DOC-CVS] svn: /phpdoc/en/trunk/reference/datetime/datetime/ add.xml modify.xml setdate.xml setisodate.xml settime.xml settimestamp.xml settimezone.xml sub.xml

2010-05-04 Thread Daniel Convissor
Hi Derick: On Tue, May 04, 2010 at 06:12:25PM +0100, Derick Rethans wrote: > > There is still a difference in userland between: > > function tralala ( $foo ); > > and > > function tralala ( &$foo ); > > with $foo being fed an object. Objects are passed by a handle, so it > looks like a refer

[PHP-DOC] Re: [DOC-CVS] svn: /phpdoc/en/trunk/reference/datetime/datetime/ add.xml modify.xml setdate.xml setisodate.xml settime.xml settimestamp.xml settimezone.xml sub.xml

2010-05-04 Thread Daniel Convissor
Hi Derick: On Tue, May 04, 2010 at 03:50:36PM +0100, Derick Rethans wrote: > On Tue, 4 May 2010, Daniel Convissor wrote: > > > Revision: http://svn.php.net/viewvc?view=revision&revision=298971 > > > > Log: > > Procedural methods operate on object by referen

Re: [PHP-DOC] listing inherited properties

2010-04-29 Thread Daniel Convissor
Hi Hannes: On Thu, Apr 29, 2010 at 10:49:34AM +0200, Hannes Magnusson wrote: > > I didn't even realize that built-in classes had private > properties/methods. Seems utterly useless to tell the end-user that. You're right. They shouldn't be in the docs in the first place, even in their original

Re: [PHP-DOC] needless 's

2010-04-26 Thread Daniel Convissor
Hola: On Mon, Apr 26, 2010 at 10:15:10AM +0200, Hannes Magnusson wrote: > > Derick gave you web/php karma just now.. I committed the example spacing changes. Thanks, --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 prog

Re: [PHP-DOC] improving object oriented / procedural combinations

2010-04-26 Thread Daniel Convissor
Hi Hannes: > Bug report it, I'll see if I can change it this weekend. http://bugs.php.net/bug.php?id=51667 Thanks so much, --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.AnalysisA

Re: [PHP-DOC] improving object oriented / procedural combinations

2010-04-26 Thread Daniel Convissor
Hi Hannes: On Mon, Apr 26, 2010 at 10:08:44AM +0200, Hannes Magnusson wrote: > > I think a new entity saying "Both examples above will output" is needed.. > Looks great though. It already exists and is what I used in that example. > Is the html already generated by PhD like this? No. > And

Re: [PHP-DOC] improving object oriented / procedural combinations

2010-04-25 Thread Daniel Convissor
Hi Hannes: On Sun, Apr 25, 2010 at 03:44:32PM +0200, Hannes Magnusson wrote: > On Sun, Apr 25, 2010 at 15:39, Daniel Convissor > wrote: > > > What seems clearest to me is to have Example #1 be drop dead simple use > > case and be composed of an OOP programlisting, a procedur

Re: [PHP-DOC] needless 's

2010-04-25 Thread Daniel Convissor
Hi Hannes: On Thu, Apr 22, 2010 at 08:46:21PM -0400, Daniel Convissor wrote: > On Thu, Apr 22, 2010 at 09:53:11PM +0200, Hannes Magnusson wrote: > > > > I have no idea why those s are there, and they do annoy me too :] > > Hannes, to pull this off, can you please grant m

Re: [PHP-DOC] improving object oriented / procedural combinations

2010-04-25 Thread Daniel Convissor
Hi Hannes: On Sun, Apr 25, 2010 at 10:46:47AM +0200, Hannes Magnusson wrote: > On Fri, Apr 23, 2010 at 21:17, Daniel Convissor > wrote: > > If you're talking about the same , I agree. ?If you are talking > > about the same , I disagree because it will lengthen and

Re: [PHP-DOC] improving object oriented / procedural combinations

2010-04-23 Thread Daniel Convissor
Hi Hannes: Thanks for your thorough consideration. Here are some more thoughts... On Fri, Apr 23, 2010 at 05:42:14PM +0200, Hannes Magnusson wrote: > > Wouldn't &style.oop.[[static.]method|ctor|dtor|property]; make more > sense? Just to make it really clear what it is. If there were cases whe

Re: [PHP-DOC] needless 's

2010-04-23 Thread Daniel Convissor
Hi Hannes: On Fri, Apr 23, 2010 at 05:27:52PM +0200, Hannes Magnusson wrote: > > My only concern is massive WS changes.. But there isn't really any way > around that :] > Please make sure the commit message is clear enough so translator know > exactly what has changed and don't have to review eve

Re: [PHP-DOC] Should examples be CLI or WEB output?

2010-04-23 Thread Daniel Convissor
Hi Hannes: On Fri, Apr 23, 2010 at 05:31:28PM +0200, Hannes Magnusson wrote: > On Fri, Apr 23, 2010 at 14:15, Daniel Convissor > > > > Several of the DateTime examples are overblown in general. ?The one > > DateTime::add() has six sample statements in it. ?For such a >

Re: [PHP-DOC] Should examples be CLI or WEB output?

2010-04-23 Thread Daniel Convissor
Hi Richard: On Fri, Apr 23, 2010 at 10:45:07AM +0100, Richard Quadling wrote: > > Just looking through some of the DateTime examples and noticed that > they are using as a line terminator. I agree, CLI output is preferable. Several of the DateTime examples are overblown in general. The one D

Re: [PHP-DOC] needless 's

2010-04-22 Thread Daniel Convissor
On Thu, Apr 22, 2010 at 09:53:11PM +0200, Hannes Magnusson wrote: > > I have no idea why those s are there, and they do annoy me too :] How about I make the changes I suggsted to all the files in the datetime/datetime directory. Then folks can take a look and see what they think about the resu

Re: [PHP-DOC] Commit document

2010-04-22 Thread Daniel Convissor
Heya: On Thu, Apr 22, 2010 at 09:50:50PM +0200, Hannes Magnusson wrote: > On Thu, Apr 22, 2010 at 20:57, Daniel Convissor > wrote: > > Welcome Jesus: > > > > On Thu, Apr 22, 2010 at 08:01:01PM +0200, Jess Cova wrote: > >> Hi good afternoon i wonder how can i co

Re: [PHP-DOC] Commit document

2010-04-22 Thread Daniel Convissor
Welcome Jesus: On Thu, Apr 22, 2010 at 08:01:01PM +0200, Jess Cova wrote: > Hi good afternoon i wonder how can i commit a document i do not know.. i > have a SVN account but i'm new In short, do a "svn checkout" of the source code. Then make your changes, do an "svn diff" to make sure the chang

Re: [PHP-DOC] needless 's

2010-04-22 Thread Daniel Convissor
Hello Again: On Tue, Apr 20, 2010 at 11:38:29AM -0400, Daniel Convissor wrote: > > * variablelist in the parameters section > * informaltable in the changelog section > * example in the examples section > * simplelist in the seealso section > > The Element Reference in &qu

Re: [PHP-DOC] improving object oriented / procedural combinations

2010-04-22 Thread Daniel Convissor
Hi Peter: On Thu, Apr 22, 2010 at 09:00:50AM +0100, Peter Cowburn wrote: > > I don't think having a new example block just for output makes much > semantic sense. How about having multiple elements > (one per paradigm) and one with the &examples.outputs* > entities? I just tested it and it wor

[PHP-DOC] improving object oriented / procedural combinations

2010-04-21 Thread Daniel Convissor
Hi Folks: In trying to add the procedural style interface to the DateTime docs I went searching for how we currently present stuff that has both object oriented and procedural interfaces. It turns out there is no consistent way of going about it, plus there are some other oddities that would b

Re: [PHP-DOC] skeletons in doc-base RFC are out of date

2010-04-21 Thread Daniel Convissor
Hi Philip: On Wed, Apr 21, 2010 at 12:20:48PM -0700, Philip Olson wrote: > > On Apr 20, 2010, at 8:42 AM, Daniel Convissor wrote: > > > The files in phpdoc/doc-base/trunk/RFC/skeletons use the old > > documentation structure. Should these files be updated, or should t

Re: [PHP-DOC] problem with phd output dir for php format

2010-04-21 Thread Daniel Convissor
Hi Philip: On Wed, Apr 21, 2010 at 12:05:03PM -0700, Philip Olson wrote: > > Typically people use a symlink, see: > http://wiki.php.net/doc/phd/view Oy. Yet another documentation how to page. :) I was looking at similar, but slightly different instructions on http://doc.php.net/php/dochowt

[PHP-DOC] problem with phd output dir for php format

2010-04-21 Thread Daniel Convissor
Hi Folks: I just set up a mirror of the PHP website on my Linux box for documentation testing purposes. The website has the manual output in "/manual/en". But PhD puts the output in "/php-web". This happens because Package/PHP/Web.php defines the format name as "PHP-Web" and then uses that

[PHP-DOC] skeletons in doc-base RFC are out of date

2010-04-20 Thread Daniel Convissor
Hi Folks: The files in phpdoc/doc-base/trunk/RFC/skeletons use the old documentation structure. Should these files be updated, or should the be eliminated? Thanks, --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 progr

[PHP-DOC] needless 's

2010-04-20 Thread Daniel Convissor
Hi Folks: I'm looking at the skeletons at http://doc.php.net/php/dochowto/chapter-skeletons.php and am seeing some elements are being wrapped in 's even though they don't need to be: * variablelist in the parameters section * informaltable in the changelog section * example in the examples sect

[PHP-DOC] online editor color issues

2010-04-19 Thread Daniel Convissor
Hi Folks: I'm using the online doc editor for the first time. Very impressive! I ran into a couple issues with colors. In the commit dialog, the log message entry field has a white background, but the foreground/text color was not set. My browser preferences use white text. So the commit me

Re: [PHP-DOC] PhDOE : Online editor - I need your opinion (and your help) !

2010-04-19 Thread Daniel Convissor
Hi Yannick: On Tue, Apr 13, 2010 at 06:46:13PM +0200, yannick wrote: > *Completely useless, therefore, essential ! Include a chat into the > editor* -10. --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

Re: [PHP-DOC] user notes proposal

2010-04-08 Thread Daniel Convissor
Hi Pedram: On Thu, Apr 08, 2010 at 03:23:50PM +0430, pedram salehpoor wrote: > > Regarding using tags, I'd like the way books put some special notes on the > side of page. So I think if we use following tags it would be good: Interesting. But what do we do with the 23,377 existing notes? > Re

Re: [PHP-DOC] finding a style guide

2010-04-06 Thread Daniel Convissor
Hi Philip: > - http://fedoraproject.org/wiki/DocsProject/StyleGuide Wow. That's an excellent read. Thanks. Though the a/an URL section needs cleaning up, so I emailed them about it. > - http://oreilly.com/oreilly/author/stylesheet.html While I don't like the way this one is written, it d

Re: [PHP-DOC] random observations on online PHP manual

2010-03-23 Thread Daniel Convissor
Hi: On Mon, Mar 22, 2010 at 01:17:25PM -0400, Robert P. J. Day wrote: > > centos/RHEL, PHP 5.3-related packages are extremely easy to come by. > it may be that you have to look for the generally-approved repos (in > this case, http://rpms.famillecollet.com/enterprise/5/, among others), > but they

Re: [PHP-DOC] the online documentation editor

2010-03-15 Thread Daniel Convissor
On Mon, Mar 15, 2010 at 01:23:27PM +0800, KSChan wrote: > > Shall we still bet on WYSIWYG editor? I didn't spend much time on this > feature :P I fear such will lead to the XML becoming an enormous mess of misused and inappropriate elements. --Dan -- T H E A N A L Y S I S A N D S O L U

Re: [PHP-DOC] the online documentation editor

2010-03-13 Thread Daniel Convissor
On Sat, Mar 13, 2010 at 06:13:14PM -0800, Rasmus Lerdorf wrote: > > Our certs are fine and > can be trusted and provides the encryption we need. If you don't want > to trust other cacert-based ones don't install the root and just tell > your browser to accept the php.net ones permanently. Which

Re: [PHP-DOC] the online documentation editor

2010-03-13 Thread Daniel Convissor
On Sat, Mar 13, 2010 at 04:28:21PM +0100, Hannes Magnusson wrote: > > Just install the root cert from http://www.cacert.org Someone I trust regarding security issues said the following recently about doing such: I note that as of 2009-01-05 evidently CAcert began requiring not just "can you get

Re: [PHP-DOC] Making PHP 5 a first class citizen

2010-01-24 Thread Daniel Convissor
Hi Hannes: On Sun, Jan 24, 2010 at 12:25:53PM +0100, Hannes Magnusson wrote: > > If we can create a standardized changelog for all features, I think > that would solve everything. Yes. Excellent. Thanks, --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

Re: [PHP-DOC] Making PHP 5 a first class citizen

2010-01-23 Thread Daniel Convissor
Hi Folks: > we'd no longer have phrases like: > > - As of PHP 5 ... There was a discussion about this a month or so ago. (I can't find it now.) Personally, I like the history being there. It is interesting to see how things evolve. Having this data there does no harm to anyone. Let alone

Re: [PHP-DOC] Re: [xml] xmllint: validating a document that doesn't specify a DTD

2009-11-24 Thread Daniel Convissor
On Tue, Nov 24, 2009 at 04:20:52PM -0500, Rob Richards wrote: > I just cant find any decent way to do this. Using that flag just causes > xmllint to build then doc and then do a validation against the DTD. Hmm... Is it possible to determine the various DTD files required, cat them together in

Re: [PHP-DOC] Building docs w/ PhD

2009-10-30 Thread Daniel Convissor
Hi Hannes: On Fri, Oct 30, 2009 at 05:46:45PM +, Hannes Magnusson wrote: > 2009/10/30 Daniel Convissor : > > On Tue, Oct 27, 2009 at 10:17:01PM -0400, Moacir de Oliveira wrote: > >> > >> > PHP Fatal error: ?Uncaught exception 'Exception' with mess

Re: [PHP-DOC] Building docs w/ PhD

2009-10-30 Thread Daniel Convissor
Hi crhsitian: > Try installing it and running the pear-installed phd. Then you need the > include path. Doh! Thanks for catching that. I added a comment explaining why fopen() is used. And a @ to suppress potential warnings. --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

Re: [PHP-DOC] Building docs w/ PhD

2009-10-30 Thread Daniel Convissor
Hi Christian: > > > > fopen(/usr/local/lib/php//HaruDoc.php): failed to open > > > > stream: No such file or directory > > I just committed a change to avoid the warning by using is_readable() > > instead of fopen() here. > I reverted your commit, because it broke everything. Ouch. What bro

Re: [PHP-DOC] PhD Release - Milestones

2009-10-30 Thread Daniel Convissor
On Fri, Oct 30, 2009 at 01:18:33PM +, Hannes Magnusson wrote: > Also, I'm not entirely sure anymore if rendering all the supported > formats (when none are specified) is A Good Thing. > Maybe we shouldn't default on any format and make the user explicitly > mention which formats to render. Ve

Re: [PHP-DOC] Building docs w/ PhD

2009-10-30 Thread Daniel Convissor
On Tue, Oct 27, 2009 at 10:17:01PM -0400, Moacir de Oliveira wrote: > Fala Thiago, > > 2009/10/27 Thiago H. Pojda > > > $ phd -d doc-base/.manual.xml --package PHP ... > > fopen(/usr/local/lib/php//HaruDoc.php): failed to open stream: No such > > file or directory I just committed a change

Re: [PHP-DOC] Access Violation

2009-10-16 Thread Daniel Convissor
Hi: You want to subscribe to PHP's "General user list." See http://us2.php.net/mailing-lists.php for more information. Good luck, --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.A

Re: [PHP-DOC] PHP4 in the installation documentation

2009-10-03 Thread Daniel Convissor
Hi Hannes: > Like with the PHP4 OO docs, they should either be removed or at most > refactored into an appendix. Yeah, the appendix is a good place for that. > Even > the functions versioninfo, there is no reason to mention PHP4 anymore. I disagree. It can be helpful to know when a function w

Re: [PHP-DOC] oop5 basic rewrite informal RFC

2009-09-09 Thread Daniel Convissor
Hi Greg: > Copy-on-write still happens, the example you gave doesn't change a > variable, only a property. Yeah. > A better comparison would be between arrays and objects, as this > demonstrates that they behave differently in PHP 5, but were the same in > PHP 4 > > $a = array('m' => 'foo');

Re: [PHP-DOC] oop5 basic rewrite informal RFC

2009-09-09 Thread Daniel Convissor
Hi Brandon: > http://blog.libssh2.org/index.php?/archives/51-Youre-being-lied-to..html Yeah, that's a good article. I've seen it on other occasions. But she's kind of "lying" too... m = $b->m\n"; // Copy-on-write is not what happens when dealing only with objects: class not_copy_on_write {

Re: [PHP-DOC] oop5 basic rewrite informal RFC

2009-09-09 Thread Daniel Convissor
On Tue, Sep 08, 2009 at 07:56:43PM -0700, Lars Torben Wilson wrote: > > Personally I like "property" I agree. That's what I, and most people, call them. It'd be good to have that be the term throughout the manual. Thanks, --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

Re: [PHP-DOC] oop5 basic rewrite informal RFC

2009-09-08 Thread Daniel Convissor
Hi Brandon: Nice stuff. Two qualms with the following: PHP 5's object model also significantly changes the way objects are passed, passing a pointer to the object rather than copying the object. First, "passed" is the followed immediately by "passing." Pick a different word for o

Re: [PHP-DOC] oop5 basic rewrite informal RFC

2009-09-08 Thread Daniel Convissor
Hi Lars: > In an earlier draft I had words to this effect, but it just got to be > unwieldy, since it felt like if I explained that some people call class > variables "properties", I should explain that others call them "members" > or "member variables" or "attributes" or what-have-you. I'll

[PHP-DOC] Re: svn says phpdoc files are binary

2009-08-29 Thread Daniel Convissor
Hola Gwynne: > Looks like ViewVC thinks the file is binary as long as svn:mime-type is > set, even though it's set to text/plain. Try propdel-ing the > svn:mime-type entirely. Doesn't seem to make a difference. --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

[PHP-DOC] svn says phpdoc files are binary

2009-08-28 Thread Daniel Convissor
Hey Gwynne and the Doc Team: I just went to look at the annotated view of a file in SVN and found it can't to do so, saying "Unable to calculate annotation data on binary file contents." Binary? Huh? These are all text files. Is this because of the conversion from CVS? Is a property misset

[PHP-DOC] "calendar and events" -> "date and time"

2009-08-27 Thread Daniel Convissor
Hi Folks Someone looking through the manual for ways to handle dates or times, will be befutled to find that the Table of Contents page, http://us2.php.net/manual/en/, has no mention of the word "date" or "time." I'm assuming that's because the relatively new DateTime class was put under the

Re: [PHP-DOC] Preferred doc checkouts

2009-07-18 Thread Daniel Convissor
On Sun, Jul 19, 2009 at 02:48:51AM +0200, Hannes Magnusson wrote: > > Note: As these modules use svn:externals you _cannot_ commit to more > then one module at a time. Are you sure? I was working on a project where we had an external reference. You were able to commit to the main repository an

Re: [PHP-DOC] What can go in a package's "Introduction"?

2009-07-05 Thread Daniel Convissor
Hi Eddie: > 3) "Why use Reflection?" - an analysis of realistic cases where > Reflection is useful, perhaps linking ot external resources for > further research (wikipedia, probably) > > And basically, I've not seen (not that it doesn't exist), an example > of #3 in use in the PHP manual any wher

Re: [PHP-DOC] CVS problem

2009-04-27 Thread Daniel Convissor
Hi Kristina: On Mon, Apr 27, 2009 at 10:46:34AM -0400, Kristina Chodorow wrote: > > cvs [server aborted]: "commit" requires write access to the repository I bet you initially checked out the sources using the public, read-only, credentials. That authentication information is then used when you

Re: [PHP-DOC] Wishing to know the documentation team and participate.

2009-04-15 Thread Daniel Convissor
Welcome Manuel: On Wed, Apr 15, 2009 at 02:24:52AM -0500, Manuel Aude wrote: > > I was hoping I could get some simple guidelines to get started into it. http://wiki.php.net/doc has much of what you'll need. The "how to" at http://doc.php.net/php/dochowto/ is a bit outdated. A new "how to" is

Re: [PHP-DOC] user comments of the future

2009-04-13 Thread Daniel Convissor
Folks: It would be neat if people on the doc team could subscribe to a page so the person could be notified when new comments are made. This will be helpful for someone who has edited the page and/or culled the existing user notes so the person can edit/curate comments as they come in. --Dan

Re: [PHP-DOC] user comments of the future

2009-03-28 Thread Daniel Convissor
On Sat, Mar 28, 2009 at 09:26:46AM -0700, Philip Olson wrote: > On 28 Mar 2009, at 07:41, Daniel Convissor wrote: > >> Even if it was working, the whole thing requires JavaScript, limiting >> availability of the comments in some situations. > > I don't buy this argume

Re: [PHP-DOC] user comments of the future

2009-03-28 Thread 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 init

Re: [PHP-DOC] Starting a "howtohelp"/"contributing" sets of book

2009-03-13 Thread Daniel Convissor
On Fri, Mar 13, 2009 at 07:12:10PM +0100, Hannes Magnusson wrote: > > I'd like to start a "how to help"/"contributing" set of books covering > how to particpate in the various php projects (pecl, qa, phpdoc, > src...). ... > move phpdoc/howto into phpdoc/en/contribute/phpdoc That sounds like a ve

Re: [PHP-DOC] xml-check wtf

2009-03-13 Thread Daniel Convissor
On Fri, Mar 13, 2009 at 09:09:03AM -0700, Philip Olson wrote: > The only maintained method for validating XML is configure.php Ah, so I'll update the doc team docs to remove references to xml-check.php. --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

Re: [PHP-DOC] SOAP documentation updated to new markup

2009-02-16 Thread Daniel Convissor
Hi Michael: On Mon, Feb 16, 2009 at 11:54:47AM +, Michael Maclean wrote: > I've been working on updating the docs for ext/soap to the new markup Thanks. > It's pretty much a port of the existing documentation though with > phrases like "you will need..." changed for the 3rd person, etc. If

Re: [PHP-DOC] Some grammar corrections to reference/json/constants.xml

2008-12-24 Thread Daniel Convissor
On Wed, Dec 24, 2008 at 09:01:24PM +0200, Simion Onea wrote: > > No problem at all, Kalle. I committed the changes myself earlier. Please correct the "as of"/"since" per http://wiki.php.net/doc/articles/nomenclature. Also please wrap the text around 70 cols (that's around where we suggest doing

Re: [PHP-DOC] Some grammar corrections to reference/json/constants.xml

2008-12-24 Thread Daniel Convissor
Hi Philip: > The HOWTO lives in phpdoc/howto/ ... Interesting. Then what's in http://cvs.php.net/viewvc.cgi/docstuff/ ? Thanks, --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.Ana

Re: [PHP-DOC] Some grammar corrections to reference/json/constants.xml

2008-12-24 Thread Daniel Convissor
On Wed, Dec 24, 2008 at 04:34:04PM +0100, Hannes Magnusson wrote: > > http://wiki.php.net/doc/articles/nomenclature ? Yes! Thanks. I just added it to the README file so I and others can find it in the future. I also just tried to commit similar changes to http://doc.php.net/php/dochowto/chapt

Re: [PHP-DOC] Some grammar corrections to reference/json/constants.xml

2008-12-24 Thread Daniel Convissor
Hi Simion: On Wed, Dec 24, 2008 at 02:19:28PM +0200, Simion Onea wrote: > > --- constants.xml 19 Dec 2008 07:52:28 - 1.5 ... > - The following constants indicates an error type returned > - by json_last_error and are all available > - as of PHP 5.3.0. > + The following constant

Re: [PHP-DOC] XHTML (was: A blank page shows)

2008-12-23 Thread Daniel Convissor
Hi Hannes: On Tue, Dec 23, 2008 at 11:10:28PM +0100, Hannes Magnusson wrote: > > PhD does try to be as xhtml compliant as it can. There are several > cases which we simply cannot fix, but others that simply have been an > oversight. Ja. Cool. > It is a tough problem. Be anal about validation

[PHP-DOC] XHTML (was: A blank page shows)

2008-12-23 Thread Daniel Convissor
On Mon, Dec 22, 2008 at 02:57:46PM +0800, Gang Chen wrote: > > $header = << "http://www.w3.org/TR/html4/loose.dtd";> Has there been discussion of making this, and all (relevant) PhD output, XHTML compliant? I can go through the code and make it so (or at least closer). > > > $t

Re: [PHP-DOC] How to start?

2008-12-10 Thread Daniel Convissor
Hi Sebastian: > like you can read in the subject - i would like to start in the Doc section > (English -> German). Welcome! > Is there anyone who can give me information and tipps fort he first stepps. http://www.php.net/ Click the "Documentation" link at the top. Notice that there's a bulle

Re: [PHP-DOC] Revision tracking in phpdoc and peardoc

2008-11-22 Thread Daniel Convissor
On Wed, Nov 12, 2008 at 11:01:38AM +, Richard Quadling wrote: > > Is there a way to create a template for commits? > > [ ] Typo/WS > [ ] Minor change > [ ] Major change/rewrite > [ ] Example added > Bug # > Comments:: I like this idea. There's no way I know of to have a template that SVN p

Re: [PHP-DOC] Re: [DOC-BUGS] #46251 [Opn->WFx]: Array type documentation, error in example

2008-11-05 Thread Daniel Convissor
On Tue, Nov 04, 2008 at 11:40:34PM +0100, Hannes Magnusson wrote: > > I think the "Wont fix" was due to the fact you can do $foo[] = > "value"; without initializing $foo = array() without getting any > notices or difference then initializing it beforehand. > > Although we shouldn't be advocating

Re: [PHP-DOC] [HEADSUP] New phpweb branch

2008-09-01 Thread Daniel Convissor
Hi Hannes: > How does http://pb11.php.net/design/styles.html look to you? http://www.analysisandsolutions.com/php/web.feedback.styles.1.png I'm using Firefox 3.0.1. Oh, one thing that may have been throwing you off before about the size of the headers is I had the "minimum font size" set. I t

Re: [PHP-DOC] [HEADSUP] New phpweb branch

2008-09-01 Thread Daniel Convissor
Hi Hannes: > I had a very hard time understanding what you meant with "hard coding" > as it definitely wasn't *hardcoded*. Using % and ems is the way to go > exactly for this reason; give the user the choice of resizing. Yup. Email conversations are rife with misunderstandings. :) > >> If we d

Re: [PHP-DOC] [HEADSUP] New phpweb branch

2008-09-01 Thread Daniel Convissor
Hi Ross: > Sorry if I came across rudely there, that wasn't my intention. No, didn't take it that way at all. Similarly, sorry if I came across harshly. > As far as I see it the best practice is to not set a font-size for the > body tag and to allow to use whatever it wants. Then apply > p

Re: [PHP-DOC] [HEADSUP] New phpweb branch

2008-09-01 Thread Daniel Convissor
Hi Ross: On Sat, Aug 30, 2008 at 11:57:55AM +0100, Ross Masters wrote: > On Sat, Aug 30, 2008 at 05:04 AM, Daniel Convissor wrote: > >>> The font size is nowhere hardcoded. It uses em and %. >> >> That's hard coding. We shouldn't be setting it at all.

Re: [PHP-DOC] [HEADSUP] New phpweb branch

2008-08-29 Thread Daniel Convissor
Hi Hannes: On Thu, Aug 28, 2008 at 08:40:24AM +0200, Hannes Magnusson wrote: > > The is rendered from the DocBook markup. In context then this is > the second heading of that section, which is why its rendered as Ah. Thanks. > The font size is nowhere hardcoded. It uses em and %. That's ha

Re: [PHP-DOC] [HEADSUP] New phpweb branch

2008-08-27 Thread Daniel Convissor
Hi Guys: > http://pb11.php.net/sitemap.php Overall, looks good. Thanks. Two minor suggestions, please. There's a lot of white space in the area between the top of the page and the header at the top of the main content section. Hmm, minor nit, that really should be an but styled to be the

  1   2   >