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 +0000 >>> >>> Revision: http://svn.php.net/viewvc?view=revision&revision=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"> >>> + >>> + <title>File 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