Re: [PHP-DOC] Question regarding checks in translations

[Yannick Torrès]

2011/11/29 Karl Pflästerer :
> Am 27.11.11 23:47, schrieb Karl Pflästerer:
>> Am 27.11.11 23:23, schrieb Yannick Torrès:
>>>  2011/11/27 Karl Pflästerer:
   Hi,
>>>
>>>  Hi,
>>>
   forgive me if I ask something which had already been discussed, but I've
   seen nothing in the archives.

   I try to help translating some of the docs and saw here
   https://edit.php.net/ this box:

   Check for errors in /language-snippets.ent

   The content for that box seems to get computed from tha class
   http://svn.php.net/repository/web/doc-editor/trunk/php/ToolsError.php

   There is a method attributLinkTag()

   To compare the linkend atrribute of the   tags it uses a regex.

   $reg = '//s';

   You see between>>> allowed.
   But for example in the german translation (and also in the english
   documentation) some   tags have another attribute between the 
 element
   name and "linkend".
>>>
>>>  Could you give me an example please of this case ?
>>
>>> From en/language-snippets.ent
>>
>> > xmlns="http://docbook.org/ns/docbook"; linkend="array.sorting">comparison of 
>> array sorting functions'>
>>
>> > xmlns="http://docbook.org/ns/docbook"; 
>> linkend="language.types.callback">callback  type'>
>>
>> In the german translation are more examples (some of them IMHO wrong, since
>> they duplicate the xmlns attribute), but I'm not sure if such a simple
>> difference should trigger such an error.
>>
>>>
   An easy fix would be
   $reg = '/]+linkend=("|\')(.*?)("|\')[^<>]*>/s';

   But that would solve only have of the problem; the other problem is that 
 the
   check script needs the same order of entities in both files and it 
 compares
   only the position of the found links in both match arrays. So e.g. one 
 link
   more in the translation will give false matches for all following 
 entries.
