bug-texinfo
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

@deftypefun in HTML regression from 4.6?


From: Simon Josefsson
Subject: @deftypefun in HTML regression from 4.6?
Date: Fri, 16 Jan 2004 07:58:06 +0100
User-agent: Gnus/5.110002 (No Gnus v0.2) Emacs/21.3.50 (gnu/linux)

HTML for @deftypefun look like (in CVS):

,----
| - Function: int idna_to_unicode_44i (const uint32_t * in, size_t inlen, 
uint32_t * out, size_t * outlen, int flags)
|
| in: input array with unicode code points.
|
| inlen: length of input array with unicode code points. 
...
`----

In 4.6 it looked like:

,----
| int idna_to_unicode_44i (const uint32_t * in, size_t inlen, uint32_t * out, 
size_t * outlen, int flags)       Function
|
|   in: input array with unicode code points.
|
|   inlen: length of input array with unicode code points. 
...
`----

The indention is lost, and combined with the removed '- Function:'
header for each function, it makes it more difficult to spot where a
function begins.

Perhaps this is better:

,----
| - Function: int idna_to_unicode_44i (const uint32_t * in, size_t inlen, 
uint32_t * out, size_t * outlen, int flags)
|
|   in: input array with unicode code points.
|
|   inlen: length of input array with unicode code points. 
...
`----

I.e., indent the body text, and add a '-' to the front of the
definition line.  I kind of liked the right justified 'Function' text
in 4.6, though.

I'm not sure how much of this was consciously changed.  If it was
accidental, then it might be good to fix, but if it was deliberate,
you might disagree with my suggestions.

Thanks.





reply via email to

[Prev in Thread] Current Thread [Next in Thread]