Re: [PHP-DOC] reference: where to obtain files. was Re: [PHP-DOC]cvs: phpdoc /en/faq obtaining.xml

2003-01-25 Thread Gabor Hojtsy
I see three options:

  a) Update the faq by hand with links used in reference.xml
  b) Create an autogenerated list here
  c) Remove most of the faq and simply state that the info
 has been moved as each extension now lists how to obtain..

I like the idea of (c).  I also like the idea of (b) in the
future but this doesn't really belong in the faq but rather
when we finally autogenerate a list of all configure options,
it'd go near there. 

c) + autogenerate the list in the future to an appendix. This 
information should really be in the reference sections, and not in a 
faq. This information is core.

On a related note.  Windows dll information should be listed 
within every reference.xml too as currently only some list 
this information.  Like:

  a) If the dll is bundled
  b) If it's compiled in the binary (no dll needed)
  c) If the dll can be found offsite (mcrypt is an example)

Windows dll information should also be moved out of the install (or 
configure?) section where it is currently (a list of Windows dlls), and 
moved to the reference sections with all information available ;)

Goba


--
PHP Documentation Mailing List (http://www.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php



Re: [PHP-DOC] manual page uncluttering

2003-01-25 Thread Gabor Hojtsy
1. Put language listing into a dropdown, not a link list.


+1 for me, and while we are at this: why dont change the names

> of the various languages to those in that language (i.e.: 'italian'
> would become 'italiano' and 'german' would become 'deutsch')?

what do you think?


Well, that name list is something we use at every place. Now that 
language name list is used to:

 - print out available languages at docs.php and download-docs.php
 - print out language switch information on all manual pages
 - print out mirror language information on mirrors.php
 - it is also remotely included in the mirror administration page

So the phpweb/include/languages.inc is a central place where all 
possible manual languages are defined and used in all places possible. 
Therefore I think this modification is not right now.

By the way I am thinking about some methods to enable php.net to be 
translated, but I am actually unable to come up with a really good 
working solution in my mind... Maybe it needs some time to get some form...

2. Remove link underline from left sidebar links.


+1 but with a caveat: add some way to be sure that the reader know

> that those are actual links (dont give it for granted). I would
> prefer having an 'hover' rule in the style sheet, so when the
> mouse is hover them they change color or something. I think you
> got what I mean.

OK for me.

Goba


--
PHP Documentation Mailing List (http://www.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php




Re: [PHP-DOC] once again: install part

2003-01-25 Thread Gabor Hojtsy
Three main parts divided by OS.
- MacOS
- Linux
  Apache
  Apache2
  thttp   
- Unices like HP/UX, BSD'S
- Windows
   Apache
   Apache2
   IIS/PWS
   Netscape
   OmniHTTP
   Sambar
   Xitami 
   
Each main OS-chapter contains:
Installation of PHP
Supported Webservers and install instructions

Cool +1.


I think this would be more user friendly and better to maintain.
Some Informations from the install files are hard to find, spread over
different places, sometimes even double.


Yep. The current structure is very bad. We need more deep sections (not 
sections emulated in titles). The current state is quite bad. The files 
also need a polish, rename, etc. It will be a hard time to move user 
notes with the pages, so this also need to be taken with care. Maybe 
integrate all possible user notes and drop the others...

I don't care about if you get boring about this old story. Asap I
search the archives for the often discussed but never descided topic.
The results will go in RFC, also the upcoming answers in this thread.


Wow ;) Some progress! :))

Goba


