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

[Maciek Sokolewicz]

On 12-09-2012 03:54, Sherif Ramadan wrote:

Just an update I've pushed the new commits to github and fixed a
couple of issues in the backend scripts (patch attached here). The
javascript for the user notes stuff was moved to a separate file,
it'll be better for caching in the UA this way, and removes a lot of
the inline code from the PHP. I also fixed some of the CSS issues with
the ?beta=1 version of the site. Although the JS is bit quirky there
atm. Working on that, but that's really due to the way the CSS is done
there. Still needs tweaking (but it's not like we advertise that part
as working now anyway).

https://github.com/php/web-php/pull/7

If anyone finds any other issues I missed please let me know.

Thanks :)



It might not be advertised as working, but it's still used by a lot of 
people (mainly those involved in the PHP Project somehow!) so if you can 
choose not to break it in the first place: just don't break it! ;)


As for the additions to the system; I've finally had some time to review 
what you've added and I think it looks ok. Personally there are only 2 
small things I'd change in the interface:
1. Don't have the popup window "slide" out, I hate that animation (but 
that's a personal thing I guess). Just have it pop up, that's more than 
enough; there's no reason to have to wait till it finishes appearing 
once clicked (and yes, I do know it's pretty fast. Like I said, it's a 
personal thing).
2. Change the input field for the reason why a note is reported from 
input to textarea. Many people often like to give more than 2 words of 
reasoning. Even if they only want to explain it in 2 words, they then 
still can. But it makes it easier to read.


Other than that, I like the interface. I also the think the whole idea 
is ok. Not too sure of the usefulness of voting down and reporting at 
the same time, as Magnus also mentioned, but I guess we could have a 
pilot for that of a kind. Keep it for say 6 months and see if it has any 
(positive) effect. If it doesn't, we can remove it; otherwise we'll know 
it's good.


- Tul

Re: [PHP-DOC] SVN Account Request: noxi

[Maciek Sokolewicz]

On 22-06-2012 10:23, Hannes Magnusson wrote:

Into which language?

-Hannes

On Fri, Jun 22, 2012 at 1:09 AM, Patrick Kleinschmidt
  wrote:

to help translating the docs, I forgot writing this in my application...

Am 22.06.2012 00:18 schrieb "Hannes Magnusson":


On Tue, May 8, 2012 at 12:55 PM, Patrick Kleinschmidt
  wrote:

"nikic" suggested me to request an account here



For what?

-Hannes





Judging by his last name and mail address, I would guess German.

- Tul

[PHP-DOC] Re: Patch files: isCopyrighted and isProtectionEnabled

[Maciek Sokolewicz]

I have committed your patch, thank you.

On 24-03-2012 21:13, Jesús Ruiz García wrote:

Thanks for your response and your help, Maciek Sokolewicz.

Attached both patches fixed.

I have made ​​the change I've indicated. Although not if I managed to do
correctly.
Check this and tell me if is OK or not.

A greeting.

El 24 de marzo de 2012 19:24, Maciek Sokolewicz
mailto:maciek.sokolew...@gmail.com>> escribió:

On 24-03-2012 13 :43, Jesús Ruiz García wrote:

I forgot to send these as patches in the editor.

Sorry and thanks.


I can commit these patches for you, however I want to modify them
slightly, since they are not in correct english (in isProtected it
should either say "mechanisms are" or "mechanism is" instead of a
combination of both; and in both it should say "an MPEG file"
instead of "a MPEG file"). Unfortunately, I can only choose to
commit or reject the patch, and not to validate it so I can alter
the patch before committing.

All these "only a global or language admin can do that"-errors are
starting to annoy me. Perhaps I could just be added to the English
language admins list? Or all such "bugs" (which IMO they are) could
be resolved? Though I think that will be hard since noone seems to
know exactly who should be able to do what, when...

[PHP-DOC] Re: Patch files: isCopyrighted and isProtectionEnabled

[Maciek Sokolewicz]

On 24-03-2012 13:43, Jesús Ruiz García wrote:

I forgot to send these as patches in the editor.

Sorry and thanks.


I can commit these patches for you, however I want to modify them 
slightly, since they are not in correct english (in isProtected it 
should either say "mechanisms are" or "mechanism is" instead of a 
combination of both; and in both it should say "an MPEG file" instead of 
"a MPEG file"). Unfortunately, I can only choose to commit or reject the 
patch, and not to validate it so I can alter the patch before committing.


All these "only a global or language admin can do that"-errors are 
starting to annoy me. Perhaps I could just be added to the English 
language admins list? Or all such "bugs" (which IMO they are) could be 
resolved? Though I think that will be hard since noone seems to know 
exactly who should be able to do what, when...

Re: [PHP-DOC] About note maintenance; when to delete notes.

[Maciek Sokolewicz]

On 15-03-2012 18:10, Jesus M. Castagnetto wrote:

If memory serves, at some point there were places that hosted code
snippets. How about, and this is a pie-in-th-sky idea, if we offer
something like that, a community-ranked collection of snippets, that may
be associated to one or more manual pages. Not sure if it is needed,
useful or relevant or cost-effective (in terms of the effort that needs
to be put to build and maintain the thing), but it might be a way to
offload all those examples that now hang ungainly from the manual.


I think that's an excelent idea! We could possibly implement is as a 
separate examples page, or a direct link to "real-world usage" or 
something like that?


- Tul

Re: [PHP-DOC] About note maintenance; when to delete notes.

[Maciek Sokolewicz]

On 11 March 2012 02:40, Jesus M. Castagnetto  wrote:

> Sorry to come so late in this discussion. But there are guidelines for
> more than a decade on how to handle notes:
>
>http://doc.php.net/php/dochowto/chapter-user-notes.php
>
> Just in case you did not see it:
>
> User Note Editing Guidelines
>
> These are some guidelines to follow when editing user notes in the manual.
>
> To begin editing user notes in the manual, you must have SVN commit access
> to the manual, and you must either:
> Subscribe to the *php-notes* mailing list or newsgroup as described at Mailing
> Lists, Newsgroups and SVN 
> Modules.
> As a user submits a new user note, it will appear as a message on the
> mailing list with links in the footer of the email that enable you to
> delete, edit, or reject that particular note.
> Log on to the server at » 
> http://master.php.net/manage/user-notes.php
>  using
> your SVN user ID and password. The user notes administration interface
> enables you to search for user notes that match particular strings and edit
> or change the status of particular notes directly through the Web interface.
>
> The thing that seems to confuse the most people is the difference between
> 'rejecting' and 'deleting' a note. Basically, they both remove the note
> from the manual, but 'rejecting' sends the user an email about the
> rejection with links to support links and other information. Here are some
> guidelines of when to use each. This section is mostly an edited version of
> Jesus M. Castagnetto's email, with a few additions and re-phrases. The code
> for managing user notes can be seen here: »
> http://svn.php.net/viewvc/web/php-master/trunk/manage/user-notes.php.
> You can also view the exact text of the rejection email there.
>
>
>- If the note is asking for help (support request, 'Does this
>   work...?', etc.) or if the person is reporting a bug, 'reject' the note.
>   The email will show them the proper place to report such issues.
>   - If the note contains useful information appropriate for the
>   manual proper, you may incorporate the information into the manual and 
> then
>   'delete' the note.
>   - If the note is in the wrong place, incorrect, a giant block of
>   silly, unnecessary code, poorly written, an answer to another person's
>   question, or just overall confusing, 'delete' it. If it was an answer 
> to a
>   question, hunt down that note and 'reject' it.
>   - If the note is in a language other than English, 'delete' the
>   note.
>   - If the note submitter's email address is obviously bogus, don't
>   'reject' the note, just 'delete' it. Rejecting the note just gives the 
> mail
>   server more work trying to send an email to a non-existent address, 
> which
>   doesn't help anything.
>
> If for some reason you need to add to a note, first ask yourself if it's
> worth it. Make sure you're not answering a user's question; if you are,
> then the note doesn't belong there (see above). If you're clarifying a
> point, see if it is appropriate to add the clarification to the manual
> proper; if it is, add it and 'delete' the note (see above). If you still
> feel that adding your addition to the note will be the best option, then go
> ahead and add it. Usually, editors add their note in a "Editor's Note"
> block at the top. Unless you are correcting a minor error, make it obvious
> that you edited the note.
>
> If you have some free time and commit access to phpdoc, try going through
> some of the manual pages and adding some of the better notes into the
> documentation proper. Be sure to 'delete' these notes after they're
> implemented.
>
> If you are in doubt about what to do with a note, you may ask for help on
> the php-notes mailing list (or phpdoc, if what you're doing involves the
> documentation proper).
>
>
>
> Hi Jesus,

I know those guidelines exist, I even linked to them from my original post.
However, those guidelines aren't very complete. They give a very rough
overview, which I agree with completely. There are tons of notes however,
which fall somewhere in between the categories supplied in the guidelines.

What I'm mainly trying to say is that I personally think we don't need a
zillion examples of how to use a basic function to perform a specific task.
Most notes (these days) contain such code. Some are still quite general
(ie. people post an example of how preg_split can be used to limit a
sentence to a number of words), others are extremely specific (ie. I've
seen posts where people show a function to the amount of days between
carnival and easter) or possibly numerous with a little usefulnus, but
mainly a lot of cluttering (ie. people post date() monthnames in different
languages, spanish, russian, chinese, french, german, etc. There w

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

[Maciek Sokolewicz]

On 19-01-2012 20:16, Yannick Torrès wrote:

Hi Philip, Hannes,

About Git migration : how are we deal with the revcheck tag ? Is there a
link between SVN revision ID and futur Git revision ID ? Is there a
script to automatically update translation to include the right Git
revision ID into the revcheck tag ?

Best,
Yannick


I still don't see why we would need or even want to move phpdoc to Git. 
Git is very nice, if you have a lot of concurrent development running in 
various "branches" where you want to combine various versions of files 
together. In the case of phpdoc however, I think all that support is 
moot. Simply because we have an "old version" of documentation as it 
was, and every change added is the current, the best and the only 
up-to-date version. There is a very clear history of every file from 
before to now, which we even rely upon when checking if translated files 
are still up-to-date with the english version.


So please, could someone explain in plain english (or point me to an RFC 
that did so), why we should move phpdoc to git instead of keep it in SVN 
where it works more than fine (IMO).


- Tul

Re: [PHP-DOC] Re: File patch isOriginal.

[Maciek Sokolewicz]

Hi Yannick,

I've attached 2 patches with corrected english. I'm not sure how you 
build the js files, so I've only changed it in js/main.js. Though I did 
notice the same text (instead of the index? why???) is also used as the 
key in the translations, I did not update those (yet), though it should 
be trivial to do so.


The other patch (error_type) changes all mentions of "attribut" to 
"attribute" (with an -e at the end), these are only used in 
error_type.php and php/ToolsError.php, for both of which the patch 
should be valid.


Hope this helps in improving it a bit.

- Tul

On 29-02-2012 18:38, Yannick Torrès wrote:

Hi Jesús, Maciek,

@Jesús : Have you an SVN account to commit into phpdoc ? or have you
make this patch via an anonymous login (or Facebook/Googe account) ?

@Maciek : Could you file a bug report and indicate where you are not
able to commit the patch, and where you are able to commit it ?

About the bad english, sorry, but english isn't my native language. Tell
me by mail all sentence isn't correct and the correct sentence.

Best,
Yannick

2012/2/29 Jesús Ruiz García mailto:jesusruiz2...@gmail.com>>

Thanks for your workMaciek ;)

I really do not know how the patch works, so maybe the problem is
we're doing something wrong. If not, hopefully as you say a patch soon.

Regards and thanks for everything.


2012/2/29 Maciek Sokolewicz mailto:maciek.sokolew...@gmail.com>>

On 29-02-2012 16:54, Maciek Sokolewicz wrote:

On 28-02-2012 23:00, Jesús Ruiz García wrote:

Hello and thanks for reading this message.

I created a patch, because I think there is an error in the
documentation in the file: isOriginal, in the directory
reference/ktaglib/__audioproperties.
In the line  of isOriginal, indicates that
returns the
length of an MPEG file. Return the length of an MPEG
file is responsible
of getLenght.

I do not know if the patch, I have to send to this
address. Attached the
patch, if any of you want to review it.

A greeting and thanks.

Jesús Ruiz
jesusruiz2...@gmail.com <mailto:jesusruiz2...@gmail.com>
<mailto:jesusruiz2007@gmail.__com
<mailto:jesusruiz2...@gmail.com>>
jesusr...@php.net <mailto:jesusr...@php.net>
<mailto:jesusr...@php.net <mailto:jesusr...@php.net>>


I just tried to validate and apply this patch via
edit.php.net <http://edit.php.net>, but got
the message 'You can't change file's owner. You must be a global
administrator or an administrator for this lang.'

However, when checking the Patches for Review section, I can
select the
user jesusruiz and click commit patch. Which works fine.

So one of both is incorrect. I personally think I should be
able to
validate such a patch anyway, and if not, I would like to
request karma
to be able to :)

