Re: Info doc

[Per Bothner <per at bothner dot com>]

On 02/22/2011 02:29 AM, Helmut Eller wrote:
> When reading the doc with Emacs it looks so:
>
> 19.1.3 Declaring methods
> ------------------------
>
>       METHOD-DECL `::=' `(('see METHOD-NAME. See FORMAL-ARGUMENTS.`)'
>           (see ANNOTATION. | see OPT-RETURN-TYPE. | see OPTION-PAIR.)* [see DEPR\
> ECATED-RETURN-SPECIFIER.] BODY`)'
>       METHOD-NAME `::=' see IDENTIFIER.
>       DEPRECATED-RETURN-SPECIFIER `::=' see IDENTIFIER.
>
>
> Looks like @ref should be used more often to get rid of all those "see".
> Also why is ::= quoted but | is not?

@ref *is* used.  I think it may be best to just drop thus cross-references
in info mode.

Could you try the attached patch, and tell me what you think?  Other
suggested tweaks are also welcome.
--
	--Per Bothner
per@bothner.com   http://per.bothner.com/

Attachment: kawa-texi.patch
Description: Text document