[PHP-DOC] cvs: phpdoc /en/reference/stream/functions stream-context-get-options.xml stream-get-options.xml

[Sara Golemon]

pollita Sat Jan  4 02:41:56 2003 EDT

  Added files: 
/phpdoc/en/reference/stream/functions   
stream-context-get-options.xml 

  Removed files:   
/phpdoc/en/reference/stream/functions   stream-get-options.xml 
  Log:
  Misnamed function in new manual page.
  
  

Index: phpdoc/en/reference/stream/functions/stream-context-get-options.xml
+++ phpdoc/en/reference/stream/functions/stream-context-get-options.xml


  
   
stream_context_get_options
Retrieve options for a stream/wrapper/context 
   
   
Description
 
  boolstream_context_get_options
  
resourcestream|context
 

 Returns an array of options on the specified stream or context.

   
  





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

[PHP-DOC] cvs: phpdoc /en/reference/stream/functions stream-filter-append.xml stream-filter-prepend.xml stream-register-filter.xml

[Sara Golemon]

pollita Sat Jan  4 02:17:18 2003 EDT

  Added files: 
/phpdoc/en/reference/stream/functions   stream-register-filter.xml 
stream-filter-prepend.xml 
stream-filter-append.xml 
  Log:
  Defined stream_register_filter, stream_filter_prepend, and stream_filter_prepend
  
  

Index: phpdoc/en/reference/stream/functions/stream-register-filter.xml
+++ phpdoc/en/reference/stream/functions/stream-register-filter.xml


  
   
stream_register_filter
Register a stream filter implemented as a PHP class derived from 
php_user_filter
   
   
Description

 booleanstream_register_filter
 stringfiltername
 stringclassname


 stream_register_filter allows you to implement
 your own filter on any registered stream used with all the other
 filesystem functions (such as fopen,
 fread etc.).


 To implement a filter, you need to define a class as an extension of
 php_user_fitler with a number of member functions 
 as defined below. When performing read/write opperations on the stream
 to which your filter is attached, PHP will pass the data through your
 filter (and any other filters attached to that stream) so that the
 data may be modified as desired. You must implement the methods
 exactly as described below - doing otherwise will lead to undefined
 behaviour.


 stream_register_filter will return &false; if the
 filtername is already defined.



 intwrite
 stringdata


 This method is called whenever data is written to the attached 
 stream (such as with fwrite).  After 
 modifying data as needed your
 filter should issue: return parent::write($data);
 so that the next filter in the chain can perform its filter.
 When no filters remain, the stream will write data
 in its final form.



 stringread
 intmaxlength


 This method is called whenever data is read from the attached 
 stream (such as with fread).  A filter
 should first call parent::read($maxlength); to
 retrieve the data from the previous filter who, ultimately,
 retrieved it from the stream.  Your filter may then modify the
 data as needed and return it. 
 Your filter should never return more than maxlength
 bytes.  Since parent::read($maxlength); will also
 not return more than maxlength bytes this
 will ordinarily be a non-issue.  However, if your filter 
 increases the size of the data being returned, you should either
 call parent::read($maxlength-$x); where 
 x is the most your filter will grow
 the size of the data read.  Alternatively, you can build a 
 read-buffer into your class.



 intflush
 boolclosing


 This method is called in response to a request to flush the
 attached stream (such as with fflush or
 fclose).  The closing
 parameter tells you whether the stream is, in fact, in the
 process of closing.  The default action is to simply call:
 return parent::flush($closing); , your
 filter may wish to perform additional writes and/or cleanup
 calls prior to or directly after a successful flush.



 voidoncreate
 




 voidonclose
 




 The example below implements a filter named rot13
 on the foo-bar.txt stream which will perform
 ROT-13 encryption on all letter characters written to/read from
 that stream.

  
  Filter for ROT13 encoding data on foo-bar.txt stream
  

  
 


 See Also:
 stream_register_wrapper,
 stream_filter_prepend, and
 stream_filter_append

   
  




Index: phpdoc/en/reference/stream/functions/stream-filter-prepend.xml
+++ phpdoc/en/reference/stream/functions/stream-filter-prepend.xml


  
   
stream_filter_prepend
Attach a filter to a stream. 
   
   
Description
 
  boolstream_filter_prepend
  resourcestream
  stringfiltername
 

 Adds filtername to the list of filters 
 attached to stream.  This filter will be
 added to the beginning of the list and
 will therefore be called first during stream opperations.  To
 add a filter to the end of the list, use 
 stream_filter_append.


 
  stream_register_filter must be called first
  in order to register the desired user filter to 
filtername.
 


 See Also:
 stream_register_filter, and
 stream_filter_append

   
  



Index: phpdoc/en/reference/stream/functions/stream-filter-append.xml
+++ phpdoc/en/reference/stream/functions/stream-filter-append.xml


  
   
stream_filter_append
Attach a filter to a stream. 
   
   
Description
 
  boolstream_filter_append
  resourcestream
  stringfiltername
 

 Adds fil

[PHP-DOC] #21209 [Com]: Error in the examples for mysql_fetch_assoc and mysql_fetch_array

[michael . mauch]

 ID:   21209
 Comment by:   [EMAIL PROTECTED]
 Reported By:  [EMAIL PROTECTED]
 Status:   Open
 Bug Type: Documentation problem
 Operating System: Windows
 PHP Version:  4CVS-2002-12-26 (dev)
 New Comment:

The manual states that mysql_error() without arguments retrieves the
error text of the last recently used MySQL function - _not_ the last
opened connection.

And that's exactly what happens at least here on Linux (tested with
4.3.0 and 4.4.0-CVS as of today).

So if the example doesn't work on Windows, it is broken on Windows. Can
you try the example on its own, without your custom error handler?


Previous Comments:


[2003-01-03 20:37:16] [EMAIL PROTECTED]

That is not true.
Your code just produces a ``Could not connect: ''
here.

PHP Version 4.4.0-dev
System Windows NT localhost 5.1 build 2600
Build Date Dec 26 2002 20:10:08
Server API Apache



[2003-01-03 17:25:23] [EMAIL PROTECTED]

Actually with 



It returns:

Could not connect: Access denied for user: 'mysql_user@localhost'
(Using password: YES)

so using mysql_error() here is just fine, it also manages the
connections' error.

Thank you for your report.



[2002-12-26 18:51:17] [EMAIL PROTECTED]

Hi!

There is an error in the code examples for mysql_fetch_assoc and
_array:
(for mysql_fetch_assoc, at the page for _array is the same error)
[code]
$conn = mysql_connect("localhost", "mysql_user",
"mysql_password");

if (!$conn) {
echo "Unable to connect to DB: " . mysql_error();
exit;
}
[/code]

That doesn't make sense. mysql_error() takes the connection that is
passed as an argument or the last opened connection. Where
mysql_error() is called, no connection to a mysql server is
established, so mysql_error() returns an empty string. Additionaly PHP
raises an E_WARNING error anyway in case mysql_connect fails. Sample
Output: (custom error handler)

[output]
Warning:
mysql_connect() [function.mysql-connect]: Access denied for user:
'mysql_user@localhost' (Using password: YES)
On Line: 2
In File: c:\web\apache\htdocs\test.php
Error Context: $conn = mysql_connect("localhost", "mysql_user",
"mysql_password");

Unable to connect to DB:
[/output]

Suggestion:
a) Change the examples so that they catch the errors in a way that is
appropriate, i.e.:
[code]
$conn = @mysql_connect("localhost", "mysql_user", "mysql_password");

if (empty($conn)) {
echo "Unable to connect to DB: " . $GLOBALS['php_errormsg'];
exit;
}
[/code]
b) More work, but would be nicer and match the documentation for
mysql_error - yet this changes the behaviour a lot, some scripts would
have to be rewritten:
Let mysql_connect no longer issue warnings ("Errors coming back from
the MySQL database backend no longer issue warnings. Instead, use
mysql_error() to retrieve the error text." - Manual page for
mysql_error() ), but modify mysql_error so that it holds error strings
from mysql_connect as well.






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


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

[PHP-DOC] #21209 [Bgs->Opn]: Error in the examples for mysql_fetch_assoc and mysql_fetch_array

[kyrael]

 ID:   21209
 User updated by:  [EMAIL PROTECTED]
 Reported By:  [EMAIL PROTECTED]
-Status:   Bogus
+Status:   Open
 Bug Type: Documentation problem
 Operating System: Windows
 PHP Version:  4CVS-2002-12-26 (dev)
 New Comment:

That is not true.
Your code just produces a ``Could not connect: ''
here.

PHP Version 4.4.0-dev
System Windows NT localhost 5.1 build 2600
Build Date Dec 26 2002 20:10:08
Server API Apache


Previous Comments:


[2003-01-03 17:25:23] [EMAIL PROTECTED]

Actually with 



It returns:

Could not connect: Access denied for user: 'mysql_user@localhost'
(Using password: YES)

so using mysql_error() here is just fine, it also manages the
connections' error.

Thank you for your report.



[2002-12-26 18:51:17] [EMAIL PROTECTED]

Hi!

There is an error in the code examples for mysql_fetch_assoc and
_array:
(for mysql_fetch_assoc, at the page for _array is the same error)
[code]
$conn = mysql_connect("localhost", "mysql_user",
"mysql_password");

if (!$conn) {
echo "Unable to connect to DB: " . mysql_error();
exit;
}
[/code]

That doesn't make sense. mysql_error() takes the connection that is
passed as an argument or the last opened connection. Where
mysql_error() is called, no connection to a mysql server is
established, so mysql_error() returns an empty string. Additionaly PHP
raises an E_WARNING error anyway in case mysql_connect fails. Sample
Output: (custom error handler)

[output]
Warning:
mysql_connect() [function.mysql-connect]: Access denied for user:
'mysql_user@localhost' (Using password: YES)
On Line: 2
In File: c:\web\apache\htdocs\test.php
Error Context: $conn = mysql_connect("localhost", "mysql_user",
"mysql_password");

Unable to connect to DB:
[/output]

Suggestion:
a) Change the examples so that they catch the errors in a way that is
appropriate, i.e.:
[code]
$conn = @mysql_connect("localhost", "mysql_user", "mysql_password");

if (empty($conn)) {
echo "Unable to connect to DB: " . $GLOBALS['php_errormsg'];
exit;
}
[/code]
b) More work, but would be nicer and match the documentation for
mysql_error - yet this changes the behaviour a lot, some scripts would
have to be rewritten:
Let mysql_connect no longer issue warnings ("Errors coming back from
the MySQL database backend no longer issue warnings. Instead, use
mysql_error() to retrieve the error text." - Manual page for
mysql_error() ), but modify mysql_error so that it holds error strings
from mysql_connect as well.






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


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

[PHP-DOC] #21403 [NEW]: getimagesize() returns ["mime"], not ["MIME"]

[michael . mauch]

From: [EMAIL PROTECTED]
Operating system: All
PHP version:  4.3.0
PHP Bug Type: Documentation problem
Bug description:  getimagesize() returns ["mime"], not ["MIME"]

The manual page for getimagesize says:

 Beginning with PHP 4.3, getimagesize() also returns an additional
parameter, MIME, ...

Should be:

 Beginning with PHP 4.3, getimagesize() also returns an additional
parameter, mime, ...

The example is right, and the other indexes are also written in lowercase,
so this should probably be consistent.

Maybe all of these string indexes could be surrounded with quotes, to make
sure nobody thinks that these are constants.
-- 
Edit bug report at http://bugs.php.net/?id=21403&edit=1
-- 
Try a CVS snapshot: http://bugs.php.net/fix.php?id=21403&r=trysnapshot
Fixed in CVS:   http://bugs.php.net/fix.php?id=21403&r=fixedcvs
Fixed in release:   http://bugs.php.net/fix.php?id=21403&r=alreadyfixed
Need backtrace: http://bugs.php.net/fix.php?id=21403&r=needtrace
Try newer version:  http://bugs.php.net/fix.php?id=21403&r=oldversion
Not developer issue:http://bugs.php.net/fix.php?id=21403&r=support
Expected behavior:  http://bugs.php.net/fix.php?id=21403&r=notwrong
Not enough info:http://bugs.php.net/fix.php?id=21403&r=notenoughinfo
Submitted twice:http://bugs.php.net/fix.php?id=21403&r=submittedtwice
register_globals:   http://bugs.php.net/fix.php?id=21403&r=globals
PHP 3 support discontinued: http://bugs.php.net/fix.php?id=21403&r=php3
Daylight Savings:   http://bugs.php.net/fix.php?id=21403&r=dst
IIS Stability:  http://bugs.php.net/fix.php?id=21403&r=isapi
Install GNU Sed:http://bugs.php.net/fix.php?id=21403&r=gnused


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