>>>
>>>  Yes it is.
>>>  The goal here is to check each file and warn when there is only one
>>>  difference even if this is an ordre problem (this can be a translation
>>>  error too).
>>
>> Ok. (for a file with only entity definition order shouldn't matter or?)
>>
>>>
   Does it make sense to rewrite that algorithm, so that it compares each
   entity in the english original and the translation so we get better 
 errors?
>>>
>>>  You mean to avoid order check ?
>>>  Perhaps we can do this yes : check the number of this tag, and check
>>>  if there is all of this tag, even if the order is not respected.
>>
>> I thought to perhaps check each entity definition; so not to do a simple
>> preg_match_all and compare $match_en[1] to $match_lang[1] but to compare the
>> linkend attribute of entity definition in en and $lang.
>>
>> Then the error could be: Difference in linkend attribute in entity xyz.
>
> To be a little bit more concrete, here is a code example (that's just a POC):
>
> 
> function extract_linkend ($s) {
>
>  $rx_linkend = '
>    /
>    <(?: link | xref)
>     [^<>]+
>     linkend=(?:"|\') (.*?) (?:"|\')
>     [^<>]*
>    >
>   /xs';
>
>  $rx_entities = '/(
>  preg_match_all($rx_entities, $s, $m_entities, PREG_SET_ORDER);
>  $linkend_by_entity = array();
>  foreach ($m_entities as $entity) {
>    preg_match_all($rx_linkend, $entity[1], $m_linkend);
>    if ($m_linkend[1])
>      $linkend_by_entity[$entity[2]] = $m_linkend[1];
>  };
>  return $linkend_by_entity;
> }
>
>
> $link_de = extract_linkend(file_get_contents('language-snippets.ent'));
> $link_en = extract_linkend(file_get_contents('../en/language-snippets.ent'));
>
> $diff = array_udiff_assoc($link_en, $link_de,
>                           function ($en, $lang) { return array_diff($en, 
> $lang) ? 1 : 0; } );
>
> foreach ($diff as $entity => $linkends) {
>  echo "Entity: $entity\n";
>  echo 'EN: ' . join('; ', $linkends), "\n";
>  echo 'DE: ' . join('; ', $link_de[$entity]), "\n\n";
> }
>
>
> If I run that (with the de translation), I get:
>
> Entity: ini.php.constants
> EN: configuration.changes.modes
> DE: ini
>
> Entity: mysqli.available.mysqlnd
> EN: book.mysqlnd
> DE: mysqli.overview.mysqlnd
>
> That could be helpful (IMHO).
>
>  KP
>
>

Thanks Karl,
I will add this asap

Great work,
Yannick

Re: [PHP-DOC] Question regarding checks in translations

[Karl Pflästerer]

Am 27.11.11 23:47, schrieb Karl Pflästerer:
> Am 27.11.11 23:23, schrieb Yannick Torrès:
>>  2011/11/27 Karl Pflästerer:
>>>   Hi,
>>
>>  Hi,
>>
>>>   forgive me if I ask something which had already been discussed, but I've
>>>   seen nothing in the archives.
>>>
>>>   I try to help translating some of the docs and saw here
>>>   https://edit.php.net/ this box:
>>>
>>>   Check for errors in /language-snippets.ent
>>>
>>>   The content for that box seems to get computed from tha class
>>>   http://svn.php.net/repository/web/doc-editor/trunk/php/ToolsError.php
>>>
>>>   There is a method attributLinkTag()
>>>
>>>   To compare the linkend atrribute of the   tags it uses a regex.
>>>
>>>   $reg = '//s';
>>>
>>>   You see between>>   But for example in the german translation (and also in the english
>>>   documentation) some   tags have another attribute between the 
>>> element
>>>   name and "linkend".
>>
>>  Could you give me an example please of this case ?
> 
>> From en/language-snippets.ent
> 
>  xmlns="http://docbook.org/ns/docbook"; linkend="array.sorting">comparison of 
> array sorting functions'>
> 
>  xmlns="http://docbook.org/ns/docbook"; 
> linkend="language.types.callback">callback  type'>
> 
> In the german translation are more examples (some of them IMHO wrong, since
> they duplicate the xmlns attribute), but I'm not sure if such a simple
> difference should trigger such an error.
> 
>>
>>>   An easy fix would be
>>>   $reg = '/]+linkend=("|\')(.*?)("|\')[^<>]*>/s';
>>>
>>>   But that would solve only have of the problem; the other problem is that 
>>> the
>>>   check script needs the same order of entities in both files and it 
>>> compares
>>>   only the position of the found links in both match arrays. So e.g. one 
>>> link
>>>   more in the translation will give false matches for all following entries.
>>
>>  Yes it is.
>>  The goal here is to check each file and warn when there is only one
>>  difference even if this is an ordre problem (this can be a translation
>>  error too).
> 
> Ok. (for a file with only entity definition order shouldn't matter or?)
> 
>>
>>>   Does it make sense to rewrite that algorithm, so that it compares each
>>>   entity in the english original and the translation so we get better 
>>> errors?
>>
>>  You mean to avoid order check ?
>>  Perhaps we can do this yes : check the number of this tag, and check
>>  if there is all of this tag, even if the order is not respected.
> 
> I thought to perhaps check each entity definition; so not to do a simple
> preg_match_all and compare $match_en[1] to $match_lang[1] but to compare the
> linkend attribute of entity definition in en and $lang.
> 
> Then the error could be: Difference in linkend attribute in entity xyz.

To be a little bit more concrete, here is a code example (that's just a POC):

]+
 linkend=(?:"|\') (.*?) (?:"|\')
 [^<>]*
>
   /xs';

  $rx_entities = '/( $linkends) {
  echo "Entity: $entity\n";
  echo 'EN: ' . join('; ', $linkends), "\n";
  echo 'DE: ' . join('; ', $link_de[$entity]), "\n\n";
}


If I run that (with the de translation), I get:

Entity: ini.php.constants
EN: configuration.changes.modes
DE: ini

Entity: mysqli.available.mysqlnd
EN: book.mysqlnd
DE: mysqli.overview.mysqlnd

That could be helpful (IMHO).

  KP

Re: [PHP-DOC] Question regarding checks in translations

[Karl Pflästerer]

Am 27.11.11 23:23, schrieb Yannick Torrès:
> 2011/11/27 Karl Pflästerer:
>>  Hi,
> 
> Hi,
> 
>>  forgive me if I ask something which had already been discussed, but I've
>>  seen nothing in the archives.
>>
>>  I try to help translating some of the docs and saw here
>>  https://edit.php.net/ this box:
>>
>>  Check for errors in /language-snippets.ent
>>
>>  The content for that box seems to get computed from tha class
>>  http://svn.php.net/repository/web/doc-editor/trunk/php/ToolsError.php
>>
>>  There is a method attributLinkTag()
>>
>>  To compare the linkend atrribute of the  tags it uses a regex.
>>
>>  $reg = '//s';
>>
>>  You see between>  But for example in the german translation (and also in the english
>>  documentation) some  tags have another attribute between the element
>>  name and "linkend".
> 
> Could you give me an example please of this case ?

>From en/language-snippets.ent

http://docbook.org/ns/docbook"; 
linkend="array.sorting">comparison of array sorting functions'>

http://docbook.org/ns/docbook"; 
linkend="language.types.callback">callback type'>

In the german translation are more examples (some of them IMHO wrong, since
they duplicate the xmlns attribute), but I'm not sure if such a simple
difference should trigger such an error.

> 
>>  An easy fix would be
>>  $reg = '/]+linkend=("|\')(.*?)("|\')[^<>]*>/s';
>>
>>  But that would solve only have of the problem; the other problem is that the
>>  check script needs the same order of entities in both files and it compares
>>  only the position of the found links in both match arrays. So e.g. one link
>>  more in the translation will give false matches for all following entries.
> 
> Yes it is.
> The goal here is to check each file and warn when there is only one
> difference even if this is an ordre problem (this can be a translation
> error too).

Ok. (for a file with only entity definition order shouldn't matter or?)

> 
>>  Does it make sense to rewrite that algorithm, so that it compares each
>>  entity in the english original and the translation so we get better errors?
> 
> You mean to avoid order check ?
> Perhaps we can do this yes : check the number of this tag, and check
> if there is all of this tag, even if the order is not respected.

I thought to perhaps check each entity definition; so not to do a simple
preg_match_all and compare $match_en[1] to $match_lang[1] but to compare the
linkend attribute of entity definition in en and $lang.

Then the error could be: Difference in linkend attribute in entity xyz.

  KP

Re: [PHP-DOC] Question regarding checks in translations

[Yannick Torrès]

2011/11/27 Karl Pflästerer :
> Hi,

Hi,

> forgive me if I ask something which had already been discussed, but I've
> seen nothing in the archives.
>
> I try to help translating some of the docs and saw here
> https://edit.php.net/ this box:
>
> Check for errors in /language-snippets.ent
>
> The content for that box seems to get computed from tha class
> http://svn.php.net/repository/web/doc-editor/trunk/php/ToolsError.php
>
> There is a method attributLinkTag()
>
> To compare the linkend atrribute of the  tags it uses a regex.
>
> $reg = '//s';
>
> You see between  But for example in the german translation (and also in the english
> documentation) some  tags have another attribute between the element
> name and "linkend".

Could you give me an example please of this case ?


> An easy fix would be
> $reg = '/]+linkend=("|\')(.*?)("|\')[^<>]*>/s';
>
> But that would solve only have of the problem; the other problem is that the
> check script needs the same order of entities in both files and it compares
> only the position of the found links in both match arrays. So e.g. one link
> more in the translation will give false matches for all following entries.

Yes it is.
The goal here is to check each file and warn when there is only one
difference even if this is an ordre problem (this can be a translation
error too).


> Does it make sense to rewrite that algorithm, so that it compares each
> entity in the english original and the translation so we get better errors?

You mean to avoid order check ?
Perhaps we can do this yes : check the number of this tag, and check
if there is all of this tag, even if the order is not respected.


>  KP
>
>
>

[PHP-DOC] Question regarding checks in translations

[Karl Pflästerer]

Hi,
forgive me if I ask something which had already been discussed, but I've 
seen nothing in the archives.


I try to help translating some of the docs and saw here 
https://edit.php.net/ this box:


Check for errors in /language-snippets.ent

The content for that box seems to get computed from tha class
http://svn.php.net/repository/web/doc-editor/trunk/php/ToolsError.php

There is a method attributLinkTag()

To compare the linkend atrribute of the  tags it uses a regex.

$reg = '//s';

You see between allowed. But for example in the german translation (and also in the 
english documentation) some  tags have another attribute between 
the element name and "linkend".


An easy fix would be
$reg = '/]+linkend=("|\')(.*?)("|\')[^<>]*>/s';

But that would solve only have of the problem; the other problem is that 
the check script needs the same order of entities in both files and it 
compares only the position of the found links in both match arrays. So 
e.g. one link more in the translation will give false matches for all 
following entries.


Does it make sense to rewrite that algorithm, so that it compares each 
entity in the english original and the translation so we get better errors?


  KP

[PHP-DOC] Question

[Jesús Cova]

I had time that I did not use online documentation edit, I do not remember
the web page if you can tell me, please Thanks.

-- 
Regards

Jesús Rafael Cova Huerta

[PHP-DOC] Question

[Jesús Cova]

Why does php online editor not work by IE? the web keeps thinking and it
does not show anything, it just shows refreshing of the AJAX like it would
be loading but it is not doing that..

-- 
Regards

Jesús Rafael Cova Huerta

Re: [PHP-DOC] Question about redirection and user notes

[Hannes Magnusson]

2009/10/20 Ruslan Yakushev :
>
>> From: Richard Quadling [mailto:rquadl...@googlemail.com]
>>
>> The entries in the left hand menu don't reflect the nested nature of
>> the IIS documentation.
>>
>> Book = install (From doc-base/manual.xml)
>>    Chapter = install.windows (From en/install/windows/index.xml)
>>       Sect1 = install.windows.iis (From en/install/windows/iis.xml)
>>       Sect1 = install.windows.iis6 (From en/install/windows/iis6.xml)
>>       Sect1 = install.windows.iis7 (From en/install/windows/iis7.xml)
>>
>
> Yes, originally I wanted to make the iis.xml to be a parent page for iis6 and 
> iis7, but I could not figure out how to do it in the docbook syntax.
>
> If you know how to make this change, could you let me know how and I will 
> definitely change it.

Could you report it as a bug?
I'll try to come up with something (using s or something along
those lines comes to mind...).

-Hannes

RE: [PHP-DOC] Question about redirection and user notes

[Ruslan Yakushev]

> -Original Message-
> From: Richard Quadling [mailto:rquadl...@googlemail.com]
> Sent: Tuesday, October 20, 2009 2:23 AM
> To: PHP Documentation ML
> Subject: Re: [PHP-DOC] Question about redirection and user notes
> 
> 2009/10/19 Hannes Magnusson :
> > On Sat, Oct 17, 2009 at 01:08, Ruslan Yakushev
>  wrote:
> >> For now I have checked in the updates so that the
> install.windows.iis contains the links to version-specific installation
> instructions and the install.windows.iis6 and install.windows.ii7 are
> the siblings to it.
> >>
> >
> >
> > It seems ok http://docs.php.net/install.windows.iis :)
> >
> > Nice work
> >
> > -Hannes
> >
> 
> The entries in the left hand menu don't reflect the nested nature of
> the IIS documentation.
> 
> Book = install (From doc-base/manual.xml)
>Chapter = install.windows (From en/install/windows/index.xml)
>   Sect1 = install.windows.iis (From en/install/windows/iis.xml)
>   Sect1 = install.windows.iis6 (From en/install/windows/iis6.xml)
>   Sect1 = install.windows.iis7 (From en/install/windows/iis7.xml)
> 
> 
> install.windows.iis is not a section "containing" iis6/7
> 
> 
> Is it really necessary to have iis.xml say anything about IIS6/7?
> 
> I don't know about previous versions of IIS in terms of running PHP.
> Maybe something should be mentioned on the iis page instead?
> 
> --
> -
> Richard Quadling
> "Standing on the shoulders of some very clever giants!"
> EE : http://www.experts-exchange.com/M_248814.html
> Zend Certified Engineer :
> http://zend.com/zce.php?c=ZEND002498&r=213474731
> ZOPA : http://uk.zopa.com/member/RQuadling

Yes, originally I wanted to make the iis.xml to be a parent page for iis6 and 
iis7, but I could not figure out how to do it in the docbook syntax.

If you know how to make this change, could you let me know how and I will 
definitely change it.

If the iis.xml does not say anything about IIS6/5.1 and IIS7 then I do not know 
what else can be said there. The IIS versions prior to IIS 5.1 are very old and 
I do not think anybody uses them today. Originally, I was thinking of just 
removing this page, but then kept it based on feedback from Hannes and Philip.

Re: [PHP-DOC] Question about redirection and user notes

[Richard Quadling]

2009/10/19 Hannes Magnusson :
> On Sat, Oct 17, 2009 at 01:08, Ruslan Yakushev  wrote:
>> For now I have checked in the updates so that the install.windows.iis 
>> contains the links to version-specific installation instructions and the 
>> install.windows.iis6 and install.windows.ii7 are the siblings to it.
>>
>
>
> It seems ok http://docs.php.net/install.windows.iis :)
>
> Nice work
>
> -Hannes
>

The entries in the left hand menu don't reflect the nested nature of
the IIS documentation.

Book = install (From doc-base/manual.xml)
   Chapter = install.windows (From en/install/windows/index.xml)
  Sect1 = install.windows.iis (From en/install/windows/iis.xml)
  Sect1 = install.windows.iis6 (From en/install/windows/iis6.xml)
  Sect1 = install.windows.iis7 (From en/install/windows/iis7.xml)


install.windows.iis is not a section "containing" iis6/7


Is it really necessary to have iis.xml say anything about IIS6/7?

I don't know about previous versions of IIS in terms of running PHP.
Maybe something should be mentioned on the iis page instead?

-- 
-
Richard Quadling
"Standing on the shoulders of some very clever giants!"
EE : http://www.experts-exchange.com/M_248814.html
Zend Certified Engineer : http://zend.com/zce.php?c=ZEND002498&r=213474731
ZOPA : http://uk.zopa.com/member/RQuadling

Re: [PHP-DOC] Question about redirection and user notes

[Hannes Magnusson]

On Sat, Oct 17, 2009 at 01:08, Ruslan Yakushev  wrote:
> For now I have checked in the updates so that the install.windows.iis 
> contains the links to version-specific installation instructions and the 
> install.windows.iis6 and install.windows.ii7 are the siblings to it.
>


It seems ok http://docs.php.net/install.windows.iis :)

Nice work

-Hannes

RE: [PHP-DOC] Question about redirection and user notes

[Ruslan Yakushev]

For now I have checked in the updates so that the install.windows.iis contains 
the links to version-specific installation instructions and the 
install.windows.iis6 and install.windows.ii7 are the siblings to it.

-Original Message-
From: Ruslan Yakushev [mailto:rusl...@microsoft.com] 
Sent: Friday, October 16, 2009 3:16 PM
To: Philip Olson
Cc: Hannes Magnusson; Richard Quadling; 'PHP Documentation ML'
Subject: RE: [PHP-DOC] Question about redirection and user notes

I have updated the patch. It should apply successfully now.

However Hannes told me on IRC that it may not be possible to do this change. If 
it is indeed not possible then I will have no choice but to make the iis6 and 
iis7 pages to be siblings of iis page.

-Original Message-
From: Ruslan Yakushev [mailto:rusl...@microsoft.com] 
Sent: Friday, October 16, 2009 2:29 PM
To: Philip Olson
Cc: Hannes Magnusson; Richard Quadling; 'PHP Documentation ML'
Subject: RE: [PHP-DOC] Question about redirection and user notes

Actually the original patch that I provided has problems. I'll produce another 
one shortly.

-Original Message-
From: Ruslan Yakushev 
Sent: Friday, October 16, 2009 1:55 PM
To: 'Philip Olson'
Cc: Hannes Magnusson; Richard Quadling; 'PHP Documentation ML'
Subject: RE: [PHP-DOC] Question about redirection and user notes

Here it is: http://ruslany.net/download/en.install.windows.zip 

-Original Message-
From: Philip Olson [mailto:phi...@roshambo.org] 
Sent: Friday, October 16, 2009 1:50 PM
To: Ruslan Yakushev
Cc: Hannes Magnusson; Richard Quadling; 'PHP Documentation ML'
Subject: Re: [PHP-DOC] Question about redirection and user notes


On Oct 16, 2009, at 1:03 PM, Ruslan Yakushev wrote:

> Can somebody please help with the change to make the  
> install.windows.iis as a parent page for the install.windows.iis6  
> and install.windows.ii7?
>
> I have made the change as in this patch: 
> http://ruslany.net/download/PHPDOCS_PROBLEM.zip
>
> When I try to build it I get this error:
>
> ERROR (file:///C:/PHPSVN/phpdoc1/en/install/windows/index.xml:50:25)
>   &install.windows.iis;
> -^
> Entity 'install.windows.iis' not defined
>
>
> I can see why it happens - the file with this entity has been moved  
> into an "iis" subfolder. But I cannot figure out how to fix it.

Hello Ruslan,

Please post a copy of your en/install/windows/ sources, as I'm unable  
to cleanly apply this patch (could easily be my problem) for testing.  
Namely, windows/manual.xml and seemingly index.xml.

Regards,
Philip

RE: [PHP-DOC] Question about redirection and user notes

[Ruslan Yakushev]

I have updated the patch. It should apply successfully now.

However Hannes told me on IRC that it may not be possible to do this change. If 
it is indeed not possible then I will have no choice but to make the iis6 and 
iis7 pages to be siblings of iis page.

-Original Message-
From: Ruslan Yakushev [mailto:rusl...@microsoft.com] 
Sent: Friday, October 16, 2009 2:29 PM
To: Philip Olson
Cc: Hannes Magnusson; Richard Quadling; 'PHP Documentation ML'
Subject: RE: [PHP-DOC] Question about redirection and user notes

Actually the original patch that I provided has problems. I'll produce another 
one shortly.

-Original Message-
From: Ruslan Yakushev 
Sent: Friday, October 16, 2009 1:55 PM
To: 'Philip Olson'
Cc: Hannes Magnusson; Richard Quadling; 'PHP Documentation ML'
Subject: RE: [PHP-DOC] Question about redirection and user notes

Here it is: http://ruslany.net/download/en.install.windows.zip 

-Original Message-
From: Philip Olson [mailto:phi...@roshambo.org] 
Sent: Friday, October 16, 2009 1:50 PM
To: Ruslan Yakushev
Cc: Hannes Magnusson; Richard Quadling; 'PHP Documentation ML'
Subject: Re: [PHP-DOC] Question about redirection and user notes


On Oct 16, 2009, at 1:03 PM, Ruslan Yakushev wrote:

> Can somebody please help with the change to make the  
> install.windows.iis as a parent page for the install.windows.iis6  
> and install.windows.ii7?
>
> I have made the change as in this patch: 
> http://ruslany.net/download/PHPDOCS_PROBLEM.zip
>
> When I try to build it I get this error:
>
> ERROR (file:///C:/PHPSVN/phpdoc1/en/install/windows/index.xml:50:25)
>   &install.windows.iis;
> -^
> Entity 'install.windows.iis' not defined
>
>
> I can see why it happens - the file with this entity has been moved  
> into an "iis" subfolder. But I cannot figure out how to fix it.

Hello Ruslan,

Please post a copy of your en/install/windows/ sources, as I'm unable  
to cleanly apply this patch (could easily be my problem) for testing.  
Namely, windows/manual.xml and seemingly index.xml.

Regards,
Philip

RE: [PHP-DOC] Question about redirection and user notes

[Ruslan Yakushev]

Actually the original patch that I provided has problems. I'll produce another 
one shortly.

-Original Message-
From: Ruslan Yakushev 
Sent: Friday, October 16, 2009 1:55 PM
To: 'Philip Olson'
Cc: Hannes Magnusson; Richard Quadling; 'PHP Documentation ML'
Subject: RE: [PHP-DOC] Question about redirection and user notes

Here it is: http://ruslany.net/download/en.install.windows.zip 

-Original Message-
From: Philip Olson [mailto:phi...@roshambo.org] 
Sent: Friday, October 16, 2009 1:50 PM
To: Ruslan Yakushev
Cc: Hannes Magnusson; Richard Quadling; 'PHP Documentation ML'
Subject: Re: [PHP-DOC] Question about redirection and user notes


On Oct 16, 2009, at 1:03 PM, Ruslan Yakushev wrote:

> Can somebody please help with the change to make the  
> install.windows.iis as a parent page for the install.windows.iis6  
> and install.windows.ii7?
>
> I have made the change as in this patch: 
> http://ruslany.net/download/PHPDOCS_PROBLEM.zip
>
> When I try to build it I get this error:
>
> ERROR (file:///C:/PHPSVN/phpdoc1/en/install/windows/index.xml:50:25)
>   &install.windows.iis;
> -^
> Entity 'install.windows.iis' not defined
>
>
> I can see why it happens - the file with this entity has been moved  
> into an "iis" subfolder. But I cannot figure out how to fix it.

Hello Ruslan,

Please post a copy of your en/install/windows/ sources, as I'm unable  
to cleanly apply this patch (could easily be my problem) for testing.  
Namely, windows/manual.xml and seemingly index.xml.

Regards,
Philip

RE: [PHP-DOC] Question about redirection and user notes

[Ruslan Yakushev]

Here it is: http://ruslany.net/download/en.install.windows.zip 

-Original Message-
From: Philip Olson [mailto:phi...@roshambo.org] 
Sent: Friday, October 16, 2009 1:50 PM
To: Ruslan Yakushev
Cc: Hannes Magnusson; Richard Quadling; 'PHP Documentation ML'
Subject: Re: [PHP-DOC] Question about redirection and user notes


On Oct 16, 2009, at 1:03 PM, Ruslan Yakushev wrote:

> Can somebody please help with the change to make the  
> install.windows.iis as a parent page for the install.windows.iis6  
> and install.windows.ii7?
>
> I have made the change as in this patch: 
> http://ruslany.net/download/PHPDOCS_PROBLEM.zip
>
> When I try to build it I get this error:
>
> ERROR (file:///C:/PHPSVN/phpdoc1/en/install/windows/index.xml:50:25)
>   &install.windows.iis;
> -^
> Entity 'install.windows.iis' not defined
>
>
> I can see why it happens - the file with this entity has been moved  
> into an "iis" subfolder. But I cannot figure out how to fix it.

Hello Ruslan,

Please post a copy of your en/install/windows/ sources, as I'm unable  
to cleanly apply this patch (could easily be my problem) for testing.  
Namely, windows/manual.xml and seemingly index.xml.

Regards,
Philip

Re: [PHP-DOC] Question about redirection and user notes

[Philip Olson]

On Oct 16, 2009, at 1:03 PM, Ruslan Yakushev wrote:

Can somebody please help with the change to make the  
install.windows.iis as a parent page for the install.windows.iis6  
and install.windows.ii7?


I have made the change as in this patch: 
http://ruslany.net/download/PHPDOCS_PROBLEM.zip

When I try to build it I get this error:

ERROR (file:///C:/PHPSVN/phpdoc1/en/install/windows/index.xml:50:25)
  &install.windows.iis;
-^
Entity 'install.windows.iis' not defined


I can see why it happens - the file with this entity has been moved  
into an "iis" subfolder. But I cannot figure out how to fix it.


Hello Ruslan,

Please post a copy of your en/install/windows/ sources, as I'm unable  
to cleanly apply this patch (could easily be my problem) for testing.  
Namely, windows/manual.xml and seemingly index.xml.


Regards,
Philip

RE: [PHP-DOC] Question about redirection and user notes

[Ruslan Yakushev]

Can somebody please help with the change to make the install.windows.iis as a 
parent page for the install.windows.iis6 and install.windows.ii7?

I have made the change as in this patch: 
http://ruslany.net/download/PHPDOCS_PROBLEM.zip 

When I try to build it I get this error:

ERROR (file:///C:/PHPSVN/phpdoc1/en/install/windows/index.xml:50:25)
   &install.windows.iis;
-^
 Entity 'install.windows.iis' not defined


I can see why it happens - the file with this entity has been moved into an 
"iis" subfolder. But I cannot figure out how to fix it.

-Original Message-
From: Ruslan Yakushev 
Sent: Thursday, October 15, 2009 12:02 PM
To: 'Philip Olson'
Cc: PHP Documentation ML
Subject: RE: [PHP-DOC] Question about redirection and user notes

Philip,

Are you suggesting to make the page "install.windows.iis" a parent page and 
make all the other IIS related pages, such as iis6 and iis7, to be child pages 
of this page?


> -Original Message-
> From: Philip Olson [mailto:phi...@roshambo.org]
> Sent: Thursday, October 15, 2009 7:54 AM
> To: Ruslan Yakushev
> Cc: PHP Documentation ML
> Subject: Re: [PHP-DOC] Question about redirection and user notes
> 
> 
> On Oct 14, 2009, at 11:21 PM, Ruslan Yakushev wrote:
> 
> > Is there any way to setup a redirection so that when this article is
> > removed: http://www.php.net/manual/en/install.windows.iis.php, then
> > anybody who browses to that URL gets redirected to
> http://www.php.net/manual/en/install.windows.iis7.php?
> 
> I don't think that page should be removed. Perhaps some generic and
> introductory text can live here, along with the TOC, as to give a
> place for people to always link to (http://php.net/
> install.windows.iis) for IIS documentation. Sorry for not looking at
> this closer earlier. One day IIS 7 will be too old, so keeping a
> generic IIS page helps us stand the test of time.
> 
> > Also, I think it is safe to remove all the user notes associated
> > with http://www.php.net/manual/en/install.windows.iis.php, because
> > most of them are very old.
> 
> While logged in, you can delete user notes by simply viewing the page
> and clicking on the [x] near each note to delete. Feel free to delete
> any note you feel doesn't need to be there. The theoretical purpose of
> user notes is to allow users to provide content for the manual, which
> is later integrated into the manual (with a credit in the commit
> message)... and after this the user notes are deleted.
> 
> > However, even though this page
> http://www.php.net/manual/en/install.windows.manual.php
> >  is getting heavily updated, I think the existing user notes should
> > be preserved there.
> >
> > What do you think?
> 
> Sure, delete/integrate user notes as you see fit.
> 
> Regards,
> Philip

RE: [PHP-DOC] Question about redirection and user notes

[Ruslan Yakushev]

Philip,

Are you suggesting to make the page "install.windows.iis" a parent page and 
make all the other IIS related pages, such as iis6 and iis7, to be child pages 
of this page?


> -Original Message-
> From: Philip Olson [mailto:phi...@roshambo.org]
> Sent: Thursday, October 15, 2009 7:54 AM
> To: Ruslan Yakushev
> Cc: PHP Documentation ML
> Subject: Re: [PHP-DOC] Question about redirection and user notes
> 
> 
> On Oct 14, 2009, at 11:21 PM, Ruslan Yakushev wrote:
> 
> > Is there any way to setup a redirection so that when this article is
> > removed: http://www.php.net/manual/en/install.windows.iis.php, then
> > anybody who browses to that URL gets redirected to
> http://www.php.net/manual/en/install.windows.iis7.php?
> 
> I don't think that page should be removed. Perhaps some generic and
> introductory text can live here, along with the TOC, as to give a
> place for people to always link to (http://php.net/
> install.windows.iis) for IIS documentation. Sorry for not looking at
> this closer earlier. One day IIS 7 will be too old, so keeping a
> generic IIS page helps us stand the test of time.
> 
> > Also, I think it is safe to remove all the user notes associated
> > with http://www.php.net/manual/en/install.windows.iis.php, because
> > most of them are very old.
> 
> While logged in, you can delete user notes by simply viewing the page
> and clicking on the [x] near each note to delete. Feel free to delete
> any note you feel doesn't need to be there. The theoretical purpose of
> user notes is to allow users to provide content for the manual, which
> is later integrated into the manual (with a credit in the commit
> message)... and after this the user notes are deleted.
> 
> > However, even though this page
> http://www.php.net/manual/en/install.windows.manual.php
> >  is getting heavily updated, I think the existing user notes should
> > be preserved there.
> >
> > What do you think?
> 
> Sure, delete/integrate user notes as you see fit.
> 
> Regards,
> Philip

Re: [PHP-DOC] Question about redirection and user notes

[Philip Olson]

On Oct 14, 2009, at 11:21 PM, Ruslan Yakushev wrote:

Is there any way to setup a redirection so that when this article is  
removed: http://www.php.net/manual/en/install.windows.iis.php, then  
anybody who browses to that URL gets redirected to http://www.php.net/manual/en/install.windows.iis7.php?


I don't think that page should be removed. Perhaps some generic and  
introductory text can live here, along with the TOC, as to give a  
place for people to always link to (http://php.net/ 
install.windows.iis) for IIS documentation. Sorry for not looking at  
this closer earlier. One day IIS 7 will be too old, so keeping a  
generic IIS page helps us stand the test of time.


Also, I think it is safe to remove all the user notes associated  
with http://www.php.net/manual/en/install.windows.iis.php, because  
most of them are very old.


While logged in, you can delete user notes by simply viewing the page  
and clicking on the [x] near each note to delete. Feel free to delete  
any note you feel doesn't need to be there. The theoretical purpose of  
user notes is to allow users to provide content for the manual, which  
is later integrated into the manual (with a credit in the commit  
message)... and after this the user notes are deleted.


However, even though this page http://www.php.net/manual/en/install.windows.manual.php 
 is getting heavily updated, I think the existing user notes should  
be preserved there.


What do you think?


Sure, delete/integrate user notes as you see fit.

Regards,
Philip

[PHP-DOC] Question about redirection and user notes

[Ruslan Yakushev]

Is there any way to setup a redirection so that when this article is removed: 
http://www.php.net/manual/en/install.windows.iis.php, then anybody who browses 
to that URL gets redirected to 
http://www.php.net/manual/en/install.windows.iis7.php?

Also, I think it is safe to remove all the user notes associated with 
http://www.php.net/manual/en/install.windows.iis.php, because most of them are 
very old. 

However, even though this page 
http://www.php.net/manual/en/install.windows.manual.php is getting heavily 
updated, I think the existing user notes should be preserved there. 

What do you think?

Re: [PHP-DOC] Question about including screenshots into the documentation

[Richard Quadling]

2009/9/25 Ruslan Yakushev :
> Hannes,
>
> What is the policy or a standard on including the UI screenshots into the PHP 
> docs. For example for Windows specific installation instructions it may be 
> beneficial to show some UI screenshots to help users to find the right 
> settings (e.g. 
> http://learn.iis.net/page.aspx/246/using-fastcgi-to-host-php-applications-on-iis-70/)
>
> However, it looks like the usage of the screenshots in the PHP docs it not 
> that common. So, when writing IIS and Windows installation docs should I 
> bother with screenshots or should I just describe how to use command line for 
> all the configuration steps?
>
> Thanks,
> Ruslan
>

Personally, a few images can certainly make things easier in the
point-and-click world.


-- 
-
Richard Quadling
"Standing on the shoulders of some very clever giants!"
EE : http://www.experts-exchange.com/M_248814.html
Zend Certified Engineer : http://zend.com/zce.php?c=ZEND002498&r=213474731
ZOPA : http://uk.zopa.com/member/RQuadling

[PHP-DOC] Question about including screenshots into the documentation

[Ruslan Yakushev]

Hannes,

What is the policy or a standard on including the UI screenshots into the PHP 
docs. For example for Windows specific installation instructions it may be 
beneficial to show some UI screenshots to help users to find the right settings 
(e.g. 
http://learn.iis.net/page.aspx/246/using-fastcgi-to-host-php-applications-on-iis-70/)

However, it looks like the usage of the screenshots in the PHP docs it not that 
common. So, when writing IIS and Windows installation docs should I bother with 
screenshots or should I just describe how to use command line for all the 
configuration steps?

Thanks,
Ruslan

Re: [PHP-DOC] Question about 'Revision Check'

[Hannes Magnusson]

On Mon, Dec 15, 2008 at 00:11, Bastian Feder  wrote:
> Hi folks,
>
> as I am scanning what to do next I looked at the 'Revision Check' page
> (http://doc.php.net/php/de/revcheck.php?dir=51&p=files) and selected
> the SQLite section.
> You'll see an HTML-table with a number of columns, which one of them
> is named 'status'.
> Since I did not find any explaination what 'status' means, I just
> wanted to ask what is this all about? What does each state (e.g.
> working, ready, etc)  mean?

Status is just an artificial status for humans to see if the
"maintainer" of that file was finished translating it or is still
working on it.
This status obviously only relates to the EN-Revision the file
references, so the chances are that files with status=ready are out of
date.

-Hannes

[PHP-DOC] Question about 'Revision Check'

[Bastian Feder]

Hi folks,

as I am scanning what to do next I looked at the 'Revision Check' page
(http://doc.php.net/php/de/revcheck.php?dir=51&p=files) and selected
the SQLite section.
You'll see an HTML-table with a number of columns, which one of them
is named 'status'.
Since I did not find any explaination what 'status' means, I just
wanted to ask what is this all about? What does each state (e.g.
working, ready, etc)  mean?

solong
Lapis

-- 
--
spread the word ... see  www.browsehappy.com ;o)

Calvin: Weekends don't count unless you spend them doing something
completely pointless.

Join the Greater IBM  Connection (http://www.xing.com/premiumgroup-6291.d26b7d)

Re: [PHP-DOC] Question about "appendices/migration52.xml"

[Hannes Magnusson]

On Jan 9, 2008 2:59 PM, Simion Onea <[EMAIL PROTECTED]> wrote:
> > -Original Message-
> > From: Hannes Magnusson [mailto:[EMAIL PROTECTED]
> > Sent: Wednesday, January 09, 2008 3:13 PM
> > To: Simion Onea
> > Cc: PHPdoc
> > Subject: Re: [PHP-DOC] Question about "appendices/migration52.xml"
> >
> > If the function isn't documented yet then I think the full
> > funcsynopsis is needed, for documented functions it is enough
> > to name the function (and the new parameter when appropriate).
> >
> > -Hannes
>
> Ok, then I understand that I should not touch them.
> But what about enclosing the function definition inside
>  ?

I wouldn't waste my time on it. Documenting these functions (even just
with the basic param info) would be better use of time :)

-Hannes

RE: [PHP-DOC] Question about "appendices/migration52.xml"

[Simion Onea]

> -Original Message-
> From: Hannes Magnusson [mailto:[EMAIL PROTECTED] 
> Sent: Wednesday, January 09, 2008 3:13 PM
> To: Simion Onea
> Cc: PHPdoc
> Subject: Re: [PHP-DOC] Question about "appendices/migration52.xml"
> 
> If the function isn't documented yet then I think the full 
> funcsynopsis is needed, for documented functions it is enough 
> to name the function (and the new parameter when appropriate).
> 
> -Hannes

Ok, then I understand that I should not touch them.
But what about enclosing the function definition inside
 ?

Regards,
Simion.

Re: [PHP-DOC] Question about "appendices/migration52.xml"

[Hannes Magnusson]

On Jan 9, 2008 1:57 PM, Simion Onea <[EMAIL PROTECTED]> wrote:
> Hi!
>
> While translating the file "appendices/migration52.xml" I found an 
> interesting situation in the lists of new/changed functions in different 
> extensions.
> For example, take lines 736 and 746. They mention two functions in the SPL 
> and XMLReader extensions respectively:
>   array iterator_to_array(Traversable it [, bool use_keys = true])
> and
>   XMLReader::open
>
> Notice that in one case the complete function definition is used, while in 
> the second case only the function name is used.
> There are many such situations in this file. What should we do in this case? 
> I think it would be good to bring them to a common format and apply the 
> necessary tags.
> I can take this task.

If the function isn't documented yet then I think the full
funcsynopsis is needed, for documented functions it is enough to name
the function (and the new parameter when appropriate).

-Hannes

[PHP-DOC] Question about "appendices/migration52.xml"

[Simion Onea]

Hi!

While translating the file "appendices/migration52.xml" I found an interesting 
situation in the lists of new/changed functions in different extensions.
For example, take lines 736 and 746. They mention two functions in the SPL and 
XMLReader extensions respectively:
  array iterator_to_array(Traversable it [, bool use_keys = true])
and
  XMLReader::open

Notice that in one case the complete function definition is used, while in the 
second case only the function name is used.
There are many such situations in this file. What should we do in this case? I 
think it would be good to bring them to a common format and apply the necessary 
tags.
I can take this task.

Best regards,
Simion.

Re: [PHP-DOC] Question on property definitions

[Hannes Magnusson]

On Dec 3, 2007 9:35 PM, Edward Z. Yang <[EMAIL PROTECTED]> wrote:
> Hannes Magnusson wrote:
> > IMO it shouldn't, not. They should look at the "class view" if they
> > want further details on how its defined, the 'detailed property'
> > listing should only contain the description of it.
>
> Ok, that sounds fine. It might, then, be useful to have a link back from
> the detailed property to the class view. It just seems a little
> counterintuitive to me that the in-depth description is not complete,
> i.e. not everything is centralized.

The "detailed property" is a badly misused classification of the section.
It should be "Property Descriptions" (in the spirit of the  in
 for functions) :)

-Hannes

Re: [PHP-DOC] Question on property definitions

[Edward Z. Yang]

Hannes Magnusson wrote:
> IMO it shouldn't, not. They should look at the "class view" if they
> want further details on how its defined, the 'detailed property'
> listing should only contain the description of it.

Ok, that sounds fine. It might, then, be useful to have a link back from
the detailed property to the class view. It just seems a little
counterintuitive to me that the in-depth description is not complete,
i.e. not everything is centralized.

-- 
 Edward Z. YangGnuPG: 0x869C48DA
 HTML Purifier  Anti-XSS Filter
 [[ 3FA8 E9A9 7385 B691 A6FC B3CB A933 BE7D 869C 48DA ]]

Re: [PHP-DOC] Question on property definitions

[Hannes Magnusson]

On Dec 1, 2007 8:03 AM, Edward Z. Yang <[EMAIL PROTECTED]> wrote:
> There's often extra information such as type, readonly and initializer
> that can be specified in the classsynopsis. Should this information be
> duplicated below in the detailed property location? (I don't think so,
> but I do think it should be re-displayed below there).

IMO it shouldn't, not. They should look at the "class view" if they
want further details on how its defined, the 'detailed property'
listing should only contain the description of it.

-Hannes

[PHP-DOC] Question on property definitions

[Edward Z. Yang]

There's often extra information such as type, readonly and initializer
that can be specified in the classsynopsis. Should this information be
duplicated below in the detailed property location? (I don't think so,
but I do think it should be re-displayed below there).
-- 
 Edward Z. YangGnuPG: 0x869C48DA
 HTML Purifier  Anti-XSS Filter
 [[ 3FA8 E9A9 7385 B691 A6FC B3CB A933 BE7D 869C 48DA ]]

Re: [PHP-DOC] Question about the tools

[Hannes Magnusson]

On Nov 27, 2007 7:41 AM, Simion Onea <[EMAIL PROTECTED]> wrote:
> Hi!
>
> Could you please tell me if I am correct:
> First I run "autoconf". (no errors/warnings)
> Then I run "./configure --with-lang=ro". And it says that I have missing ids.
> So I cannot expect that "make test" will pass.
> Am I correct?

I don't think "make test" works anymore, but since the missing IDs are
detected at ./configure time they are replaced with "???" to fix the
build.
Meaning: make test_xml works fine - even with missing IDs.

-Hannes

[PHP-DOC] Question about the tools

[Simion Onea]

Hi!

Could you please tell me if I am correct:
First I run "autoconf". (no errors/warnings)
Then I run "./configure --with-lang=ro". And it says that I have missing ids.
So I cannot expect that "make test" will pass.
Am I correct?

Regards,
Simion.

Re: [PHP-DOC] Question about ini.xml files

[Hannes Magnusson]

On 10/1/07, Nuno Lopes <[EMAIL PROTECTED]> wrote:
> > On 10/1/07, Nuno Lopes <[EMAIL PROTECTED]> wrote:
> >> Although the tables of ini.xml are generated automatically for the
> >> English
> >> manual, the content is not (the explanation of what each opt does).
> >> So you need to translate those files as you would do with any other file.
> >>
> >> Nuno
> >>
> >> P.S.: don't worry because they don't change that often
> >
> > This does however raise the question; shouldn't we split ini.xml into two
> > files?
> > One containing the ini table list and one with the explanations.
> >
> > That way translators could ignore the table list file and only
> > translate the explanation file and get the updated ini-table-list for
> > free.
>
> uhm.. well.. thats too much work for me :P
> Anyway, the table contains localized strings, so the script would need to
> know how to speak the hundreds of languages that the manual is translated
> into.

Ahh. Good point.

-Hannes

Re: [PHP-DOC] Question about ini.xml files

[Nuno Lopes]

On 10/1/07, Nuno Lopes <[EMAIL PROTECTED]> wrote:
Although the tables of ini.xml are generated automatically for the 
English

manual, the content is not (the explanation of what each opt does).
So you need to translate those files as you would do with any other file.

Nuno

P.S.: don't worry because they don't change that often


This does however raise the question; shouldn't we split ini.xml into two 
files?

One containing the ini table list and one with the explanations.

That way translators could ignore the table list file and only
translate the explanation file and get the updated ini-table-list for
free.


uhm.. well.. thats too much work for me :P
Anyway, the table contains localized strings, so the script would need to 
know how to speak the hundreds of languages that the manual is translated 
into.


Nuno 

Re: [PHP-DOC] Question about ini.xml files

[Hannes Magnusson]

On 10/1/07, Nuno Lopes <[EMAIL PROTECTED]> wrote:
> Although the tables of ini.xml are generated automatically for the English
> manual, the content is not (the explanation of what each opt does).
> So you need to translate those files as you would do with any other file.
>
> Nuno
>
> P.S.: don't worry because they don't change that often

This does however raise the question; shouldn't we split ini.xml into two files?
One containing the ini table list and one with the explanations.

That way translators could ignore the table list file and only
translate the explanation file and get the updated ini-table-list for
free.

-Hannes

Re: [PHP-DOC] Question about ini.xml files

[Nuno Lopes]

Although the tables of ini.xml are generated automatically for the English 
manual, the content is not (the explanation of what each opt does).

So you need to translate those files as you would do with any other file.

Nuno

P.S.: don't worry because they don't change that often

- Original Message - 

Hi !

I have a question about 'ini.xml' files from the translator's point of 
view.
Do we need to translate them or are they automatically generated and we 
must

not touch them?

Regards,
Simion. 

[PHP-DOC] Question about ini.xml files

[Simion Onea]

Hi !

I have a question about 'ini.xml' files from the translator's point of view.
Do we need to translate them or are they automatically generated and we must
not touch them?

Regards,
Simion.

Re: [PHP-DOC] Question about

[Hannes Magnusson]

On 9/26/07, Simion Onea <[EMAIL PROTECTED]> wrote:
> Hi!
>
> A short question about markup:
> Can  be used inside  and inside 
> ?

Yes; http://www.docbook.org/tdg5/en/html/literal.html

-Hannes

[PHP-DOC] Question about

[Simion Onea]

Hi!

A short question about markup:
Can  be used inside  and inside ?

Regards,
Simion.

Re: [PHP-DOC] Question about

[Hannes Magnusson]

On 6/19/07, Simion Onea <[EMAIL PROTECTED]> wrote:

Hi,

Should I translate the text between the "type" tags, such as in the example 
below ?

Example: The result resource that is being evaluated.


No. Don't translate the argument name either (the  tags)

-Hannes

[PHP-DOC] Question about

[Simion Onea]

Hi,

Should I translate the text between the "type" tags, such as in the example 
below ?

Example: The result resource that is being evaluated.

Sincerely,
Simion Onea.

Re: [PHP-DOC] Question about "extensions.ent".

[Nuno Lopes]

Maybe the wording is not the best, but that file is supposed to be 
translated. The file you shouldn't translate is the 
en/appendices/extensions.xml


Nuno


- Original Message - 
From: "Simion Onea" <[EMAIL PROTECTED]>

To: 
Sent: Monday, June 11, 2007 2:33 PM
Subject: [PHP-DOC] Question about "extensions.ent".


In attention to Mr. Hartmut Holzgraefe,

Hello,

I currently participate in the translation of the documentation to Romanian.
I noticed that on Sep 3, 2005 you placed in the "ro" tree a file named 
"extensions.ent" with the contents:



I opened this file in the "en" tree and basically in the beginning I found 
the following comment:



I am confused whether we should translate this file or not.

Sincerely,
Simion Onea. 

[PHP-DOC] Question about "extensions.ent".

[Simion Onea]

In attention to Mr. Hartmut Holzgraefe,

Hello,

I currently participate in the translation of the documentation to Romanian.
I noticed that on Sep 3, 2005 you placed in the "ro" tree a file named 
"extensions.ent" with the contents:


I opened this file in the "en" tree and basically in the beginning I found the 
following comment:


I am confused whether we should translate this file or not.

Sincerely,
Simion Onea.

Re: [PHP-DOC] question about mail function in safe_mode

[Hannes Magnusson]

Hi Sergei!

Please file a bug-report for the .ru translators about it.

-Hannes

On 9/19/06, Sergei Drachev <[EMAIL PROTECTED]> wrote:

Hello,

There is a string
"4.2.3   The additional_parameters parameter is disabled in safe_mode and the
mail() function will expose a warning message and return FALSE when used."

on the page http://www.php.net/manual/ru/function.mail.php
This sentence was not translated into russian.

I think some people who dont speak english perfectly could have problems with
understanding its meaning. (And they have)

It could be written as:
The additional_parameters parameter is disabled in safe_mode.
The mail() function will expose a warning message and return FALSE when used
dispite the number of parameters.

Or it could be written as:
The additional_parameters parameter is disabled in safe_mode and the mail()
function will expose a warning message and return FALSE when you try to use
this parameter.


With Best Regards,
Sergei Drachev.

[PHP-DOC] question about mail function in safe_mode

[Sergei Drachev]

Hello,

There is a string 
"4.2.3   The additional_parameters parameter is disabled in safe_mode and the
mail() function will expose a warning message and return FALSE when used."

on the page http://www.php.net/manual/ru/function.mail.php
This sentence was not translated into russian.

I think some people who dont speak english perfectly could have problems with
understanding its meaning. (And they have)

It could be written as:
The additional_parameters parameter is disabled in safe_mode.
The mail() function will expose a warning message and return FALSE when used
dispite the number of parameters.

Or it could be written as:
The additional_parameters parameter is disabled in safe_mode and the mail()
function will expose a warning message and return FALSE when you try to use
this parameter.


With Best Regards,
Sergei Drachev.

Re: [PHP-DOC] Question on pg_result_status

[Christopher Kings-Lynne]

Fixed in CVS.
Cornelia Boenigk wrote:
Hi
The constants.xml says:
PGSQL_COPY_OUT
PGSQL_COPY_IN
...
Returned by pg_result_status
The manual-page for pg_result_status says:
Possible return values are ...
PGSQL_COPY_TO, PGSQL_COPY_FROM,
Wich one is correct?
Regards
Conni

Re: [PHP-DOC] Question on pg_result_status

[Philip Olson]

According to the source:

 a) http://lxr.php.net/
 b) search for function name

http://lxr.php.net/source/php-src/ext/pgsql/pgsql.c#444

IN/OUT are used. Even pgsql_copy_(from|to) use the IN/OUT
constants. I could not find TO/FROM anywhere in the history
either.

Regards,
Philip

On Sun, 1 May 2005, Cornelia Boenigk wrote:

> Hi
> 
> The constants.xml says:
> 
> PGSQL_COPY_OUT
> PGSQL_COPY_IN
> ...
> Returned by pg_result_status
> 
> 
> The manual-page for pg_result_status says:
> 
> Possible return values are ...
> PGSQL_COPY_TO, PGSQL_COPY_FROM,
> 
> Wich one is correct?
> 
> Regards
> Conni
> 

[PHP-DOC] Question on pg_result_status

[Cornelia Boenigk]

Hi
The constants.xml says:
PGSQL_COPY_OUT
PGSQL_COPY_IN
...
Returned by pg_result_status
The manual-page for pg_result_status says:
Possible return values are ...
PGSQL_COPY_TO, PGSQL_COPY_FROM,
Wich one is correct?
Regards
Conni

Re: [PHP-DOC] Question about encoding again

[Derick Rethans]

On Thu, 21 Apr 2005, Xiaoyu Huang wrote:

> I have waited the whole day but the manual is still not updated.
> Was the build stopped or something else was wrong?

It still has errors, fix them first!

  [8]=>  string(241) "SP_ENCODING=XML SP_CHARSET_FIXED=YES 
/usr/bin/openjade -D . -wno-idref -c ./entities/ISO/catalog -c 
./dsssl/docbook/catalog -c ./dsssl/defaults/catalog -d dsssl/phpweb.dsl -V 
use-output-dir -t sgml ./dtds/dbxml-4.1.2/phpdocxml.dcl manual.xml"
  [9]=>  string(243) 
"/usr/bin/openjade:/home/derick/phpdoc-all/zh/appendices/ini.xml:2751:13:E: 
document type does not allow element "para" here; missing one of "footnote", 
"caution", "important", "note", "tip", "warning", "blockquote", 
"informalexample" start-tag"
  [10]=>  string(131) 
"/usr/bin/openjade:/home/derick/phpdoc-all/zh/appendices/ini.xml:2761:17:E: end 
tag for "para" omitted, but OMITTAG NO was specified"

regards,
Derick

-- 
Derick Rethans
http://derickrethans.nl | http://ez.no | http://xdebug.org

Re: [PHP-DOC] Question about encoding again

[Xiaoyu Huang]

Hi Derick,
I have waited the whole day but the manual is still not updated.
Was the build stopped or something else was wrong?
yours,
Xiaoyu
Derick Rethans åé:
On Wed, 20 Apr 2005, Xiaoyu Huang wrote:

Hi Derick,
I have commited the 2 new files in UTF-8 encoding and add the encoding 
header. Also i have updated some outdated files. would you please help us to 
recompile the Chinese (zh) manual?

will start a build now.
regards,
Derick

Re: [PHP-DOC] Question about encoding again

[Derick Rethans]

On Wed, 20 Apr 2005, Xiaoyu Huang wrote:

> Hi Derick,
> 
> I have commited the 2 new files in UTF-8 encoding and add the encoding 
> header. Also i have updated some outdated files. would you please help us to 
> recompile the Chinese (zh) manual?

will start a build now.

regards,
Derick

Re: [PHP-DOC] Question about encoding again

[Xiaoyu Huang]

Hi Derick,

I have commited the 2 new files in UTF-8 encoding and add the encoding 
header. Also i have updated some outdated files. would you please help us to 
recompile the Chinese (zh) manual?

Thank you.

yours,
Xiaoyu



"Derick Rethans" <[EMAIL PROTECTED]> 
??:[EMAIL PROTECTED]
> On Wed, 20 Apr 2005, Xiaoyu Huang wrote:
>
>> Hi,
>>
>> I have a question about the encoding of language-defs.ent and
>> language-snippets.ent. what should be the encoding of it?
>> I'm working on the Chinese manual. should it be UTF-8 or GB2312? shall i 
>> add
>>  
>> at the beginning of the file?
>>
>> the Chinese manual is full of unreadable chars now, so i need your help.
>
> If you can, please make it all utf-8 encode, which means you need
> encoding="utf-8" in your headers.
>
> regards,
> Derick 

Re: [PHP-DOC] Question about encoding again

[Derick Rethans]

On Wed, 20 Apr 2005, Xiaoyu Huang wrote:

> Hi,
> 
> I have a question about the encoding of language-defs.ent and 
> language-snippets.ent. what should be the encoding of it?
> I'm working on the Chinese manual. should it be UTF-8 or GB2312? shall i add
>  
> at the beginning of the file?
> 
> the Chinese manual is full of unreadable chars now, so i need your help.

If you can, please make it all utf-8 encode, which means you need 
encoding="utf-8" in your headers.

regards,
Derick

[PHP-DOC] Question about encoding again

[Xiaoyu Huang]

Hi,

I have a question about the encoding of language-defs.ent and 
language-snippets.ent. what should be the encoding of it?
I'm working on the Chinese manual. should it be UTF-8 or GB2312? shall i add
 
at the beginning of the file?

the Chinese manual is full of unreadable chars now, so i need your help.

Thank you!

yours,
Xiaoyu 

[PHP-DOC] question

[hagop]

hi
I'm student {windows apllication developper}the 
last 2 or 3 years i discover that web developing is more wanted orpreferable 
for the next generation .
 
my question is 
1st question
Is the web development more important 
than application development ?
2nd questionwe are student now and we still 
student over the years ?because all the time we have new language to 
learnwhat is your opnion be student all the time and 
upgrade ourself all time ,or fix to a one developing language 

 
3 questionif i prepare to 
learn php mysql ,is we obligate to all things about php 
?
 
4 questionI found a billions of other tutorial 
on the web.how we can filter all this web site and 
download only what we are need (for beginner ,intermediat student) 
?
 
5 question 
what about asp or asp.net how is the 
best or preferable(yours opinion) php or asp.net
 
thanks

Re: [PHP-DOC] Question about using

[Gabor Hojtsy]

GH> Please give more context. This seems to be a part which explains how
GH> register_globalled stuff was changed, so there the $ has the role to
GH> show how it was with register globals. If this is the case, then the
GH> dollar should not be removed. The question is not simply have the dollar
GH> or not, since it always depends on the context.
Thank's for your explain.
Can you review my latest commit?
Seems to be fine to me.
Goba

Re[2]: [PHP-DOC] Question about using

[Alexander Voytsekhovskyy]

Good day, Gabor.

GH> Please give more context. This seems to be a part which explains how
GH> register_globalled stuff was changed, so there the $ has the role to
GH> show how it was with register globals. If this is the case, then the
GH> dollar should not be removed. The question is not simply have the dollar
GH> or not, since it always depends on the context.

Thank's for your explain.
Can you review my latest commit?

-- 
С уважением,
 Alexander  mailto:[EMAIL PROTECTED]

Re: [PHP-DOC] Question about using

[Gabor Hojtsy]

Can you explain me, why we should write
PHP_AUTH_USER
without symbol '$' and $HTTP_SERVER_VARS with it?
GH> If you use the $ symbol, then it suggest that the global variable usage
GH> is suggested. PHP_AUTH_USER is supposed to be in the _SERVER array if I
GH> remember correctly, and if you write it with $, then you promote the
GH> usage of register_globals = on, which is not right. $HTTP_SERVER_VARS is
GH> the only way to access the ther variable, so it is fine with the dollar.
So, next part of PHP-manual:
For example,
$userfile_name will equal 
$_FILES['userfile']['name'],
$userfile_type will equal 
$_FILES['userfile']['type'], etc.

I should change to:
For example,
userfile_name will equal
$_FILES['userfile']['name'],
userfile_type will equal
$_FILES['userfile']['type'], etc.
Am i shure?
Please give more context. This seems to be a part which explains how 
register_globalled stuff was changed, so there the $ has the role to 
show how it was with register globals. If this is the case, then the 
dollar should not be removed. The question is not simply have the dollar 
or not, since it always depends on the context.

Goba

Re[2]: [PHP-DOC] Question about using

[Alexander Voytsekhovskyy]

Good day, Gabor.

>> Can you explain me, why we should write
>> PHP_AUTH_USER
>> without symbol '$' and $HTTP_SERVER_VARS with it?

GH> If you use the $ symbol, then it suggest that the global variable usage
GH> is suggested. PHP_AUTH_USER is supposed to be in the _SERVER array if I
GH> remember correctly, and if you write it with $, then you promote the
GH> usage of register_globals = on, which is not right. $HTTP_SERVER_VARS is
GH> the only way to access the ther variable, so it is fine with the dollar.

So, next part of PHP-manual:

For example,
$userfile_name will equal 
$_FILES['userfile']['name'],
$userfile_type will equal 
$_FILES['userfile']['type'], etc.

I should change to:

For example,
userfile_name will equal
$_FILES['userfile']['name'],
userfile_type will equal
$_FILES['userfile']['type'], etc.

Am i shure?


-- 
С уважением,
 Alexander  mailto:[EMAIL PROTECTED]

Re: [PHP-DOC] Question about using

[Gabor Hojtsy]

Can you explain me, why we should write PHP_AUTH_USER
without symbol '$' and $HTTP_SERVER_VARS with it?
If you use the $ symbol, then it suggest that the global variable usage 
is suggested. PHP_AUTH_USER is supposed to be in the _SERVER array if I 
remember correctly, and if you write it with $, then you promote the 
usage of register_globals = on, which is not right. $HTTP_SERVER_VARS is 
the only way to access the ther variable, so it is fine with the dollar.

It might be an option to write 
$_SERVER['PHP_AUTH_USER'] (in case I am not mistaken, 
and this is part of the server superglobal).

Goba

[PHP-DOC] Question about using

[Voytsekhovskyy Alexander]

Good day.

Can you explain me, why we should write PHP_AUTH_USER
without symbol '$' and $HTTP_SERVER_VARS with it?

-- 
Best regards,
Войцеховский Александр [young], 
http://young.org.ua

RE: [PHP-DOC] Question about security

[Enrique Garcia Briones]

Hi, 

Database mean that way of handling information in an ordered way, this
is the simplest explanation I know.

And an example for a database (handler) with built-in access control is
MySQL, you can read more about MySQL at http://www.mysql.com and an
example of a database handler with not such good access control is
Microsoft Access

Enrique García Briones


-Mensaje original-
De: Voytsekhovskyy Alexander [mailto:[EMAIL PROTECTED] 
Enviado el: Martes, 09 de Marzo de 2004 09:53 a.m.
Para: [EMAIL PROTECTED]
Asunto: [PHP-DOC] Question about security

Goog day.

During translation http://www.php.net/manual/en/security.apache.php to
my language, i have some problems with understanding some moments:


When PHP is used as an Apache module it inherits Apache's user
permissions (typically those of the "nobody" user). This has several
impacts on security and authorization. For example, if you are using
PHP to access a database, unless that database has built-in access
control, you will have to make the database accessible to the "nobody"
user. This means a malicious script could access and modify the
database, even without a username and password. It's entirely possible
that a web spider could stumble across a database administrator's web
page, and drop all of your databases. You can protect against this
with Apache authorization, or you can design your own access model
using LDAP, .htaccess files, etc. and include that code as part of
your PHP scripts.


What databases need to mean? text files? And some impossible to
understand about atypical autorization?

Sorry for my english.





-- 
С уважением,
 Voytsekhovskyy  mailto:[EMAIL PROTECTED]

[PHP-DOC] Question about security

[Voytsekhovskyy Alexander]

Goog day.

During translation http://www.php.net/manual/en/security.apache.php to
my language, i have some problems with understanding some moments:


When PHP is used as an Apache module it inherits Apache's user
permissions (typically those of the "nobody" user). This has several
impacts on security and authorization. For example, if you are using
PHP to access a database, unless that database has built-in access
control, you will have to make the database accessible to the "nobody"
user. This means a malicious script could access and modify the
database, even without a username and password. It's entirely possible
that a web spider could stumble across a database administrator's web
page, and drop all of your databases. You can protect against this
with Apache authorization, or you can design your own access model
using LDAP, .htaccess files, etc. and include that code as part of
your PHP scripts.


What databases need to mean? text files? And some impossible to
understand about atypical autorization?

Sorry for my english.





-- 
С уважением,
 Voytsekhovskyy  mailto:[EMAIL PROTECTED]

Re: [PHP-DOC] Question on license of php manual

[Hartmut Holzgraefe]

Jochen Metzger wrote:
Well actually the original paragraph in english is:

Any publication in standard (paper) book form shall require the citation
of the original publisher and author
I am not sure what this exactly means.
Actually IMHO this means that, you are allowed to make copies of pages
of it as long it is not published as a "standard book" or "standard
paperbook". So you are allowed to copy single pages with a copymachine
and use them for e.g. training.
Did I get that alright, or am I misunderstanding the license wrong.
Copying/Printing parts of the manual and distributing them as training
material should be ok with all of us and even with the license. Add a
notice like "This material is taken from the PHP manual available on
 and is (c) by the PHP Documentation Group" should completely
put you on the safe side (even handing out a complete printout of the
manual to your students should be ok this way, it's only about 4000+
pages right now ;)
What the license trys to prevent is just that some publisher publishes
the document as a regular book without prior permission (IMHO)
Disclaimer: i'm an engineer, not a lawyer, so please don't take my
personal opinions as legel advice ;)
--
Hartmut Holzgraefe  <[EMAIL PROTECTED]>

Re: [PHP-DOC] Question on license of php manual

[Jochen Metzger]

Hi Ali,
hi, list,
> I have not read the entire licence, but 
> 
> > Ich frage deshalb nach weil der Satz:
> > Verbreitung dieser Arbeit oder abgeleiteter Arbeiten in jeglicher
> > Standard- (Papier-) Buchform ist ohne vorherige Erlaubnis durch den
> > Copyright-Inhaber untersagt. 
> this paragraph clearly states that you can't just print and publish
> parts of the manual without prior authorization of the copyright holder.
> 
> 
THx for you answer.

Well actually the original paragraph in english is:

Any publication in standard (paper) book form shall require the citation
of the original publisher and author

I am not sure what this exactly means.
Actually IMHO this means that, you are allowed to make copies of pages
of it as long it is not published as a "standard book" or "standard
paperbook". So you are allowed to copy single pages with a copymachine
and use them for e.g. training.

Did I get that alright, or am I misunderstanding the license wrong.


Cheers

Jochen

Re: [PHP-DOC] Question about installation

[Gabor Hojtsy]

This mailing list is for the PHP documentation authors. Please ask
support questions at [EMAIL PROTECTED] (or better
[EMAIL PROTECTED] for hungarian support).

Goba

On Mon, 12 Jan 2004, [ISO-8859-2] Nexus Márton wrote:

> Dear Webmaster,
>
>  I had a problem by installing my PHP under my Apache 1.3.2 under
> Win98: Since I have made (almost?) all the neccessary changes in the
> httpd.conf (Documentroot, Scriptalias, Addtype ...php) and in the php.ini,
> Apache makes the PHP to run (the PHP... is running appears in the
> console). But it doesn't run the PHP-scripts contained by a HTML-file
> (they worked on an other server), and it can't also open either
> index.php.
>  What have to I configure yet?
>
> Thanks: Lawrence
>

[PHP-DOC] Question about installation

[Nexus Márton]

Dear Webmaster,

 I had a problem by installing my PHP under my Apache 1.3.2 under 
Win98: Since I have made (almost?) all the neccessary changes in the 
httpd.conf (Documentroot, Scriptalias, Addtype ...php) and in the php.ini, 
Apache makes the PHP to run (the PHP... is running appears in the 
console). But it doesn't run the PHP-scripts contained by a HTML-file 
(they worked on an other server), and it can't also open either 
index.php. 
 What have to I configure yet?

Thanks: Lawrence

Re: [PHP-DOC] Question on _()

[Gabor Hojtsy]

IMHO, rules should never give us less freedom.. Can't it be the 
exception that confirms the rule ? Do we have to live without a _() 
documentation just for historical reasons ? Maybe we can break rules 
for one time.. What will happen if we add _.xml ?
file names are created from xml node IDs

some tools do not like '_' in node IDs, thats why we use '-' instead

and while _.xml and -.xml are valid filenames i'm not sure about
'-' being a valid node ID
XML spec:

| Validity constraint: ID
|
| Values of type ID must match the Name production. [...]
The Name production:

Letter   ::= BaseChar | Ideographic
NameChar ::= Letter | Digit | '.' | '-' | '_' | ':' |
 CombiningChar | Extender
Name ::= (Letter | '_' | ':') (NameChar)*
I am not going to copy BaseChar and Ideographic here... I assume from 
this spec that the XML spec does not allow us to have '-' as the first 
char of an ID. Unless '-' is part of BaseChar or Ideographic... It is 
not easy to find this out from the spec (these two have an ugly definition).

Goba

Re: [PHP-DOC] Question on _()

[Gabor Hojtsy]

[...] you should name it "-.xml",
but this is not a valid filename AFAIK.
sure it is ... you just have to make sure you
escape the filename so that the leading '-' is
not taken as a commandline option specifier
$ touch -- -.xml

$ ls -l -- -.xml
-rw-rw-r--1 hartmut  users   0 2003-10-17 14:02 -.xml
Hm, I only tried touch -.xml, not thought about the -- possibility :) So 
then there is no problem...

Goba

Re: [PHP-DOC] Question on _()

[Gabor Hojtsy]

Oups, missed the - issue :/

IMHO, rules should never give us less freedom.. Can't it be the 
exception that confirms the rule ? Do we have to live without a _() 
documentation just for historical reasons ? Maybe we can break rules for 
one time.. What will happen if we add _.xml ?

BTW, do livedocs solve the problem ? (didn't have the time to look at it)
There are a *lots* of tools dependant on the _ to - conversion 
(including the online function search, some of the CHM features, many 
quickref tools built into IDEs and browsers, the PHP docref() feature, 
the revcheck file output, etc). This is not a rule we have a chance to 
think about changing...

Goba

Re: [PHP-DOC] Question on _()

[Hartmut Holzgraefe]

Mehdi Achour wrote:
IMHO, rules should never give us less freedom.. Can't it be the 
exception that confirms the rule ? Do we have to live without a _() 
documentation just for historical reasons ? Maybe we can break rules for 
one time.. What will happen if we add _.xml ?
file names are created from xml node IDs

some tools do not like '_' in node IDs, thats why we use '-' instead

and while _.xml and -.xml are valid filenames i'm not sure about
'-' being a valid node ID
--
Hartmut Holzgraefe  <[EMAIL PROTECTED]>

Re: [PHP-DOC] Question on _()

[Mehdi Achour]

I was wondering.. why isn't _() documented at all ? I thought it had 
a problematic name (for builds) but it appears to be fine on my box.
Anyone againt me adding _.xml under gettext/function ? (documenting 
it as an alias)


Back when the issue with the _() was raised it was decided not to 
document it as an function.


At the time I wasn't involved in the PHP project, so I don't know 
nothing about this thread. Can you tell me what were the reasons of 
making such a choice ?


As it is written in the howto, all file names should have _ replaced 
with -. This is for historical reasons, and we are not going to break 
the rule. So if you would add such a file, you should name it "-.xml", 
but this is not a valid filename AFAIK.
Oups, missed the - issue :/

IMHO, rules should never give us less freedom.. Can't it be the 
exception that confirms the rule ? Do we have to live without a _() 
documentation just for historical reasons ? Maybe we can break rules for 
one time.. What will happen if we add _.xml ?

BTW, do livedocs solve the problem ? (didn't have the time to look at it)

Thank you for your time :)

didou

Re: [PHP-DOC] Question on _()

[Hartmut Holzgraefe]

Gabor Hojtsy wrote:
[...] you should name it "-.xml",
but this is not a valid filename AFAIK.
sure it is ... you just have to make sure you
escape the filename so that the leading '-' is
not taken as a commandline option specifier
$ touch -- -.xml

$ ls -l -- -.xml
-rw-rw-r--1 hartmut  users   0 2003-10-17 14:02 -.xml


--
Hartmut Holzgraefe  <[EMAIL PROTECTED]>

Re: [PHP-DOC] Question on _()

[Gabor Hojtsy]

I was wondering.. why isn't _() documented at all ? I thought it had 
a problematic name (for builds) but it appears to be fine on my box.
Anyone againt me adding _.xml under gettext/function ? (documenting 
it as an alias)
Back when the issue with the _() was raised it was decided not to 
document it as an function.
At the time I wasn't involved in the PHP project, so I don't know 
nothing about this thread. Can you tell me what were the reasons of 
making such a choice ?
As it is written in the howto, all file names should have _ replaced 
with -. This is for historical reasons, and we are not going to break 
the rule. So if you would add such a file, you should name it "-.xml", 
but this is not a valid filename AFAIK.

Goba

Re: [PHP-DOC] Question on _()

[Mehdi Achour]

I was wondering.. why isn't _() documented at all ? I thought it had a 
problematic name (for builds) but it appears to be fine on my box.
Anyone againt me adding _.xml under gettext/function ? (documenting it 
as an alias)


Back when the issue with the _() was raised it was decided not to 
document it as an function.
At the time I wasn't involved in the PHP project, so I don't know 
nothing about this thread. Can you tell me what were the reasons of 
making such a choice ?

Mehdi

Re: [PHP-DOC] Question on _()

[Derick Rethans]

On Thu, 16 Oct 2003, Mehdi Achour wrote:

> I was wondering.. why isn't _() documented at all ? I thought it had a 
> problematic name (for builds) but it appears to be fine on my box.
> Anyone againt me adding _.xml under gettext/function ? (documenting it 
> as an alias)

Back when the issue with the _() was raised it was decided not to 
document it as an function.

Derick

-- 
"Interpreting what the GPL actually means is a job best left to those
that read the future by examining animal entrails."
-
 Derick Rethans http://derickrethans.nl/ 
 International PHP Magazine  http://php-mag.net/
-

[PHP-DOC] Question on _()

[Mehdi Achour]

Hi all,

I was wondering.. why isn't _() documented at all ? I thought it had a 
problematic name (for builds) but it appears to be fine on my box.
Anyone againt me adding _.xml under gettext/function ? (documenting it 
as an alias)

didou

[PHP-DOC] Question

[finsoft]

Hello,

is there any current work on Estonian documentation translation?

FinSoft
[EMAIL PROTECTED]

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

Re: [PHP-DOC] Question

[Gabor Hojtsy]

is there any current work on Estonian documentation translation?
I don't know of any...

Goba

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

Re: AW: [PHP-DOC] Question concerning xsl-styles

[Hartmut Holzgraefe]

[EMAIL PROTECTED] wrote:
the paragraph layout is not as perfect as with TeX or other layout
systems (regarding whitespace distribution in justified text)
but it is definetly readable (about as good as what Word does IMHO)


If you mean the empty lines in the grey boxes before and after the real
text:
no, i was refering to the ammount of whitespace between words in
general paragraphs, the whitespace is not as equaly distributed
as it could be
looks like FOP is following a simple "per line" approach here instead
of the more sophisticated "per paragraph" algorithms used by TeX and
other 'real' typesetting systems ...
--
Six Offene Systeme GmbH http://www.six.de/
i.A. Hartmut Holzgraefe Email: [EMAIL PROTECTED]   Tel.: +49-711-99091-77
Sie finden uns auf der CeBIT in Halle 6/H44   http://www.six.de/cebit2003/

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

Re: [PHP-DOC] Question concerning xsl-styles

[Gabor Hojtsy]

I've found a(n easy ;) solution for building PDFs, simply use FOP 
0.20.5rc2 and include the hyphenation-files from 0.20.4 (otherwise it 
would take the whole night listing error-msgs)). There is still much 
work to do, but if you're interested in the result:

http://www.t0.or.at/~sunny/php/php_manual_en.pdf.zip
this is looking *very* promising :)

the paragraph layout is not as perfect as with TeX or other layout
systems (regarding whitespace distribution in justified text)
but it is definetly readable (about as good as what Word does IMHO)
looks like we're finally done with DSSSL then?
(ok, i assume the fancy style for www.php.net still needs porting?)
Last time I hav checked phpweb output through XSLT, it was working. I 
have worked with porting all things possible, so the phpweb.xsl should 
work nearly the same as DSSSL ones. The only problem was the very deep 
TOC AFAIK, but that is solved by Thomas, as he said :)

Goba



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

AW: [PHP-DOC] Question concerning xsl-styles

[tom]

Von: Hartmut Holzgraefe [mailto:[EMAIL PROTECTED]
> Thomas Schöfbeck wrote:
> > I've found a(n easy ;) solution for building PDFs, simply use FOP
> > 0.20.5rc2 and include the hyphenation-files from 0.20.4 (otherwise it
> > would take the whole night listing error-msgs)). There is still much
> > work to do, but if you're interested in the result:
> >
> > http://www.t0.or.at/~sunny/php/php_manual_en.pdf.zip
>
> this is looking *very* promising :)

Many thanks!

> the paragraph layout is not as perfect as with TeX or other layout
> systems (regarding whitespace distribution in justified text)
> but it is definetly readable (about as good as what Word does IMHO)

If you mean the empty lines in the grey boxes before and after the real
text:
this is a general problem (also in html), there doesn't exist something like
a trim() in XPATH 1.0. I've thought already about a manual template "xsl"
for it checking char by char, but considering all the different encodings,
etc. it would be too messy and time-consuming during the build. The only
thing I could offer is to change step by step all the e.g.

 

 
to
 

> looks like we're finally done with DSSSL then?
> (ok, i assume the fancy style for www.php.net still needs porting?)

Hmmm On one hand I'd like to have more testing and feedback before (I
did these 3 styles in just one week beside my job, so there might be several
bugs).

On the other hand, if I remember James' mail that omitting manual-builds for
almost 7 weeks is due to a "problem" "a: take forever" (while html takes
almost the same time with 20min, bightml takes with xsl 11min and dsssl
80min{!}), and we've got again a mail concerning a "printable format" we
should speed up things.

But as you've already mentioned, phpweb needs porting, and the following
things should also be done before:

- ensure that the building machine has physically 1 GB RAM (is needed by
fop - will decrease when the dev-part got a separate doc), otherwise it
would swap around the whole night for a job of 2 min.) JAMES: Would you
please take care of this while you move stuff around?

- Check, if there are hyphenation-files for all languages (otherwise fop
shows a whole night error-msgs). I didn't check if fop 0.20.4 has hyph-files
for all languages we provide as translation (just in case that there are
some missing: would you be so kind and provide me the missing hyph-files
from tex to rewrite and implement them into fop.jar {I don't wanna search
and download 100s of MEGS for just 2 or 3 files}?)

- xmllib (xsltproc), java, and fop (0.20.5rc2 with our adapted fop.jar)
should be installed on the generating-machine. JAMES?

- The configure/makefile should be adapted (implementation of images (still
a open bug!), paths, etc.) the best would be with a temporary possibility
for a fallback, and a final agreement with the systems-group (JAMES?) what
will be called (so that we finally have control over build-process again via
these files (see bugs #18914 and #20077 which wouldn't even occur if they
went over us))

- and all the things that won't come into my mind in this very moment ;)

Cu,
Thomas



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

Re: [PHP-DOC] Question concerning xsl-styles

[tom]

> > It would be good if somebody could check the results of the xsl-styles 
> > (also build-experiences on other boxes would be nice ;).
> > 
> > If somebody can't build them, he can find it at
> > 
> > html:http://www.t0.or.at/~sunny/php/php_manual_en.zip, and
> > bightml: http://www.t0.or.at/~sunny/php/php_manual_en.html.zip
> > 
> > I've found a(n easy ;) solution for building PDFs, simply use FOP 
> > 0.20.5rc2 and include the hyphenation-files from 0.20.4 (otherwise it 
> > would take the whole night listing error-msgs)). There is still much 
> > work to do, but if you're interested in the result:
> > 
> > http://www.t0.or.at/~sunny/php/php_manual_en.pdf.zip
> > 
> > All 3 zip-files have about 4 MB.
> 
> Sorry, but I cannot devote time to this. You know, we are putting 
> together the first PHP conference, and every second thought of mine is 
> about it... If I forget about this, please remind me after 2,5 weeks 
> (then the conference will be over :).
> 
> Goba

No prob, have a successful conference!

Thomas



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

Re: [PHP-DOC] Question concerning xsl-styles

[Hartmut Holzgraefe]

Thomas Schöfbeck wrote:
I've found a(n easy ;) solution for building PDFs, simply use FOP 
0.20.5rc2 and include the hyphenation-files from 0.20.4 (otherwise it 
would take the whole night listing error-msgs)). There is still much 
work to do, but if you're interested in the result:

http://www.t0.or.at/~sunny/php/php_manual_en.pdf.zip
this is looking *very* promising :)

the paragraph layout is not as perfect as with TeX or other layout
systems (regarding whitespace distribution in justified text)
but it is definetly readable (about as good as what Word does IMHO)
looks like we're finally done with DSSSL then?
(ok, i assume the fancy style for www.php.net still needs porting?)
--
Six Offene Systeme GmbH http://www.six.de/
i.A. Hartmut Holzgraefe Email: [EMAIL PROTECTED]   Tel.: +49-711-99091-77
Sie finden uns auf der CeBIT in Halle 6/H44   http://www.six.de/cebit2003/

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

Re: [PHP-DOC] Question concerning xsl-styles

[Gabor Hojtsy]

TOC's should look like in the dsssl-version
Wow!

>, otherwise I have something
overlooked. I've done just a view changes on purpose, like making the 
functions EIGHTER a link OR bold (bold and link would disturb the reader 
too much, if there are several function-names in one para).
This is ok with me.

It would be good if somebody could check the results of the xsl-styles 
(also build-experiences on other boxes would be nice ;).

If somebody can't build them, he can find it at

html:http://www.t0.or.at/~sunny/php/php_manual_en.zip, and
bightml: http://www.t0.or.at/~sunny/php/php_manual_en.html.zip
I've found a(n easy ;) solution for building PDFs, simply use FOP 
0.20.5rc2 and include the hyphenation-files from 0.20.4 (otherwise it 
would take the whole night listing error-msgs)). There is still much 
work to do, but if you're interested in the result:

http://www.t0.or.at/~sunny/php/php_manual_en.pdf.zip

All 3 zip-files have about 4 MB.
Sorry, but I cannot devote time to this. You know, we are putting 
together the first PHP conference, and every second thought of mine is 
about it... If I forget about this, please remind me after 2,5 weeks 
(then the conference will be over :).

Goba



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

Re: [PHP-DOC] Question concerning xsl-styles

[Thomas Schöfbeck]

Gabor Hojtsy wrote:
as you can see on the newly committed xsl-styles, the html and bightml 
versions seem to work fine (some design-improvements are always 
possible ;), but I have a problem with the fo-styles (or the 
FOP-behavior):


Well, I don't have any idea to your problem, but I need to ask if you 
were able to limit the TOC size, and generate documentation without 
"infinitely" deep TOC?

Goba
TOC's should look like in the dsssl-version, otherwise I have something 
overlooked. I've done just a view changes on purpose, like making the 
functions EIGHTER a link OR bold (bold and link would disturb the reader 
too much, if there are several function-names in one para).

It would be good if somebody could check the results of the xsl-styles 
(also build-experiences on other boxes would be nice ;).

If somebody can't build them, he can find it at

html:http://www.t0.or.at/~sunny/php/php_manual_en.zip, and
bightml: http://www.t0.or.at/~sunny/php/php_manual_en.html.zip
I've found a(n easy ;) solution for building PDFs, simply use FOP 
0.20.5rc2 and include the hyphenation-files from 0.20.4 (otherwise it 
would take the whole night listing error-msgs)). There is still much 
work to do, but if you're interested in the result:

