[Doxygen-develop] Multi-language support in Doxygen?

[Jim W. <js...@bl...>]

Hi,

   Does doxygen support documentation in multiple languages?

As an example, the basic schema is that somewhere at the "top" of the =20=

source definition (or in a configuration file), a "default language" is =20=

defined.  Then a set of "Alternate Languages" is defined, in a =20
Scheme-style list (language identifiers are [a-zA-Z0-9]* )  Then =20
certain '///' comments that have a '< [Identifier]' and directly follow =20=

default-language comments would define one of the alternate language =20
comments.  Then the command-line for generating the documentation would =20=

have an optional language setting (something like 'doxygen -l EN').

Here is an example of how this might look (taken from the Desktop =20
Connection Library, which uses Doxygen): (see =20
http://www.kallisys.com/newton/dcl/)

/// DefaultLang =3D EN
/// AltLangs =3D (FR)
@interface DeliveryController : NSObject < IDCLObjCApplication >
{
	// C++
	TDCLCommLayer*			mCommLayer;		///< =
Couche de communication
	///<EN Communications layer
	TDCLServer*				mServer;		=
///< Serveur (\c nil s'il ne tourne pas)
	///<EN Server (\c nil if it returns no *?
}

   I don't know whether Doxygen interprets comments following function =20=

definition headings.. (I haven't actually used it, just looked at it's =20=

use in the source files.

// =20
------------------------------------------------------------------------=20=

- //
//  * main
// =20
------------------------------------------------------------------------=20=

- //
// Point d'entr=E9e de l'application Delivery.
// EN> Entry point for the Delivery Application
int
main( int argc, const char *argv[] )
{
	return NSApplicationMain( argc, argv );
}

Jim Witte
js...@bl...
Indiana University CS=