[PHP-DOC] :: compiling manual ::

[eManual]

hi people, i've tried to compile the manual on 
WINDOWS, using cygwin, i've got a error, that tell me that the file 
'file-entities.xml' cannot be open for writing.
 
So, i've change the file
file-entities.php.in
at the line number: 76
i've commented the line that i've 
change
//$fp = 
fopen("$out_dir/entities/file-entities.ent", "w");$fp = 
fopen("../entities/file-entities.ent", "w");
 
after this, the manual, compiles well, when run the 
command configure, but in time of 'make test' show some errors (3 to be exact) 
about this, i'll tell my route:
$ autoconf
$ ./configure
-> error, changed the file 
'file-entities.php.in' with that lines above.
again
$ autoconf
$ ./configure
->works
now, the little headache
$ make test
../phpdoc-tools/jade/nsgmls.exe -i lang-en -D . -s 
./dtds/dbxml-4.1.2/phpdocxml.dcl manual.xml
C:\cygwin\arquivos\phpdoc-tools\jade\nsgmls.exe:manual.xml:52:2:E: cannot 
open "/arquivos/phpdoc/installpart.xml" (No such 
file or directory)

C:\cygwin\arquivos\phpdoc-tools\jade\nsgmls.exe:C:/cygwinarquivos/phpdoc/en/appendices/reserved.xml:1132:2:E: 
cannot open "/arquivos/phpdoc/reserved.constants.xml" (No such file or 
directory)

C:\cygwin\arquivos\phpdoc-tools\jade\nsgmls.exe:manual.xml:241:2:E: 
cannot open "/arquivos/phpdoc/funcindex.xml" (No such file or 
directory)
make: *** [test] Error 1
 
i don't know what this can be, the files is in the directory that the make 
test say me that it won't, i don't know really what to do anymore.
 
and a second question the nickname 'thomasgm' is blocked at cvs.php.net? or 
not?
 
--
Thanks,
Turbano

[PHP-DOC] #21209 [Opn->Bgs]: Error in the examples for mysql_fetch_assoc and mysql_fetch_array

[nicos]

 ID:   21209
 Updated by:   [EMAIL PROTECTED]
 Reported By:  [EMAIL PROTECTED]
-Status:   Open
+Status:   Bogus
 Bug Type: Documentation problem
 Operating System: Windows
 PHP Version:  4CVS-2002-12-26 (dev)
 New Comment:

Actually with 



It returns:

Could not connect: Access denied for user: 'mysql_user@localhost'
(Using password: YES)

so using mysql_error() here is just fine, it also manages the
connections' error.

Thank you for your report.


Previous Comments:


[2002-12-26 18:51:17] [EMAIL PROTECTED]

Hi!

There is an error in the code examples for mysql_fetch_assoc and
_array:
(for mysql_fetch_assoc, at the page for _array is the same error)
[code]
$conn = mysql_connect("localhost", "mysql_user",
"mysql_password");

if (!$conn) {
echo "Unable to connect to DB: " . mysql_error();
exit;
}
[/code]

That doesn't make sense. mysql_error() takes the connection that is
passed as an argument or the last opened connection. Where
mysql_error() is called, no connection to a mysql server is
established, so mysql_error() returns an empty string. Additionaly PHP
raises an E_WARNING error anyway in case mysql_connect fails. Sample
Output: (custom error handler)

[output]
Warning:
mysql_connect() [function.mysql-connect]: Access denied for user:
'mysql_user@localhost' (Using password: YES)
On Line: 2
In File: c:\web\apache\htdocs\test.php
Error Context: $conn = mysql_connect("localhost", "mysql_user",
"mysql_password");

Unable to connect to DB:
[/output]

Suggestion:
a) Change the examples so that they catch the errors in a way that is
appropriate, i.e.:
[code]
$conn = @mysql_connect("localhost", "mysql_user", "mysql_password");

if (empty($conn)) {
echo "Unable to connect to DB: " . $GLOBALS['php_errormsg'];
exit;
}
[/code]
b) More work, but would be nicer and match the documentation for
mysql_error - yet this changes the behaviour a lot, some scripts would
have to be rewritten:
Let mysql_connect no longer issue warnings ("Errors coming back from
the MySQL database backend no longer issue warnings. Instead, use
mysql_error() to retrieve the error text." - Manual page for
mysql_error() ), but modify mysql_error so that it holds error strings
from mysql_connect as well.






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


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

[PHP-DOC] #21137 [Opn->Csd]: Wrong page name of imagettfbbox function

[nicos]

 ID:   21137
 Updated by:   [EMAIL PROTECTED]
 Reported By:  [EMAIL PROTECTED]
-Status:   Open
+Status:   Closed
 Bug Type: Documentation problem
 Operating System: all
 PHP Version:  4.3.0RC4
 New Comment:

It looks fixed now...

Thank for your report.


Previous Comments:


[2002-12-21 14:41:10] [EMAIL PROTECTED]

The man page with the description of imagettfbbox() has the title
"imagettftext".

Christoph




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


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

[PHP-DOC] #20597 [Opn->Csd]: [chm] bug on function.shm-detach.html

[nicos]

 ID:  20597
 Updated by:  [EMAIL PROTECTED]
 Reported By: [EMAIL PROTECTED]
-Status:  Open
+Status:  Closed
 Bug Type:Documentation problem
 PHP Version: 4.2.3
 New Comment:

According to http://lxr.php.net/source/php4/ext/sysvshm/sysvshm.c#173,
shm_detach will always return TRUE. 

I'm fixing the documentation so now it says that it's a boolean.


Previous Comments:


[2002-11-23 12:33:25] [EMAIL PROTECTED]

I have found a bug on page function.shm-detach.html
[chm date: 2002-10-26]...

