Re: [PHP-DOC] Question about the tools

2007-11-27 Thread 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] Another question about the tools

2007-11-27 Thread Simion Onea
 -Original Message-
 From: Hannes Magnusson [mailto:[EMAIL PROTECTED] 
 Sent: Tuesday, November 27, 2007 12:04 PM
 To: Simion Onea
 Cc: PHPdoc
 Subject: Re: [PHP-DOC] Question about the tools
 
 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

Actually I was trying to do a preliminary test because I cannot make PhD
work for me.
As I understand, after installing PhD I must run php configure.php
--with-lang=ro that will create .manual.xml that will be further
processed by PhD.
Well, configure.php says that happ shittens and I should fix the errors.
You can see the output in the attached file.
Am I doing something wrong ?

Regards,
Simion.
[EMAIL PROTECTED] phpdoc]# php configure.php --with-lang=ro
configure.php: $Id: configure.php,v 1.9 2007/11/05 11:27:52 rquadling Exp $
PHP version: 5.2.4

checking for php: /usr/bin/php
checking for jade: no
  Error: Could not find a Jade/OpenJade executable. Use 
--with-jade=/path/to/jade
checking for nsgmls: /usr/bin/onsgmls
checking for xsltproc: /usr/bin/xsltproc
checking for xmllint: /usr/bin/xmllint
checking for docbook (HTML): .//docbook/docbook-dsssl/html/docbook.dsl
checking for docbook (print): .//docbook/docbook-dsssl/print/docbook.dsl
checking catalogs: -c .//entities/ISO/catalog
checking for PHP source: no
  Warning: No PHP source directory found.
checking for PEAR source: no
checking for PECL source: no
checking for CSS to use for HTML docs: none
checking for CHM-only inclusion: disabled
checking for internals doc exclusion: no
checking for language: ro
checking for treesaving: no
checking for forced .manual.xml: no
generating ./scripts/test_missing-entities.php: done
generating ./scripts/missing-entities.php: done
generating ./scripts/phpweb-entities.php: done
generating ./scripts/file-entities.php: done
generating ./phpbook/phpbook-xsl/htmlhelp-config.xsl: done
generating ./phpbook/phpbook-xsl/param_html.xsl: done
generating ./phpbook/phpbook-dsssl/install.dsl: done
generating ./phpbook/phpbook-dsssl/common.dsl: done
generating ./phpbook/phpbook-dsssl/quickref.dsl: done
generating ./phpbook/phpbook-dsssl/howto.dsl: done
generating ./phpbook/phpbook-dsssl/phpweb.dsl: done
generating ./phpbook/phpbook-dsssl/print.dsl: done
generating ./phpbook/phpbook-dsssl/html.dsl: done
generating ./phpbook/phpbook-dsssl/howto-php.dsl: done
generating ./phpbook/phpbook-dsssl/html-locale.dsl: done
generating ./RFC/manual.xml: done
generating ./manual.xml: done
generating ./entities/version.ent: done
generating ./Makefile: done

Creating file: entities/file-entities.ent...

Testing the manual for missing elements...

Created file: entities/missing-entities.ent
* No missing entities were found

Created file: entities/missing-ids.xml
* No missing ids found
eyh man. No worries. Happ shittens. Try again after fixing the errors above


[PHP-DOC] Found the errors

