Re: Re: GeometryKit documentation

Philippe C.D. Robert <[email protected]> Mon, 21 Oct 2002 18:43:28 +0200
Newsgroups gmane.comp.gnu.3dkit.general
Message-ID <[email protected]>
On Monday, October 21, 2002, at 06:30  Uhr, Brent Gulanowski wrote:
>>>>> MatrixFunc comes out fine for me -- the methods are re-organized 
>>>>> alphabetically, however. G3DBox, Line, Quaternion, Sphere, Plane, 
>>>>> Intersecting and all the Matrices aren't recognized as ObjC 
>>>>> classes and their method documentation is being ignored.
>>>>
>>>> The problem is definitely that headerdoc doesn't like @class being 
>>>> used by Objective-C grammar. All of the headers I created that had 
>>>> @class preprocessor directive did not produce complete documenation 
>>>> html.
>>>
>>> This has been filed as bug #136 at
>>> http://opendarwin.org/bugzilla/query.cgi
>>> (requires an account to login)
>>
>> Uhm, unless I miss sth this works for me - what is the problem 
>> exactly (well at least for these classes which do contain some 
>> description)?
>>
>> BTW bugzilla is only configured for HeaderDoc 6.x, but 7.2 is the 
>> current version...
>
> Here's part of the header2HTML.pl output:
>
> Processing G3DIntersecting.h
> Unknown class type (known: cpp, objC)
>
> Processing G3DLine.h
> Unknown class type (known: cpp, objC)
>
> Processing G3DMatrix3d.h
> Unknown class type (known: cpp, objC)
>
> Processing G3DMatrix3f.h
> Unknown class type (known: cpp, objC)
>
> Processing G3DMatrix4d.h
> Unknown class type (known: cpp, objC)
>
> Processing G3DMatrix4f.h
> Unknown class type (known: cpp, objC)
>
> Processing G3DMatrixFunc.h
>
> [etc...]
>
> You didn't get these errors? In the output doc files, the methods are 
> not produced.

I do, but only for these classes which do not contain any method 
documentation. So I somehow assumed this has sth to do with this - esp. 
because the documentation looks OK then.

-Phil
--
Philippe C.D. Robert
http://www.nice.ch/~phip