Anyway: the patch is committed. Thank you for supplying this
patch.


On a side note, trying to reject a patch, I get:
"The file you want to clear local change isn't own by you.
You can only do this action for yours files."

Now, obviously this is incorrect as well, and very likely
related to the above problem (not to mention the hideous english).

I'm actually thinking of going through the source for the editor
and correcting all such grammar and spelling mistakes, I find
them quite annoying to be honest. So expect a patch soon ;)





diff --git a/error_type.php b/error_type.php
index 952a804..78991c7 100644
--- a/error_type.php
+++ b/error_type.php
@@ -113,148 +113,148 @@ $tags = array(
 foreach ($tags as $tag => $label)
 {
 $error['nb' . $label . 'Tag']['head'] = $label . ' tag';
-$error['nb' . $label . 'Tag']['desc'] = 'Throw if the number of ' . 
$label . ' tags is different from english version.';
+$error['nb' . $label . 'Tag']['desc'] = 'Throw if the number of ' . 
$label . ' tags is different in the english version.';
 }
 
 $error['-No error-']['head'] = '- No errors -';
 $error['-No error-']['desc'] = 'There are no more errors in this file.';
 
-$error['attributXmlXlinkAppendix']['head'] = 'Appendix tag';
-$error['attributXmlXlinkAppendix']['desc'] = 'Th

Re: [PHP-DOC] Re: File patch isOriginal.

[Maciek Sokolewicz]

Hi Alex,

basically here's what I noticed:
Let me give you a (live) example:
1. I have en and nl karma
2. When I go to "Patches for review(0)" (where the 0 is incorrect, but
that's not the point right now)
3. I navigate down to 'guilhermeblanco', and right click on construct.xml
in the tree, I can choose "Commit". And it works
4. When I navigate to user 'ch', and right click on a patch in the tree, I
can NOT choose "commit" (why??)

Then in contrast:
when instead of choosing commit, I click "Edit file", I get a dialog which
shows me 3 options:
- Validate Patch
- Reject patch
- edit file

Whenever I click on validate or reject, I get told I don't have karma to
change the owner. However, I CAN commit the patch via the method I
mentioned earlier.

The thing is: I don't understand why I can't change the owner, but CAN
commit the patch.
I also don't understand why I can commit patches by some logged in users,
but not by others. Even though both patches are for the english tree.

- Tul

On 29 February 2012 19:51, Alexander Moskaliov  wrote:

> Seems strange.
>
> jesusruiz have es doc karma.
> In this case only es lang or global admins can see "Commit" menu on
> this user, user's patches, user's folders or user's files in "Patches
> for review".
>
> I will try check it deeply tomorrow.
> Please, Can you tell me on what directly "click commit patch" means in
> your case?
>
>
> With regards, Alexander Moskaliov
> ir...@irker.net
>
>
>
> 2012/2/29 Maciek Sokolewicz :
> >
> > I just tried to validate and apply this patch via edit.php.net, but got
> the
> > message 'You can't change file's owner. You must be a global
> administrator
> > or an administrator for this lang.'
> >
> > However, when checking the Patches for Review section, I can select the
> user
> > jesusruiz and click commit patch. Which works fine.
> >
> > So one of both is incorrect. I personally think I should be able to
> validate
> > such a patch anyway, and if not, I would like to request karma to be
> able to
> > :)
> >
> > Anyway: the patch is committed. Thank you for supplying this patch.
>

Re: [PHP-DOC] Re: File patch isOriginal.

[Maciek Sokolewicz]

Hey Yannick,

I'll add a bugreport in a minute.

About the english, I understand, and it's not a problem ;)
As soon as I figure out how the hell git works and how I can get the 
latest version of doc-editor, I'll send you a patch. I have one against 
the latest svn version, but that's outdated compared to the git version 
I guess.


On 29-02-2012 18:38, Yannick Torrès wrote:

Hi Jesús, Maciek,

@Jesús : Have you an SVN account to commit into phpdoc ? or have you
make this patch via an anonymous login (or Facebook/Googe account) ?

@Maciek : Could you file a bug report and indicate where you are not
able to commit the patch, and where you are able to commit it ?

About the bad english, sorry, but english isn't my native language. Tell
me by mail all sentence isn't correct and the correct sentence.

Best,
Yannick

2012/2/29 Jesús Ruiz García mailto:jesusruiz2...@gmail.com>>

Thanks for your workMaciek ;)

I really do not know how the patch works, so maybe the problem is
we're doing something wrong. If not, hopefully as you say a patch soon.

Regards and thanks for everything.


2012/2/29 Maciek Sokolewicz mailto:maciek.sokolew...@gmail.com>>

On 29-02-2012 16:54, Maciek Sokolewicz wrote:

On 28-02-2012 23:00, Jesús Ruiz García wrote:

Hello and thanks for reading this message.

I created a patch, because I think there is an error in the
documentation in the file: isOriginal, in the directory
reference/ktaglib/__audioproperties.
In the line  of isOriginal, indicates that
returns the
length of an MPEG file. Return the length of an MPEG
file is responsible
of getLenght.

I do not know if the patch, I have to send to this
address. Attached the
patch, if any of you want to review it.

A greeting and thanks.

Jesús Ruiz
jesusruiz2...@gmail.com <mailto:jesusruiz2...@gmail.com>
<mailto:jesusruiz2007@gmail.__com
<mailto:jesusruiz2...@gmail.com>>
jesusr...@php.net <mailto:jesusr...@php.net>
<mailto:jesusr...@php.net <mailto:jesusr...@php.net>>


I just tried to validate and apply this patch via
edit.php.net <http://edit.php.net>, but got
the message 'You can't change file's owner. You must be a global
administrator or an administrator for this lang.'

However, when checking the Patches for Review section, I can
select the
user jesusruiz and click commit patch. Which works fine.

So one of both is incorrect. I personally think I should be
able to
validate such a patch anyway, and if not, I would like to
request karma
to be able to :)

Anyway: the patch is committed. Thank you for supplying this
patch.


On a side note, trying to reject a patch, I get:
"The file you want to clear local change isn't own by you.
You can only do this action for yours files."

Now, obviously this is incorrect as well, and very likely
related to the above problem (not to mention the hideous english).

I'm actually thinking of going through the source for the editor
and correcting all such grammar and spelling mistakes, I find
them quite annoying to be honest. So expect a patch soon ;)

[PHP-DOC] Re: File patch isOriginal.

[Maciek Sokolewicz]

On 29-02-2012 16:54, Maciek Sokolewicz wrote:

