Re: [PHP-DOC] para role=seealso

2001-12-22 Thread Hartmut Holzgraefe

Egon Schmid wrote:

 The second line is correct. This means something goes wrong with the
 dsl files or with different versions of DocBook.



just have a look at the source and you will see the difference
causing this behaviour

english version

 funcsynopsis
  funcprototype
   funcdefstring functionmysql_error/function/funcdef
   paramdefresource
parameter
 optionallink_identifier/optional
/parameter
   /paramdef
  /funcprototype
 /funcsynopsis

german version
 funcsynopsis
  funcprototype
   funcdefstring functionmysql_error/function/funcdef
   paramdefint 
parameteroptionalVerbindungs-Kennung/optional/parameter/paramdef
  /funcprototype
 /funcsynopsis

has ever been this way since i did the original dsssl addition
i have already noticed some time ago that multiline paramdefs
confuse my code, but as it is going to be obsolete with DocBook4
anyway i'm not going to rewrite it again

the DSSSL code in the DocBook4 branch already does it right in
combination with the switch from funcsynopsis to methodsynopsis

PS: what is the relation between para role=seealso
 and rendering of prototypes? i just don't get it?


-- 
Hartmut Holzgraefe  [EMAIL PROTECTED]  http://www.six.de  +49-711-99091-77






Re: [PHP-DOC] para role=seealso

2001-12-22 Thread Gabor Hojtsy

 the DSSSL code in the DocBook4 branch already does it right in
 combination with the switch from funcsynopsis to methodsynopsis

Can't wait to see things working with DocBook 4 ;)

 PS: what is the relation between para role=seealso
  and rendering of prototypes? i just don't get it?

The DSSSL formatting maybe. I am still interested in how
to render that para role=seealso, if someone can find
the time... Not that urgent, so have a Merry Christmas
instead, and don't break it with work ;))

Goba





[PHP-DOC] para role=seealso

2001-12-21 Thread Gabor Hojtsy

Hi!

I tried to play some with this para role=seealso
rendering, but it seemed I am unable to guess how do
things in DSSSL myself :)

I would like to make the para role=seealso rendering
look like the note tag rendering, a container blockquote,
with an autogenerated See also: text.

This would eliminate the need of making such paras:

   para
See also functionis_array/function, functionexplode/function, 
functionimplode/function, functionsplit/function 
and functionjoin/function.
   /para

And we would use this form:

   para role=seealso
functionis_array/function, functionexplode/function, 
functionimplode/function, functionsplit/function 
and functionjoin/function
   /para

Or even better just a list, if someone can make the rendering
to print out the list delimiters...

   para role=seealso
functionis_array/function
functionexplode/function
functionimplode/function
functionsplit/function 
functionjoin/function
   /para

This would be the best option anyway :)) But this also makes
impossible to express things in see also parts such as

para
 See also the reverse function functionebcdic2ascii/function 
/para

As this would be:

para role=seealso
 functionebcdic2ascii/function
/para

Without any plus info...

As discusseb before, it is not optimal for us to introduce a new
tag for this see also thing, but many of us would like to see
this separate see also rendering, as I can remember. This is also
proved in the NewCHM comments...

Goba




Re: [PHP-DOC] para role=seealso

2001-12-21 Thread Egon Schmid

From: Gabor Hojtsy [EMAIL PROTECTED]

 I tried to play some with this para role=seealso
 rendering, but it seemed I am unable to guess how do
 things in DSSSL myself :)

I noticed recently that it seems that the rendering for the function
prototypes doesn´t work. Compare the different rendering with DSSSL
(common-html.dsl)  at:

www.dynamicwebpages.de/mysql_error

with

www.php.net/mysq_error

The rendering at php.net is now wrong and it seems to me that there
isn´t any rendering, at least for function prototypes.

-Egon




Re: [PHP-DOC] para role=seealso

2001-12-21 Thread Gabor Hojtsy

 I noticed recently that it seems that the rendering for the function
 prototypes doesn´t work. Compare the different rendering with DSSSL
 (common-html.dsl)  at:

 www.dynamicwebpages.de/mysql_error

 with

 www.php.net/mysq_error

 The rendering at php.net is now wrong and it seems to me that there
 isn´t any rendering, at least for function prototypes.

So to be correct the current rendering does not include
the type in the optional part... The first is from
php.net, the second is from dynamicwebpages.de:

string mysql_error (resource [link_identifier])
string mysql_error ([int Verbindungs-Kennung])

But as said before, I do not know DSSSL, just tried to play
with it, so I cannot resolve this problem...

Goba




Re: [PHP-DOC] para role=seealso

2001-12-21 Thread Friedhelm Betz


Hi,

 The rendering at php.net is now wrong and it seems to me that there
 isn´t any rendering, at least for function prototypes.

 So to be correct the current rendering does not include
 the type in the optional part... The first is from
 php.net, the second is from dynamicwebpages.de:

 string mysql_error (resource [link_identifier])
 string mysql_error ([int Verbindungs-Kennung])

 But as said before, I do not know DSSSL, just tried to play
 with it, so I cannot resolve this problem...

 Goba

It seems to depend on the language

http://www.php.net/manual/en/function.mysql-error.php
string mysql_error (resource [link_identifier])

http://www.php.net/manual/de/function.mysql-error.php
string mysql_error ([int Verbindungs-Kennung])

http://www.php.net/manual/hu/function.mysql-error.php
string mysql_error (int [link_identifier])

All the builds on php.net are from Friday, 21, except hu

Strange..., html-locale.dsl ?
I myself have no knowledge about DSSSL, but someone could find this
info usefull?


Friedhelm




Re: [PHP-DOC] para role=seealso

2001-12-21 Thread Egon Schmid

From: Gabor Hojtsy [EMAIL PROTECTED]

  I noticed recently that it seems that the rendering for the
function
  prototypes doesn´t work. Compare the different rendering with
DSSSL
  (common-html.dsl)  at:
 
  www.dynamicwebpages.de/mysql_error
 
  with
 
  www.php.net/mysq_error
 
  The rendering at php.net is now wrong and it seems to me that
there
  isn´t any rendering, at least for function prototypes.

 So to be correct the current rendering does not include
 the type in the optional part... The first is from
 php.net, the second is from dynamicwebpages.de:

 string mysql_error (resource [link_identifier])
 string mysql_error ([int Verbindungs-Kennung])

 But as said before, I do not know DSSSL, just tried to play
 with it, so I cannot resolve this problem...

I know the history :)  Hartmut played with the stylesheets and got
the first line displayed like the second. Forget for now some
translation anomalies. If you don´t use any stylesheet, the default
behaviour of DocBook is, what you can see in the first line.

The second line is correct. This means something goes wrong with the
dsl files or with different versions of DocBook.

-Egon