It`s not a bug, but this page not provide information about kind of
returned value funtion shm_detach() and how to interpret this value.




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


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

[PHP-DOC] cvs: phpdoc /en/reference/sem/functions shm-detach.xml

[CHAILLAN Nicolas]

nicos   Fri Jan  3 17:51:13 2003 EDT

  Modified files:  
/phpdoc/en/reference/sem/functions  shm-detach.xml 
  Log:
  fixing proto, according to the code, shm-detach will always return TRUE, so it's 
boolean.
  
Index: phpdoc/en/reference/sem/functions/shm-detach.xml
diff -u phpdoc/en/reference/sem/functions/shm-detach.xml:1.2 
phpdoc/en/reference/sem/functions/shm-detach.xml:1.3
--- phpdoc/en/reference/sem/functions/shm-detach.xml:1.2Wed Apr 17 02:43:52 
2002
+++ phpdoc/en/reference/sem/functions/shm-detach.xmlFri Jan  3 17:51:13 2003
@@ -1,5 +1,5 @@
 
-
+
 
   

@@ -9,7 +9,7 @@

 Description
  
-  intshm_detach
+  boolshm_detach
   intshm_identifier
  
 



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

[PHP-DOC] #19568 [Opn->Fbk]: Chinese version PDF PHP manual is corrupted

[nicos]

 ID:   19568
 Updated by:   [EMAIL PROTECTED]
 Reported By:  [EMAIL PROTECTED]
-Status:   Open
+Status:   Feedback
 Bug Type: Documentation problem
 Operating System: all
 PHP Version:  4.2.3
 New Comment:

Are you still experementing the problem with the latest version of PDF
manual in Chinese?

Thank you for your report.


Previous Comments:


[2002-09-24 01:28:22] [EMAIL PROTECTED]

My Windows 98SE is Simplified Chinese Version. And I can see some other
Chinese Version PDF document.(Simplified GB code or Tranditional BIG5
code)



[2002-09-24 01:24:41] [EMAIL PROTECTED]

I cannot see Chinese character in the Chinese version PDF PHP manual.
They are all appear like <25163><20876> <32918><30427><25991> .
I use Windows 98SE and Acrobat Reader 4.0(English Version).




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


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

Re: [PHP-DOC] Re: #18293 - mkdir()

[nicos]

Very nice, as you can see the doc is here, so I know.

End of the discussion for me.

Regards.
M.CHAILLAN Nicolas
[EMAIL PROTECTED]
www.WorldAKT.com Hébergement de sites internets.

- Original Message -
From: "Philip Olson" <[EMAIL PROTECTED]>
To: <[EMAIL PROTECTED]>
Cc: "Gabor Hojtsy" <[EMAIL PROTECTED]>; <[EMAIL PROTECTED]>; "Derick
Rethans" <[EMAIL PROTECTED]>
Sent: Friday, January 03, 2003 10:15 PM
Subject: Re: [PHP-DOC] Re: #18293 - mkdir()


>
> >I never said you weren't contributing. Actually you're one of the
> > most important contributors around (for me at least). I closed the bug
> > because I really thought it was fixed. Only derick pointed me something
that
> > I had didn't thought about...
> > Btw I can do the job myself. I had just got few minutes of
work...
> > Really I have no time to lose with such discussions, it's
pointless.
> > I hope you've got my point, I was working a *bit* please excuse me if it
> > took me 20 minutes to answer to your mail...
>
> Please do not make half-assed commits. If you are going
> to make any commit at all, spend more time on it.
> Always check unified diffs, always make test, always be
> 100% you know what you're talking about.
>
> If you can't make a proper commit, don't commit at all.
>
> Regards,
> Philip
>


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

[PHP-DOC] cvs: phpdoc /en/reference/filesystem/functions chmod.xml

[Gabor Hojtsy]

gobaFri Jan  3 16:35:35 2003 EDT

  Modified files:  
/phpdoc/en/reference/filesystem/functions   chmod.xml 
  Log:
  Modify wording in example (my => owner) to make it more "official"
  
  
Index: phpdoc/en/reference/filesystem/functions/chmod.xml
diff -u phpdoc/en/reference/filesystem/functions/chmod.xml:1.4 
phpdoc/en/reference/filesystem/functions/chmod.xml:1.5
--- phpdoc/en/reference/filesystem/functions/chmod.xml:1.4  Fri Jan  3 16:32:04 
2003
+++ phpdoc/en/reference/filesystem/functions/chmod.xml  Fri Jan  3 16:35:33 2003
@@ -1,5 +1,5 @@
 
-
+
 
   

@@ -46,16 +46,16 @@
  
   
 
   



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

[PHP-DOC] cvs: phpdoc /en/reference/filesystem/functions chmod.xml mkdir.xml

[Gabor Hojtsy]

gobaFri Jan  3 16:32:24 2003 EDT

  Modified files:  
/phpdoc/en/reference/filesystem/functions   chmod.xml mkdir.xml 
  Log:
  Adding explanation of modes in chmod functions documentation. Feel free
  to correct wording if it is not correct. Also moved Nicos' note on modes
  here. Point to chmod page from mkdir for mode details.
  
  
Index: phpdoc/en/reference/filesystem/functions/chmod.xml
diff -u phpdoc/en/reference/filesystem/functions/chmod.xml:1.3 
phpdoc/en/reference/filesystem/functions/chmod.xml:1.4
--- phpdoc/en/reference/filesystem/functions/chmod.xml:1.3  Tue Aug 13 23:28:02 
2002
+++ phpdoc/en/reference/filesystem/functions/chmod.xml  Fri Jan  3 16:32:04 2003
@@ -1,5 +1,5 @@
 
-
+
 
   

@@ -32,6 +32,43 @@
 ]]>
   
  
+
+
+ The mode parameter consists of three octal
+ number components specifying access restrictions for the owner,
+ the user group in which the owner is in, and to everybody else in
+ this order. One component can be computed by adding up the needed
+ permissions for that target user base. Number 1 means that you
+ grant execute rights, number 2 means that you make the file
+ writeable, number 4 means that you make the file readable. Add
+ up these numbers to specify needed rights. You can also read more
+ about modes on UNIX systems with 'man 1 chmod' and 'man 2 chmod'.
+ 
+  
+
+  
+ 
+
+
+ 
+  
+   The current user is the user under which PHP runs. It is
+   probably not the same user you use for normal shell or FTP
+   access.
+  
+ 
 
 
  &return.success;
Index: phpdoc/en/reference/filesystem/functions/mkdir.xml
diff -u phpdoc/en/reference/filesystem/functions/mkdir.xml:1.6 
phpdoc/en/reference/filesystem/functions/mkdir.xml:1.7
--- phpdoc/en/reference/filesystem/functions/mkdir.xml:1.6  Fri Jan  3 16:11:31 
2003
+++ phpdoc/en/reference/filesystem/functions/mkdir.xml  Fri Jan  3 16:32:06 2003
@@ -1,5 +1,5 @@
 
-
+
 
   

@@ -31,8 +31,8 @@
 
 
  The mode is 0777 by default, which means the widest possible
- access. If you need more information about mode under 
- UNIX systems, please read 'man 1 chmod' and 'man 2 chmod'.
+ access. For more information on modes, read the details
+ on the chmod page.
  
   
 

Re: [PHP-DOC] cvs: phpdoc /en/reference/http/functions header.xml

[Philip Olson]

On Fri, 3 Jan 2003, Gabor Hojtsy wrote:

> > Ok, just to check, this should be ok, right?
> > 
> > 
> 
> :)) I have put the comment before the function call because
> the wording points to the future. Now the comment is after
> the code, so it does not look beautiful that it uses wording
> which points to the future...
> 
> Well, I think this will be the most thought out example in
> the documentation ;))
> 
> Actually there is no technical problem in the example, just
> this small grammatical one ;)

Also example.com is always used for examples.  Anyway,
someone else already modified this so this topic is
closed :)

Regards,
Philip


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

Re: [PHP-DOC] Re: #18293 - mkdir()

[Philip Olson]

>I never said you weren't contributing. Actually you're one of the
> most important contributors around (for me at least). I closed the bug
> because I really thought it was fixed. Only derick pointed me something that
> I had didn't thought about...
> Btw I can do the job myself. I had just got few minutes of work...
> Really I have no time to lose with such discussions, it's pointless.
> I hope you've got my point, I was working a *bit* please excuse me if it
> took me 20 minutes to answer to your mail...

Please do not make half-assed commits. If you are going 
to make any commit at all, spend more time on it.  
Always check unified diffs, always make test, always be 
100% you know what you're talking about.

If you can't make a proper commit, don't commit at all.

Regards,
Philip


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

[PHP-DOC] cvs: phpdoc /en/reference/filesystem/functions mkdir.xml

[Gabor Hojtsy]

gobaFri Jan  3 16:11:31 2003 EDT

  Modified files:  
/phpdoc/en/reference/filesystem/functions   mkdir.xml 
  Log:
  Correcting the corrections...
  
  
Index: phpdoc/en/reference/filesystem/functions/mkdir.xml
diff -u phpdoc/en/reference/filesystem/functions/mkdir.xml:1.5 
phpdoc/en/reference/filesystem/functions/mkdir.xml:1.6
--- phpdoc/en/reference/filesystem/functions/mkdir.xml:1.5  Fri Jan  3 15:11:56 
2003
+++ phpdoc/en/reference/filesystem/functions/mkdir.xml  Fri Jan  3 16:11:31 2003
@@ -1,5 +1,5 @@
 
-
+
 
   

@@ -21,12 +21,17 @@
  octal number, which means it should have a leading zero.
  The mode is also modified by the current umask, which you
  can change using umask.
- 
- Mode is ignored on Windows.
-
- Please note also that mode is optional and that
- it is by default '0777' (read, write and execution for EVERY
- access). If you need more informations about mode under 
+
+
+ 
+  
+   Mode is ignored on Windows, and became optional in PHP 4.2.0.
+  
+ 
+
+
+ The mode is 0777 by default, which means the widest possible
+ access. If you need more information about mode under 
  UNIX systems, please read 'man 1 chmod' and 'man 2 chmod'.
  
   



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

Re: [PHP-DOC] Re: #18293 - mkdir()

[nicos]

Hello,

   I never said you weren't contributing. Actually you're one of the
most important contributors around (for me at least). I closed the bug
because I really thought it was fixed. Only derick pointed me something that
I had didn't thought about...
Btw I can do the job myself. I had just got few minutes of work...
Really I have no time to lose with such discussions, it's pointless.
I hope you've got my point, I was working a *bit* please excuse me if it
took me 20 minutes to answer to your mail...

Thank you anyway.

Regards.
M.CHAILLAN Nicolas
[EMAIL PROTECTED]
www.WorldAKT.com Hébergement de sites internets.

- Original Message -
From: "Gabor Hojtsy" <[EMAIL PROTECTED]>
To: <[EMAIL PROTECTED]>; <[EMAIL PROTECTED]>
Sent: Friday, January 03, 2003 10:01 PM
Subject: Re: [PHP-DOC] Re: #18293 - mkdir()


> > Please don't say I'm not 'keen' to fix that. I'm the one that put this
> > thread online. I was just working on something else. I think you ALSO
have
> a
> > job so you probably know what I'm talking about.
> >
> > Anyway, it looks like it has been added in PHP 4.2.0.
>
> Yes, I do have a job, actually I am a university student. And I do file
> bugs,
> when I cannot do the job myself, and hope that someone will do it right.
> Then
> when I have the time to close it myself, I do it. But I don't close a bug,
> while the problem is not solved, or only the half of it is solved.
>
> 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/http/functions header.xml

[Gabor Hojtsy]

> Ok, just to check, this should be ok, right?
> 
> 

:)) I have put the comment before the function call because
the wording points to the future. Now the comment is after
the code, so it does not look beautiful that it uses wording
which points to the future...

Well, I think this will be the most thought out example in
the documentation ;))

Actually there is no technical problem in the example, just
this small grammatical one ;)

Goba


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

Re: [PHP-DOC] Re: #18293 - mkdir()

[Gabor Hojtsy]

> Please don't say I'm not 'keen' to fix that. I'm the one that put this
> thread online. I was just working on something else. I think you ALSO have
a
> job so you probably know what I'm talking about.
>
> Anyway, it looks like it has been added in PHP 4.2.0.

Yes, I do have a job, actually I am a university student. And I do file
bugs,
when I cannot do the job myself, and hope that someone will do it right.
Then
when I have the time to close it myself, I do it. But I don't close a bug,
while the problem is not solved, or only the half of it is solved.

Goba


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

[PHP-DOC] cvs: phpdoc /en/reference/http/functions header.xml

[Maciek Sokolewicz]

tularis Fri Jan  3 15:59:51 2003 EDT

  Modified files:  
/phpdoc/en/reference/http/functions header.xml 
  Log:
   -Updated the example so everyone is finally satisfied
  
  
Index: phpdoc/en/reference/http/functions/header.xml
diff -u phpdoc/en/reference/http/functions/header.xml:1.10 
phpdoc/en/reference/http/functions/header.xml:1.11
--- phpdoc/en/reference/http/functions/header.xml:1.10  Fri Jan  3 11:05:16 2003
+++ phpdoc/en/reference/http/functions/header.xml   Fri Jan  3 15:59:51 2003
@@ -1,5 +1,5 @@
 
-
+
 
   

@@ -173,10 +173,11 @@
   
 
   
  



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

[PHP-DOC] cvs: phpdoc /en/reference/xml/functions xml-parse-into-struct.xml

[CHAILLAN Nicolas]

nicos   Fri Jan  3 15:53:01 2003 EDT

  Modified files:  
/phpdoc/en/reference/xml/functions  xml-parse-into-struct.xml 
  Log:
  4th argument of xml-parse-into-struct is optional (0 by default).
  
Index: phpdoc/en/reference/xml/functions/xml-parse-into-struct.xml
diff -u phpdoc/en/reference/xml/functions/xml-parse-into-struct.xml:1.3 
phpdoc/en/reference/xml/functions/xml-parse-into-struct.xml:1.4
--- phpdoc/en/reference/xml/functions/xml-parse-into-struct.xml:1.3 Fri Apr 19 
07:11:21 2002
+++ phpdoc/en/reference/xml/functions/xml-parse-into-struct.xml Fri Jan  3 15:53:01 
+2003
@@ -1,5 +1,5 @@
 
-
+
 
   

@@ -13,7 +13,7 @@
  resourceparser
  stringdata
  array&values
- array&index
+ array&index
 
 
  This function parses an XML file into 2 parallel array



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

Re: [PHP-DOC] cvs: phpdoc /en/reference/http/functions header.xml

[Tularis]

Ok, just to check, this should be ok, right?




Gabor Hojtsy wrote:

No ;) There is no point in providing that Content-type,
as HTML is the default. Also plain/html is not a valid
content type, text/html is. This is why I have proposed
that "Location: http://www.example.com/"; header.

Also examples should start at the first character on the
line, and PHP code should not be indented with one space.



Goba




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

Re: [PHP-DOC] Re: #18293 - mkdir()

[nicos]

Please don't say I'm not 'keen' to fix that. I'm the one that put this
thread online. I was just working on something else. I think you ALSO have a
job so you probably know what I'm talking about.

Anyway, it looks like it has been added in PHP 4.2.0.

--
Regards.
M.CHAILLAN Nicolas
[EMAIL PROTECTED]
www.WorldAKT.com Hébergement de sites internets.

"Gabor Hojtsy" <[EMAIL PROTECTED]> a écrit dans le message de news:
00af01c2b366$900ccfb0$[EMAIL PROTECTED]
> > So, do some research... CVS and its logs are your
> > friend.
>
> OK, so as Nicos is not keen on fixing that... I made some
> research, as it seems, the change was made by "mfischer"
> and it was between the PHP_4_0_7 branch point and
> PHP_4_2_0 branch point, exactly before the latter. It means
> I guess, that it was included in PHP 4.2.0 the first time.
>
> So it seems that the second parameter is optional from 4.2.0
> and it is always 0777 if not specified from then... Is it
> correct?
>
> Reference: http://cvs.php.net/cvs.php/php4/ext/standard/file.c
>
> The change was in the 1.204 revision.
>
> Goba
>



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

Re: [PHP-DOC] streams reference

[Philip Olson]

On Fri, 3 Jan 2003, Wez Furlong wrote:
> http://www.php.net/manual/en/function.fopen.php
> 
> "Note:  The list of supported protocols can be found in Appendix I. "
> 
> Appendix I is a link...

OOPS, I was looking through streams API docs
and not wrappers.xml :)  This is fine and
not part of streams api docs, doh! My bad!

Regards,
Philip


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

Re: [PHP-DOC] Re: #18293 - mkdir()

[Gabor Hojtsy]

> So, do some research... CVS and its logs are your
> friend.

OK, so as Nicos is not keen on fixing that... I made some
research, as it seems, the change was made by "mfischer"
and it was between the PHP_4_0_7 branch point and
PHP_4_2_0 branch point, exactly before the latter. It means
I guess, that it was included in PHP 4.2.0 the first time.

So it seems that the second parameter is optional from 4.2.0
and it is always 0777 if not specified from then... Is it
correct?

Reference: http://cvs.php.net/cvs.php/php4/ext/standard/file.c

The change was in the 1.204 revision.

Goba


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

Re: [PHP-DOC] streams reference

[Wez Furlong]

http://www.php.net/manual/en/function.fopen.php

"Note:  The list of supported protocols can be found in Appendix I. "

Appendix I is a link...

--Wez.

On Fri, 3 Jan 2003, Philip Olson wrote:

> On Fri, 3 Jan 2003, Wez Furlong wrote:
> > Do you volunteer to maintain 2 * (number of translations) of the
> > information about which streams/wrappers are present?
>
>   Users are not expected to read the entire documentation
>   of PHP streams API just to get some information on how
>   to use the PHP functions found in ref.stream  This is
>   especially true when this information is moved into the
>   developers manual later on.
>
>   Also, my comments below are more general then this
>   specific topic of available streams.  And besides, I
>   can't find this information in the appendix so please
>   point me to it.
>
> > That is the reason that I moved the wrapper information into an
> > appendix, because it made reading about this stuff difficult (and the
> > fopen() reference page unreadable).
>
>   Which is why ref.stream now exists.  A place where your
>   typical PHP user can learn how to use streams, not a
>   place to learn how to implement streams into PHP
>   extensions.
>
>   Regards,
>   Philip
>
>
>
> > On Fri, 3 Jan 2003, Philip Olson wrote:
> >
> > > > > When are certain streams not available, like, I assume
> > > > > allow_url_fopen dictates the availability of the http stream?
> > > > > FTP module for ftp, etc.
> > > > >
> > > > This is all documented in Apendix I (which is linked a couple times from
> > > > ref.stream), do you think we need to go into it in detail on ref.stream as
> > > > well?
> > >
> > > I'm struggling with a response to this but in the end
> > > I feel the answer is yes.  Here's why:
> > >
> > > a) Users should never be expected to read about
> > >the streams API much like users are never
> > >expected to understand PHP source.
> > > b) This only adds to the confusion on which functions
> > >are PHP functions and which are part of the
> > >API.
> > > c) One day there will be a PHP developers manual
> > >and I assume the streams API docs will be
> > >moved as part of it.  So the less we rely on
> > >them now the better.
> > >
> > > Also, I am unable to find this information in the appendix.
> > >
> > > Basically, ref.stream should hold its own and streams api
> > > should only be an enhancement of knowledge for advanced
> > > users, such as PHP source developers.
> > >
> > > Regards,
> > > Philip
> > >
> > >
> > >
> >
> >
> > --
> > PHP Documentation Mailing List (http://www.php.net/)
> > To unsubscribe, visit: http://www.php.net/unsub.php
> >
>
>
>
>


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

[PHP-DOC] #18293 [Asn->Csd]: mkdir does not give any explanation of mode parameter

[nicos]

 ID:   18293
 Updated by:   [EMAIL PROTECTED]
 Reported By:  [EMAIL PROTECTED]
-Status:   Assigned
+Status:   Closed
 Bug Type: Documentation problem
 Operating System: Windows XP Home Edition
 PHP Version:  4.2.1
 Assigned To:  nicos
 New Comment:

Really fixed now.


Previous Comments:


[2003-01-03 14:04:31] [EMAIL PROTECTED]

documentation is not sufficient, reopening



[2003-01-03 14:03:03] [EMAIL PROTECTED]

It has been fixed and the documentation will be updated soon.


Thank for your report.



[2003-01-02 20:03:51] [EMAIL PROTECTED]

Assigned, nicos.



[2002-07-14 08:35:11] [EMAIL PROTECTED]

on NT/windows... just put 0777
note that the 0 before is needed as it is octal ;)



[2002-07-12 03:39:39] [EMAIL PROTECTED]

The 'mkdir()' function documentation does not give any idea what the
'mode' value should take, nor any links to other parts of the
documentation where 'mode' is explained.

Maybe it's a UNIX thing (I am from the Windows world - somebody has to
do it)?  I had a search for mode, and could not find what I wanted.  In
the end, for my code, I just stuck the value '0700' from the example
and that seems to work.  But it's hardly a good way to code eh?

Please put some explanation of what mode is, and the possible values it
can take, and what each of the values mean, either in the mkdir
documentation (or if it exists clearly explained elsewhere in the PHP
docs, then a link to that section).

Thanks for all the work you folks do!




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


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

[PHP-DOC] cvs: phpdoc /en/reference/filesystem/functions mkdir.xml

[CHAILLAN Nicolas]

nicos   Fri Jan  3 15:11:56 2003 EDT

  Modified files:  
/phpdoc/en/reference/filesystem/functions   mkdir.xml 
  Log:
  fixing again (mode is ignored on windows)
  
Index: phpdoc/en/reference/filesystem/functions/mkdir.xml
diff -u phpdoc/en/reference/filesystem/functions/mkdir.xml:1.4 
phpdoc/en/reference/filesystem/functions/mkdir.xml:1.5
--- phpdoc/en/reference/filesystem/functions/mkdir.xml:1.4  Fri Jan  3 15:05:06 
2003
+++ phpdoc/en/reference/filesystem/functions/mkdir.xml  Fri Jan  3 15:11:56 2003
@@ -1,5 +1,5 @@
 
-
+
 
   

@@ -22,7 +22,7 @@
  The mode is also modified by the current umask, which you
  can change using umask.
  
- Mode is NOT needed on Windows.
+ Mode is ignored on Windows.
 
  Please note also that mode is optional and that
  it is by default '0777' (read, write and execution for EVERY



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

Re: [PHP-DOC] Re: #18293 - mkdir()

[nicos]

Done...

Regards.
M.CHAILLAN Nicolas
[EMAIL PROTECTED]
www.WorldAKT.com Hébergement de sites internets.

- Original Message -
From: "Philip Olson" <[EMAIL PROTECTED]>
To: <[EMAIL PROTECTED]>
Cc: <[EMAIL PROTECTED]>
Sent: Friday, January 03, 2003 9:04 PM
Subject: Re: [PHP-DOC] Re: #18293 - mkdir()


>
> On Fri, 3 Jan 2003 [EMAIL PROTECTED] wrote:
> > Hello,
> >
> > Actually we have no idea (We = me and Derick) of when mode became
optional,
> > maybe from the beginning anyway I commit, please see then change and
correct
> > typos if it's needed. You probably have some better way to say what I
said
> > according to others documentations.
>
> So, do some research... CVS and its logs are your
> friend.
>
> Also, that's not how to implement optional arguments,
> look at some other examples to learn how or the
> HOWTO:
>
> http://www.php.net/manual/howto/chapter-skeletons.html
>
> Regards,
> Philip
>
>


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

Re: [PHP-DOC] cvs: phpdoc /en/reference/filesystem/functions mkdir.xml

[Philip Olson]

> >   can change using umask.
> > + 
> > + Mode is NOT needed on Windows.
> 
> It's not needed on Unices either, it defaults to 0777.
> 
> > +
> > + Please note also that mode is optional and that
> > + it is by default '0777' (read, write and execution for EVERY
> > + access). If you need more informations about mode under 
> > + UNIX systems, please read 'man 1 chmod' and 'man 2 chmod'.
> 
> Under Windows the mode is simply ignored, this misses in the 
> documentation.

Also, use a , not this whitespace.  Whitespace
does not show up as HTML.  Anyway, use a  and
someone showed a link to the man page, use it after
editing entities/global.ent.

Regards,
Philip


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

[PHP-DOC] cvs: phpdoc /en/reference/filesystem/functions mkdir.xml

[CHAILLAN Nicolas]

nicos   Fri Jan  3 15:05:08 2003 EDT

  Modified files:  
/phpdoc/en/reference/filesystem/functions   mkdir.xml 
  Log:
  fixing optional argument
  
Index: phpdoc/en/reference/filesystem/functions/mkdir.xml
diff -u phpdoc/en/reference/filesystem/functions/mkdir.xml:1.3 
phpdoc/en/reference/filesystem/functions/mkdir.xml:1.4
--- phpdoc/en/reference/filesystem/functions/mkdir.xml:1.3  Fri Jan  3 14:58:58 
2003
+++ phpdoc/en/reference/filesystem/functions/mkdir.xml  Fri Jan  3 15:05:06 2003
@@ -1,5 +1,5 @@
 
-
+
 
   

@@ -11,7 +11,7 @@
  
   intmkdir
   stringpathname
-  [intmode]
+  intmode
  
 
  Attempts to create the directory specified by pathname.



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

Re: [PHP-DOC] Re: #18293 - mkdir()

[Philip Olson]

On Fri, 3 Jan 2003 [EMAIL PROTECTED] wrote:
> Hello,
> 
> Actually we have no idea (We = me and Derick) of when mode became optional,
> maybe from the beginning anyway I commit, please see then change and correct
> typos if it's needed. You probably have some better way to say what I said
> according to others documentations.

So, do some research... CVS and its logs are your
friend.

Also, that's not how to implement optional arguments,
look at some other examples to learn how or the
HOWTO:

http://www.php.net/manual/howto/chapter-skeletons.html

Regards,
Philip



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

Re: [PHP-DOC] cvs: phpdoc /en/reference/filesystem/functions mkdir.xml

[Gabor Hojtsy]

>   
>intmkdir
>
stringpathname
> -
intmode
> +
[intmode]
>   

This is not the way to specify optional parameters. Please at least
read the howto before adding new XML content...
http://www.php.net/manual/howto/chapter-skeletons.html
Hint: You should specify choice='opt' for the methodparam
instead of those [] chars...

>   octal number, which means it should have a leading zero.
>   The mode is also modified by the current umask, which you
>   can change using umask.
> +
> + Mode is NOT needed on Windows.
> +
> + Please note also that mode is optional and that
> + it is by default '0777' (read, write and execution for EVERY
> + access). If you need more informations about mode under
> + UNIX systems, please read 'man 1 chmod' and 'man 2 chmod'.

You probably wanted to add graphs. Adding enters does not mean
that it will be displayed in a new paragraph. Also add  if
it is imporant, and do not shout (write it in capital letters). I think
you probably wanted to write 'Mode has no effect on Windows' or
something like this...

Goa


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

[PHP-DOC] #18293 [Csd->Asn]: mkdir does not give any explanation of mode parameter

[derick]

 ID:   18293
 Updated by:   [EMAIL PROTECTED]
 Reported By:  [EMAIL PROTECTED]
-Status:   Closed
+Status:   Assigned
 Bug Type: Documentation problem
 Operating System: Windows XP Home Edition
 PHP Version:  4.2.1
 Assigned To:  nicos
 New Comment:

documentation is not sufficient, reopening


Previous Comments:


[2003-01-03 14:03:03] [EMAIL PROTECTED]

It has been fixed and the documentation will be updated soon.


Thank for your report.



[2003-01-02 20:03:51] [EMAIL PROTECTED]

Assigned, nicos.



[2002-07-14 08:35:11] [EMAIL PROTECTED]

on NT/windows... just put 0777
note that the 0 before is needed as it is octal ;)



[2002-07-12 03:39:39] [EMAIL PROTECTED]

The 'mkdir()' function documentation does not give any idea what the
'mode' value should take, nor any links to other parts of the
documentation where 'mode' is explained.

Maybe it's a UNIX thing (I am from the Windows world - somebody has to
do it)?  I had a search for mode, and could not find what I wanted.  In
the end, for my code, I just stuck the value '0700' from the example
and that seems to work.  But it's hardly a good way to code eh?

Please put some explanation of what mode is, and the possible values it
can take, and what each of the values mean, either in the mkdir
documentation (or if it exists clearly explained elsewhere in the PHP
docs, then a link to that section).

Thanks for all the work you folks do!




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


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

Re: [PHP-DOC] cvs: phpdoc /en/reference/filesystem/functions mkdir.xml

[Derick Rethans]

On Fri, 3 Jan 2003, CHAILLAN Nicolas wrote:

> nicos Fri Jan  3 14:58:58 2003 EDT
> 
>   Modified files:  
> /phpdoc/en/reference/filesystem/functions mkdir.xml 
>   Log:
>   fixing #18293, adding more informations about mode
>   
> Index: phpdoc/en/reference/filesystem/functions/mkdir.xml
> diff -u phpdoc/en/reference/filesystem/functions/mkdir.xml:1.2 
>phpdoc/en/reference/filesystem/functions/mkdir.xml:1.3
> --- phpdoc/en/reference/filesystem/functions/mkdir.xml:1.2Wed Apr 17 02:38:09 
>2002
> +++ phpdoc/en/reference/filesystem/functions/mkdir.xmlFri Jan  3 14:58:58 
>2003
> @@ -1,5 +1,5 @@
>  
> -
> +
>  
>
> 
> @@ -11,7 +11,7 @@
>   
>intmkdir
>stringpathname
> -  intmode
> +  [intmode]

This is not valid, please fix.

>   
>  
>   Attempts to create the directory specified by pathname.
> @@ -21,6 +21,13 @@
>   octal number, which means it should have a leading zero.
>   The mode is also modified by the current umask, which you
>   can change using umask.
> + 
> + Mode is NOT needed on Windows.

It's not needed on Unices either, it defaults to 0777.

> +
> + Please note also that mode is optional and that
> + it is by default '0777' (read, write and execution for EVERY
> + access). If you need more informations about mode under 
> + UNIX systems, please read 'man 1 chmod' and 'man 2 chmod'.

Under Windows the mode is simply ignored, this misses in the 
documentation.

Derick

-- 

-
 Derick Rethans http://derickrethans.nl/ 
 PHP Magazine - PHP Magazine for Professionals   http://php-mag.net/
-


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

[PHP-DOC] #18293 [Asn->Csd]: mkdir does not give any explanation of mode parameter

[nicos]

 ID:   18293
 Updated by:   [EMAIL PROTECTED]
 Reported By:  [EMAIL PROTECTED]
-Status:   Assigned
+Status:   Closed
 Bug Type: Documentation problem
 Operating System: Windows XP Home Edition
 PHP Version:  4.2.1
 Assigned To:  nicos
 New Comment:

It has been fixed and the documentation will be updated soon.


Thank for your report.


Previous Comments:


[2003-01-02 20:03:51] [EMAIL PROTECTED]

Assigned, nicos.



[2002-07-14 08:35:11] [EMAIL PROTECTED]

on NT/windows... just put 0777
note that the 0 before is needed as it is octal ;)



[2002-07-12 03:39:39] [EMAIL PROTECTED]

The 'mkdir()' function documentation does not give any idea what the
'mode' value should take, nor any links to other parts of the
documentation where 'mode' is explained.

Maybe it's a UNIX thing (I am from the Windows world - somebody has to
do it)?  I had a search for mode, and could not find what I wanted.  In
the end, for my code, I just stuck the value '0700' from the example
and that seems to work.  But it's hardly a good way to code eh?

Please put some explanation of what mode is, and the possible values it
can take, and what each of the values mean, either in the mkdir
documentation (or if it exists clearly explained elsewhere in the PHP
docs, then a link to that section).

Thanks for all the work you folks do!




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


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

Re: [PHP-DOC] Re: #18293 - mkdir()

[nicos]

Hello,

Actually we have no idea (We = me and Derick) of when mode became optional,
maybe from the beginning anyway I commit, please see then change and correct
typos if it's needed. You probably have some better way to say what I said
according to others documentations.

Thank you.

--
Regards.
M.CHAILLAN Nicolas
[EMAIL PROTECTED]
www.WorldAKT.com Hébergement de sites internets.

"Gabor Hojtsy" <[EMAIL PROTECTED]> a écrit dans le message de news:
006b01c2b361$b6d8b410$[EMAIL PROTECTED]
> > According to standard/file.c it looks like mkdir second argument is
> optional
> > and that it's 0777 by default.
> >
> > So no need of any mode for windows. I'm working on the doc now.
>
> Please also provide compatibility information.
> From what version it is optional, etc...
>
> Goba
>



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

[PHP-DOC] cvs: phpdoc /en/reference/filesystem/functions mkdir.xml

[CHAILLAN Nicolas]

nicos   Fri Jan  3 14:58:58 2003 EDT

  Modified files:  
/phpdoc/en/reference/filesystem/functions   mkdir.xml 
  Log:
  fixing #18293, adding more informations about mode
  
Index: phpdoc/en/reference/filesystem/functions/mkdir.xml
diff -u phpdoc/en/reference/filesystem/functions/mkdir.xml:1.2 
phpdoc/en/reference/filesystem/functions/mkdir.xml:1.3
--- phpdoc/en/reference/filesystem/functions/mkdir.xml:1.2  Wed Apr 17 02:38:09 
2002
+++ phpdoc/en/reference/filesystem/functions/mkdir.xml  Fri Jan  3 14:58:58 2003
@@ -1,5 +1,5 @@
 
-
+
 
   

@@ -11,7 +11,7 @@
  
   intmkdir
   stringpathname
-  intmode
+  [intmode]
  
 
  Attempts to create the directory specified by pathname.
@@ -21,6 +21,13 @@
  octal number, which means it should have a leading zero.
  The mode is also modified by the current umask, which you
  can change using umask.
+ 
+ Mode is NOT needed on Windows.
+
+ Please note also that mode is optional and that
+ it is by default '0777' (read, write and execution for EVERY
+ access). If you need more informations about mode under 
+ UNIX systems, please read 'man 1 chmod' and 'man 2 chmod'.
  
   
 

Re: [PHP-DOC] Re: #18293 - mkdir()

[Gabor Hojtsy]

> According to standard/file.c it looks like mkdir second argument is
optional
> and that it's 0777 by default.
>
> So no need of any mode for windows. I'm working on the doc now.

Please also provide compatibility information.
>From what version it is optional, etc...

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/http/functions header.xml

[Gabor Hojtsy]

> I must be going blind... can't believe I actually missed that :S
> 
> 
> 
> Is this ok with everybody?

No ;) There is no point in providing that Content-type,
as HTML is the default. Also plain/html is not a valid
content type, text/html is. This is why I have proposed
that "Location: http://www.example.com/"; header.

Also examples should start at the first character on the
line, and PHP code should not be indented with one space.



Goba


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

Re: [PHP-DOC] Re: #18293 - mkdir()

[nicos]

According to standard/file.c it looks like mkdir second argument is optional
and that it's 0777 by default.

So no need of any mode for windows. I'm working on the doc now.

--
Regards.
M.CHAILLAN Nicolas
[EMAIL PROTECTED]
www.WorldAKT.com Hébergement de sites internets.

"Michael Mauch" <[EMAIL PROTECTED]> a écrit dans le message de news:
[EMAIL PROTECTED]
> Gabor Hojtsy <[EMAIL PROTECTED]> wrote:
> >> 0777 is fine for WIN32.
> >
> > Well, this is not too scientific. The user notes indicate on that
> > page, that the read/write permissions can actually be set...
>
> Which user note is that? I can't find one saying that the permissions
> work on Win32. And in virtual_mkdir() in tsrm_virtual_cwd.c I see:
>
> #ifdef TSRM_WIN32
> retval = mkdir(new_state.cwd);
> #else
> retval = mkdir(new_state.cwd, mode);
> #endif
>
> So perhaps the manual should state that the second parameter of PHP's
> mkdir is ignored on Win32?
>
> To open another can of worms: the chmod manual page is also not very
> specific about the modes - and as I understand, you can have at least
> read-only files on Windows.
>
> Regards...
> Michael



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

Re: [PHP-DOC] streams reference

[Gabor Hojtsy]

> Do you volunteer to maintain 2 * (number of translations) of the
> information about which streams/wrappers are present?
> 
> That is the reason that I moved the wrapper information into an
> appendix, because it made reading about this stuff difficult (and the
> fopen() reference page unreadable).

We discussed creating the "PHP Developers Manual" sometime in the future,
and also discussed that it should be English only. So when it is started
(maybe in a 'dev' subdir of phpdoc for start?), all the translations of
the non userspace stuff will be useless (not built for the online manual).

Therefore I recommend adding a note to the API docs XML file that there is
not too much point in translating that.

Unless there is a good point to support translation of the developers
manual, in which case I'll go completely mad ;)

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/http/functions header.xml

[Derick Rethans]

On Fri, 3 Jan 2003, Tularis wrote:

> I must be going blind... can't believe I actually missed that :S
> 
> 
> 
> Is this ok with everybody?

No, you should remove the indentation:



Derick

-- 

-
 Derick Rethans http://derickrethans.nl/ 
 PHP Magazine - PHP Magazine for Professionals   http://php-mag.net/
-


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

Re: [PHP-DOC] streams reference

[Philip Olson]

On Fri, 3 Jan 2003, Wez Furlong wrote:
> Do you volunteer to maintain 2 * (number of translations) of the
> information about which streams/wrappers are present?

  Users are not expected to read the entire documentation
  of PHP streams API just to get some information on how 
  to use the PHP functions found in ref.stream  This is
  especially true when this information is moved into the
  developers manual later on.

  Also, my comments below are more general then this
  specific topic of available streams.  And besides, I
  can't find this information in the appendix so please
  point me to it.

> That is the reason that I moved the wrapper information into an
> appendix, because it made reading about this stuff difficult (and the
> fopen() reference page unreadable).

  Which is why ref.stream now exists.  A place where your
  typical PHP user can learn how to use streams, not a
  place to learn how to implement streams into PHP 
  extensions.

  Regards,
  Philip



> On Fri, 3 Jan 2003, Philip Olson wrote:
> 
> > > > When are certain streams not available, like, I assume
> > > > allow_url_fopen dictates the availability of the http stream?
> > > > FTP module for ftp, etc.
> > > >
> > > This is all documented in Apendix I (which is linked a couple times from
> > > ref.stream), do you think we need to go into it in detail on ref.stream as
> > > well?
> >
> > I'm struggling with a response to this but in the end
> > I feel the answer is yes.  Here's why:
> >
> > a) Users should never be expected to read about
> >the streams API much like users are never
> >expected to understand PHP source.
> > b) This only adds to the confusion on which functions
> >are PHP functions and which are part of the
> >API.
> > c) One day there will be a PHP developers manual
> >and I assume the streams API docs will be
> >moved as part of it.  So the less we rely on
> >them now the better.
> >
> > Also, I am unable to find this information in the appendix.
> >
> > Basically, ref.stream should hold its own and streams api
> > should only be an enhancement of knowledge for advanced
> > users, such as PHP source developers.
> >
> > Regards,
> > Philip
> >
> >
> >
> 
> 
> -- 
> PHP Documentation Mailing List (http://www.php.net/)
> To unsubscribe, visit: http://www.php.net/unsub.php
> 



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

Re: [PHP-DOC] cvs: phpdoc /en/reference/http/functions header.xml

[Tularis]

I must be going blind... can't believe I actually missed that :S



Is this ok with everybody?


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

Re: [PHP-DOC] cvs: phpdoc /en/reference/http/functions header.xml

[Gabor Hojtsy]

>  

Well, I have included a correct example in my bug report to add.
The "corrected" example above is far not correct, because:

 1. You never add that content-type after echoing out some HTML.
This is why I added a Location header, which some people do
try to add after the HTML code, and it is much more common then
specifying x-px-realaudio...

 2. The comment is out of the PHP code block, and is not valid anymore.

Please really correct that example.

Thanks,
Goba


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

Re: [PHP-DOC] streams reference

[Wez Furlong]

Do you volunteer to maintain 2 * (number of translations) of the
information about which streams/wrappers are present?

That is the reason that I moved the wrapper information into an
appendix, because it made reading about this stuff difficult (and the
fopen() reference page unreadable).

--Wez.

On Fri, 3 Jan 2003, Philip Olson wrote:

> > > When are certain streams not available, like, I assume
> > > allow_url_fopen dictates the availability of the http stream?
> > > FTP module for ftp, etc.
> > >
> > This is all documented in Apendix I (which is linked a couple times from
> > ref.stream), do you think we need to go into it in detail on ref.stream as
> > well?
>
> I'm struggling with a response to this but in the end
> I feel the answer is yes.  Here's why:
>
> a) Users should never be expected to read about
>the streams API much like users are never
>expected to understand PHP source.
> b) This only adds to the confusion on which functions
>are PHP functions and which are part of the
>API.
> c) One day there will be a PHP developers manual
>and I assume the streams API docs will be
>moved as part of it.  So the less we rely on
>them now the better.
>
> Also, I am unable to find this information in the appendix.
>
> Basically, ref.stream should hold its own and streams api
> should only be an enhancement of knowledge for advanced
> users, such as PHP source developers.
>
> Regards,
> Philip
>
>
>


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

Re: [PHP-DOC] streams reference

[Philip Olson]

> > When are certain streams not available, like, I assume
> > allow_url_fopen dictates the availability of the http stream?
> > FTP module for ftp, etc.
> >
> This is all documented in Apendix I (which is linked a couple times from
> ref.stream), do you think we need to go into it in detail on ref.stream as
> well?

I'm struggling with a response to this but in the end
I feel the answer is yes.  Here's why:

a) Users should never be expected to read about 
   the streams API much like users are never
   expected to understand PHP source.
b) This only adds to the confusion on which functions
   are PHP functions and which are part of the
   API.
c) One day there will be a PHP developers manual
   and I assume the streams API docs will be
   moved as part of it.  So the less we rely on 
   them now the better.

Also, I am unable to find this information in the appendix.

Basically, ref.stream should hold its own and streams api
should only be an enhancement of knowledge for advanced
users, such as PHP source developers.

Regards,
Philip


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

[PHP-DOC] cvs: phpdoc /en/reference/stream/functions stream-get-options.xml stream-select.xml

[Sara Golemon]

pollita Fri Jan  3 13:55:46 2003 EDT

  Added files: 
/phpdoc/en/reference/stream/functions   stream-get-options.xml 
stream-select.xml 
  Log:
  New documentation.
  
  

Index: phpdoc/en/reference/stream/functions/stream-get-options.xml
+++ phpdoc/en/reference/stream/functions/stream-get-options.xml


  
   
stream_get_options
Retrieve options for a stream/wrapper/context 
   
   
Description
 
  boolstream_get_options
  
resourcestream|context
 

 Returns an array of options on the specified stream or context.

   
  



Index: phpdoc/en/reference/stream/functions/stream-select.xml
+++ phpdoc/en/reference/stream/functions/stream-select.xml


  
   
stream_select
Runs the equivalent of the select() system call on the given 
 arrays of streams with a timeout specified by tv_sec and tv_usec 
   
   
Description
 
  intstream_select
  resource&read
  resource&write
  
resource&except
  inttv_sec
  inttv_usec
 

 The stream_select function accepts arrays of streams and
 waits for them to change status. Its opperation is equivalent to that of
 the socket_select function except in that it acts on streams.


 The streams listed in the read array will be watched to
 see if characters become available for reading (more precisely, to see if
 a read will not block - in particular, a stream resource is also ready on
 end-of-file, in which case an fread will return
 a zero length string).


 The streams listed in the write array will be
 watched to see if a write will not block.


 The streams listed in the except array will be
 watched for exceptions.


 
  On exit, the arrays are modified to indicate which stream resource
  actually changed status.
 


 You do not need to pass every array to
 stream_select. You can leave it out and use an
 empty array or &null; instead. Also do not forget that those arrays are
 passed by reference and will be modified after
 stream_select returns.


 Example:
 

 


 
  Due a limitation in the current Zend Engine it is not possible to pass a
  constant modifier like &null; directly as a parameter to a function
  which expects this parameter to be passed by reference. Instead use a
  temporary variable or an expression with the leftmost member being a
  temporary variable:
  

 
 


 The tv_sec and tv_usec
 together form the timeout parameter. The
 timeout is an upper bound on the amount of time
 elapsed before stream_select returns.
 tv_sec may be zero , causing
 stream_select to return immediately. This is useful
 for polling. If tv_sec is &null; (no timeout),
 stream_select can block indefinitely.


 On success stream_select returns the number of
 stream resorces contained in the modified arrays, which may be zero if
 the timeout expires before anything interesting happens. On error &false;
 is returned.


 
 Be sure to use the === operator when checking for an
 error. Since the stream_select may return 0 the
 comparison with == would evaluate to &true;:
 

 
 


 
  Be aware that some stream implementations need to be handled very
  carefully. A few basic rules:
  
   

 You should always try to use stream_select
 without timeout. Your program should have nothing to do if there is
 no data available. Code that depends on timeouts is not usually
 portable and difficult to debug.

   
   

 If you read/write to a stream returned in the arrays be aware that
 they do not necessarily read/write the full amount of data you have
 requested. Be prepared to even only be able to read/write a single
 byte.

   
  
 


 See also
 stream_set_blocking

   
  





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

[PHP-DOC] cvs: phpdoc /en/reference/stream reference.xml

[Sara Golemon]

pollita Fri Jan  3 13:17:06 2003 EDT

  Modified files:  
/phpdoc/en/reference/stream reference.xml 
  Log:
  Added brief description of user defined filters, fixed CDATA endtag.
  
  
Index: phpdoc/en/reference/stream/reference.xml
diff -u phpdoc/en/reference/stream/reference.xml:1.2 
phpdoc/en/reference/stream/reference.xml:1.3
--- phpdoc/en/reference/stream/reference.xml:1.2Thu Jan  2 21:54:21 2003
+++ phpdoc/en/reference/stream/reference.xmlFri Jan  3 13:17:05 2003
@@ -1,5 +1,5 @@
 
-
+
  
   Stream functions
   Streams
@@ -21,6 +21,12 @@
  set limit on what can be done with them. See  
  for a listing of stream wrappers built into PHP.
 
+
+ In addition to streams, support for custom user filters is also available.
+ While a stream (such as 'http') is designed to communicate with an endpoint,
+ one or more filters can be placed between the stream and the application to
+ further process the data as it is read/written.
+
 
  A stream is referenced as: 
scheme://target
  
@@ -43,11 +49,6 @@
   
  
 
-
- Filters may also be applied to streams to further process data on its
- way into or out of a stream related call.  Documentation on this
- functionality is comming soon.
-

   

@@ -69,8 +70,17 @@

 

-&reftitle.resources;
-&no.resource;
+Stream Classes
+
+ User designed wrappers can be registered via 
+stream_register_wrapper,
+ using the class definition shown on that manual page.
+
+
+ class php_user_filter is predefined and is an abstract
+ baseclass for use with user defined filters.  See the manual page for
+ stream_register_filter for details on implementing
+ user defined filters.
+

 

@@ -107,7 +117,7 @@
 $ftpfile   = file_get_contents("ftp://user:[EMAIL PROTECTED]/foo.txt";);   // Read 
remote file from ftp.example.com using FTP 
 $ftpsfile  = file_get_contents("ftps://user:[EMAIL PROTECTED]/foo.txt");  // Read 
remote file from ftp.example.com using FTPS 
 ?>
-]]?>
+]]>
   
  
 



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

Re: [PHP-DOC] Re: #18293 - mkdir()

[Steph]

> Is someone here using PHP under MSWindows? I
> personally am lucky and do not need to use that OS at
> work or home.

I'm unlucky and use it,  BUT I've already been through this when I was
working on dir functions last year.  None of the permissions _can_ work
on doze so it doesn't really need testing.  Be aware that the 2nd
argument does need to be something sane, regardless.

 It comes to mind
> that no only chmod() and mkdir(), but umask() (and
> perhaps others) might benefit from the modes being
> included in the manual itself from one the sources
> people have pointed out.
>
I know the first time I came across file permissions I was totally
bewildered... but surely a link would do?


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

[PHP-DOC] cvs: phpdoc /en/reference/http/functions header.xml

[Maciek Sokolewicz]

tularis Fri Jan  3 11:05:17 2003 EDT

  Modified files:  
/phpdoc/en/reference/http/functions header.xml 
  Log:
   updated the *fix* so it better suits the purpose
  
  
Index: phpdoc/en/reference/http/functions/header.xml
diff -u phpdoc/en/reference/http/functions/header.xml:1.9 
phpdoc/en/reference/http/functions/header.xml:1.10
--- phpdoc/en/reference/http/functions/header.xml:1.9   Fri Jan  3 10:28:42 2003
+++ phpdoc/en/reference/http/functions/header.xml   Fri Jan  3 11:05:16 2003
@@ -1,5 +1,5 @@
 
-
+
 
   

@@ -172,9 +172,10 @@
  
   
 
   



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

Re: [PHP-DOC] cvs: phpdoc /en/reference/http/functions header.xml

[Derick Rethans]

On Fri, 3 Jan 2003, Maciek Sokolewicz wrote:

> tularis   Fri Jan  3 10:28:42 2003 EDT
> 
>   Modified files:  
> /phpdoc/en/reference/http/functions   header.xml 
>   Log:
>Fixed bug id #21391

hmm, a much better fix would be:



like goba showed in the email as the point was that outputting HTML is a 
problem when you use headers.

Derick

-- 

-
 Derick Rethans http://derickrethans.nl/ 
 PHP Magazine - PHP Magazine for Professionals   http://php-mag.net/
-


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

[PHP-DOC] #21391 [Asn->Csd]: header page example bogus

[tularis]

 ID:   21391
 Updated by:   [EMAIL PROTECTED]
 Reported By:  [EMAIL PROTECTED]
-Status:   Assigned
+Status:   Closed
 Bug Type: Documentation problem
 Operating System: n/a
 PHP Version:  4.3.0
 Assigned To:  tularis
 New Comment:

This bug has been fixed in CVS.

In case this was a PHP problem, snapshots of the sources are packaged
every three hours; this change will be in the next snapshot. You can
grab the snapshot at http://snaps.php.net/.
 
In case this was a documentation problem, the fix will show up soon at
http://www.php.net/manual/.

In case this was a PHP.net website problem, the change will show
up on the PHP.net site and on the mirror sites in short time.
 
Thank you for the report, and for helping us make PHP better.

because it seems that empty lines before http://php.net/header:

| 
| // Broken, note the blank line above

Is bogus, because whitespace before and after examples is stripped off,
so the example should be modified to have a different error case
presented.

Ie:

| 
| http://www.example.com/";); ?>
| // Broken, note the script output above

I cannot do this myself now...




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


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

[PHP-DOC] cvs: phpdoc /en/reference/http/functions header.xml

[Maciek Sokolewicz]

tularis Fri Jan  3 10:28:42 2003 EDT

  Modified files:  
/phpdoc/en/reference/http/functions header.xml 
  Log:
   Fixed bug id #21391
  
  
Index: phpdoc/en/reference/http/functions/header.xml
diff -u phpdoc/en/reference/http/functions/header.xml:1.8 
phpdoc/en/reference/http/functions/header.xml:1.9
--- phpdoc/en/reference/http/functions/header.xml:1.8   Wed Nov  6 13:34:39 2002
+++ phpdoc/en/reference/http/functions/header.xml   Fri Jan  3 10:28:42 2003
@@ -1,5 +1,5 @@
 
-
+
 
   

@@ -172,9 +172,10 @@
  
   
 
   
  



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

[PHP-DOC] #21391 [Opn->Asn]: header page example bogus

[tularis]

 ID:   21391
 Updated by:   [EMAIL PROTECTED]
 Reported By:  [EMAIL PROTECTED]
-Status:   Open
+Status:   Assigned
 Bug Type: Documentation problem
 Operating System: n/a
 PHP Version:  4.3.0
-Assigned To:  
+Assigned To:  tularis
 New Comment:

I agree that the example is a little bit faulty, but let me explain
what is ment there IMHO:

You should not send any output before the header() calls, blanc lines
before http://php.net/header:

| 
| // Broken, note the blank line above

Is bogus, because whitespace before and after examples is stripped off,
so the example should be modified to have a different error case
presented.

Ie:

| 
| http://www.example.com/";); ?>
| // Broken, note the script output above

I cannot do this myself now...




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


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

[PHP-DOC] #21391 [NEW]: header page example bogus

[goba]

From: [EMAIL PROTECTED]
Operating system: n/a
PHP version:  4.3.0
PHP Bug Type: Documentation problem
Bug description:  header page example bogus

The example on http://php.net/header:

| 
| // Broken, note the blank line above

Is bogus, because whitespace before and after examples is stripped off, so
the example should be modified to have a different error case presented.

Ie:

| 
| http://www.example.com/";); ?>
| // Broken, note the script output above

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


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

Re: [PHP-DOC] Re: #18293 - mkdir()

[Michael Mauch]

Gabor Hojtsy <[EMAIL PROTECTED]> wrote:
>> >> 0777 is fine for WIN32.
>> > 
>> > Well, this is not too scientific. The user notes indicate on that
>> > page, that the read/write permissions can actually be set...
>> 
>> Which user note is that? I can't find one saying that the permissions
>> work on Win32. And in virtual_mkdir() in tsrm_virtual_cwd.c I see:
>> 
>> #ifdef TSRM_WIN32
>> retval = mkdir(new_state.cwd);
>> #else
>> retval = mkdir(new_state.cwd, mode);
>> #endif
>> 
>> So perhaps the manual should state that the second parameter of PHP's
>> mkdir is ignored on Win32?
>> 
>> To open another can of worms: the chmod manual page is also not very
>> specific about the modes - and as I understand, you can have at least
>> read-only files on Windows.
> 
> First of all, I must admit I never checked anything different than 0777
> on windows ;)

If you still have access to a Windows box with PHP, can you test some
other cases?

> There is more than one user note stating that the permissions work on
> some level though. One example:
> 
> | It does work on Windows. 
> | I use Win 98 with the Sambar Server. 
> | The only chmods allowed are the 775 and 666 mod. 775 for non-writeable
> | and 666 for writeable. The only thing is that the usergroups doesn't
> | work. 

Umm, that's on the chmod page, not on the mkdir page. I was refering to
the mkdir function; sorry if that wasn't clear enough.

> The number examples are pretty dumb, but the user says it worked for
> him... BTW if the code says, it is ignored on windows, then it should
> be documented as is, and the notes should be removed. It is possible
> that it was supported in a previous version of PHP maybe...

For chmod it is not ignored - only for mkdir (but yes, it should be
documented there).

Giving Windows developers a chance to not let their scripts break on
Unix is a good thing, but first of all it should be documented how they
can use these modes on their own platform, I guess.

Regards...
Michael

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

Re: [PHP-DOC] Re: #18293 - mkdir()

[Jesus M. Castagnetto]

Is someone here using PHP under MSWindows? I
personally am lucky and do not need to use that OS at
work or home.

Basically and script that tests each possible
permisiong combination is doable. It comes to mind
that no only chmod() and mkdir(), but umask() (and
perhaps others) might benefit from the modes being
included in the manual itself from one the sources
people have pointed out.

Volunteers? ;-)

--- Gabor Hojtsy <[EMAIL PROTECTED]> wrote:
> > >> 0777 is fine for WIN32.
> > > 
> > > Well, this is not too scientific. The user notes
> indicate on that
> > > page, that the read/write permissions can
> actually be set...
> > 
> > Which user note is that? I can't find one saying
> that the permissions
> > work on Win32. And in virtual_mkdir() in
> tsrm_virtual_cwd.c I see:
> > 
> > #ifdef TSRM_WIN32
> > retval = mkdir(new_state.cwd);
> > #else
> > retval = mkdir(new_state.cwd, mode);
> > #endif
> > 
> > So perhaps the manual should state that the second
> parameter of PHP's
> > mkdir is ignored on Win32?
> > 
> > To open another can of worms: the chmod manual
> page is also not very
> > specific about the modes - and as I understand,
> you can have at least
> > read-only files on Windows.
> 
> First of all, I must admit I never checked anything
> different than 0777
> on windows ;)
> 
> There is more than one user note stating that the
> permissions work on
> some level though. One example:
> 
> | It does work on Windows. 
> | I use Win 98 with the Sambar Server. 
> | The only chmods allowed are the 775 and 666 mod.
> 775 for non-writeable
> | and 666 for writeable. The only thing is that the
> usergroups doesn't
> | work. 
> 
> The number examples are pretty dumb, but the user
> says it worked for
> him... BTW if the code says, it is ignored on
> windows, then it should
> be documented as is, and the notes should be
> removed. It is possible
> that it was supported in a previous version of PHP
> maybe...
> 
> Goba
> 
> 
> -- 
> PHP Documentation Mailing List (http://www.php.net/)
> To unsubscribe, visit: http://www.php.net/unsub.php
> 


=
--- Jesus M. Castagnetto <[EMAIL PROTECTED]>

__
Do you Yahoo!?
Yahoo! Mail Plus - Powerful. Affordable. Sign up now.
http://mailplus.yahoo.com

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

Re: [PHP-DOC] Re: #18293 - mkdir()

[Gabor Hojtsy]

> >> 0777 is fine for WIN32.
> > 
> > Well, this is not too scientific. The user notes indicate on that
> > page, that the read/write permissions can actually be set...
> 
> Which user note is that? I can't find one saying that the permissions
> work on Win32. And in virtual_mkdir() in tsrm_virtual_cwd.c I see:
> 
> #ifdef TSRM_WIN32
> retval = mkdir(new_state.cwd);
> #else
> retval = mkdir(new_state.cwd, mode);
> #endif
> 
> So perhaps the manual should state that the second parameter of PHP's
> mkdir is ignored on Win32?
> 
> To open another can of worms: the chmod manual page is also not very
> specific about the modes - and as I understand, you can have at least
> read-only files on Windows.

First of all, I must admit I never checked anything different than 0777
on windows ;)

There is more than one user note stating that the permissions work on
some level though. One example:

| It does work on Windows. 
| I use Win 98 with the Sambar Server. 
| The only chmods allowed are the 775 and 666 mod. 775 for non-writeable
| and 666 for writeable. The only thing is that the usergroups doesn't
| work. 

The number examples are pretty dumb, but the user says it worked for
him... BTW if the code says, it is ignored on windows, then it should
be documented as is, and the notes should be removed. It is possible
that it was supported in a previous version of PHP maybe...

Goba


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

[PHP-DOC] #21388 [Fbk]: [chm] bug on streams.php-stream-open-wrapper-ex.html

[tularis]

 ID:   21388
 Updated by:   [EMAIL PROTECTED]
 Reported By:  [EMAIL PROTECTED]
 Status:   Feedback
 Bug Type: Documentation problem
 Operating System: windows
 PHP Version:  4.3.0
 New Comment:

ignore my last message... it's a mistake!


Previous Comments:


[2003-01-03 07:23:38] [EMAIL PROTECTED]

Thank you for this bug report. To properly diagnose the problem, we
need a backtrace to see what is happening behind the scenes. To
find out how to generate a backtrace, please read
http://bugs.php.net/bugs-generating-backtrace.php

Once you have generated a backtrace, please submit it to this bug
report and change the status back to "Open". Thank you for helping
us make PHP better.



[2003-01-03 07:15:28] [EMAIL PROTECTED]

Manual description: "php_stream_open_wrapper_ex() is exactly like
php_stream_open_wrapper(), but allows you to specify a
php_stream_context object using context. To find out more about stream
contexts, see XXX"

Ok, now I see that "XXX" is a number in manual's Function Reference. It
looks pretty wired for me for a first time. Any other Roman number is
ok, but XXX looks like "thing that should be filled in later" . 

Thing for discussion : 
Shouldn't it be a link to the XXX part of manual ? 
Or instead of "see XXX" -> "see XXX part of Function Reference" ? 

BTW. PHP manual is a great job :)



[2003-01-03 06:57:30] [EMAIL PROTECTED]

I am afraid I cannot see the point. What is the bug?



[2003-01-03 06:15:22] [EMAIL PROTECTED]

I have found a bug on page streams.php-stream-open-wrapper-ex.html
which is : 
To find out more about stream contexts, see XXX 
[chm date: 2002-12-27]...





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


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

Re: [PHP-DOC] Re: #18293 - mkdir()

[Michael Mauch]

Gabor Hojtsy <[EMAIL PROTECTED]> wrote:
>> 0777 is fine for WIN32.
> 
> Well, this is not too scientific. The user notes indicate on that
> page, that the read/write permissions can actually be set...

Which user note is that? I can't find one saying that the permissions
work on Win32. And in virtual_mkdir() in tsrm_virtual_cwd.c I see:

#ifdef TSRM_WIN32
retval = mkdir(new_state.cwd);
#else
retval = mkdir(new_state.cwd, mode);
#endif

So perhaps the manual should state that the second parameter of PHP's
mkdir is ignored on Win32?

To open another can of worms: the chmod manual page is also not very
specific about the modes - and as I understand, you can have at least
read-only files on Windows.

Regards...
Michael

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

[PHP-DOC] #21388 [Opn->Fbk]: [chm] bug on streams.php-stream-open-wrapper-ex.html

[tularis]

 ID:   21388
 Updated by:   [EMAIL PROTECTED]
 Reported By:  [EMAIL PROTECTED]
-Status:   Open
+Status:   Feedback
 Bug Type: Documentation problem
 Operating System: windows
 PHP Version:  4.3.0
 New Comment:

Thank you for this bug report. To properly diagnose the problem, we
need a backtrace to see what is happening behind the scenes. To
find out how to generate a backtrace, please read
http://bugs.php.net/bugs-generating-backtrace.php

Once you have generated a backtrace, please submit it to this bug
report and change the status back to "Open". Thank you for helping
us make PHP better.


Previous Comments:


[2003-01-03 07:15:28] [EMAIL PROTECTED]

Manual description: "php_stream_open_wrapper_ex() is exactly like
php_stream_open_wrapper(), but allows you to specify a
php_stream_context object using context. To find out more about stream
contexts, see XXX"

Ok, now I see that "XXX" is a number in manual's Function Reference. It
looks pretty wired for me for a first time. Any other Roman number is
ok, but XXX looks like "thing that should be filled in later" . 

Thing for discussion : 
Shouldn't it be a link to the XXX part of manual ? 
Or instead of "see XXX" -> "see XXX part of Function Reference" ? 

BTW. PHP manual is a great job :)



[2003-01-03 06:57:30] [EMAIL PROTECTED]

I am afraid I cannot see the point. What is the bug?



[2003-01-03 06:15:22] [EMAIL PROTECTED]

I have found a bug on page streams.php-stream-open-wrapper-ex.html
which is : 
To find out more about stream contexts, see XXX 
[chm date: 2002-12-27]...





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


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

[PHP-DOC] #21388 [Fbk->Opn]: [chm] bug on streams.php-stream-open-wrapper-ex.html

[quest]

 ID:   21388
 User updated by:  [EMAIL PROTECTED]
 Reported By:  [EMAIL PROTECTED]
-Status:   Feedback
+Status:   Open
 Bug Type: Documentation problem
 Operating System: windows
 PHP Version:  4.3.0
 New Comment:

Manual description: "php_stream_open_wrapper_ex() is exactly like
php_stream_open_wrapper(), but allows you to specify a
php_stream_context object using context. To find out more about stream
contexts, see XXX"

Ok, now I see that "XXX" is a number in manual's Function Reference. It
looks pretty wired for me for a first time. Any other Roman number is
ok, but XXX looks like "thing that should be filled in later" . 

Thing for discussion : 
Shouldn't it be a link to the XXX part of manual ? 
Or instead of "see XXX" -> "see XXX part of Function Reference" ? 

BTW. PHP manual is a great job :)


Previous Comments:


[2003-01-03 06:57:30] [EMAIL PROTECTED]

I am afraid I cannot see the point. What is the bug?



[2003-01-03 06:15:22] [EMAIL PROTECTED]

I have found a bug on page streams.php-stream-open-wrapper-ex.html
which is : 
To find out more about stream contexts, see XXX 
[chm date: 2002-12-27]...





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


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

Re: [PHP-DOC] Re: #18293 - mkdir()

[Gabor Hojtsy]

> 0777 is fine for WIN32.

Well, this is not too scientific. The user notes indicate on that
page, that the read/write permissions can actually be set...

Goba


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

[PHP-DOC] #21388 [Opn->Fbk]: [chm] bug on streams.php-stream-open-wrapper-ex.html

[goba]

 ID:   21388
 Updated by:   [EMAIL PROTECTED]
 Reported By:  [EMAIL PROTECTED]
-Status:   Open
+Status:   Feedback
 Bug Type: Documentation problem
 Operating System: windows
 PHP Version:  4.3.0
 New Comment:

I am afraid I cannot see the point. What is the bug?


Previous Comments:


[2003-01-03 06:15:22] [EMAIL PROTECTED]

I have found a bug on page streams.php-stream-open-wrapper-ex.html
which is : 
To find out more about stream contexts, see XXX 
[chm date: 2002-12-27]...





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


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

Re: [PHP-DOC] Re: #18293 - mkdir()

[nicos]

0777 is fine for WIN32.

Regards.
M.CHAILLAN Nicolas
[EMAIL PROTECTED]
www.WorldAKT.com Hébergement de sites internets.

- Original Message -
From: "Gabor Hojtsy" <[EMAIL PROTECTED]>
To: "Michael Mauch" <[EMAIL PROTECTED]>; <[EMAIL PROTECTED]>;
<[EMAIL PROTECTED]>
Sent: Friday, January 03, 2003 12:38 PM
Subject: Re: [PHP-DOC] Re: #18293 - mkdir()


> > >The user wants to add to
> > > http://www.php.net/manual/en/function.mkdir.php some informations
about
> the
> > > second argument of mkdir() which is unix mode. Where should we point
> him? It
> > > would be nice if someone adds a link or a nice description in the
> > > documentation.
> >
> >
>
 FreeBSD+5.0-current>
> > or
>
 FreeBSD+5.0-current&format=html>
> > perhaps?
> >
> > But I don't know which of these modes are applicable to which Windows
> > versions. Users of Unix and the like can of course be referred to their
> > man pages.
>
> The problem is:
>
>  1. No modes are applicable to any windows versions AFAIK.
>  2. But programmers on windows do develop scripts which should
> work on linux or unix OSes.
>  3. That parameter is needed even on windows...
>
> => They need to have information on what to write in there.
>
> Goba
>


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

[PHP-DOC] #21388 [NEW]: [chm] bug on streams.php-stream-open-wrapper-ex.html

[quest]

From: [EMAIL PROTECTED]
Operating system: windows
PHP version:  4.3.0
PHP Bug Type: Documentation problem
Bug description:  [chm] bug on streams.php-stream-open-wrapper-ex.html

I have found a bug on page streams.php-stream-open-wrapper-ex.html which is
: 
To find out more about stream contexts, see XXX 
[chm date: 2002-12-27]...

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


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

Re: [PHP-DOC] Re: #18293 - mkdir()

[Gabor Hojtsy]

> >The user wants to add to
> > http://www.php.net/manual/en/function.mkdir.php some informations about
the
> > second argument of mkdir() which is unix mode. Where should we point
him? It
> > would be nice if someone adds a link or a nice description in the
> > documentation.
>
>

> or

> perhaps?
>
> But I don't know which of these modes are applicable to which Windows
> versions. Users of Unix and the like can of course be referred to their
> man pages.

The problem is:

 1. No modes are applicable to any windows versions AFAIK.
 2. But programmers on windows do develop scripts which should
work on linux or unix OSes.
 3. That parameter is needed even on windows...

=> They need to have information on what to write in there.

Goba


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

[PHP-DOC] Re: #18293 - mkdir()

[Michael Mauch]

[EMAIL PROTECTED] wrote:

>The user wants to add to
> http://www.php.net/manual/en/function.mkdir.php some informations about the
> second argument of mkdir() which is unix mode. Where should we point him? It
> would be nice if someone adds a link or a nice description in the
> documentation.


or 

perhaps?

But I don't know which of these modes are applicable to which Windows
versions. Users of Unix and the like can of course be referred to their
man pages.

Regards...
Michael

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

Re: [PHP-DOC] #18293 - mkdir()

[Gabor Hojtsy]

> Think also about Win32 users, they don't have man or info. We can't
give
> a such link too because it might be down... So we need an official link or
> somethink that we can copy *in* the manual.

Look around at http://www.tldp.org/ This is the official "The Linux
Documentation
Project" homepage, so it should not be down ;)

Goba


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

[PHP-DOC] cvs: phpdoc /en/reference/mcrypt reference.xml

[Sander Roobol]

sander  Fri Jan  3 06:11:52 2003 EDT

  Modified files:  
/phpdoc/en/reference/mcrypt reference.xml 
  Log:
  mcrypt is now available on windows too
  
  
Index: phpdoc/en/reference/mcrypt/reference.xml
diff -u phpdoc/en/reference/mcrypt/reference.xml:1.10 
phpdoc/en/reference/mcrypt/reference.xml:1.11
--- phpdoc/en/reference/mcrypt/reference.xml:1.10   Mon Dec 30 13:55:52 2002
+++ phpdoc/en/reference/mcrypt/reference.xmlFri Jan  3 06:11:52 2003
@@ -1,5 +1,5 @@
 
-
+
  
   Mcrypt Encryption Functions
   mcrypt
@@ -14,7 +14,6 @@
  GOST in CBC, OFB, CFB and ECB cipher modes. Additionally, it
  supports RC6 and IDEA which are considered "non-free".
 
-   ¬e.no-windows.extension;

 




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

[PHP-DOC] #21383 [Opn->Csd]: Undocumented configure feature for win32

[nicos]

 ID:   21383
 Updated by:   [EMAIL PROTECTED]
 Reported By:  [EMAIL PROTECTED]
-Status:   Open
+Status:   Closed
 Bug Type: Documentation problem
 Operating System: Any
 PHP Version:  4.3.0
 New Comment:

And it is documented already on the windows installation page.

Thank for your report.


Previous Comments:


[2003-01-03 03:36:53] [EMAIL PROTECTED]

This is only something for people who compile PHP themselves and not
really a user issue, though it probably can be documented on the
"Windows compiling" page.



[2003-01-03 03:35:27] [EMAIL PROTECTED]

In 4.3.0 release ànnouncements I've found following:
"The Windows build can now be configured more comfortably, for example
when dealing with built-in extensions. (Sebastian) "

but I did not found any reference to this in the manual...




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


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

Re: [PHP-DOC] #18293 - mkdir()

[nicos]

Hello,

Think also about Win32 users, they don't have man or info. We can't give
a such link too because it might be down... So we need an official link or
somethink that we can copy *in* the manual.

Regards.
M.CHAILLAN Nicolas
[EMAIL PROTECTED]
www.WorldAKT.com Hébergement de sites internets.

- Original Message -
From: "Jesus M. Castagnetto" <[EMAIL PROTECTED]>
To: <[EMAIL PROTECTED]>; <[EMAIL PROTECTED]>
Sent: Friday, January 03, 2003 10:03 AM
Subject: Re: [PHP-DOC] #18293 - mkdir()


> My first guess will be to ask the user to do:
>
> man chmod
>
> or
>
> info chmod
>
> Otherwise a link from Google I just found:
>
> http://www.computerhope.com/unix/uchmod.htm
>
> But maybe someone (nicos?) can add this info the the
> manual (if it is not there for a related function
> already)
>
>
>
> --- [EMAIL PROTECTED] wrote:
> > Hello,
> >
> > The user wants to add to
> > http://www.php.net/manual/en/function.mkdir.php some
> > informations about the
> > second argument of mkdir() which is unix mode. Where
> > should we point him? It
> > would be nice if someone adds a link or a nice
> > description in the
> > documentation.
> >
> > Thank you for your comments.
> >
> > --
> > Regards.
> > M.CHAILLAN Nicolas
> > [EMAIL PROTECTED]
> > www.WorldAKT.com Hébergement de sites internets.
> >
> >
> >
> >
> > --
> > PHP Documentation Mailing List (http://www.php.net/)
> > To unsubscribe, visit: http://www.php.net/unsub.php
> >
>
>
> =
> --- Jesus M. Castagnetto <[EMAIL PROTECTED]>
>
> __
> Do you Yahoo!?
> Yahoo! Mail Plus - Powerful. Affordable. Sign up now.
> http://mailplus.yahoo.com


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

[PHP-DOC] #21383 [Opn]: Undocumented configure feature for win32

[derick]

 ID:   21383
 Updated by:   [EMAIL PROTECTED]
 Reported By:  [EMAIL PROTECTED]
 Status:   Open
 Bug Type: Documentation problem
 Operating System: Any
 PHP Version:  4.3.0
 New Comment:

This is only something for people who compile PHP themselves and not
really a user issue, though it probably can be documented on the
"Windows compiling" page.


Previous Comments:


[2003-01-03 03:35:27] [EMAIL PROTECTED]

In 4.3.0 release ànnouncements I've found following:
"The Windows build can now be configured more comfortably, for example
when dealing with built-in extensions. (Sebastian) "

but I did not found any reference to this in the manual...




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


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

[PHP-DOC] #21383 [NEW]: Undocumented configure feature for win32

[r16]

From: [EMAIL PROTECTED]
Operating system: Any
PHP version:  4.3.0
PHP Bug Type: Documentation problem
Bug description:  Undocumented configure feature for win32

In 4.3.0 release ànnouncements I've found following:
"The Windows build can now be configured more comfortably, for example
when dealing with built-in extensions. (Sebastian) "

but I did not found any reference to this in the manual...
-- 
Edit bug report at http://bugs.php.net/?id=21383&edit=1
-- 
Try a CVS snapshot: http://bugs.php.net/fix.php?id=21383&r=trysnapshot
Fixed in CVS:   http://bugs.php.net/fix.php?id=21383&r=fixedcvs
Fixed in release:   http://bugs.php.net/fix.php?id=21383&r=alreadyfixed
Need backtrace: http://bugs.php.net/fix.php?id=21383&r=needtrace
Try newer version:  http://bugs.php.net/fix.php?id=21383&r=oldversion
Not developer issue:http://bugs.php.net/fix.php?id=21383&r=support
Expected behavior:  http://bugs.php.net/fix.php?id=21383&r=notwrong
Not enough info:http://bugs.php.net/fix.php?id=21383&r=notenoughinfo
Submitted twice:http://bugs.php.net/fix.php?id=21383&r=submittedtwice
register_globals:   http://bugs.php.net/fix.php?id=21383&r=globals
PHP 3 support discontinued: http://bugs.php.net/fix.php?id=21383&r=php3
Daylight Savings:   http://bugs.php.net/fix.php?id=21383&r=dst
IIS Stability:  http://bugs.php.net/fix.php?id=21383&r=isapi
Install GNU Sed:http://bugs.php.net/fix.php?id=21383&r=gnused


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

Re: [PHP-DOC] #18293 - mkdir()

[Jesus M. Castagnetto]

My first guess will be to ask the user to do:

man chmod

or 

info chmod

Otherwise a link from Google I just found:

http://www.computerhope.com/unix/uchmod.htm

But maybe someone (nicos?) can add this info the the
manual (if it is not there for a related function
already)



--- [EMAIL PROTECTED] wrote:
> Hello,
> 
> The user wants to add to
> http://www.php.net/manual/en/function.mkdir.php some
> informations about the
> second argument of mkdir() which is unix mode. Where
> should we point him? It
> would be nice if someone adds a link or a nice
> description in the
> documentation.
> 
> Thank you for your comments.
> 
> --
> Regards.
> M.CHAILLAN Nicolas
> [EMAIL PROTECTED]
> www.WorldAKT.com Hébergement de sites internets.
> 
> 
> 
> 
> -- 
> PHP Documentation Mailing List (http://www.php.net/)
> To unsubscribe, visit: http://www.php.net/unsub.php
> 


=
--- Jesus M. Castagnetto <[EMAIL PROTECTED]>

__
Do you Yahoo!?
Yahoo! Mail Plus - Powerful. Affordable. Sign up now.
http://mailplus.yahoo.com

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

[PHP-DOC] cvs: phpdoc /en/reference/stream/functions stream-get-wrappers.xml

[Sara Golemon]

pollita Fri Jan  3 03:16:39 2003 EDT

  Added files: 
/phpdoc/en/reference/stream/functions   stream-get-wrappers.xml 
  Log:
  New function.
  
  

Index: phpdoc/en/reference/stream/functions/stream-get-wrappers.xml
+++ phpdoc/en/reference/stream/functions/stream-get-wrappers.xml


  
   
stream_get_wrappers
Retrieve list of registered streams 
   
   
Description
 
  arraystream_get_wrappers
  
 

 Returns an indexed array containing the name of all stream wrappers
 available on the running system.


 See Also:
 stream_register_wrapper

   
  





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