Files

82 lines
2.2 KiB
C
Raw Permalink Normal View History

/**
2024-11-08 18:05:46 +00:00
* @file
* Main page of the Doxygen-generated documentation.
*/
2020-05-19 12:51:43 -07:00
2008-01-10 07:31:40 -08:00
/**
2024-11-08 18:05:46 +00:00
* @mainpage ns-3 Documentation
2008-01-10 07:31:40 -08:00
*
2024-11-08 18:05:46 +00:00
* @section intro-sec Introduction
* <a href="http://www.nsnam.org/">ns-3</a> documentation is maintained using
2008-01-10 07:31:40 -08:00
* <a href="http://www.doxygen.org">Doxygen</a>.
* Doxygen is typically used for
2008-01-10 07:31:40 -08:00
* API documentation, and organizes such documentation across different
2009-11-13 13:25:14 -08:00
* modules. This project uses Doxygen for building the definitive
* maintained API documentation. Additional ns-3 project documentation
2011-06-29 20:55:34 -07:00
* can be found at the
* <a href="http://www.nsnam.org/documentation/latest">project web site</a>.
2008-01-10 07:31:40 -08:00
*
2024-11-08 18:05:46 +00:00
* @section install-sec Building the Documentation
*
2025-03-05 20:04:53 -08:00
* Building ns-3 Doxygen requires Doxygen version 1.11
*
2022-01-13 23:59:59 -03:00
* Type "./ns3 docs doxygen" or "./ns3 docs doxygen-no-build" to build the
2009-11-14 07:13:06 -08:00
* documentation. The doc/ directory contains
* configuration for Doxygen (doxygen.conf) and main.h. The Doxygen
* build process puts html files into the doc/html/ directory, and latex
2008-01-10 07:31:40 -08:00
* filex into the doc/latex/ directory.
*
* @section topics-sec Doxygen groups
2008-01-10 07:31:40 -08:00
*
* The ns-3 library is split across many modules, and the Doxygen for these modules is typically
* added to <a href ="https://www.doxygen.nl/manual/grouping.html">Doxygen groups</a>.
* These groupings can be browsed under the <b><a href="topics.html">Topics</a></b> tab.
2008-01-10 07:31:40 -08:00
*/
2020-05-19 12:51:43 -07:00
2008-01-10 07:31:40 -08:00
/**
2024-11-08 18:05:46 +00:00
* @namespace ns3
* @brief Every class exported by the ns3 library is enclosed in the
2008-01-10 07:31:40 -08:00
* ns3 namespace.
*/
/**
2024-11-08 18:05:46 +00:00
* @name Macros defined by the build system.
*
* These have to be visible for doxygen to document them,
* so we put them here in a file only seen by doxygen, not the compiler.
*
* @{
*/
/**
2024-11-08 18:05:46 +00:00
* @ingroup assert
*
2024-11-08 18:05:46 +00:00
* @def NS3_ASSERT_ENABLE
*
* Enable asserts at compile time.
*
2021-11-29 21:58:30 -03:00
* This is normally set by `./ns3 configure --build-profile=debug`.
*/
#define NS3_ASSERT_ENABLE
/**
2024-11-08 18:05:46 +00:00
* @ingroup logging
*
2024-11-08 18:05:46 +00:00
* @def NS3_LOG_ENABLE
*
* Enable logging at compile time.
*
2021-11-29 21:58:30 -03:00
* This is normally set by `./ns3 configure --build-profile=debug`.
*/
#define NS3_LOG_ENABLE
/**@}*/
2020-05-19 12:51:43 -07:00
/**
2024-11-08 18:05:46 +00:00
* @page EnvironVar All Environment Variables
2020-05-19 12:51:43 -07:00
*
* All environment variables used by ns-3 are documented by module.
*
2024-11-08 18:05:46 +00:00
* @section environcore Core Environment Variables
2020-05-19 12:51:43 -07:00
* See \ref core-environ
*/