--
PHP Documentation Mailing List (http://www.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php




Re: [PHP-DOC] cvs: phpdoc /en/reference/wddx/functionswddx-add-vars.xml

2003-01-25 Thread Gabor Hojtsy
-  wddx_add_vars
+  boolwddx_add_vars


Shouldn't make test check for this type of error?  Like,
a missing return type!


As long as the DTD does not require it, it is not a problem for make 
test... And the DocBook DTD has no requirement to have a type there...
http://www.docbook.org/tdg/en/html/methodsynopsis.html

We can of course modify that to require the type, but that needs a 
customization of the DTD [which I proposed for the sections already at 
dtds/phpbook.dtd]. The customization to require a type would do no harm, 
as it is even backward compatible to DocBook...

Goba


--
PHP Documentation Mailing List (http://www.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php



Re: [PHP-DOC] manual page uncluttering

2003-01-25 Thread Simone Cortesi
At 12.40 25/01/03 +0100, Gabor Hojtsy wrote:

>>>1. Put language listing into a dropdown, not a link list.
>>+1 for me, and while we are at this: why dont change the names
>> of the various languages to those in that language (i.e.: 'italian'
>> would become 'italiano' and 'german' would become 'deutsch')?
>>what do you think?
>
>Well, that name list is something we use at every place. Now that language name list 
>is used to:
>
> - print out available languages at docs.php and download-docs.php
> - print out language switch information on all manual pages
> - print out mirror language information on mirrors.php
> - it is also remotely included in the mirror administration page

Ok, my fault. I underestimated these problems. And this would be too much work for too 
little improvement.

-- 
Simone Cortesi
http://cortesi.com/
blog  *  photos  *  PHP in italian
did I help you? http://cortesi.com/wishlist.php



-- 
PHP Documentation Mailing List (http://www.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php




[PHP-DOC] Notes Status, 8630 total

2003-01-25 Thread phpdoc
Following are the top 20 pages of the manual, sorted by the number
of user notes contributed. These sections could use a polish, those
notes represent 11.4% of the 8630 total user notes.

Notes  |  Page
---+-
   84  | http://php.net/manual/en/function.preg-replace.php
   64  | http://php.net/manual/en/language.oop.php
   61  | http://php.net/manual/en/features.file-upload.php
   58  | http://php.net/manual/en/function.header.php
   55  | http://php.net/manual/en/ref.imap.php
   54  | http://php.net/manual/en/ref.pdf.php
   53  | http://php.net/manual/en/function.include.php
   52  | http://php.net/manual/en/function.fopen.php
   49  | http://php.net/manual/en/function.mail.php
   48  | http://php.net/manual/en/function.exec.php
   47  | http://php.net/manual/en/ref.mail.php
   42  | http://php.net/manual/en/function.date.php
   41  | http://php.net/manual/en/function.eval.php
   41  | http://php.net/manual/en/ref.domxml.php
   41  | http://php.net/manual/en/ref.exec.php
   39  | http://php.net/manual/en/ref.oci8.php
   39  | http://php.net/manual/en/function.mssql-connect.php
   38  | http://php.net/manual/en/function.md5.php
   38  | http://php.net/manual/en/function.imagettftext.php
   38  | http://php.net/manual/en/function.mktime.php


-- 
PHP Documentation Mailing List (http://www.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php




[PHP-DOC] cvs: phpdoc /en/reference/mysql/functions mysql-get-proto-info.xml

2003-01-25 Thread Derick Rethans
derick  Sat Jan 25 12:16:34 2003 EDT

  Modified files:  
/phpdoc/en/reference/mysql/functionsmysql-get-proto-info.xml 
  Log:
  - I am not picky :)
  
Index: phpdoc/en/reference/mysql/functions/mysql-get-proto-info.xml
diff -u phpdoc/en/reference/mysql/functions/mysql-get-proto-info.xml:1.5 
phpdoc/en/reference/mysql/functions/mysql-get-proto-info.xml:1.6
--- phpdoc/en/reference/mysql/functions/mysql-get-proto-info.xml:1.5Sun Dec  1 
21:37:29 2002
+++ phpdoc/en/reference/mysql/functions/mysql-get-proto-info.xmlSat Jan 25 
+12:16:34 2003
@@ -1,5 +1,5 @@
 
-
+
 
   

@@ -35,7 +35,7 @@
  
  
 
  
 



-- 
PHP Documentation Mailing List (http://www.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php




Re: [PHP-DOC] documenting new function

2003-01-25 Thread Maxim Maletsky

On Sat, 25 Jan 2003 07:06:13 +0900 Moriyoshi Koizumi <[EMAIL PROTECTED]> wrote:

> On Fri, Jan 24, 2003 at 10:27:00PM +0100, Maxim Maletsky wrote:
> > I would need to add a few changes to the NEWS file. I remember trying it a
> > while ago, but at the moment `@-' prefixing of CVS commit message did
> > not work. Would anyone offer to add a few entries to the NEWS file for
> > me? The two entries are as follows:
> > 
> > - Added OCIPasswordChange() which allows renewing the expired Oracle users.
> > (Maxim)
> > - Fixed bug #16798 (Compile failure with LOB support for Oracle versions 
> > under 8.1). (Maxim)
> 
> Why don't you add the entries to NEWS by hand?

It seems that I don't have the karma for it, Moriyoshi. 


---
Maxim Maletsky
[EMAIL PROTECTED]



-- 
PHP Documentation Mailing List (http://www.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php




[PHP-DOC] #21877 [NEW]: fread may read less bytes than requested even if EOF is not reached ...

2003-01-25 Thread hholzgra
From: [EMAIL PROTECTED]
Operating system: *
PHP version:  4CVS-2003-01-25 (stable)
PHP Bug Type: Documentation problem
Bug description:  fread may read less bytes than requested even if  EOF is not reached 
...

i asume this not only true for C fread() but also for PHP ?

if so -> should be documented as such ...
-- 
Edit bug report at http://bugs.php.net/?id=21877&edit=1
-- 
Try a CVS snapshot: http://bugs.php.net/fix.php?id=21877&r=trysnapshot
Fixed in CVS:   http://bugs.php.net/fix.php?id=21877&r=fixedcvs
Fixed in release:   http://bugs.php.net/fix.php?id=21877&r=alreadyfixed
Need backtrace: http://bugs.php.net/fix.php?id=21877&r=needtrace
Try newer version:  http://bugs.php.net/fix.php?id=21877&r=oldversion
Not developer issue:http://bugs.php.net/fix.php?id=21877&r=support
Expected behavior:  http://bugs.php.net/fix.php?id=21877&r=notwrong
Not enough info:http://bugs.php.net/fix.php?id=21877&r=notenoughinfo
Submitted twice:http://bugs.php.net/fix.php?id=21877&r=submittedtwice
register_globals:   http://bugs.php.net/fix.php?id=21877&r=globals
PHP 3 support discontinued: http://bugs.php.net/fix.php?id=21877&r=php3
Daylight Savings:   http://bugs.php.net/fix.php?id=21877&r=dst
IIS Stability:  http://bugs.php.net/fix.php?id=21877&r=isapi
Install GNU Sed:http://bugs.php.net/fix.php?id=21877&r=gnused


-- 
PHP Documentation Mailing List (http://www.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php




[PHP-DOC] #21877 [Opn]: fread may read less bytes than requested even if EOF is not reached ...

2003-01-25 Thread hholzgra
 ID:   21877
 Updated by:   [EMAIL PROTECTED]
 Reported By:  [EMAIL PROTECTED]
 Status:   Open
 Bug Type: Documentation problem
 Operating System: *
 PHP Version:  4CVS-2003-01-25 (stable)
 Assigned To:  hholzgra
 New Comment:

ok, it only true for non-blocking php streams ...

but still this should be mentioned on the fread() page


Previous Comments:


[2003-01-25 12:56:17] [EMAIL PROTECTED]

i asume this not only true for C fread() but also for PHP ?

if so -> should be documented as such ...




-- 
Edit this bug report at http://bugs.php.net/?id=21877&edit=1


-- 
PHP Documentation Mailing List (http://www.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php




[PHP-DOC] #19862 [Opn->Bgs]: online documentation is bugged...

2003-01-25 Thread hholzgra
 ID:   19862
 Updated by:   [EMAIL PROTECTED]
 Reported By:  [EMAIL PROTECTED]
-Status:   Open
+Status:   Bogus
 Bug Type: Documentation problem
 Operating System: any
 PHP Version:  4.2.3
 New Comment:

see http://php.net/xml_parse :

[...]
data

Chunk of data to parse. A document may be parsed piece-wise by
calling xml_parse() several times with new data, as long as the
is_final parameter is set and TRUE when the last data is parsed. 

is_final (optional)

If set and TRUE, data is the last piece of data sent in this parse.

[...]

it is totaly valid to split data chunks wherever you want, 
you may even feed xml_parse() character by character.

the manual example will not only work for local files but also for e.g.
http: remote streams where you can't get the input size in advance, and
for any kind of non-blocking stream where fread() may return less than
the requested number of bytes even if EOF is not yet reached
 


Previous Comments:


[2002-10-11 08:54:43] [EMAIL PROTECTED]

Expat is a SAX parser. It can handle blocks (or streams as they're
preferred to be called these days) and doesn't care whether a document
is valid or even when it is a document.

The point of using a stream-based parser, is that you're not required
to open up files entirely (in fact - your input can be a socket).

Allthough the manual example dies, as soon as a parser error is
detected, one can actually retrieve the linenumber of the error, store
everything from that line on in a buffer, process the lines before that
and retrieve the next block, appending it to the buffer.

So I agree, the example is not very useful in some cases, but not for
your reasoning.



[2002-10-11 08:01:36] [EMAIL PROTECTED]

URL: http://www.php.net/manual/en/ref.xml.php

how the files are opened is not the correct way or the input/output may
get mixed up or truncated on same cases...

I mean ... you should not open files in blocks, but whole file ... I
copy pasted your example to my code and when some block (of those 4096
bytes) end and next blocks start value somehow happened to be in the
middle XML value, then the value was truncated or cutted half in
output. anyway the input (cycle) should be in one piece (whole file at
once) or row by row, not by constant number of bytes.



Example 1. (your version)

$file = "data.xml";
$depth = array();

function startElement($parser, $name, $attrs) {
global $depth;
for ($i = 0; $i < $depth[$parser]; $i++) {
print "  ";
}
print "$name\n";
$depth[$parser]++;
}

function endElement($parser, $name) {
global $depth;
$depth[$parser]--;
}

$xml_parser = xml_parser_create();
xml_set_element_handler($xml_parser, "startElement", "endElement");
if (!($fp = fopen($file, "r"))) {
die("could not open XML input");
}

while ($data = fread($fp, 4096)) {
if (!xml_parse($xml_parser, $data, feof($fp))) {
die(sprintf("XML error: %s at line %d",
xml_error_string(xml_get_error_code($xml_parser)),
xml_get_current_line_number($xml_parser)));
}
}
xml_parser_free($xml_parser);




BUT THIS SHOULD BE (my version):

Example 1.

$file = "data.xml";
$depth = array();

function startElement($parser, $name, $attrs) {
global $depth;
for ($i = 0; $i < $depth[$parser]; $i++) {
print "  ";
}
print "$name\n";
$depth[$parser]++;
}

function endElement($parser, $name) {
global $depth;
$depth[$parser]--;
}

$xml_parser = xml_parser_create();
xml_set_element_handler($xml_parser, "startElement", "endElement");
if (!($fp = fopen($file, "r"))) {
die("could not open XML input");
}

$data = fread($fp, filesize($file)));
if (!xml_parse($xml_parser, $data, feof($fp)))
{
die(sprintf("XML error: %s at line %d",
xml_error_string(xml_get_error_code($xml_parser)),
xml_get_current_line_number($xml_parser)));
}

xml_parser_free($xml_parser);





-- 
Edit this bug report at http://bugs.php.net/?id=19862&edit=1


-- 
PHP Documentation Mailing List (http://www.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php




[PHP-DOC] #20522 [Opn->Csd]: german+spanish translation: $HTTP_ENCODING instead of $HTTP_ACCEPT_ENCODING

2003-01-25 Thread hholzgra
 ID:   20522
 Updated by:   [EMAIL PROTECTED]
 Reported By:  [EMAIL PROTECTED]
-Status:   Open
+Status:   Closed
 Bug Type: Documentation problem
 Operating System: N/A
 PHP Version:  4.2.2
 Assigned To:  k.schroeder
 New Comment:

fixed in CVS


Previous Comments:


[2002-11-20 12:02:34] [EMAIL PROTECTED]

I think there is a mistake in the german translation
http://www.php.net/manual/de/language.variables.predefined.php
and in the file
language.variables.predefined.html
in the german offline/downloadable version (03-11-2002)

"$HTTP_ENCODING
Inhalt des Accept-Encoding:-Headers der aktuellen Anforderung (wenn es
einen gibt). Beispiel: 'gzip'."

I think it should say:
$HTTP_ACCEPT_ENCODING instead of $HTTP_ENCODING

---

On my Apache/1.3.26 with PHP/4.2.2
$HTTP_ENCODING is undefined, i.e. isset($HTTP_ENCODING)==false
whereas
$HTTP_ACCEPT_ENCODING contains the Accept-Encoding Header, e.g. for
Mozilla: "gzip, deflate, compress;q=0.9"

---

The German version
http://www.php.net/manual/de/language.variables.predefined.php
seems to be quite old (or even outdated?) and is very different from
the English version and all other translations (which have the warning
concerning register_globals etc.)
http://www.php.net/manual/en/language.variables.predefined.php 

---

I think there is quite a similar error in the spanish translation,
which also is older and different from the English version:
http://www.php.net/manual/es/language.variables.predefined.php

"HTTP_ENCODING
Los contenidos de la cabecera Accept-Encoding: de la petición actual,
si la hay. Por ejemplo: 'gzip'."

I think that there, too, it should say
HTTP_ACCEPT_ENCODING instead of HTTP_ENCODING

---

Kind regards from Switzerland
Thomas Luethi




-- 
Edit this bug report at http://bugs.php.net/?id=20522&edit=1


-- 
PHP Documentation Mailing List (http://www.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php




[PHP-DOC] #20570 [Opn->Csd]: description of MAX_FILE_SIZE should be clear

2003-01-25 Thread hholzgra
 ID:   20570
 Updated by:   [EMAIL PROTECTED]
 Reported By:  [EMAIL PROTECTED]
-Status:   Open
+Status:   Closed
 Bug Type: Documentation problem
 Operating System: independency
 PHP Version:  4.3.0RC1
 New Comment:

there is no step 3, php itself does not check MAX_FILE_SIZE
(unless your script does)

will add the "user won't have to wait to long" part


Previous Comments:


[2002-11-22 08:38:47] [EMAIL PROTECTED]

[quote from php manual
 mian>>feature>>handling file uploads]

The MAX_FILE_SIZE hidden field must precede the file input field and
its value is the maximum filesize accepted. The value is in bytes. 

[warnning]
warning: The MAX_FILE_SIZE is advisory to the browser. It is easy to
circumvent this maximum. So don't count on it that the browser obeys
you wish! The PHP-settings for maximum-size, however, cannot be fooled.
 
[/warnning]
[/quote]
it doesn't tell how php check the size
1 year ago I 1st time read it, and re-read it today, finally get what
it means

document should tell more to programmers:
--
1. user's file size is checked at the beginning of transfer before
upload is done
2. hard limit: file size is check against "PHP-settings for
maximum-size", file which larger will be refused
3. then, soft limit: check against "MAX_FILE_SIZE" if there is one
hidden value before input file field
4. when transfer done, php-script is active, manage to store the
uploaded-file, however, value of MAX_FILE_SIZE easy to circumvent, and
cannot be trust on, your php-script should re-check the uploaded file
size as u wish.
FAQ: u said MAX_FILE_SIZE is untrustable, why we should make use of it?
why not use only php-script to check filesize?
answer: in current php, handling of upload file, scirpt is not active,
thus, cannot check filesize until transfer of upload file is done.
MAX_FILE_SIZE get ability to soft limit the filesize before user have
to wait too long.
--

this is what i comprehend :)
yes, it's too long, hope u guys can refine it, and put into new version
of phpmanual




-- 
Edit this bug report at http://bugs.php.net/?id=20570&edit=1


-- 
PHP Documentation Mailing List (http://www.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php




[PHP-DOC] #20644 [Opn]: Incrementing/Decrementing booleans != boolean+1

2003-01-25 Thread hholzgra
 ID:   20644
 Updated by:   [EMAIL PROTECTED]
 Reported By:  [EMAIL PROTECTED]
 Status:   Open
 Bug Type: Documentation problem
 Operating System: all
 PHP Version:  4.3.0-dev
 New Comment:

compare this to

$a = "a";
$a = $a + 1;

and 

$a = "a";
$a = $a++;

++ is defined as increment, which may have different meanings on
different types

it is *not* defined as "is always the same as +=1 "

so it is definetly not a bug IHMO

the documentation issue is still valid 


Previous Comments:


[2002-11-27 04:24:49] [EMAIL PROTECTED]

it's still not a bug, and there was some discussion about this on
php-dev or some other list a while ago..can't find that now thouhg, but
there was also "fix" for this, but it was reverted. (iirc)




[2002-11-27 02:56:32] [EMAIL PROTECTED]

Please explain how this is to be documented (why this isn't a bug) as I
fail to understand the seemingly inconsistent behavior of this
example:

$t = true;
$a = $t + 1; (same as $t += 1; // 2)
$b = ++$t;

print "a: $a b: $b"; // a: 2 b: 1

In otherwords, incrementing/decrementing a boolean keeps it as boolean
while adding an integer, such as 1, changes it to an integer.

Reclassifying as a scripting engine problem so php-dev gets this
report.  Please provide a documentable reason for this behavior.



[2002-11-27 01:49:34] [EMAIL PROTECTED]

Reclassified.




[2002-11-27 01:24:49] [EMAIL PROTECTED]

it was really an user error, sorry.
i found than "++" operator doesn't make type conversion from boolean to
int, and if variable is boolean and equals TRUE than after ++ it
remains as TRUE, so

$a = TRUE; echo ($a++).$a;

produces output "11"
this behavior of increment operator was unexpected to me and i suppose
that it can be the same to others, so i wrote an user note at "type
juggling" part at online documentation



[2002-11-26 20:37:54] [EMAIL PROTECTED]

Not known and most likely user error. Please provide a reproducing
script.




The remainder of the comments for this report are too long. To view
the rest of the comments, please view the bug report online at
http://bugs.php.net/20644

-- 
Edit this bug report at http://bugs.php.net/?id=20644&edit=1


-- 
PHP Documentation Mailing List (http://www.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php




[PHP-DOC] win32 builtin zlib

2003-01-25 Thread Friedhelm Betz
Hi,

I rewrote the part in the phpdoc manual about building on windows.
zlib is builtin with 4.3.0 but the shipped Workspace for VC++
relies on a precompilded external zlib.lib.

Therefore building on win32, out of the box, is not possible without
downloading zlib sources, compiling them and either modify the
workspace or figure out where to place zlib.lib.

Two points:

1.) In the released 4.3.0 source dist, the workspace points to ../../zlib,
2.) for example snapshot php4-STABLE-200301241430 points to
../../zlib/Release

This is hard to document

1.) Are there future plans to include the zlib sources?
2.) Should users be advised to modify config.win32.h.in
3.) Should users be advised to download zlib sources, building
zlib.lib?

Thanks for any thoughts, suggestions, corrections

Regards
Friedhelm Betz


-- 
PHP Documentation Mailing List (http://www.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php




[PHP-DOC] Re: [PHP-DEV] win32 builtin zlib

2003-01-25 Thread Zeev Suraski
At 19:59 25/01/2003, Friedhelm Betz wrote:

Hi,

I rewrote the part in the phpdoc manual about building on windows.
zlib is builtin with 4.3.0 but the shipped Workspace for VC++
relies on a precompilded external zlib.lib.

Therefore building on win32, out of the box, is not possible without
downloading zlib sources, compiling them and either modify the
workspace or figure out where to place zlib.lib.

Two points:

1.) In the released 4.3.0 source dist, the workspace points to ../../zlib,
2.) for example snapshot php4-STABLE-200301241430 points to
../../zlib/Release

This is hard to document

1.) Are there future plans to include the zlib sources?


No.  zlib is included in a similar way to the way we include 
bindlib_w32.  It's in a different repository on cvs.php.net, that we expect 
to be checked out and built by the time you build PHP.

2.) Should users be advised to modify config.win32.h.in


Nope (this particular file doesn't exist anymore, btw)


3.) Should users be advised to download zlib sources, building
zlib.lib?


Not sure - I think that zlib should be in the win32build.zip archive.  If 
you put it where bindlib_w32.lib is, we should be fine :)

Zeev


--
PHP Documentation Mailing List (http://www.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php



[PHP-DOC] Re: [PHP-DEV] win32 builtin zlib

2003-01-25 Thread Friedhelm Betz
Saturday, January 25, 2003, Zeev Suraski wrote:

>>1.) Are there future plans to include the zlib sources?

> No.  zlib is included in a similar way to the way we include 
> bindlib_w32.  It's in a different repository on cvs.php.net, that we expect 
> to be checked out and built by the time you build PHP.

Ok, from users point the same...
Maybe my question was a bit misleading, I meant provided within
win32build.zip, maybe.

>>2.) Should users be advised to modify config.win32.h.in

> Nope (this particular file doesn't exist anymore, btw)

Hm, you are right, at least not in the snapshots, but in the official
release 4.3.0 from php.net... anyway.

>>3.) Should users be advised to download zlib sources, building
>> zlib.lib?

> Not sure - I think that zlib should be in the win32build.zip archive.

Nope;-)

As zlib is builtin and the workspaces rely on, it would be really nice
for users if they are done by downloading php4.xxx.tar.gz, win32build.zip
and bindlib_w32.zip, the way like other standard builtin modules are fine
with.

So what would be the "offical" advise from php.net showing up in the
manual?
Checking out zlib from cvs?
Where to place, so that the workspaces shipped with releases from
php.net working out of the box?

Regards
 Friedhelm Betz


-- 
PHP Documentation Mailing List (http://www.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php




[PHP-DOC] Re: [PHP-DEV] win32 builtin zlib

2003-01-25 Thread Maxim Maletsky


On Sat, 25 Jan 2003 18:59:37 +0100 Friedhelm Betz <[EMAIL PROTECTED]> wrote:

> Hi,
> 
> I rewrote the part in the phpdoc manual about building on windows.
> zlib is builtin with 4.3.0 but the shipped Workspace for VC++
> relies on a precompilded external zlib.lib.

This is just what I run into a few hours ago trying to build php5
checkout with VC6.

> Therefore building on win32, out of the box, is not possible without
> downloading zlib sources, compiling them and either modify the
> workspace or figure out where to place zlib.lib.

I had to download zlib.lib from w3c.org before building
(here:
http://dev.w3.org/cvsweb/libwww/Library/External/zlib.lib?sortby=file)

> Two points:
> 
> 1.) In the released 4.3.0 source dist, the workspace points to ../../zlib,
> 2.) for example snapshot php4-STABLE-200301241430 points to
> ../../zlib/Release
>
> This is hard to document
> 
> 1.) Are there future plans to include the zlib sources?

probably the quickiest way, unless there are some problems with it, not
really sure.

> 2.) Should users be advised to modify config.win32.h.in

This would mean that every distribution would have to be modified
beforeit is built for win32, not the best way IMO.

> 3.) Should users be advised to download zlib sources, building
> zlib.lib?

The link above from w3c could be a good idea to point the user to.

-- 
Maxim Maletsky
[EMAIL PROTECTED]


-- 
PHP Documentation Mailing List (http://www.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php




Re: [PHP-DOC] Re: [PHP-DEV] win32 builtin zlib

2003-01-25 Thread Friedhelm Betz

[...]
> The link above from w3c could be a good idea to point the user to.

Sure, but not a very smart solution IMHO ;-). It think it should be
possible (and preferable) to bundle the required whatever files
with win32build.zip ;-)

 Friedhelm   


-- 
PHP Documentation Mailing List (http://www.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php




Re: [PHP-DOC] Re: [PHP-DEV] win32 builtin zlib

2003-01-25 Thread Maxim Maletsky

On Sat, 25 Jan 2003 23:39:36 +0100 Friedhelm Betz <[EMAIL PROTECTED]> wrote:

> 
> [...]
> > The link above from w3c could be a good idea to point the user to.
> 
> Sure, but not a very smart solution IMHO ;-). It think it should be
> possible (and preferable) to bundle the required whatever files
> with win32build.zip ;-)

I completely agree. I didn't know about the win32build.zip untill Zeev
mentioned it.

---
Maxim Maletsky
[EMAIL PROTECTED]


-- 
PHP Documentation Mailing List (http://www.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php




[PHP-DOC] cvs: phpdoc /en/reference/image/functions imagecolorallocatealpha.xml

2003-01-25 Thread Sara Golemon
pollita Sat Jan 25 20:34:13 2003 EDT

  Added files: 
/phpdoc/en/reference/image/functionsimagecolorallocatealpha.xml 
  Log:
  New function.
  
  

Index: phpdoc/en/reference/image/functions/imagecolorallocatealpha.xml
+++ phpdoc/en/reference/image/functions/imagecolorallocatealpha.xml


 
  
   imagecolorallocatealpha
   Allocate a color for an image
  
  
   Description

 intimagecolorallocatealpha
 resourceimage
 intred
 intgreen
 intblue
 intalpha

   
imagecolorallocatealpha behaves identically to 
imagecolorallocate with the addition of the transparency
parameter alpha which may have a value between 
0 and 127.  0
indicates completely opaque while 127 indicates
completely transparent.
   
   
Returns &false; if the allocation failed.
   
  
 





-- 
PHP Documentation Mailing List (http://www.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php




[PHP-DOC] #20570 [Csd]: description of MAX_FILE_SIZE should be clear

2003-01-25 Thread Xuefer
 ID:   20570
 User updated by:  [EMAIL PROTECTED]
 Reported By:  [EMAIL PROTECTED]
 Status:   Closed
 Bug Type: Documentation problem
 Operating System: independency
 PHP Version:  4.3.0RC1
 New Comment:

sorry, there is step 3, php itself does check MAX_FILE_SIZE

if MAX_FILE_SIZE is for script not for php itself, it shouldn't mention
by document

look at these code:
  safe_php_register_variable(param, value, array_ptr, 0 TSRMLS_CC);
  if (!strcmp(param, "MAX_FILE_SIZE")) {
max_file_size = atol(value);
  }
==
  else if (max_file_size && (total_bytes > max_file_size)) {
sapi_module.sapi_error(E_WARNING, "MAX_FILE_SIZE of %ld bytes
exceeded - file [%s=%s] not saved", max_file_size, param, filename);
cancel_upload = UPLOAD_ERROR_B;
  } else if
...


Previous Comments:


[2003-01-25 13:18:54] [EMAIL PROTECTED]

there is no step 3, php itself does not check MAX_FILE_SIZE
(unless your script does)

will add the "user won't have to wait to long" part



[2002-11-22 08:38:47] [EMAIL PROTECTED]

[quote from php manual
 mian>>feature>>handling file uploads]

The MAX_FILE_SIZE hidden field must precede the file input field and
its value is the maximum filesize accepted. The value is in bytes. 

[warnning]
warning: The MAX_FILE_SIZE is advisory to the browser. It is easy to
circumvent this maximum. So don't count on it that the browser obeys
you wish! The PHP-settings for maximum-size, however, cannot be fooled.
 
[/warnning]
[/quote]
it doesn't tell how php check the size
1 year ago I 1st time read it, and re-read it today, finally get what
it means

document should tell more to programmers:
--
1. user's file size is checked at the beginning of transfer before
upload is done
2. hard limit: file size is check against "PHP-settings for
maximum-size", file which larger will be refused
3. then, soft limit: check against "MAX_FILE_SIZE" if there is one
hidden value before input file field
4. when transfer done, php-script is active, manage to store the
uploaded-file, however, value of MAX_FILE_SIZE easy to circumvent, and
cannot be trust on, your php-script should re-check the uploaded file
size as u wish.
FAQ: u said MAX_FILE_SIZE is untrustable, why we should make use of it?
why not use only php-script to check filesize?
answer: in current php, handling of upload file, scirpt is not active,
thus, cannot check filesize until transfer of upload file is done.
MAX_FILE_SIZE get ability to soft limit the filesize before user have
to wait too long.
--

this is what i comprehend :)
yes, it's too long, hope u guys can refine it, and put into new version
of phpmanual




-- 
Edit this bug report at http://bugs.php.net/?id=20570&edit=1


-- 
PHP Documentation Mailing List (http://www.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php




[PHP-DOC] #20570 [Csd->Opn]: description of MAX_FILE_SIZE should be clear

2003-01-25 Thread philip
 ID:   20570
 Updated by:   [EMAIL PROTECTED]
 Reported By:  [EMAIL PROTECTED]
-Status:   Closed
+Status:   Open
 Bug Type: Documentation problem
 Operating System: independency
-PHP Version:  4.3.0RC1
+PHP Version:  4.3.0
 New Comment:

Still open, more information is needed in these docs regarding all of
this.


Previous Comments:


[2003-01-25 20:04:02] [EMAIL PROTECTED]

sorry, there is step 3, php itself does check MAX_FILE_SIZE

if MAX_FILE_SIZE is for script not for php itself, it shouldn't mention
by document

look at these code:
  safe_php_register_variable(param, value, array_ptr, 0 TSRMLS_CC);
  if (!strcmp(param, "MAX_FILE_SIZE")) {
max_file_size = atol(value);
  }
==
  else if (max_file_size && (total_bytes > max_file_size)) {
sapi_module.sapi_error(E_WARNING, "MAX_FILE_SIZE of %ld bytes
exceeded - file [%s=%s] not saved", max_file_size, param, filename);
cancel_upload = UPLOAD_ERROR_B;
  } else if
...



[2003-01-25 13:18:54] [EMAIL PROTECTED]

there is no step 3, php itself does not check MAX_FILE_SIZE
(unless your script does)

will add the "user won't have to wait to long" part



[2002-11-22 08:38:47] [EMAIL PROTECTED]

[quote from php manual
 mian>>feature>>handling file uploads]

The MAX_FILE_SIZE hidden field must precede the file input field and
its value is the maximum filesize accepted. The value is in bytes. 

[warnning]
warning: The MAX_FILE_SIZE is advisory to the browser. It is easy to
circumvent this maximum. So don't count on it that the browser obeys
you wish! The PHP-settings for maximum-size, however, cannot be fooled.
 
[/warnning]
[/quote]
it doesn't tell how php check the size
1 year ago I 1st time read it, and re-read it today, finally get what
it means

document should tell more to programmers:
--
1. user's file size is checked at the beginning of transfer before
upload is done
2. hard limit: file size is check against "PHP-settings for
maximum-size", file which larger will be refused
3. then, soft limit: check against "MAX_FILE_SIZE" if there is one
hidden value before input file field
4. when transfer done, php-script is active, manage to store the
uploaded-file, however, value of MAX_FILE_SIZE easy to circumvent, and
cannot be trust on, your php-script should re-check the uploaded file
size as u wish.
FAQ: u said MAX_FILE_SIZE is untrustable, why we should make use of it?
why not use only php-script to check filesize?
answer: in current php, handling of upload file, scirpt is not active,
thus, cannot check filesize until transfer of upload file is done.
MAX_FILE_SIZE get ability to soft limit the filesize before user have
to wait too long.
--

this is what i comprehend :)
yes, it's too long, hope u guys can refine it, and put into new version
of phpmanual




-- 
Edit this bug report at http://bugs.php.net/?id=20570&edit=1


-- 
PHP Documentation Mailing List (http://www.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php




[PHP-DOC] Re: [PHP-DEV] win32 builtin zlib

2003-01-25 Thread Zeev Suraski
At 00:25 26/01/2003, Friedhelm Betz wrote:

Saturday, January 25, 2003, Zeev Suraski wrote:

>>1.) Are there future plans to include the zlib sources?

> No.  zlib is included in a similar way to the way we include
> bindlib_w32.  It's in a different repository on cvs.php.net, that we 
expect
> to be checked out and built by the time you build PHP.

Ok, from users point the same...
Maybe my question was a bit misleading, I meant provided within
win32build.zip, maybe.

>>2.) Should users be advised to modify config.win32.h.in

> Nope (this particular file doesn't exist anymore, btw)

Hm, you are right, at least not in the snapshots, but in the official
release 4.3.0 from php.net... anyway.

>>3.) Should users be advised to download zlib sources, building
>> zlib.lib?

> Not sure - I think that zlib should be in the win32build.zip archive.

Nope;-)

As zlib is builtin and the workspaces rely on, it would be really nice
for users if they are done by downloading php4.xxx.tar.gz, win32build.zip
and bindlib_w32.zip, the way like other standard builtin modules are fine
with.

I'm not really following.  I have to admit I never built PHP from the 
pre-made library binaries, so it sounds awkward to me.  Are we making 
people download the bindlib source and build it?  If so, we should do the 
same with zlib (looking into it, I guess it means creating a zlib.zip file, 
like bindlib_w32.zip).  zlib and bindlib sit in exactly the same level of 
integration with PHP.

To me it sounds a bit weird that the ready-made builds of these libraries 
don't come bundled in win32build.zip, but I guess that's fine as long as 
it's documented.

Zeev


--
PHP Documentation Mailing List (http://www.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php