2007-11-27 Thread Simion Onea
 -Original Message-
 From: Hannes Magnusson [mailto:[EMAIL PROTECTED] 
 Sent: Tuesday, November 27, 2007 12:04 PM
 To: Simion Onea
 Cc: PHPdoc
 Subject: Re: [PHP-DOC] Question about the tools
 
 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

Oh, I found the errors! They went to PHP's error log that I configured.
A lot of IDs are missing (about 40). Probably because the majority of files
are not translated. But I thought they will be taken ftom the English tree.
What can I do? I just wanted to build the Romanian manual as it is.

Regards,
Simion.


[PHP-DOC] Re: Found the errors

2007-11-27 Thread Hannes Magnusson
On Nov 27, 2007 11:27 AM, Simion Onea [EMAIL PROTECTED] wrote:
  -Original Message-
  From: Hannes Magnusson [mailto:[EMAIL PROTECTED]
  Sent: Tuesday, November 27, 2007 12:04 PM
  To: Simion Onea
  Cc: PHPdoc
  Subject: Re: [PHP-DOC] Question about the tools
 
  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

 Oh, I found the errors! They went to PHP's error log that I configured.
 A lot of IDs are missing (about 40). Probably because the majority of files
 are not translated. But I thought they will be taken ftom the English tree.
 What can I do? I just wanted to build the Romanian manual as it is.

php configure.php --with-lang=ro --force-dom-save
You'll still get the error - but .manual.xml will be created.

-Hannes


Re: [PHP-DOC] Found the errors

2007-11-27 Thread Fernando Correa da Conceição

Simion Onea escreveu:

-Original Message-
From: Hannes Magnusson [mailto:[EMAIL PROTECTED] 
Sent: Tuesday, November 27, 2007 12:04 PM

To: Simion Onea
Cc: PHPdoc
Subject: Re: [PHP-DOC] Question about the tools

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



Oh, I found the errors! They went to PHP's error log that I configured.
A lot of IDs are missing (about 40). Probably because the majority of files
are not translated. But I thought they will be taken ftom the English tree.
What can I do? I just wanted to build the Romanian manual as it is.

Regards,
Simion.

  
Missing ids is not that a file is not translated. Is about outdated 
files, files that need update. Some id change or is added on a en file 
and this file is not updated, this will make a missing id, because the 
id exists on en(and can be used in other part of the manual) but do not 
exist in ro, because the translated version do not have it. So, to take 
care of missing ids, update the files where they are.
And the manual build without any error with/without missing ids. The 
build system take care of this.


Fernando Correa da Conceição


[PHP-DOC] RE: Found the errors

2007-11-27 Thread Simion Onea
 -Original Message-
 From: Hannes Magnusson [mailto:[EMAIL PROTECTED] 
 Sent: Tuesday, November 27, 2007 12:38 PM
 To: Simion Onea
 Cc: PHPdoc
 Subject: Re: Found the errors
 
 php configure.php --with-lang=ro --force-dom-save You'll 
 still get the error - but .manual.xml will be created.

I tried this, Hannes. The script took a long time to execute and the
resulting .manual.xml has just one line:
?xml version=1.0?

Regards,
Simion.


[PHP-DOC] Re: Found the errors

2007-11-27 Thread Hannes Magnusson
On Nov 27, 2007 2:10 PM, Simion Onea [EMAIL PROTECTED] wrote:
  -Original Message-
  From: Hannes Magnusson [mailto:[EMAIL PROTECTED]
  Sent: Tuesday, November 27, 2007 12:38 PM
  To: Simion Onea
  Cc: PHPdoc
  Subject: Re: Found the errors
 
  php configure.php --with-lang=ro --force-dom-save You'll
  still get the error - but .manual.xml will be created.

 I tried this, Hannes. The script took a long time to execute and the
 resulting .manual.xml has just one line:
 ?xml version=1.0?

Worked fine for me, post the error messages and let me have a look

-Hannes


[PHP-DOC] Re: Found the errors

2007-11-27 Thread Hannes Magnusson
On Nov 27, 2007 2:43 PM, Simion Onea [EMAIL PROTECTED] wrote:
  -Original Message-
  From: Hannes Magnusson [mailto:[EMAIL PROTECTED]
  Sent: Tuesday, November 27, 2007 3:29 PM
  To: Simion Onea
  Cc: PHPdoc
  Subject: Re: Found the errors
 
  Worked fine for me, post the error messages and let me have a look
 
  -Hannes

 I send the error log in the attachment.

Thats one bigass errorlog.
This isn't a clean checkout, is it?

A clean checkout works fine for me, and these errors you are getting
don't really make sense.
If you are still able to reproduce this on a clean checkout send me
your entities/file-entities.ent file.

-Hannes


Re: [PHP-DOC] Logs

2007-11-27 Thread Hannes Magnusson
On Nov 27, 2007 2:59 PM, Simion Onea [EMAIL PROTECTED] wrote:
  -Original Message-
  From: Hannes Magnusson [mailto:[EMAIL PROTECTED]
  Sent: Tuesday, November 27, 2007 3:29 PM
  To: Simion Onea
  Cc: PHPdoc
  Subject: Re: Found the errors
 
  Worked fine for me, post the error messages and let me have a look
 
  -Hannes

 Please rename the attachment from .zip_ to .zip.
 I did it because it gets banned by the mail server.

I need your /var/www/WebSites/phpdoc/entities/file-entities.ent file
from a clean checkout
-Hannes
(p.s. there is no need to start new threads all the time when dealing
with the same issue...)


[PHP-DOC] Re: PhD builds online

2007-11-27 Thread Hannes Magnusson
On Nov 25, 2007 11:36 PM, Hannes Magnusson [EMAIL PROTECTED] wrote:
 * With the exception of Czech, Polish and Spanish which did not pass test_xml

Spanish builds are now online :)

-Hannes


Re: [PHP-DOC] new-reference-structure builds on docs.php.net

2007-11-27 Thread Philip Olson


On Nov 26, 2007, at 4:09 PM, Hannes Magnusson wrote:


Hi all

Just a heads up, http://docs.php.net is now building from the
REF_STRUCT_DEV branch and will continue doing so until the rest of the
150 extensions have been upgraded and we can ditch the branch.

It would be great if people could pitch in, upgrading couple of
reference pages to the new-ref-struct - or upgrading some functions to
the new-doc-style (which is ~4years old..) :)



The following wiki entry details how to help with the new-ref-struct  
update:


  http://doc.php.net/wiki/skeletons/convert

I'll finish the new-doc-style update these coming days.

Regards,
Philip


Re: [PHP-DOC] new-reference-structure builds on docs.php.net

2007-11-27 Thread Olivier Hill
Hello,

If I have added a new function in the manual last week (new XML file),
should I MFH it to that branch and/or other branches? Or should I just
let it alone not to clash with anyone else's work?

Olivier

On Nov 27, 2007 7:36 PM, Philip Olson [EMAIL PROTECTED] wrote:


 On Nov 26, 2007, at 4:09 PM, Hannes Magnusson wrote:

  Hi all
 
  Just a heads up, http://docs.php.net is now building from the
  REF_STRUCT_DEV branch and will continue doing so until the rest of the
  150 extensions have been upgraded and we can ditch the branch.
 
  It would be great if people could pitch in, upgrading couple of
  reference pages to the new-ref-struct - or upgrading some functions to
  the new-doc-style (which is ~4years old..) :)


 The following wiki entry details how to help with the new-ref-struct
 update:

http://doc.php.net/wiki/skeletons/convert

 I'll finish the new-doc-style update these coming days.

 Regards,
 Philip



[PHP-DOC] RE: Found the errors

2007-11-27 Thread Simion Onea
 -Original Message-
 From: Hannes Magnusson [mailto:[EMAIL PROTECTED] 
 Sent: Tuesday, November 27, 2007 3:57 PM
 To: Simion Onea
 Cc: PHPdoc
 Subject: Re: Found the errors
 
 Thats one bigass errorlog.
 This isn't a clean checkout, is it?
 
 A clean checkout works fine for me, and these errors you are 
 getting don't really make sense.
 If you are still able to reproduce this on a clean checkout 
 send me your entities/file-entities.ent file.
 
 -Hannes

Hi Hannes!

I finally managed to build the .manual.xml file and ran PhD to build the
manual itself.

Now I understand where was my mistake. Before using php configure.php and
PhD I launched ./configure and make test. And because these tools are
now incompatible, I messed up things.
I did a clean checkout of both phpdoc and phpdoc-ro-dir as you
suggested.
Then I ran php configure.php --with-lang=ro --force-dom-save. It finished
successfully.
Then I ran phd -d.manual.xml. It also worked fine.

Now I understand how it works.
Sorry for taking your time, when it was my mistake. I just didn't know that
I must not use the ./configure script anymore.

Best regards,
Simion.