>> why are `@anchor` and friends discouraged on an `@item` line?
>> AFAICS, the reason for this restriction is not documented in the
>> manual, and it seems to work just fine...
>
> Do you have a specific output showing it discouraged? And if yes,
> with which version of GNU Texinfo?
This is with a self-compiled version 7.1. For some auto-generated
documentation I tried stuff like this:
```
@table @asis
@item @anchor{foo}@code{foo} ...
@item @anchor{bar}@code{bar} ...
...
@end table
```
I guess I have to change this to
```
@table @asis
@anchor{foo}
@item @code{foo}
...
@anchor{bar}
@item @code{bar}
...
@end table
```
BTW, there is a similar issue with
```
@table @asis
@item @ref{foo}
...
@item @bar{foo}
...
@end table
```
to be used with HTML output only, and which also causes warnings with
`makeinfo`. In this case, however, I don't know how to avoid the
warning...
> In any case, I think that an @anchor on a @table @item line is not a
> problem, but for @vtable and @ftable the @item is also used as an
> index entry. An @anchor in index entry may not be the best as it
> could appear both where the @item is and in the @printindex
> formatting of the index entry. This happens in the HTML output for
> instance. Also the HTML output in printindex will contain nested
> <a>, which is invalid HTML, though it is not a practical issue on
> browsers.
Ok, thanks for the explanation. Maybe it makes sense to mention this
in the documentation.
Werner
