Re: [PHP-DOC] Notes system (again)
Jared W wrote: [ ... ] Some good points here :) I'm leaning towards weaning the entire PHP documentation process away from the general php bugs system, as the two just don't seem to be the best of friends. This new notes system can be a big part of the new setup. Regards, Philip Have to agree 100% with you Philip the documentation bugs should have its own system, integration with the notes system could work, mark the note as a bug and its sent over to the bug system? Solves 2 problems at once really to be honest I don't like touching the bugs system it seems to be snipers's baby and likely to hurt me if I touch it ;) I think that we need to distinguish between two things : - a documentation bug : IMHO, this one should be handled by bugs.php.net. We could click on a link that automatically will post the bug report with the notes lists email address. - a note that can be added to the documentation (an example to add, a warning that will avoid confusion, etc.) : since there is no bug here, we shouldn't create one. IMHO, this is when the new interface is needed. The note would be marked as to be integrated. The note will then hide from the online documentation and show in the browsable interface. With this interface, someone with good knowledge about the topic and enough karma to phpdoc should be able to browse this kind of notes, commit some changes and then delete the entry (or mark it as integrated so we can have some statistics) In regards to the current notes system from a users point of view it's the best resource out there, people are constantly commenting in irc how much they are being helped with it, the comments are getting better as people seem to know what is accepted and not these days, although some more monitoring could be done better some how as a lot of shitty notes still get through, bugs etc etc just have a look at some obscure functions some time Having never seen the email that is sent to rejected letters I cant comment however there has been a lot of noise on it as of late so I assume its not up to par, so maybe a complete overhaul is in order? http://cvs.php.net/co.php/php-master-web/manage/user-notes.php?login=2r=1.34 see the contents of $reject_text didou
Re: [PHP-DOC] Notes system (again)
Gabor Hojtsy wrote: That was my original idea. Anyone can submit a bug report, fixing it should be left to whoever has CVS access to phpdoc. We can even use for the bug report originator the php-notes lists address, that way the other editors will know that someone did mark a particular entry as such and does not duplicate the effort. Some good points here :) I'm leaning towards weaning the entire PHP documentation process away from the general php bugs system, as the two just don't seem to be the best of friends. This new notes system can be a big part of the new setup. Have to agree 100% with you Philip the documentation bugs should have its own system, integration with the notes system could work, mark the note as a bug and its sent over to the bug system? Solves 2 problems at once really to be honest I don't like touching the bugs system it seems to be snipers's baby and likely to hurt me if I touch it ;) Am I correct if I think that you are suggesting that the doc group should have a bug system on its own? Like PEAR and PECL? Are the PEAR and PECL bug systems a copy of the original bug system? Is it a good idea to have four differently evolving copies of the same bug system? I think the problem here will be for core developpers. Right now, if some user post a bug report about the zend engine (or some part of the core) but the developper think that this a documentation bug, he will just want to change the category to Documentation bug and won't struggle to post a new bug on the new documentation bugs interface and then mark the original post as bogus or won't fix. But again, wa can do some kind of magic here. Having a separate system for the documentation bug will help to categorize those bugs. We can for example create a category for each extension, etc. didou
Re: [PHP-DOC] manual
Hi John! I was just wondering if the manual is available in pdf format? It will be available sometime later. We need some time for the manual builds. Goba
Re: [PHP-DOC] manual
On Fri, 21 Nov 2003, Gabor Hojtsy wrote: Hi John! I was just wondering if the manual is available in pdf format? It will be available sometime later. We need some time for the manual builds. Manualbuilds are running atm... but not the PDFs yet. Derick
[PHP-DOC] cvs: phpdoc /scripts/quickref Makefile makefunclist.php originalafter.js prefixcompress.php processafter.php test.html unusedcompress.php
gobaFri Nov 21 06:07:42 2003 EDT
Added files:
/phpdoc/scripts/quickreftest.html
Modified files:
/phpdoc/scripts/quickrefMakefile makefunclist.php originalafter.js
prefixcompress.php processafter.php
unusedcompress.php
Log:
adding make clean, removing irrelevant make dependencies, adding license headers to
PHP files, and tweaking the js code to be a bit more compact after compression
Index: phpdoc/scripts/quickref/Makefile
diff -u phpdoc/scripts/quickref/Makefile:1.2 phpdoc/scripts/quickref/Makefile:1.3
--- phpdoc/scripts/quickref/Makefile:1.2Thu Nov 20 14:31:24 2003
+++ phpdoc/scripts/quickref/MakefileFri Nov 21 06:07:42 2003
@@ -15,5 +15,8 @@
funclist.txt:
php makefunclist.php
-funclist.zip: Makefile after.js before.js compkey.txt compressed.txt funclist.txt
functions.js index.html makefunclist.php manual_en_contents.txt middle.js
originalafter.js prefixcompress.php prefixcompressed.txt processafter.php readme.txt
unusedcompress.php
- zip funclist.zip Makefile after.js before.js compkey.txt compressed.txt
funclist.txt functions.js index.html makefunclist.php manual_en_contents.txt middle.js
originalafter.js prefixcompress.php prefixcompressed.txt processafter.php readme.txt
unusedcompress.php
+funclist.zip: Makefile after.js before.js compkey.txt compressed.txt funclist.txt
functions.js test.html makefunclist.php middle.js originalafter.js prefixcompress.php
prefixcompressed.txt processafter.php readme.txt unusedcompress.php
+ zip funclist.zip Makefile after.js before.js compkey.txt compressed.txt
funclist.txt functions.js test.html makefunclist.php middle.js originalafter.js
prefixcompress.php prefixcompressed.txt processafter.php readme.txt unusedcompress.php
+
+clean:
+ rm funclist.txt prefixcompressed.txt compressed.txt functions.js after.js
compkey.txt
Index: phpdoc/scripts/quickref/makefunclist.php
diff -u phpdoc/scripts/quickref/makefunclist.php:1.2
phpdoc/scripts/quickref/makefunclist.php:1.3
--- phpdoc/scripts/quickref/makefunclist.php:1.2Thu Nov 20 14:29:49 2003
+++ phpdoc/scripts/quickref/makefunclist.phpFri Nov 21 06:07:42 2003
@@ -1,4 +1,24 @@
?php
+/*
+# +--+
+# | PHP Version 4|
+# +--+
+# | Copyright (c) 1997-2003 The PHP Group|
+# +--+
+# | This source file is subject to version 2.02 of the PHP licence, |
+# | that is bundled with this package in the file LICENCE and is |
+# | avalible through the world wide web at |
+# | http://www.php.net/license/2_02.txt. |
+# | If you did not receive a copy of the PHP license and are unable to |
+# | obtain it through the world wide web, please send a note to |
+# | [EMAIL PROTECTED] so we can mail you a copy immediately. |
+# +--+
+# | Authors:Mitja Slenc [EMAIL PROTECTED] |
+# | Gabor Hojtsy [EMAIL PROTECTED] |
+# +--+
+#
+# $Id: makefunclist.php,v 1.3 2003/11/21 11:07:42 goba Exp $
+*/
$XML_REF_ROOT = ../../en/reference/;
$FUNCTIONS= array();
Index: phpdoc/scripts/quickref/originalafter.js
diff -u phpdoc/scripts/quickref/originalafter.js:1.1
phpdoc/scripts/quickref/originalafter.js:1.2
--- phpdoc/scripts/quickref/originalafter.js:1.1Thu Nov 20 14:03:51 2003
+++ phpdoc/scripts/quickref/originalafter.jsFri Nov 21 06:07:42 2003
@@ -1,279 +1,277 @@
-';
+'; //'
-// CONFIGURATION
+// Initialisation --
-// how many matches to show at most, must be even
+// how many matches to show at most (must be even!)
fh_showmatches=29;
-// END CONFIGURATION
-
var _d=document;
var isnotopera=true;
+fh_matches=new Array();
+fh_inmenu=fh_menupos=0;
+fh_matchesjoined=;
+fh_currenttext=;
+
+var f_p=_d.forms[0].pattern;
+var f_s=_d.forms[0].show;
+
+// Layer setup -
+
if (_d.all (isnotopera=(navigator.userAgent.toLowerCase().indexOf(opera)==-1))) {
- width=width:165px;
+width=width:165px;
} else {
- isnotopera=true;
- width=min-width:155px;
+isnotopera=true;
+width=min-width:155px;
}
-_d.write(div id=funchelper style=\background-color: white; border: 1px solid
black; top: 90px;+width+; padding: 4px; font-size: 9px; display:none;
position:absolute;\/div);
+_d.write(div id=\funchelper\
[PHP-DOC] cvs: phpdoc /scripts/quickref originalafter.js processafter.php
gobaFri Nov 21 06:30:17 2003 EDT
Modified files:
/phpdoc/scripts/quickreforiginalafter.js processafter.php
Log:
putting a small timeout on the onblur hide action, so click actions on links will
still be handled, before the dropdown disappears
Index: phpdoc/scripts/quickref/originalafter.js
diff -u phpdoc/scripts/quickref/originalafter.js:1.2
phpdoc/scripts/quickref/originalafter.js:1.3
--- phpdoc/scripts/quickref/originalafter.js:1.2Fri Nov 21 06:07:42 2003
+++ phpdoc/scripts/quickref/originalafter.jsFri Nov 21 06:30:16 2003
@@ -192,11 +192,8 @@
}
}
-function fh_EBlur()
-{
-f_p.autocomplete=on;
-fh_HideAll();
-}
+function fh_EBlur() { setTimeout(fh_EBlurT(), 200); }
+function fh_EBlurT() { f_p.autocomplete=on; fh_HideAll(); }
function fh_EKeyPress(ev)
{
Index: phpdoc/scripts/quickref/processafter.php
diff -u phpdoc/scripts/quickref/processafter.php:1.2
phpdoc/scripts/quickref/processafter.php:1.3
--- phpdoc/scripts/quickref/processafter.php:1.2Fri Nov 21 06:07:42 2003
+++ phpdoc/scripts/quickref/processafter.phpFri Nov 21 06:30:17 2003
@@ -16,7 +16,7 @@
# | Authors:Mitja Slenc [EMAIL PROTECTED] |
# +--+
#
-# $Id: processafter.php,v 1.2 2003/11/21 11:07:42 goba Exp $
+# $Id: processafter.php,v 1.3 2003/11/21 11:30:17 goba Exp $
*/
$lines=file(originalafter.js);
@@ -24,7 +24,7 @@
$lines[$key]=array_shift(explode(//, trim($line)));
}
-$leave=array(cpd, dcp, for, document, forms, break, if, continue,
var, style, innerHTML, value, getElementById, autocomplete, onblur,
onfocus, onkeyup, onkeydown, onkeypress, display, pattern, show, left,
top, event, evt, ev, which, length, all, navigator, userAgent,
toLowerCase, indexOf, width, else, write, split, join, charAt,
substring, function, return, new, Array, switch, case, push, pop,
default, true, false, offsetLeft, offsetParent, while, null, tagName,
clientLeft, parseInt, border, isNaN, getAttribute, charCode, keyCode,
cc, test, u57385, u57386);
+$leave=array(cpd, dcp, for, document, forms, break, if, continue,
var, style, innerHTML, value, getElementById, autocomplete, onblur,
onfocus, onkeyup, onkeydown, onkeypress, display, pattern, show, left,
top, event, evt, ev, which, length, all, navigator, userAgent,
toLowerCase, indexOf, width, else, write, split, join, charAt,
substring, function, return, new, Array, switch, case, push, pop,
default, true, false, offsetLeft, offsetParent, while, null, tagName,
clientLeft, parseInt, border, isNaN, getAttribute, charCode, keyCode,
cc, setTimeout, fh_EBlurT);
$text=implode( , $lines);
[PHP-DOC] cvs: phpdoc /en/reference/url/functions get-meta-tags.xml http-build-query.xml
progcom Fri Nov 21 07:02:49 2003 EDT Modified files: /phpdoc/en/reference/url/functions get-meta-tags.xml http-build-query.xml Log: fix entity Index: phpdoc/en/reference/url/functions/get-meta-tags.xml diff -u phpdoc/en/reference/url/functions/get-meta-tags.xml:1.4 phpdoc/en/reference/url/functions/get-meta-tags.xml:1.5 --- phpdoc/en/reference/url/functions/get-meta-tags.xml:1.4 Mon Jun 16 16:11:10 2003 +++ phpdoc/en/reference/url/functions/get-meta-tags.xml Fri Nov 21 07:02:48 2003 @@ -1,5 +1,5 @@ ?xml version=1.0 encoding=iso-8859-1? -!-- $Revision: 1.4 $ -- +!-- $Revision: 1.5 $ -- !-- splitted from ./en/functions/strings.xml, last change in rev 1.2 -- refentry id=function.get-meta-tags refnamediv @@ -18,7 +18,7 @@ /methodsynopsis para Opens parameterfilename/parameter and parses it line by line - for lt;meta tags in the file. This can be a local file or + for lt;metagt; tags in the file. This can be a local file or an acronymURL/acronym. The parsing stops at literallt;/headgt;/literal. /para @@ -106,3 +106,4 @@ vim: et tw=78 syn=sgml vi: ts=1 sw=1 -- + Index: phpdoc/en/reference/url/functions/http-build-query.xml diff -u phpdoc/en/reference/url/functions/http-build-query.xml:1.2 phpdoc/en/reference/url/functions/http-build-query.xml:1.3 --- phpdoc/en/reference/url/functions/http-build-query.xml:1.2 Wed Sep 10 12:18:13 2003 +++ phpdoc/en/reference/url/functions/http-build-query.xml Fri Nov 21 07:02:48 2003 @@ -1,5 +1,5 @@ ?xml version=1.0 encoding=iso-8859-1? -!-- $Revision: 1.0 -- +!-- $Revision: 1.3 $ -- refentry id=function.http-build-query refnamediv refnamehttp_build_query/refname
[PHP-DOC] Module für Apache 1.3.7 mit PHP 4.2.2. erzeugen
Hallo, ich habe folgendes Problem: Auf dem Server läuft Apache 1.3.7 mit php 4.2.2 und ich habe Apache 2.0 mit php 4.3.3 Wenn ich mit Make ein Modul erzeuge, funktioniert es nicht, weil meine Version neuer ist. Wie kann ich mit Apache 2.0 und php 4.3.3 ein Modul kompilieren, das auch unter Apache 1.3.7 mit php 4.2.2 funktioniert ? vielen Dank im voraus Bernd Brinkmann
AW: [PHP-DOC] Module für Apache 1.3.7 mit PHP 4.2.2. erzeugen
Hi Mr. Brinkmann, At first speak only english in this mailing list. Second there is a php general mailing list for this question. Best regards, Andreas Otterstein -Ursprüngliche Nachricht- Von: Bernd [mailto:[EMAIL PROTECTED] Gesendet: Freitag, 21. November 2003 12:39 An: [EMAIL PROTECTED] Betreff: [PHP-DOC] Module für Apache 1.3.7 mit PHP 4.2.2. erzeugen Hallo, ich habe folgendes Problem: Auf dem Server läuft Apache 1.3.7 mit php 4.2.2 und ich habe Apache 2.0 mit php 4.3.3 Wenn ich mit Make ein Modul erzeuge, funktioniert es nicht, weil meine Version neuer ist. Wie kann ich mit Apache 2.0 und php 4.3.3 ein Modul kompilieren, das auch unter Apache 1.3.7 mit php 4.2.2 funktioniert ? vielen Dank im voraus Bernd Brinkmann
[PHP-DOC] #26352 [Opn]: strpos() webpage missing an example for the use of offset attriubte
ID: 26352 Updated by: [EMAIL PROTECTED] Reported By: scott at abcoa dot com Status: Open -Bug Type:Website problem +Bug Type:Documentation problem PHP Version: Irrelevant New Comment: This is a docbug. Previous Comments: [2003-11-21 12:11:56] scott at abcoa dot com Boy! Bad example I put down. --snip-- $HTML_End = strpos($res_str,]],$HTML_Start); $XML_End = strpos($res_str,]],$HTML_End); --snip-- Would cause the variable $HTML_End and $XML_End to have the save value. So, an better example would be --snip-- $HTML_End = strpos($res_str,]],$HTML_Start); $XML_End = strpos($res_str,]],($HTML_End+1)); --snip-- But you get the drift about the need for a better example and a better example to clarify the understanding of hte word, 'offset'. [2003-11-21 11:47:24] scott at abcoa dot com Description: Read the strpos() function at http://us3.php.net/manual/en/function.strpos.php and had some trouble with it for a while, it took me a while to better understand it because I never use this function before. There are two problem here. Problem #1: The word 'offset' is a bad choice of word because the definition of it can be anything to what anyone's interpretation of the definition. Like mine, I assumed that offset meant to cancel each other out but when playing around with the script, I then knew that is not what it meant so I had no idea of what it meant. This problem can be overcome by the Problem #2. Problem #2: There is no example script of a strpos() with the use of offset attribute. So, how about updating the webpage to include the example. That would help to reduce the confusion and struggling in the long run. An example of it would be like this but don't take my word for it and you can use a simplier example -- $res_str = blah blah blah blah; $XML_Start = (strpos($res_str,![CDATA[)+9); $HTML_Start = (strpos($res_str,![CDATA[,$XML_Start)+9); $HTML_End = strpos($res_str,]],$HTML_Start); $XML_End = strpos($res_str,]],$HTML_End); --snip-- Thanks!! -- Edit this bug report at http://bugs.php.net/?id=26352edit=1
