Bug 20187

Summary: @see not working in single-class case
Product: kdoc Reporter: Ivan E. Moore II <rkrusty>
Component: generalAssignee: Sirtaj Singh Kang <taj>
Status: CLOSED FIXED    
Severity: normal    
Priority: NOR    
Version: unspecified   
Target Milestone: ---   
Platform: unspecified   
OS: Other   
Latest Commit: Version Fixed In:

Description Ivan E. Moore II 2001-02-10 00:06:34 UTC
(*** This bug was imported into bugs.kde.org ***)

Package: kdoc
Version: 2.0a46-1
Severity: normal

(Originally submitted to the Debian BTS by Stephen M Moraco <stephen_moraco@agilent.com> as Bug#85443)

Using the '@see {ClassName}' form.  When only one name is given
say:
        * @see Phonebook

(where Phonebook is one of the classes in this kdoc run) I get
nothing (no See Also section).

If however I have
        * @see Phonebook PhonebookEntry

then I get a See also section.

Workaround:  I found that adding  a space followed by a '.' character
        that the resultant output is a linked class reference in a
        see also section and a slightly annoying trailing period. (Less
        annoying than having no see also section ;-)

I believe that a single class name is an allowed form of @see
so I'm sugesting there's some sort of problem here.