Re: [PHP-DOC] Re: [DOC-CVS] svn: /phpdoc/en/trunk/reference/spl/ book.xml files.xml miscellaneous.xml

2009-10-09 Thread Philip Olson 


On Oct 8, 2009, at 1:33 PM, Hannes Magnusson wrote:


On Wed, Oct 7, 2009 at 22:12, Hannes Magnusson
hannes.magnus...@gmail.com wrote:

On Wed, Oct 7, 2009 at 22:09, Peter Cowburn sala...@php.net wrote:
The other part files don't use entities either, I was just  
following

what has been done elsewhere (iterators.xml and interfaces.xml for
examples). Would you suggest they're changed as well?



I'd say so.. We do already in couple of other files (timezone.xml
comes to mind) when there is nearly nothing but structural elements  
in

the xml.


I don't remember how to mark these files as DO NOT TRANSLATE though
(makes no sense translating them now that they only contain
entities).. Philip?


We simply insert a snippet instructing translators to not translate it  
(like !-- DO NOT TRANSLATE THIS FILE --) and add the filename to  
scripts (like revcheck.php) for skipping. The second part is often  
forgotten, but eventually scripts/include/lib-translations.inc.php  
will be integrated so it won't be much of an issue.


Regards,
Philip

[PHP-DOC] Re: [DOC-CVS] svn: /phpdoc/en/trunk/reference/spl/ book.xml files.xml miscellaneous.xml

2009-10-08 Thread Hannes Magnusson 
On Wed, Oct 7, 2009 at 22:12, Hannes Magnusson
hannes.magnus...@gmail.com wrote:
 On Wed, Oct 7, 2009 at 22:09, Peter Cowburn sala...@php.net wrote:
 The other part files don't use entities either, I was just following
 what has been done elsewhere (iterators.xml and interfaces.xml for
 examples). Would you suggest they're changed as well?


 I'd say so.. We do already in couple of other files (timezone.xml
 comes to mind) when there is nearly nothing but structural elements in
 the xml.

I don't remember how to mark these files as DO NOT TRANSLATE though
(makes no sense translating them now that they only contain
entities).. Philip?

-Hannes

[PHP-DOC] Re: [DOC-CVS] svn: /phpdoc/en/trunk/reference/spl/ book.xml files.xml miscellaneous.xml

2009-10-07 Thread Hannes Magnusson 
On Wed, Oct 7, 2009 at 22:09, Peter Cowburn sala...@php.net wrote:
 2009/10/7 Hannes Magnusson hannes.magnus...@gmail.com:
 On Wed, Oct 7, 2009 at 21:45, Peter Cowburn sala...@php.net wrote:
 salathe                                  Wed, 07 Oct 2009 19:45:56 +

 Revision: http://svn.php.net/viewvc?view=revisionrevision=289297

 Log:
 Tidying of SPL book structure

 Changed paths:
    U   phpdoc/en/trunk/reference/spl/book.xml
    A   phpdoc/en/trunk/reference/spl/files.xml
    A   phpdoc/en/trunk/reference/spl/miscellaneous.xml

 Modified: phpdoc/en/trunk/reference/spl/book.xml
 ===
 --- phpdoc/en/trunk/reference/spl/book.xml      2009-10-07 19:38:37 UTC 
 (rev 289296)
 +++ phpdoc/en/trunk/reference/spl/book.xml      2009-10-07 19:45:56 UTC 
 (rev 289297)
 @@ -26,12 +26,9 @@
  reference.spl.interfaces;
  reference.spl.exceptions;
  reference.spl.reference;
 + reference.spl.files;
 + reference.spl.miscellaneous;

 - reference.spl.arrayobject;
 - reference.spl.splfileinfo;
 - reference.spl.splfileobject;
 - reference.spl.spltempfileobject;
 -
  !-- TODO: Not documented
  reference.spl.splfixedarray;
  reference.spl.splobjectstorage;

 Added: phpdoc/en/trunk/reference/spl/files.xml
 ===
 --- phpdoc/en/trunk/reference/spl/files.xml                             
 (rev 0)
 +++ phpdoc/en/trunk/reference/spl/files.xml     2009-10-07 19:45:56 UTC 
 (rev 289297)
 @@ -0,0 +1,41 @@
 +?xml version=1.0 encoding=UTF-8?
 +!-- $Revision: $ --
 +
 +part xml:id=spl.files xmlns=http://docbook.org/ns/docbook; 
 xmlns:xlink=http://www.w3.org/1999/xlink;
 +
 + titleFile Handling/title
 +
 + partintro
 +  para
 +   SPL provides a number of classes to work with files.
 +  /para

 Maybe that little text can simply be an entity? Makes it easier for
 translators and makes up for the fact this commit breaks all
 translations :)


 The other part files don't use entities either, I was just following
 what has been done elsewhere (iterators.xml and interfaces.xml for
 examples). Would you suggest they're changed as well?


I'd say so.. We do already in couple of other files (timezone.xml
comes to mind) when there is nearly nothing but structural elements in
the xml.

It makes it easier for translators and they get the english
translation for free if they haven't translated some childrens,
rather then needing to keep that file up2date which contains nothing
but entity references to children chapters..

-Hannes