Re: HTML bugs revisited

[Werner LEMBERG]

> There's no good solution to this, unfortunately.  The code fragment
> above is IMHO a terrible kludge, so it's a small wonder it breaks
> under slightly unusual circumstances.  One work-around I can suggest
> is to define a dummy macro:
> 
>   @macro defdummy
>   @end macro

This works indeed!  Thanks for the idea.  It vastly improves the HTML
output.  I now have

  @DefescList
  @DefescItem
  @DefescListEnd

which is not bad.  Please document this address@hidden'  behaviour of the
HTML translator.

> > Additionally the string `\n[ident]' is represented as
> > 
> >   <b><tt>\n[</tt></b><i><var>ident</var><tt>]</tt>
> >   </i>
> > 
> > (embedded in a <td>...</td> construction).  This is not correct.
> > It should rather be
> > 
> >   <b><tt>\n[</tt></b><i><var>ident</var><b><tt>]</tt></b>
> 
> I don't understand why do you think so.  @deffn formats only the
> function's _name_ in bold, the rest are the function's arguments, so
> they are formatted in slanted face, like TeX does with @var (since
> arguments in the @def... commands have the implicit @var markup).

No.  I explicitly force @t:

  @macro Defesc{name, delimI, arg, delimII}
  @deffn Escape @address@hidden@t{\delimII\}
                                             ^^
  @esindex \name\
  @end macro

  @Defesc {\\n, @lbrack{}, ident, @rbrack}

So it looks like a bug in makeinfo.

> > BTW, ordinary `[' and `]' in a @defmac are printed upright in a DVI
> > file, while they are slanted in the HTML output (which is incorrect).
> 
> Please show the Texinfo fragment you were using.  If you are adding
> the @t markup via macro, like you did in @Defesc, it's possible that
> mixing slanted and typewriter faces has different effects in
> different browsers.

I don't rely on the browser, I rely on the produced HTML code.

 @macro Defmac{name, arg, package}
 @defmac @t{.\name\} \arg\
 @maindex \name\ @address@hidden
 @end macro

 @Defmac {SM, address@hidden, man}
 ...
 @endDefmac

Result:

  <b><tt>.SM</tt></b><i> [text]   
  </i>

It should be

  <b><tt>.SM<//t></b> [<i>text</i>]

TeX handles the brackets specially, making them upright.  HTML should
mimick this IMHO to produce consistent output.


    Werner