PHP Documentation - Re: [PHP-DOC] wrong symbols in phpdoc/chm

Author

Re: [PHP-DOC] wrong symbols in phpdoc/chm

Nuno Lopes

2005-09-21, 6:56 pm

Hi,

This is a know problem and is being tracked at http://bugs.php.net/33838

Regards,
Nuno

----- Original Message -----
> Hi all,
>
> What's wrong with php-doc in CHM format?
> There are a lot of "????" symbols throughout all the manual.
> In stead of "Next", "Prev" and many topic captions etc links I see just
> series of "?".
> CHM file is dated 2005-09-19, md5sum = 0578af416d91cc9bdf3fed5e4ffa48ac,
> English.
>
> I tried an old and quite outdated CHMs and they work just fine.
> What's up with newer ones?
>
> Regards,
> JV.

Vlad J.

2005-09-21, 6:56 pm

Hi Nuno,
Thanks for your prompt reply.
Sorry for bothering, I'd have checked bugtracker myself.

I'd like to contribute and fix this problem or at least find the origin of
the trouble.
Could you please point me out to the instructions relevant to CHM targets?

Thanks,
JV.

""Nuno Lopes"" <nlopess@php.net> wrote in message
news:000901c5bef2$73147210$0100a8c0@pc07
653...[color=darkred]
> Hi,
>
> This is a know problem and is being tracked at http://bugs.php.net/33838
>
> Regards,
> Nuno
>
>
> ----- Original Message -----

Nuno Lopes

2005-09-21, 6:56 pm

The chm build tools are available at http://cvs.php.net/phpdoc/chm
However this is a problem in the server's configuration, because the chms
I've built on my machine are fine. It's probably just a locales problem
within openjade.

Nuno

----- Original Message -----[color=darkred]
> Hi Nuno,
> Thanks for your prompt reply.
> Sorry for bothering, I'd have checked bugtracker myself.
>
> I'd like to contribute and fix this problem or at least find the origin of
> the trouble.
> Could you please point me out to the instructions relevant to CHM targets?
>
> Thanks,
> JV.
>
>
> ""Nuno Lopes"" <nlopess@php.net> wrote in message
> news:000901c5bef2$73147210$0100a8c0@pc07
653...

Vlad J.

2005-09-21, 6:56 pm

Hi Nuno,

Got phpdoc and necessary tools installed and now it fails with the error
below:

[JV@xjv phpdoc]$ make
rm -rf html && mkdir html
/usr/local/bin/php -q ./scripts/rtlpatch/hackmanuallang.php en
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/html.dsl -V use-output-dir -t sgml
../dtds/dbxml-4.1.2/phpdocxml.dcl manual.xml
/usr/bin/openjade:E: error reading "dsssl/catalog" (Is a directory)

I checked "~/phpdoc/dssl/catalog" is a directory.
OpenJade 1.3.1
OpenSP 1.3.4

The same problem happens under Windows/Cygwin (openjade 1.3.3pre1) and under
native Linux (openjade version is listed above).
Any ideas?

Thanks,
JV.

""Nuno Lopes"" <nlopess@php.net> wrote in message
news:003b01c5bef9$cf19dd00$0100a8c0@pc07
653...[color=darkred]
> The chm build tools are available at http://cvs.php.net/phpdoc/chm
> However this is a problem in the server's configuration, because the chms
> I've built on my machine are fine. It's probably just a locales problem
> within openjade.
>
> Nuno
>
>
> ----- Original Message -----
of[color=darkred]
targets?[color=darkred]
http://bugs.php.net/33838[color=darkred]
just[color=darkred]

Derick Rethans

2005-09-22, 3:56 am

On Wed, 21 Sep 2005, Nuno Lopes wrote:

> The chm build tools are available at http://cvs.php.net/phpdoc/chm
> However this is a problem in the server's configuration, because the chms I've
> built on my machine are fine. It's probably just a locales problem within
> openjade.

?? Nothing in the configuration changed in a whole year... and it
suddendly stopped working. I also can't debug anything as Windows
refuses to show any CHMs at all right now.

Derick

Vlad J.

2005-09-22, 3:56 am

"Derick Rethans" <derick@php.net> wrote in message
news:Pine.LNX.4.62.0509220847530.17320@localhost...
> On Wed, 21 Sep 2005, Nuno Lopes wrote:
>
chms I've[color=darkred]
within[color=darkred]
>
> ?? Nothing in the configuration changed in a whole year... and it
> suddendly stopped working. I also can't debug anything as Windows
> refuses to show any CHMs at all right now.

What's about phpdoc/chm/make_chm.php?
it was changed 2 w

s ago.
Also, it's unclear which one directory is really used for building chm
files.
I see two concurent ways: phpdoc/htmlhelp/make_chm.bat and
phpdoc/chm/make_chm.bat
Both set of tools expect all the files produced by running make in html
subdirectory while really it appears a level higher.
So with default setting neither works.
Anyway, it does not expliain what's wrong with "Next", "Back" and other
links.

BTW, chm I downloaded yesterday works fine.
Probably you tried to run chm from a networked drive. Since IE version 6 it
won't work for the reasons known to MS alone...
Try chm on a local disk.

JV

Nuno Lopes

2005-09-22, 7:55 am

> On Wed, 21 Sep 2005, Nuno Lopes wrote:
>
>
> ?? Nothing in the configuration changed in a whole year... and it
> suddendly stopped working. I also can't debug anything as Windows
> refuses to show any CHMs at all right now.
>
> Derick

I was searching on google for this problem, but I couldn't find anything..
I'm lost.
Maybe a change in the dsssl sheets or the way that openjade is invoked, I
don't know..

Nuno

Vlad J.

2005-09-22, 6:56 pm

""Nuno Lopes"" <nlopess@php.net> wrote in message
news:005101c5bf5a$06f664e0$0100a8c0@pc07
653...
chms[color=darkred]
within[color=darkred]
>
> I was searching on google for this problem, but I couldn't find anything..
> I'm lost.
> Maybe a change in the dsssl sheets or the way that openjade is invoked, I
> don't know..
>
> Nuno

I got it working and discovered some problems with make_chm.bat,
make_chm.php and make_make_chm_fancy.php.
First of all, I was trying and got it working under Win32, b'ze I think it's
appropriate since MS hhc.exe is a native Win32 executable.
It might be tried under wine and Linux but I didn't do it.
Most of the problems were with fopen() mode, directories and a lot of
substr() around $FANCY.
Finally, produced chm file works fine and contains correct links and topics.

If anybody is interested in Win32 target, just let me know and I'll post
diff.

Now regarding wrong symbols.
I was unable to find any reason for the trouble. But one possible way for it
is found.
All final HTMLs for English lang are with charset=Windows-1252 According to
chm/common.php, there is convertCharset() function is called for all of the
files and it is to convert the content from UTF-8 (internal charset, see
common.php:6) into preferred charset which is Win-1252 for English. Looks
like it fails to translate some international stuff into Win1252.

Sponsored Links