RE: [Doxygen-users] Including external documentation

[Glenn M. <gle...@vo...>]

Everything may be on one line, but what stands out to me as a possible
error is that your @class and @fn prototypes also list the file name,
AltCtrlx.h. This could certainly contribute to the prototypes not
matching what Doxygen extracts.

Only on your first @file reference do you need that file name.

HTH.

Glenn

> -----Original Message-----
> From: jalal @ gnomedia [mailto:ja...@gn...]
> Sent: Saturday, December 29, 2001 9:38 AM
> To: dox...@li...
> Subject: [Doxygen-users] Including external documentation
>=20
>=20
> Hi all
>=20
> I'm trying to document an existing library (the Windows=20
> Template Library), of which I have the header files and not=20
> much else. Nothing is documented in files and I can't change them.
> So, I have an external documentation file. In this I have,=20
> for example (this is an excerpt):
>=20
> /** @file AtlCtrlx.h
>     @brief bitmap button, check list view and other controls
> */
>=20
> /** @class WTL::CMultiPaneStatusBarCtrlImpl AtlCtrlx.h
>     @brief Class implementing a MultiPane status bar control
>     @see WTL::CMultiPaneStatusBarCtrl
> */
>=20
> /** @fn template<class T, class TBase =3D CStatusBarCtrl> BOOL=20
> WTL::CMultiPaneStatusBarCtrlImpl< T, TBase >::SetPanes(int*=20
> pPanes, int nPanes, bool bSetText =3D true) AtlCtrlx.h
>  *  @brief Sets the panes to values
>  *=20
>  *  Further instruction will go here.
>  */                                  =20
>=20
> Everything works very well, except for the @fn tag, which=20
> gives me '... not defined' error. I've tried every combination I can=20
> think of, but no way will Doxygen recognize it. (and yes,=20
> everything is on one line, I'm not sure what the emailer is=20
> going to do with it.)
>=20
> Any ideas?
>=20
> regards
> jalal
>=20
>=20
>=20
>=20
>=20
> _______________________________________________
> Doxygen-users mailing list
> Dox...@li...
> https://lists.sourceforge.net/lists/listinfo/doxygen-users
>=20