http://www.t0.or.at/~sunny/php/php_manual_en.pdf.zip

All 3 zip-files have about 4 MB.

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

Re: [PHP-DOC] Question concerning xsl-styles

[Gabor Hojtsy]

as you can see on the newly committed xsl-styles, the html and bightml 
versions seem to work fine (some design-improvements are always possible 
;), but I have a problem with the fo-styles (or the FOP-behavior):
Well, I don't have any idea to your problem, but I need to ask if you 
were able to limit the TOC size, and generate documentation without 
"infinitely" deep TOC?

Goba



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

[PHP-DOC] Question concerning xsl-styles

[Thomas Schöfbeck]

Hi all,

as you can see on the newly committed xsl-styles, the html and bightml 
versions seem to work fine (some design-improvements are always possible 
;), but I have a problem with the fo-styles (or the FOP-behavior):

xsltproc does output-escaping also on quotes (" -> "), but FOP 
stops with an [error 1] if it stumbles over a ". So I thought that 
I do a workaround and do a disable-output-escaping on some places like 
the faq-questions, but then I run into the prob of "<" getting "<" (a 
good example is FAQ-question 47.4, where '"' are included as well as 
'<', where FOP stops eighter because of the "e; or the ).

Programming all these cases can't be the way (and the next day a new 
fop-version is out, which understands " also :).
Using XALAN as processor (which doesn't escape the quotes) is also not 
the optimum, because we would have to run a script to merge the 
function-files before xalan to overcome the max. open files limit.

Does anybody have an idea?

Thomas

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

Re: [PHP-DOC] question

[Gabor Hojtsy]

If you reply to the rejection mail, you will 
probably get more
information. We cannot see your note anymore, so 
the guy
who removed may help you clear this 
up.
 
You may have written something already in the 
manual, or
the guy who deleted, just integrated your 
information to the
manual, there can be some reasons...
 
Goba

  - Original Message - 
  From: 
  Jon Kriek 
  
  To: [EMAIL PROTECTED] 
  Sent: Wednesday, March 05, 2003 1:03 
  AM
  Subject: [PHP-DOC] question
  
  
  I don’t understand why my comment 
  was removed from the manual (switch)
  It didn't violate anything here http://www.php.net/manual/about-notes.php
   
  - Jon 
  Kriek

Re: [PHP-DOC] question

[Victor Boivie]

Hi Jon,

I don’t understand why my comment was removed from the manual (switch)

It didn't violate anything here http://www.php.net/manual/about-notes.php
I removed your note since I didn't think it offer much more than the 
manual already said. There are a lot of notes submitted every day, and 
sometimes I set the treshold a bit high. Not that this justifies all 
other notes that say even less than your note - we just don't have time 
to check them all.

But there is one good thing about your note that I didn't realise first. 
Perhaps someone will replace their:

include ($_GET["page"]);

with your snippet (I've seen the previous one quite often and we can all 
see how secure is is).

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

[PHP-DOC] question

[Jon Kriek]

I don’t understand why my comment 
was removed from the manual (switch)
It didn't violate anything here http://www.php.net/manual/about-notes.php
 
- Jon 
Kriek

[PHP-DOC] Question on the ifx-extension

[Cornelia Boenigk]

Hi everybody

Working on the translation of the ifx-extension I am in doubt whether
the following is correct:

ifxus_open_slob -- Opens an slob object
...
Returns FALSE on error otherwise the new slob object-id.

Is this really true? Does the function return a *new* object-id
anytime the slob-object is opened?

Regards
Conni


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

Re: [PHP-DOC] Question on ifx_prepare

[Gabor Hojtsy]

> The  says
>
> int ifx_prepare ( string query, int conn_id [, int cursor_def, mixed
> blobidarray])
>
> and in the text below the Parameter is called cursor_type parameter
>
> Which one is correct?

Form the PHP source:

/* --
** int ifx_prepare(string query, int connid,
** [, int cursortype] [, array blobidarry])
**
** $hold, $scroll are optional and valid only for select queries
** $blobidarray is optional, an array of blob id's
**
** prepares query $query on connection $connid
** select queries accept an optional cursortype param: IFX_SCROLL, IFX_HOLD
(or'ed mask)
** blobsupport: mark the blob-column with ? and add a
blob-id-functionparameter
** example: ifx_query("insert into catalog (stock_num, manu_code ,cat_descr,
**cat_picture) values(1,'HRO',?,?)",$cid,$bid1,$bid2);
**
** returns a "result id" on success or FALSE on error
** also sets "affected_rows for retrieval by ifx_affected_rows
** --
*/

/* {{{ proto int ifx_prepare(string query, int connid [, int cursortype] [,
array idarray])
   Prepare a query on a given connection */

Goba



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

[PHP-DOC] Question on ifx_prepare

[Cornelia Boenigk]

Hi

The  says

int ifx_prepare ( string query, int conn_id [, int cursor_def, mixed
blobidarray])

and in the text below the Parameter is called cursor_type parameter

Which one is correct?

Regards
Conni


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

Re: [PHP-DOC] Question on translation

[Gabor Hojtsy]

> In the shared-memory extension there is a old file called size.xml.
> The new file is named shmop-size.xml. I added the new file to the
> repository. Can I now remove/delete the file size.xml or what to do
> with it?
> What to do generally with files which are renamed.
> Leave? Remove?

If the contents are the same, then the old file should be deleted.

Goba



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

Re: [PHP-DOC] Question on translation

[Cornelia Boenigk]

Hi all

Next Question:

In the shared-memory extension there is a old file called size.xml.
The new file is named shmop-size.xml. I added the new file to the
repository. Can I now remove/delete the file size.xml or what to do
with it?
What to do generally with files which are renamed.
Leave? Remove?

Greetings
Conni


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

Re: [PHP-DOC] Question on translation

[Gabor Hojtsy]

> 1. There is a file in /pgsql called constants.xml which doesn't exist
> in the de-tree. What about this file? Isn't it needed in the de-tree?

If there is anything to translate in it (literal English), then
you should copy and translate. Otherwise this file will be used
from the EN tree...

> Can I copy this structure as it is in the de-tree?
> Is
>
> &reftitle.intro;
> defined in the de-tree?

&reftitle..; entities are defined in language-snippets.ent in the
root of the de tree. This new structure should be applied to the
de tree to populate consistency.

Goba



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

Re: [PHP-DOC] Question on translation

[Friedhelm Betz]

Hi Cornelia,

Sunday, August 11, 2002, 9:08:10 PM, you wrote:

> Hi everybody

> I want to synchronize the pgsql-translation with the en-tree.
> I have two questions:

> 1. There is a file in /pgsql called constants.xml which doesn't exist
> in the de-tree.
> What about this file? Isn't it needed in the de-tree?

> 2. In the en-tree there is a new structure of reference.xml like this:

> 
>
> &reftitle.intro;
> 
>  PostgreSQL database is Open Source product and available without
>   ...
>  extensibility. PostgreSQL is an open source descendant of this
>  original Berkeley code.
> 
>

> The file in the de-tree loks like this:

>  
>
> PostgreSQL, ursprünglich entwickelt im UC Berkeley Computer
> Science
> ...
> Weiterentwicklung des ursprünglichen Berkeley-Codes.
>

> Can I copy this structure as it is in the de-tree?
> Is
>
> &reftitle.intro;
> defined in the de-tree?

Please  do  so  :-).  As  you  may  have  recognized  the en-manual is
re-structed and this should also happen in de and the other languages,
by  updates  or new translations. No worry about the entities they are
definded.

Once you took over the structure from en, there is an entity
&reference.pgsql.constants; pointing to constants.xml file.
Look  at  the  constants.xml  in  en and see, if there is somethimg to
translate.  If yes copy it to de-tree, if no there is no need to copy
this  file  (hope  I  am right :-)) as the build system will take this
missing file from the en-tree.

BTW, if you would like to add some infos to the constants feel free.
Also  don't hesitate to improve the structuring of the pgsql-reference
file,  if you like to. I just moved around the contents to fit the new
structure and maybe you find some errors or logical issues.

By
 Friedhelm   


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