On 28-02-2012 23:00, Jesús Ruiz García wrote:

Hello and thanks for reading this message.

I created a patch, because I think there is an error in the
documentation in the file: isOriginal, in the directory
reference/ktaglib/audioproperties.
In the line  of isOriginal, indicates that returns the
length of an MPEG file. Return the length of an MPEG file is responsible
of getLenght.

I do not know if the patch, I have to send to this address. Attached the
patch, if any of you want to review it.

A greeting and thanks.

Jesús Ruiz
jesusruiz2...@gmail.com <mailto:jesusruiz2...@gmail.com>
jesusr...@php.net <mailto:jesusr...@php.net>


I just tried to validate and apply this patch via edit.php.net, but got
the message 'You can't change file's owner. You must be a global
administrator or an administrator for this lang.'

However, when checking the Patches for Review section, I can select the
user jesusruiz and click commit patch. Which works fine.

So one of both is incorrect. I personally think I should be able to
validate such a patch anyway, and if not, I would like to request karma
to be able to :)

Anyway: the patch is committed. Thank you for supplying this patch.


On a side note, trying to reject a patch, I get:
"The file you want to clear local change isn't own by you.
You can only do this action for yours files."

Now, obviously this is incorrect as well, and very likely related to the 
above problem (not to mention the hideous english).


I'm actually thinking of going through the source for the editor and 
correcting all such grammar and spelling mistakes, I find them quite 
annoying to be honest. So expect a patch soon ;)

[PHP-DOC] Re: File patch isOriginal.

[Maciek Sokolewicz]

On 28-02-2012 23:00, Jesús Ruiz García wrote:

Hello and thanks for reading this message.

I created a patch, because I think there is an error in the
documentation in the file: isOriginal, in the directory
reference/ktaglib/audioproperties.
In the line  of isOriginal, indicates that returns the
length of an MPEG file. Return the length of an MPEG file is responsible
of getLenght.

I do not know if the patch, I have to send to this address. Attached the
patch, if any of you want to review it.

A greeting and thanks.

Jesús Ruiz
jesusruiz2...@gmail.com 
jesusr...@php.net 


I just tried to validate and apply this patch via edit.php.net, but got 
the message 'You can't change file's owner. You must be a global 
administrator or an administrator for this lang.'


However, when checking the Patches for Review section, I can select the 
user jesusruiz and click commit patch. Which works fine.


So one of both is incorrect. I personally think I should be able to 
validate such a patch anyway, and if not, I would like to request karma 
to be able to :)


Anyway: the patch is committed. Thank you for supplying this patch.

Re: [PHP-DOC] About note maintenance; when to delete notes.

[Maciek Sokolewicz]

On 24-02-2012 23:12, Ronald Chmara wrote:

On Fri, Feb 24, 2012 at 1:54 PM, Maciek Sokolewicz
  wrote:

  The reason I'm using such "strict" guidelines is simply
to make the manual notes readable. If you look at a page such as
http://www.php.net/manual/en/function.strtotime.php, there are>  100 notes
present. Trying to find something useful to you is simply impossible on such
a page.


I disagree. The problem is not that there are too many notes. (That's
a bit like complaining the internet has too many pages). The problem
on that page is that strtotime isn't documented in such a way as to
make the many notes unnecessary.


I disagree, see below why.



Trying to clean that page to only leave samples that solve very
common problems or clarify the behaviour of the function is IMO a good
thing. That does often mean removing various code samples of the type "this
might be useful to some people".

I am wondering what others think, should we try to thin down the stream of
notes and simply delete notes that have little to say about the actual
function or are of relatively little use to the common PHP coder? Or should
we leave as many notes as possible with examples so people can find
*anything* in there? Possibly leading to unwieldy long lists of notes?

What do YOU think? Feel free to comment / criticise / be constructive ;)


Notes, to me, are an indication of what is lacking in the manual. If
you want to delete a note, make sure the content/idea/concept has
already been put into the documentation somehow. Update the
documentation, *then* delete the note. Simply deleting a note adds no
value to the project. A page with many notes is a page in need of a
re-write, not a note purge.

-Ronabop


I agree that many notes may mean that the documentation is not 
explenatory enough, that is IMO not always the case. If you look at the 
strtotime page, you would be adding the following examples to the manual:


- how to make "strotime work with dates prior to 1970"
- how "next month" is interpreted in edge cases
- the fact that mm/dd/ is a US date format, while dd/mm/ is a 
european format

- weeks start on sunday
- how to parse dates stored in MySQL
- how to calculate the time passed since a certain date (ie. timediff)
- how to loop through date ranges
- possible misunderstandings in the interpretation of dates by strotime
- the fact that you have to escape modifiers
- how to "add time" using strtotime
- how to handle specific time formats using strtotime
- how to calculate bank holidays
- how to convert dates from some specific format to another
- the fact that strtotime produces different output on 32bit machines 
than it does on 64bit

- workarounds to make a different day the first day of the week

etc.
Some of these, I agree, should indeed be added to the manual. However, 
many are simply showing possible ways to work with the function. Not 
something that many people would *need*. The documentation is IMO not a 
place to hold every possible use of the function. It's a place where you 
go to find out how it works, and in the notes any interesting sidenotes 
about why it may not work as expected.
Examples are added to clarify how to work with the function, but 
providing every possible way of using it (potentially millions) is 
simply not useful.


My other point is that such spam drowns out the useful notes, such as 
the one explaining differences in function behaviour between 32bit and 
64bit systems. Instead you find a zillion notes explaining how you can 
emulate behaviour of other functions using this one.

[PHP-DOC] About note maintenance; when to delete notes.

[Maciek Sokolewicz]

I've been maintaining notes in the manual off and on since I came to the 
PHP project, quite a few years ago.


A few days ago I deleted a note, and the author sent a mail to the 
php-general list complaining about it. The answer by Dan was basically 
that the notes maintainers are overzealous and the author should contact 
the person who had deleted the note for clarification. Though I 
personally think saying that notes maintainers are overzealous is simply 
incorrect and may even be interpreted as insulting (yes, I do feel that 
way), that's not the point I'm trying to discuss.


The point I'm trying to bring up is: what notes do we want to keep in 
the manual, and what notes do we not want in there.


http://doc.php.net/php/dochowto/chapter-user-notes.php
This url gives a few guidelines, but mainly focuses on the difference 
between deleting and rejecting notes.


Personally, I hold to the following guidelines (set by myself, since 
none really exist):
- does the note add any valuable insight into the mechanism of the 
function / behaviour described ?

- does the note clarify the use of the function / behaviour described?
- does the note explain something which is clearly missing from the 
documentation?


And in the case of an example function:
- is the code provided easy to interpret? (ie. are there comments 
explaining any 'difficult' behaviour) and

- is the code provided useful to many people?

Obviously, since these are my own guidelines, I was wondering what the 
rest thinks about this. The reason I'm using such "strict" guidelines is 
simply to make the manual notes readable. If you look at a page such as 
http://www.php.net/manual/en/function.strtotime.php, there are > 100 
notes present. Trying to find something useful to you is simply 
impossible on such a page. Trying to clean that page to only leave 
samples that solve very common problems or clarify the behaviour of the 
function is IMO a good thing. That does often mean removing various code 
samples of the type "this might be useful to some people".


I am wondering what others think, should we try to thin down the stream 
of notes and simply delete notes that have little to say about the 
actual function or are of relatively little use to the common PHP coder? 
Or should we leave as many notes as possible with examples so people can 
find *anything* in there? Possibly leading to unwieldy long lists of notes?


What do YOU think? Feel free to comment / criticise / be constructive ;)
- Tul

P.S. Sent to both php-doc and php-notes since very few people actively 
read the notes list.

Re: [PHP-DOC] Contributions are ready for review

[Maciek Sokolewicz]

I have already commited about half of these; apparently I can't commit 
patches from non-anonymous users since the commit options seems to be 
missing in the menu (and I currently don't have an SVN client on this 
semi-public computer; nor any inclination to install one).


Deleting of patches would be easier if there was actually such an option 
next to the commit option (ie. the right-click menu). Instead, you have 
to open the file for editing and manually reject the patch.


- Tul

On 15-02-2012 13:55, Yannick Torrès wrote:

Hi all,

Is there some one who can work on all of this proposal ?

Best,
Yannick

2012/2/13 mailto:phpdoc@lists.php.net>>

Hello PHP EN Documentation team,

There are contributions within the online editor queue for this
language.
Please review, then commit or delete these patches.

Patches for review :
---
* (update) On 2011-05-26 09:31:28 by uw :
en/reference/mysqlnd_ms/concepts.xml
* (update) On 2011-06-27 21:34:04 by guilhermeblanco :
en/language/predefined/errorexception/construct.xml
* (update) On 2011-08-16 11:29:39 by rdohms :
en/reference/strings/functions/strrchr.xml
* (update) On 2011-08-21 16:53:17 by ch :
en/reference/snmp/snmp/construct.xml
* (update) On 2011-08-21 17:01:11 by ch :
en/reference/snmp/book.xml
* (update) On 2011-08-31 21:40:23 by breck7 :
en/reference/network/functions/header.xml
* (update) On 2011-09-24 04:35:10 by mch :
en/language/predefined/variables/server.xml
* (update) On 2011-10-11 06:36:22 by mch :
en/reference/amqp/constants.xml
* (update) On 2011-10-12 00:44:09 by mch :
en/reference/gearman/gearmanclient.xml
* (update) On 2011-10-22 14:16:59 by anonymous #11769 :
en/language/operators.xml
* (update) On 2011-10-27 04:16:08 by anonymous #11351 :
en/reference/mysqlnd_ms/ini.xml
* (update) On 2011-11-13 19:18:10 by anonymous #12333 :
en/reference/curl/functions/curl-setopt-array.xml
* (update) On 2011-11-15 11:21:38 by anonymous #12333 :
en/reference/bzip2/functions/bzwrite.xml
* (update) On 2011-11-15 11:21:59 by anonymous #12333 :
en/reference/apc/apciterator/construct.xml
* (update) On 2011-11-15 11:26:44 by anonymous #12333 :
en/reference/apc/functions/apc-bin-dumpfile.xml
* (update) On 2011-11-15 11:32:27 by anonymous #12333 :
en/reference/zlib/functions/gzgetss.xml
* (update) On 2011-11-15 11:35:47 by anonymous #12333 :
en/reference/amqp/amqpexchange/publish.xml
* (update) On 2011-11-15 11:39:06 by anonymous #12333 :
en/reference/apache/functions/apache-getenv.xml
* (update) On 2011-11-15 11:42:47 by anonymous #12333 :
en/reference/apache/functions/apache-note.xml
* (update) On 2011-11-15 11:43:59 by anonymous #12333 :
en/reference/apc/functions/apc-add.xml
* (update) On 2011-11-15 11:46:45 by anonymous #12333 :
en/reference/apc/functions/apc-bin-dump.xml
* (update) On 2011-11-15 11:47:47 by anonymous #12333 :
en/reference/apc/functions/apc-cache-info.xml
* (update) On 2011-11-15 11:48:46 by anonymous #12333 :
en/reference/apc/functions/apc-clear-cache.xml
* (update) On 2011-11-27 19:57:45 by joey :
en/reference/apc/ini.xml
* (update) On 2011-12-28 16:31:18 by anonymous #13445 :
en/reference/datetime/book.xml
* (update) On 2011-12-28 17:03:22 by anonymous #13445 :
en/reference/iconv/functions/iconv-set-encoding.xml
* (update) On 2012-01-01 12:55:20 by anonymous #13445 :
en/language/variables.xml
* (update) On 2012-01-03 01:39:47 by anonymous #13445 :
en/reference/datetime/functions/mktime.xml
* (update) On 2012-01-03 01:39:51 by anonymous #13445 :
en/reference/datetime/functions/gmmktime.xml
* (update) On 2012-01-26 02:21:33 by christoph.rosse :
en/reference/classobj/functions/get-class-vars.xml
* (update) On 2012-01-26 04:33:55 by christoph.rosse :
en/reference/classobj/functions/get-parent-class.xml
* (update) On 2012-02-06 01:54:13 by anonymous #11769 :
en/language/wrappers/rar.xml
* (update) On 2012-02-06 02:12:11 by anonymous #11769 :
en/language/wrappers/audio.xml
* (update) On 2012-02-12 19:07:22 by Narf :
en/reference/cubrid/functions/cubrid-pconnect.xml
* (update) On 2012-02-12 19:22:47 by Narf :
en/reference/cubrid/functions/cubrid-pconnect-with-url.xml



--
https://edit.php.net/
This email is send automatically by the Php Docbook Online Editor.

[PHP-DOC] Re: en/reference/ibm_db2 - changes to multiple files plus a new file db2-last-insert-id.xml

[Maciek Sokolewicz]

DeDe Morton wrote:


I don't have cvs contribution access so if somebody could contribute 
this for me that would be great. I'm a newbie at this, so I hope that 
I've done everything correctly. Thanks!!


Summary of changes:

Added the new file db2-last-insert-id.xml. (I'm attaching the file to 
this email. I hope that's the correct way to submit this addition.)


Modified en/reference/ibm_db2/versions.xml to include entry for the new 
function db2_last_insert_id.


Modified en/reference/ibm_db2/functions/db2-connect.xml to add 
trusted_context parameter and corresponding example.


Modified en/reference/ibm_db2/functions/db2-pconnect to add 
trusted_context parameter and corresponding example.


Modified en/reference/ibm_db2/functions/db2-set-option to add 
trusted_user and trusted_password parameters. Also fixed tagging of 
several notes and incorrect tagging for the type parameter.
 



DeDe Morton


>The following new i5/OS options are available as of ibm_db2 
version 1.5.1.
>Note: prior versions of ibm_db2 do not support these new i5 
options.



I know you didn't write this, but could you perhaps also change it to:
Note: ibm_db2 versions prior to 1.5.1 do not support the i5/OS options.
It sounds so weird like it is above, like 2 different ways of saying the 
exact same thing.


- Tul

[PHP-DOC] Re: Patch to address a working problem in $_REQUEST

[Maciek Sokolewicz]

Lars Torben Wilson wrote:

Hi all,

This patch is to address a working error I stumbled across today in
the documentation for $_REQUEST.

RCS file: /repository/phpdoc/en/language/predefined/variables/request.xml,v
retrieving revision 1.6
diff -u -u -r1.6 request.xml
--- en/language/predefined/variables/request.xml23 Aug 2008 15:40:21 
-  1.6
+++ en/language/predefined/variables/request.xml4 Nov 2008 07:13:13 
-
@@ -71,9 +71,11 @@
   
   

-Variables provided to the script via the GET, POST, and COOKIE input
-mechanisms, and which therefore cannot be trusted. The presence and
-order of variable inclusion in this array is defined according to the
+The variables in $_REQUEST are provided to the
+script via the GET, POST, and COOKIE input mechanisms and
+therefore could be modified by the remote user and cannot be
+trusted. The presence and order of variables listed in this array
+is defined according to the
 PHP variables_order
 configuration directive.



Regards,

Torben


What error? You simply reworded the text a bit to highlight what you see 
as the most important reason not to trust userdata ?


- Tul

Re: [PHP-DOC] Unix manual pages for phpdoc!

[Maciek Sokolewicz]

Hannes Magnusson wrote:

On Mon, Oct 20, 2008 at 21:45, Philip Olson <[EMAIL PROTECTED]> wrote:

On 19 Oct 2008, at 12:41, Hannes Magnusson wrote:


Hi all

I created and uploaded a new package on our PEAR-channel, doc.php.net,
called "pman".

There is one problem:

 philip$ pear install doc.php.net/pman
 downloading pman-1.0.0.tgz ...
 Starting to download pman-1.0.0.tgz (3,810,407 bytes)
 ..done: 3,810,407 bytes
 ERROR: bad md5sum for file
/usr/local/pear/PEAR/docs/pman/man3/DomDocument.xinclude.3.gz
 philip$

Hannes and I determined it's likely due to a case insensitive file system
because the following exists inside phd/package-pman.xml:

 
 

One for Dom, and the other for domxml. Let's see what a Windows user has to
say... I use Mac.



And as of yet I have no idea how we can fix this.

both ext/domxml (PHP4) and ext/dom (PHP5) define the "DOMDocument"
class and the "xinclude" method.
Fortunately the ext/domxml docs haven't been upgraded to use the new
OO-doc-style so there IDs are still "function.domdocument-xinclude"
while the ext/dom ID is "domdocument.xinclude" hence not causing any
conflicts.

However, the unix man-page output format uses the  to
generate the filenames, not the IDs, so you can write "pman strpos"
rather then "pman function.strpos".

Short of renaming the ext/domxml refname to intentionally include an
typo I have no idea how we can fix this :(

Btw: Since ext/domxml and ext/dom are so alike (both defining the
exact same classnames and the only difference in the methodnames are
camelCased vs under_scored) the documentation search for end-users
(either via php.net/short-syntax-lookup or via the "search" box) is
really sucky experience, never exactly knowing if they are browsing
the ext/dom or ext/domxml docs :(
This problem will partially be fixed by fixing the version
information, but then new problem arises: If a user has the
domelement->get_elements_by_tag_name page open and sees it is PHP4...
how is he supposed to know there is an PHP5 alternative?

My vote goes to removing the ext/domxml docs, PHP4 is dead anyway and
those so crappy unfortunate needing to read PHP4 code (for whatever
reason, upgrading maybe) and check the manual for "WTF is going on"
will have to search "the attic" or something

-Hannes


Or perhaps we could make our documentation based on PHP version like the 
mysql manual does. So we have a "different" manual for PHP6, PHP 5(.3), 
5.2, one for PHP 4, etc. Then we could include /domxml in the PHP4 
manual, and the dom in the PHP5 and 6 ones. You could add a small 
dropdown box at the top like we have with languages now to choose the 
PHP version you're looking into. You could also have that stored in a 
cookie via my php.net functionality.
I'm pretty sure phD can be modified to output docs specific to versions 
if we properly assign versions and changelogs to all functionality.


- Tul

[PHP-DOC] Re: cvs: phpdoc /en/chapters intro.xml

[Maciek Sokolewicz]

please revert this asap.
Translations should go into their own tree, not the ENGLISH tree.

Peter Emil Henriksen wrote:

rmlrSun Sep 14 10:24:43 2008 UTC

  Modified files:  
/phpdoc/en/chapters	intro.xml 
  Log:

  Started translation
  
http://cvs.php.net/viewvc.cgi/phpdoc/en/chapters/intro.xml?r1=1.47&r2=1.48&diff_format=u

Index: phpdoc/en/chapters/intro.xml
diff -u phpdoc/en/chapters/intro.xml:1.47 phpdoc/en/chapters/intro.xml:1.48
--- phpdoc/en/chapters/intro.xml:1.47   Fri May  2 12:28:47 2008
+++ phpdoc/en/chapters/intro.xmlSun Sep 14 10:24:43 2008
@@ -1,34 +1,35 @@
 
-
+
+
  http://docbook.org/ns/docbook"; 
xmlns:xlink="http://www.w3.org/1999/xlink";>
-  Introduction
+  Introduktion
 
   

-   What is PHP?
+   Hvad er PHP?

-PHP (recursive acronym for "PHP: Hypertext
-Preprocessor") is a widely-used open source general-purpose
-scripting language that is especially suited for web
-development and can be embedded into HTML.
+PHP (rekursiv akronym for "PHP: Hypertext
+Preprocessor") er et meget udbredt open source general-purpose
+scripting sprog der er særligt tilpasset til web
+udvikling og kan blive indkapsle i HTML.


-Nice, but what does that mean? An example:
+Fedt, men hvad betyder det? Et eksempel:


 
- An introductory example
+ Et introduktions eksempel
  
 

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

[Maciek Sokolewicz]

Hannes Magnusson wrote:

On Wed, Aug 20, 2008 at 11:43, Jiania Hung <[EMAIL PROTECTED]> wrote:

Sounds like good idea.if you need help,call me anytime.:)


Going through the pages listed on http://pb11.php.net/sitemap.php and
upgrade them would be awesome.
Currently only the pages linked from the main-top-menu have been
upgraded (plus manual pages), with the exception of the download and
mailinglist pages (waiting for better designs on those two).

Its an extremely easy upgrade procedure, see:
http://cvs.php.net/viewvc.cgi/phpweb/sites.php?r1=1.46&r2=1.46.2.1 and
http://cvs.php.net/viewvc.cgi/phpweb/links.php?r1=1.211&r2=1.211.2.1
for instance.

See include/layout.inc (bottom) for the definition of the functions.


I don't think you have phpweb karma, do you?
If not I'm sure we can hook you up after seeing a patch for few files.


Ones the basic stuff is completed (see links above) we can start
looking into what else needs/should to be done in terms of code
rewrite...

-Hannes


Wow, that looks awesome! If you need more hands, feel free to say so, 
I've got some free time in the next couple of weeks.


- Tul

[PHP-DOC] [Fwd: #45687 [Opn->Bgs]: Why is PCNTL marked experimental]

[Maciek Sokolewicz]

Right, so, if this _is_ still considered experimental, then we should 
fix it in the documentation; and if it's not, we should fix the 
configure script.


Which one will it be? :)

- Tul

 Original Message 
Subject: #45687 [Opn->Bgs]: Why is PCNTL marked experimental
Date: Sat, 2 Aug 2008 16:41:32 GMT
From: [EMAIL PROTECTED]
To: [EMAIL PROTECTED]
Newsgroups: php.bugs
Followup-To: php.internals
References: <[EMAIL PROTECTED]>

 ID:   45687
 Updated by:   [EMAIL PROTECTED]
 Reported By:  robert at shilston dot com
-Status:   Open
+Status:   Bogus
 Bug Type: PCNTL related
 Operating System: Fedora 2.6.17-1.2187_FC5
 PHP Version:  5.2.6
 New Comment:

This is not a discussion forum, ask your question on the
[EMAIL PROTECTED] mailing list.


Previous Comments:


[2008-08-02 13:11:45] robert at shilston dot com

Description:

I note that in configure script for 5.2.6, PCNTL is marked as
experimental.  However, this isn't reflected in the online
documentation.  Can anyone shed any light on whether PCNTL is stable,
and if not, what the outstanding concerns might be?






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

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

[Maciek Sokolewicz]

tularis Wed Aug 22 17:24:24 2007 UTC

  Modified files:  
/phpdoc/en/reference/pdoconstants.xml 
  Log:
  explained PDO::FETCH_SERIALIZE use
  
http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/pdo/constants.xml?r1=1.19&r2=1.20&diff_format=u
Index: phpdoc/en/reference/pdo/constants.xml
diff -u phpdoc/en/reference/pdo/constants.xml:1.19 
phpdoc/en/reference/pdo/constants.xml:1.20
--- phpdoc/en/reference/pdo/constants.xml:1.19  Wed Jun 20 22:25:12 2007
+++ phpdoc/en/reference/pdo/constants.xml   Wed Aug 22 17:24:24 2007
@@ -1,5 +1,5 @@
 
-
+
 
 http://docbook.org/ns/docbook";>
  &reftitle.constants;
@@ -286,6 +286,7 @@


 
+ As PDO::FETCH_INTO but object is provided as a 
serialized string.
  Available since PHP 5.1.0.
 

[PHP-DOC] cvs: phpdoc /en/install/windows iis.xml

[Maciek Sokolewicz]

tularis Wed Aug 22 16:30:16 2007 UTC

  Modified files:  
/phpdoc/en/install/windows  iis.xml 
  Log:
  added note how to use 32bit-php on 64bit-servers
  
http://cvs.php.net/viewvc.cgi/phpdoc/en/install/windows/iis.xml?r1=1.20&r2=1.21&diff_format=u
Index: phpdoc/en/install/windows/iis.xml
diff -u phpdoc/en/install/windows/iis.xml:1.20 
phpdoc/en/install/windows/iis.xml:1.21
--- phpdoc/en/install/windows/iis.xml:1.20  Wed Jun 20 22:24:11 2007
+++ phpdoc/en/install/windows/iis.xml   Wed Aug 22 16:30:16 2007
@@ -1,5 +1,5 @@
 
-
+
 http://docbook.org/ns/docbook"; 
xmlns:xlink="http://www.w3.org/1999/xlink";>
  Microsoft IIS / PWS
  
@@ -88,6 +88,15 @@
   any data.
  
 
+
+ 
+  The PHP executable is distributed as a 32bit application. If you are 
running
+  a 64bit version of Windows you will either need to rebuild the binary 
yourself,
+  or make sure IIS is configured to also run 32bit extensions. You can 
usually 
+  turn this on by using the IIS Administration script as follows:
+  Cscript.exe adsutil.vbs SET W3SVC/AppPools/Enable32bitAppOnWin64 1
+ 
+

   
  

[PHP-DOC] cvs: phpdoc /en/reference/image/functions imagegd.xml imagegd2.xml imagegif.xml imagejpeg.xml imagepng.xml imagewbmp.xml imagexbm.xml

[Maciek Sokolewicz]

tularis Fri Jul 13 14:45:23 2007 UTC

  Modified files:  
/phpdoc/en/reference/image/functionsimagewbmp.xml imagepng.xml 
imagegd2.xml imagegd.xml 
imagexbm.xml imagejpeg.xml 
imagegif.xml 
  Log:
  clarified the description of the filename parameter
  
http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/image/functions/imagewbmp.xml?r1=1.9&r2=1.10&diff_format=u
Index: phpdoc/en/reference/image/functions/imagewbmp.xml
diff -u phpdoc/en/reference/image/functions/imagewbmp.xml:1.9 
phpdoc/en/reference/image/functions/imagewbmp.xml:1.10
--- phpdoc/en/reference/image/functions/imagewbmp.xml:1.9   Wed Jun 20 
22:24:40 2007
+++ phpdoc/en/reference/image/functions/imagewbmp.xml   Fri Jul 13 14:45:23 2007
@@ -1,5 +1,5 @@
 
-
+
 http://docbook.org/ns/docbook";>
  
   imagewbmp
@@ -27,8 +27,8 @@
  filename
  
   
-   The path to the saved file. If not set or &null;, the raw image stream
-   will be outputed directly.
+   The path to save the file to. If not set or &null;, the raw image stream
+   will be outputted directly.
   
  
 
http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/image/functions/imagepng.xml?r1=1.12&r2=1.13&diff_format=u
Index: phpdoc/en/reference/image/functions/imagepng.xml
diff -u phpdoc/en/reference/image/functions/imagepng.xml:1.12 
phpdoc/en/reference/image/functions/imagepng.xml:1.13
--- phpdoc/en/reference/image/functions/imagepng.xml:1.12   Wed Jun 20 
22:24:38 2007
+++ phpdoc/en/reference/image/functions/imagepng.xmlFri Jul 13 14:45:23 2007
@@ -1,5 +1,5 @@
 
-
+
 http://docbook.org/ns/docbook";>
  
   imagepng
@@ -28,8 +28,8 @@
  filename
  
   
-   The path to the saved file. If not set or &null;, the raw image stream
-   will be outputed directly.
+   The path to save the file to. If not set or &null;, the raw image stream
+   will be outputted directly.
   
   

http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/image/functions/imagegd2.xml?r1=1.16&r2=1.17&diff_format=u
Index: phpdoc/en/reference/image/functions/imagegd2.xml
diff -u phpdoc/en/reference/image/functions/imagegd2.xml:1.16 
phpdoc/en/reference/image/functions/imagegd2.xml:1.17
--- phpdoc/en/reference/image/functions/imagegd2.xml:1.16   Wed Jun 20 
22:24:38 2007
+++ phpdoc/en/reference/image/functions/imagegd2.xmlFri Jul 13 14:45:23 2007
@@ -1,5 +1,5 @@
 
-
+
 http://docbook.org/ns/docbook";>
  
   imagegd2
@@ -27,8 +27,8 @@
  filename
  
   
-   The path to the saved file. If not set or &null;, the raw image stream
-   will be outputed directly.
+   The path to save the file to. If not set or &null;, the raw image stream
+   will be outputted directly.
   
  
 
http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/image/functions/imagegd.xml?r1=1.9&r2=1.10&diff_format=u
Index: phpdoc/en/reference/image/functions/imagegd.xml
diff -u phpdoc/en/reference/image/functions/imagegd.xml:1.9 
phpdoc/en/reference/image/functions/imagegd.xml:1.10
--- phpdoc/en/reference/image/functions/imagegd.xml:1.9 Wed Jun 20 22:24:38 2007
+++ phpdoc/en/reference/image/functions/imagegd.xml Fri Jul 13 14:45:23 2007
@@ -1,5 +1,5 @@
 
-
+
 http://docbook.org/ns/docbook";>
  
   imagegd
@@ -25,8 +25,8 @@
  filename
  
   
-   The path to the saved file. If not set or &null;, the raw image stream
-   will be outputed directly.
+   The path to save the file to. If not set or &null;, the raw image stream
+   will be outputted directly.
   
  
 
http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/image/functions/imagexbm.xml?r1=1.6&r2=1.7&diff_format=u
Index: phpdoc/en/reference/image/functions/imagexbm.xml
diff -u phpdoc/en/reference/image/functions/imagexbm.xml:1.6 
phpdoc/en/reference/image/functions/imagexbm.xml:1.7
--- phpdoc/en/reference/image/functions/imagexbm.xml:1.6Wed Jun 20 
22:24:40 2007
+++ phpdoc/en/reference/image/functions/imagexbm.xmlFri Jul 13 14:45:23 2007
@@ -1,5 +1,5 @@
 
-
+
 http://docbook.org/ns/docbook";>
  
   imagexbm
@@ -27,8 +27,8 @@
  filename
  
   
-   The path to the saved file. If not set or &null;, the raw image stream
-   will be outputed directly.
+   The path to save the file to. If not set or &null;, the raw image stream
+   will be outputted directly.
   
  
 
http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/image/functions/imagejpeg.xml?r1=1.10&r2=1.11&diff_format=u
Index: phpdoc/en/reference/image/functions/imagejpeg.xml
diff -u phpdoc/en/reference/image/functions/imagejpeg.xml:1.10 
phpdoc/en/reference/image/functions/imagejpeg.xml:1.11
--- phpdoc/en/reference/image/functions/imagejpeg.xml:1.10  Wed Jun 20 
22:24:38 2007
+++ phpdoc/en/reference/image/functions/imagejpeg.xml   Fri Jul 13 14:45:23 2007
@@ -1

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

[Maciek Sokolewicz]

tularis Sat Jun  9 09:04:48 2007 UTC

  Modified files:  
/phpdoc/en/reference/dbaconfigure.xml 
  Log:
  fixed typo "malfaunctioning" => "malfunctioning"
  
http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/dba/configure.xml?r1=1.14&r2=1.15&diff_format=u
Index: phpdoc/en/reference/dba/configure.xml
diff -u phpdoc/en/reference/dba/configure.xml:1.14 
phpdoc/en/reference/dba/configure.xml:1.15
--- phpdoc/en/reference/dba/configure.xml:1.14  Fri Aug 13 04:34:34 2004
+++ phpdoc/en/reference/dba/configure.xml   Sat Jun  9 09:04:48 2007
@@ -1,5 +1,5 @@
 
-
+
 
  &reftitle.install;
  
@@ -18,7 +18,7 @@
dbm and ndbm which conflict with
many installations. The reason for this is that on several systems these
libraries are part of more than one other library. The configuration test
-   only prevents you from configuring malfaunctioning single handlers but not 
+   only prevents you from configuring malfunctioning single handlers but not 
combinations.
   
  

[PHP-DOC] cvs: phpdoc /en/reference/array/functions array-slice.xml

[Maciek Sokolewicz]

tularis Fri Jun  8 13:24:48 2007 UTC

  Modified files:  
/phpdoc/en/reference/array/functionsarray-slice.xml 
  Log:
  reworded "will reset numeric array keys by default" to explain it more clearly
  
http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/array/functions/array-slice.xml?r1=1.13&r2=1.14&diff_format=u
Index: phpdoc/en/reference/array/functions/array-slice.xml
diff -u phpdoc/en/reference/array/functions/array-slice.xml:1.13 
phpdoc/en/reference/array/functions/array-slice.xml:1.14
--- phpdoc/en/reference/array/functions/array-slice.xml:1.13Tue Oct 31 
11:24:01 2006
+++ phpdoc/en/reference/array/functions/array-slice.xml Fri Jun  8 13:24:47 2007
@@ -1,5 +1,5 @@
 
-
+
 
 
  
@@ -37,9 +37,9 @@
array.
   
   
-   Note that array_slice will reset numeric array
-   keys by default. Since PHP 5.0.2, you can change this behaviour by
-   setting preserve_keys to &true;.
+   Note that array_slice will reorder and reset the 
+   array indices by default. Since PHP 5.0.2, you can change this 
+   behaviour by setting preserve_keys to &true;.
   
   

[PHP-DOC] cvs: phpdoc /en/language/oop5 abstract.xml

[Maciek Sokolewicz]

tularis Fri Jun  8 12:48:13 2007 UTC

  Modified files:  
/phpdoc/en/language/oop5abstract.xml 
  Log:
  reworded visibility explenation & fixed typo
  
http://cvs.php.net/viewvc.cgi/phpdoc/en/language/oop5/abstract.xml?r1=1.13&r2=1.14&diff_format=u
Index: phpdoc/en/language/oop5/abstract.xml
diff -u phpdoc/en/language/oop5/abstract.xml:1.13 
phpdoc/en/language/oop5/abstract.xml:1.14
--- phpdoc/en/language/oop5/abstract.xml:1.13   Wed Aug  3 16:14:00 2005
+++ phpdoc/en/language/oop5/abstract.xmlFri Jun  8 12:48:13 2007
@@ -1,5 +1,5 @@
 
-
+
  
   Class Abstraction
 
@@ -14,10 +14,10 @@
   
When inheriting from an abstract class, all methods marked abstract in
the parent's class declaration must be defined by the child; additionally,
-   these methods must be defined with the same (or weaker)
-   visibillity. For example,
+   these methods must be defined with the same (or a less restricted)
+   visibility. For example,
if the abstract method is defined as protected, the function implementation
-   must be defined as either protected or public.
+   must be defined as either protected or public, but not private.
   
 
   

[PHP-DOC] cvs: phpdoc /en/reference/fileinfo/functions finfo-open.xml

[Maciek Sokolewicz]

tularis Sun May  6 19:45:58 2007 UTC

  Modified files:  
/phpdoc/en/reference/fileinfo/functions finfo-open.xml 
  Log:
  added example, cleaned up description, clarified parameters
  
http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/fileinfo/functions/finfo-open.xml?r1=1.1&r2=1.2&diff_format=u
Index: phpdoc/en/reference/fileinfo/functions/finfo-open.xml
diff -u phpdoc/en/reference/fileinfo/functions/finfo-open.xml:1.1 
phpdoc/en/reference/fileinfo/functions/finfo-open.xml:1.2
--- phpdoc/en/reference/fileinfo/functions/finfo-open.xml:1.1   Thu Mar  9 
14:15:41 2006
+++ phpdoc/en/reference/fileinfo/functions/finfo-open.xml   Sun May  6 
19:45:58 2007
@@ -1,18 +1,21 @@
 
-
-
+
 
  
   finfo_open
+  finfo->__construct()
   Create a new fileinfo resource
  
+
  
   &reftitle.description;
+  Procedural style
   
resourcefinfo_open
intoptions
stringarg
   
+  Object oriented style (constructor):
   
finfo

@@ -21,12 +24,11 @@
 stringmagic_file

   
-
   
This function opens a magic database and returns its resource.
   
-
  
+
  
   &reftitle.parameters;
   
@@ -46,16 +48,17 @@
   
Name of a magic database file, usually something like
/path/to/magic.mime. If not specified,
-   MAGIC environment variable is used. If this variable
-   is not set neither, /usr/share/misc/magic is used.
-   .mime and/or .mgc is added if
-   appropriate.
+   the MAGIC environment variable is used. If this 
variable
+   is not set either, /usr/share/misc/magic is used 
by default.
+   A .mime and/or .mgc suffix is 
added if
+   needed.
   
  
 

   
  
+
  
   &reftitle.returnvalues;
   
@@ -63,6 +66,60 @@
   
  
 
+ 
+  &reftitle.examples;
+  
+   Object oriented style
+   
+
+  
+  
+  
+   Procedural style
+   
+
+   
+  
+  &example.outputs;
+  
+
+  
+ 
+
  
   &reftitle.seealso;
   

[PHP-DOC] cvs: phpdoc /en/reference/misc/functions define.xml

[Maciek Sokolewicz]

tularis Fri Apr 27 11:10:29 2007 UTC

  Modified files:  
/phpdoc/en/reference/misc/functions define.xml 
  Log:
  define() also allows null and boolean values
  
http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/misc/functions/define.xml?r1=1.9&r2=1.10&diff_format=u
Index: phpdoc/en/reference/misc/functions/define.xml
diff -u phpdoc/en/reference/misc/functions/define.xml:1.9 
phpdoc/en/reference/misc/functions/define.xml:1.10
--- phpdoc/en/reference/misc/functions/define.xml:1.9   Fri Apr 27 07:54:37 2007
+++ phpdoc/en/reference/misc/functions/define.xml   Fri Apr 27 11:10:29 2007
@@ -1,5 +1,5 @@
 
-
+
 
  
   define
@@ -35,7 +35,9 @@
  value
  
   
-   The value of the constant; only scalar values, that is 
integers, floats and strings are allowed.
+   The value of the constant; only scalar and null values are 
allowed. 
+   Scalar values are integer, 
+   float, string or boolean values.
   
  
 

[PHP-DOC] cvs: phpdoc /en/reference/misc/functions define.xml

[Maciek Sokolewicz]

tularis Fri Apr 27 07:54:37 2007 UTC

  Modified files:  
/phpdoc/en/reference/misc/functions define.xml 
  Log:
  Added a note that only scalar values are allowed as the value of constants.
  
http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/misc/functions/define.xml?r1=1.8&r2=1.9&diff_format=u
Index: phpdoc/en/reference/misc/functions/define.xml
diff -u phpdoc/en/reference/misc/functions/define.xml:1.8 
phpdoc/en/reference/misc/functions/define.xml:1.9
--- phpdoc/en/reference/misc/functions/define.xml:1.8   Mon Feb 19 00:03:13 2007
+++ phpdoc/en/reference/misc/functions/define.xml   Fri Apr 27 07:54:37 2007
@@ -1,5 +1,5 @@
 
-
+
 
  
   define
@@ -35,7 +35,7 @@
  value
  
   
-   The value of the constant.
+   The value of the constant; only scalar values, that is 
integers, floats and strings are allowed.
   
  
 

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

[Maciek Sokolewicz]

tularis Wed Apr 18 16:04:50 2007 UTC

  Modified files:  
/phpdoc/en/reference/gnupg  reference.xml 
  Log:
  fixed typo in example, note #74579
  
http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/gnupg/reference.xml?r1=1.4&r2=1.5&diff_format=u
Index: phpdoc/en/reference/gnupg/reference.xml
diff -u phpdoc/en/reference/gnupg/reference.xml:1.4 
phpdoc/en/reference/gnupg/reference.xml:1.5
--- phpdoc/en/reference/gnupg/reference.xml:1.4 Thu Dec  8 12:10:53 2005
+++ phpdoc/en/reference/gnupg/reference.xml Wed Apr 18 16:04:50 2007
@@ -1,5 +1,5 @@
 
-
+
 
 
 
@@ -87,7 +87,7 @@
 // add key with passphrase 'test' for signing
 gnupg_addsignkey($res,"8660281B6051D071D94B5B230549F9DC851566DC","test");
 // sign
-$signed = gnupg_sign("just a test");
+$signed = gnupg_sign($res,"just a test");
 echo $signed;
 ?>
 ]]>

[PHP-DOC] cvs: phpdoc /en/reference/datetime/functions strtotime.xml

[Maciek Sokolewicz]

tularis Tue Apr 10 12:53:24 2007 UTC

  Modified files:  
/phpdoc/en/reference/datetime/functions strtotime.xml 
  Log:
  fix typo in section about 2-digit interpretation [again]
  
http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/datetime/functions/strtotime.xml?r1=1.22&r2=1.23&diff_format=u
Index: phpdoc/en/reference/datetime/functions/strtotime.xml
diff -u phpdoc/en/reference/datetime/functions/strtotime.xml:1.22 
phpdoc/en/reference/datetime/functions/strtotime.xml:1.23
--- phpdoc/en/reference/datetime/functions/strtotime.xml:1.22   Mon Apr  9 
13:24:35 2007
+++ phpdoc/en/reference/datetime/functions/strtotime.xmlTue Apr 10 
12:53:24 2007
@@ -1,5 +1,5 @@
 
-
+
 
 
  
@@ -30,7 +30,7 @@
   

 If the number of the year is specified in a two digit format, the values
-between 0-69 are mapped to 2000-2069 and 70-99 to 1970-2000.
+between 00-69 are mapped to 2000-2069 and 70-99 to 1970-1999.

   
  

[PHP-DOC] cvs: phpdoc /en/reference/datetime/functions strtotime.xml

[Maciek Sokolewicz]

tularis Mon Apr  9 13:24:35 2007 UTC

  Modified files:  
/phpdoc/en/reference/datetime/functions strtotime.xml 
  Log:
  fix typo in section about 2-digit interpretation (usernote)
  
http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/datetime/functions/strtotime.xml?r1=1.21&r2=1.22&diff_format=u
Index: phpdoc/en/reference/datetime/functions/strtotime.xml
diff -u phpdoc/en/reference/datetime/functions/strtotime.xml:1.21 
phpdoc/en/reference/datetime/functions/strtotime.xml:1.22
--- phpdoc/en/reference/datetime/functions/strtotime.xml:1.21   Thu Feb 15 
08:12:19 2007
+++ phpdoc/en/reference/datetime/functions/strtotime.xmlMon Apr  9 
13:24:35 2007
@@ -1,5 +1,5 @@
 
-
+
 
 
  
@@ -30,7 +30,7 @@
   

 If the number of the year is specified in a two digit format, the values
-between 0-69 are mapped to 2000-2069 and 70-100 to 1970-2000.
+between 0-69 are mapped to 2000-2069 and 70-99 to 1970-2000.

   
  

[PHP-DOC] cvs: phpdoc /en/reference/gmp/functions gmp-perfect-square.xml

[Maciek Sokolewicz]

tularis Sat Jan  8 15:21:25 2005 EDT

  Modified files:  
/phpdoc/en/reference/gmp/functions  gmp-perfect-square.xml 
  Log:
  fixed typo
  sqrtrm => sqrtrem
  
http://cvs.php.net/diff.php/phpdoc/en/reference/gmp/functions/gmp-perfect-square.xml?r1=1.4&r2=1.5&ty=u
Index: phpdoc/en/reference/gmp/functions/gmp-perfect-square.xml
diff -u phpdoc/en/reference/gmp/functions/gmp-perfect-square.xml:1.4 
phpdoc/en/reference/gmp/functions/gmp-perfect-square.xml:1.5
--- phpdoc/en/reference/gmp/functions/gmp-perfect-square.xml:1.4Thu Feb 
26 06:14:11 2004
+++ phpdoc/en/reference/gmp/functions/gmp-perfect-square.xmlSat Jan  8 
15:21:24 2005
@@ -1,5 +1,5 @@
 
-
+
 
   

@@ -45,7 +45,7 @@
 
 
  See also: gmp_sqrt,
- gmp_sqrtrm.  
+ gmp_sqrtrem.  
 

   

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

[Maciek Sokolewicz]

tularis Sun Jan  2 09:41:46 2005 EDT

  Modified files:  
/phpdoc/en/reference/http/functions setcookie.xml 
  Log:
  integrated a couple of notes
  
http://cvs.php.net/diff.php/phpdoc/en/reference/http/functions/setcookie.xml?r1=1.33&r2=1.34&ty=u
Index: phpdoc/en/reference/http/functions/setcookie.xml
diff -u phpdoc/en/reference/http/functions/setcookie.xml:1.33 
phpdoc/en/reference/http/functions/setcookie.xml:1.34
--- phpdoc/en/reference/http/functions/setcookie.xml:1.33   Fri Oct 29 
05:03:30 2004
+++ phpdoc/en/reference/http/functions/setcookie.xmlSun Jan  2 09:41:45 2005
@@ -1,5 +1,5 @@
 
-
+
 
   

@@ -314,20 +314,18 @@
 
 
  
-  For more information on cookies, see Netscape's cookie
-  specification at &spec.cookies; and 
-  RFC 2965.
- 
- 
-  You may notice the expire parameter takes on a
-  Unix timestamp, as opposed to the date format Wdy, DD-Mon-
-  HH:MM:SS GMT, this is because PHP does this conversion
-  internally.
- 
- 
-  expire is compared to the client's time which can
-  differ from server's time.
+  The following RFC's may also be useful:
+  RFC 2109 and 
+  RFC 2695
+  
+   You may notice the expire parameter takes on a
+   Unix timestamp, as opposed to the date format Wdy, DD-Mon-
+   HH:MM:SS GMT, this is because PHP does this conversion
+   internally.
+  
+  
+   expire is compared to the client's time which can
+   differ from server's time.
  
 
 

[PHP-DOC] cvs: phpdoc /en/faq using.xml

[Maciek Sokolewicz]

tularis Sun Dec 26 06:31:56 2004 EDT

  Modified files:  
/phpdoc/en/faq  using.xml 
  Log:
  added 'G' modifier to shorthandbytes section
  
http://cvs.php.net/diff.php/phpdoc/en/faq/using.xml?r1=1.32&r2=1.33&ty=u
Index: phpdoc/en/faq/using.xml
diff -u phpdoc/en/faq/using.xml:1.32 phpdoc/en/faq/using.xml:1.33
--- phpdoc/en/faq/using.xml:1.32Sun Oct 31 15:10:34 2004
+++ phpdoc/en/faq/using.xml Sun Dec 26 06:31:55 2004
@@ -1,5 +1,5 @@
 
-
+
 
   Using PHP
   Using PHP
@@ -419,8 +419,9 @@
 
 
  
-  The available options are K (for Kilobytes) and M (for Megabytes), these
-  are case insensitive.  Anything else assumes bytes.  
+  The available options are K (for Kilobytes), M (for Megabytes) and G (for
+  Gigabytes; available since PHP 5.1.0), these are case insensitive.
+  Anything else assumes bytes.
   1M equals one Megabyte or 1048576
   bytes.  1K equals one Kilobyte or 
   1024 bytes.  You may not use these shorthand 

[PHP-DOC] cvs: phpdoc /en/reference/dio/functions dio-close.xml dio-fcntl.xml dio-open.xml dio-seek.xml dio-tcsetattr.xml dio-truncate.xml

[Maciek Sokolewicz]

tularis Tue Sep  7 17:36:23 2004 EDT

  Modified files:  
/phpdoc/en/reference/dio/functions  dio-close.xml dio-fcntl.xml 
dio-open.xml dio-seek.xml 
dio-tcsetattr.xml 
dio-truncate.xml 
  Log:
  added notes about unavailable functions on windows, and added examples
  
http://cvs.php.net/diff.php/phpdoc/en/reference/dio/functions/dio-close.xml?r1=1.4&r2=1.5&ty=u
Index: phpdoc/en/reference/dio/functions/dio-close.xml
diff -u phpdoc/en/reference/dio/functions/dio-close.xml:1.4 
phpdoc/en/reference/dio/functions/dio-close.xml:1.5
--- phpdoc/en/reference/dio/functions/dio-close.xml:1.4 Thu Mar  4 12:49:47 2004
+++ phpdoc/en/reference/dio/functions/dio-close.xml Tue Sep  7 17:36:21 2004
@@ -1,5 +1,5 @@
 
-
+
 
   

@@ -18,6 +18,22 @@
 
 
  See also dio_open.
+
+
+ 
+ 
+  Closing an open file descriptor
+ 
+ 
+
+  
+ 
 

   
http://cvs.php.net/diff.php/phpdoc/en/reference/dio/functions/dio-fcntl.xml?r1=1.6&r2=1.7&ty=u
Index: phpdoc/en/reference/dio/functions/dio-fcntl.xml
diff -u phpdoc/en/reference/dio/functions/dio-fcntl.xml:1.6 
phpdoc/en/reference/dio/functions/dio-fcntl.xml:1.7
--- phpdoc/en/reference/dio/functions/dio-fcntl.xml:1.6 Thu Mar  4 12:49:47 2004
+++ phpdoc/en/reference/dio/functions/dio-fcntl.xml Tue Sep  7 17:36:22 2004
@@ -1,5 +1,5 @@
 
-
+
 
   

@@ -78,7 +78,7 @@
   

 F_DUPFD - finds the lowest numbered available file descriptor
-greater or equal than args and returns
+greater than or equal to args and returns
 them.

   
@@ -91,7 +91,30 @@

   
  
+  
+  
+   Setting and clearing a lock
+  
+  
+
+  
+ 
 
+¬e.no-windows;

   
 
http://cvs.php.net/diff.php/phpdoc/en/reference/dio/functions/dio-open.xml?r1=1.5&r2=1.6&ty=u
Index: phpdoc/en/reference/dio/functions/dio-open.xml
diff -u phpdoc/en/reference/dio/functions/dio-open.xml:1.5 
phpdoc/en/reference/dio/functions/dio-open.xml:1.6
--- phpdoc/en/reference/dio/functions/dio-open.xml:1.5  Thu Mar  4 12:49:47 2004
+++ phpdoc/en/reference/dio/functions/dio-open.xml  Tue Sep  7 17:36:22 2004
@@ -1,5 +1,5 @@
 
-
+
 
   

@@ -73,6 +73,21 @@
 
  See also: dio_close.
 
+
+ 
+  Setting the baud rate on a serial port
+ 
+ 
+
+ 
+

   
 
http://cvs.php.net/diff.php/phpdoc/en/reference/dio/functions/dio-seek.xml?r1=1.4&r2=1.5&ty=u
Index: phpdoc/en/reference/dio/functions/dio-seek.xml
diff -u phpdoc/en/reference/dio/functions/dio-seek.xml:1.4 
phpdoc/en/reference/dio/functions/dio-seek.xml:1.5
--- phpdoc/en/reference/dio/functions/dio-seek.xml:1.4  Thu Aug 12 14:11:57 2004
+++ phpdoc/en/reference/dio/functions/dio-seek.xml  Tue Sep  7 17:36:22 2004
@@ -1,5 +1,5 @@
 
-
+
 
   

@@ -46,6 +46,35 @@

   
  
+  
+  
+   Setting the baud rate on a serial port
+  
+  
+
+  
+  
 

   
http://cvs.php.net/diff.php/phpdoc/en/reference/dio/functions/dio-tcsetattr.xml?r1=1.7&r2=1.8&ty=u
Index: phpdoc/en/reference/dio/functions/dio-tcsetattr.xml
diff -u phpdoc/en/reference/dio/functions/dio-tcsetattr.xml:1.7 
phpdoc/en/reference/dio/functions/dio-tcsetattr.xml:1.8
--- phpdoc/en/reference/dio/functions/dio-tcsetattr.xml:1.7 Thu Mar  4 12:49:47 
2004
+++ phpdoc/en/reference/dio/functions/dio-tcsetattr.xml Tue Sep  7 17:36:22 2004
@@ -1,5 +1,5 @@
 
-
+
 
   

@@ -75,6 +75,7 @@
   
  
 
+¬e.no-windows;

   
 
http://cvs.php.net/diff.php/phpdoc/en/reference/dio/functions/dio-truncate.xml?r1=1.3&r2=1.4&ty=u
Index: phpdoc/en/reference/dio/functions/dio-truncate.xml
diff -u phpdoc/en/reference/dio/functions/dio-truncate.xml:1.3 
phpdoc/en/reference/dio/functions/dio-truncate.xml:1.4
--- phpdoc/en/reference/dio/functions/dio-truncate.xml:1.3  Sun Jun 29 12:59:53 
2003
+++ phpdoc/en/reference/dio/functions/dio-truncate.xml  Tue Sep  7 17:36:22 2004
@@ -1,5 +1,5 @@
 
-
+
 
   

@@ -24,6 +24,7 @@
  file is left unchanged or is extended. In the latter case the
  extended part reads as zero bytes. &return.success;.
 
+¬e.no-windows;

   
 

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

[Maciek Sokolewicz]

tularis Tue Sep  7 17:35:58 2004 EDT

  Modified files:  
/phpdoc/en/reference/dioreference.xml 
  Log:
  removed the message saying DIO support in unavailable on windows, and replaced it 
with one stating that on windows it requires php5
  
http://cvs.php.net/diff.php/phpdoc/en/reference/dio/reference.xml?r1=1.9&r2=1.10&ty=u
Index: phpdoc/en/reference/dio/reference.xml
diff -u phpdoc/en/reference/dio/reference.xml:1.9 
phpdoc/en/reference/dio/reference.xml:1.10
--- phpdoc/en/reference/dio/reference.xml:1.9   Tue Feb 24 03:45:32 2004
+++ phpdoc/en/reference/dio/reference.xml   Tue Sep  7 17:35:54 2004
@@ -1,5 +1,5 @@
 
-
+
  
   Direct IO Functions
   Direct IO
@@ -17,7 +17,9 @@
  filesystem functions are more
  than adequate. 
 
-¬e.no-windows.extension;
+
+ This extension is only available on Windows Platforms as of PHP 5.0.0
+

 

[PHP-DOC] cvs: phpdoc /en/reference/array/functions natsort.xml

[Maciek Sokolewicz]

tularis Sun Aug  1 19:20:42 2004 EDT

  Modified files:  
/phpdoc/en/reference/array/functionsnatsort.xml 
  Log:
  added the & to the parameter to make it clear(er) that this parameter is passed by 
reference
  
http://cvs.php.net/diff.php/phpdoc/en/reference/array/functions/natsort.xml?r1=1.9&r2=1.10&ty=u
Index: phpdoc/en/reference/array/functions/natsort.xml
diff -u phpdoc/en/reference/array/functions/natsort.xml:1.9 
phpdoc/en/reference/array/functions/natsort.xml:1.10
--- phpdoc/en/reference/array/functions/natsort.xml:1.9 Thu Feb 26 14:55:33 2004
+++ phpdoc/en/reference/array/functions/natsort.xml Sun Aug  1 19:20:42 2004
@@ -1,5 +1,5 @@
 
-
+
 
   

@@ -12,7 +12,7 @@
 Description
  
   voidnatsort
-  arrayarray
+  array&array
  
 
  This function implements a sort algorithm that orders

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

[Maciek Sokolewicz]

tularis Fri Jul 16 08:41:51 2004 EDT

  Modified files:  
/phpdoc/en/reference/image/functionsimagecreate.xml 
  Log:
  fixed small typo in example (& removed comments about it)
  
http://cvs.php.net/diff.php/phpdoc/en/reference/image/functions/imagecreate.xml?r1=1.7&r2=1.8&ty=u
Index: phpdoc/en/reference/image/functions/imagecreate.xml
diff -u phpdoc/en/reference/image/functions/imagecreate.xml:1.7 
phpdoc/en/reference/image/functions/imagecreate.xml:1.8
--- phpdoc/en/reference/image/functions/imagecreate.xml:1.7 Mon Dec 15 11:51:11 
2003
+++ phpdoc/en/reference/image/functions/imagecreate.xml Fri Jul 16 08:41:51 2004
@@ -1,5 +1,5 @@
 
-
+
 
  
   
@@ -30,7 +30,7 @@
 

[PHP-DOC] cvs: phpdoc /en/language/oop5 visibility.xml

[Maciek Sokolewicz]

tularis Thu Jul 15 05:47:21 2004 EDT

  Modified files:  
/phpdoc/en/language/oop5visibility.xml 
  Log:
  fixed small typo (public, private or private => public, private or protected)
  
http://cvs.php.net/diff.php/phpdoc/en/language/oop5/visibility.xml?r1=1.1&r2=1.2&ty=u
Index: phpdoc/en/language/oop5/visibility.xml
diff -u phpdoc/en/language/oop5/visibility.xml:1.1 
phpdoc/en/language/oop5/visibility.xml:1.2
--- phpdoc/en/language/oop5/visibility.xml:1.1  Sun Jul 11 08:33:25 2004
+++ phpdoc/en/language/oop5/visibility.xml  Thu Jul 15 05:47:21 2004
@@ -1,5 +1,5 @@
 
-
+
  
   Visibility
   
@@ -12,7 +12,7 @@
   
Members Visibility

-   Class members must be defined with public, private, or private.
+   Class members must be defined with public, private, or protected.

 
  Member declaration

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

[Maciek Sokolewicz]

tularis Sat Jan  4 05:51:51 2003 EDT

  Modified files:  
/phpdoc/en/reference/image/functionsgetimagesize.xml 
  Log:
   Fixed bug #21403
  
  
Index: phpdoc/en/reference/image/functions/getimagesize.xml
diff -u phpdoc/en/reference/image/functions/getimagesize.xml:1.10 
phpdoc/en/reference/image/functions/getimagesize.xml:1.11
--- phpdoc/en/reference/image/functions/getimagesize.xml:1.10   Fri Sep  6 02:58:43 
2002
+++ phpdoc/en/reference/image/functions/getimagesize.xmlSat Jan  4 05:51:51 
+2003
@@ -1,5 +1,5 @@
 
-
+
 
  
   
@@ -78,7 +78,7 @@


 Beginning with PHP 4.3, getimagesize also returns an
-additional parameter, MIME, that corresponds with the
+additional parameter, mime, that corresponds with the
 MIME type of the image.  This information can be used to deliver images
 with correct HTTP Content-type headers:
 



-- 
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/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

[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