2017-09-17 19:43:27 -07:00
|
|
|
/**
|
2024-11-08 18:05:46 +00:00
|
|
|
* @file
|
2017-09-17 19:43:27 -07:00
|
|
|
* 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
|
2022-06-05 21:01:11 -07:00
|
|
|
* <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>.
|
2022-06-05 21:01:11 -07:00
|
|
|
* 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
|
2022-06-05 21:01:11 -07:00
|
|
|
* 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
|
2022-06-05 21:01:11 -07:00
|
|
|
*
|
2025-03-05 20:04:53 -08:00
|
|
|
* Building ns-3 Doxygen requires Doxygen version 1.11
|
2022-06-05 21:01:11 -07:00
|
|
|
*
|
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
|
2022-06-05 21:01:11 -07:00
|
|
|
* 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.
|
2022-06-05 21:01:11 -07:00
|
|
|
*
|
2025-02-02 10:55:35 -08:00
|
|
|
* @section topics-sec Doxygen groups
|
2008-01-10 07:31:40 -08:00
|
|
|
*
|
2025-02-02 10:55:35 -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.
|
|
|
|
|
*/
|
|
|
|
|
|
2017-09-17 19:43:27 -07:00
|
|
|
/**
|
2024-11-08 18:05:46 +00:00
|
|
|
* @name Macros defined by the build system.
|
2022-06-05 21:01:11 -07:00
|
|
|
*
|
2017-09-17 19:43:27 -07:00
|
|
|
* 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.
|
2022-06-05 21:01:11 -07:00
|
|
|
*
|
2017-09-17 19:43:27 -07:00
|
|
|
* @{
|
|
|
|
|
*/
|
2014-03-10 10:57:50 -07:00
|
|
|
/**
|
2024-11-08 18:05:46 +00:00
|
|
|
* @ingroup assert
|
2014-03-10 10:57:50 -07:00
|
|
|
*
|
2024-11-08 18:05:46 +00:00
|
|
|
* @def NS3_ASSERT_ENABLE
|
2014-03-10 10:57:50 -07:00
|
|
|
*
|
|
|
|
|
* Enable asserts at compile time.
|
|
|
|
|
*
|
2021-11-29 21:58:30 -03:00
|
|
|
* This is normally set by `./ns3 configure --build-profile=debug`.
|
2014-03-10 10:57:50 -07:00
|
|
|
*/
|
|
|
|
|
#define NS3_ASSERT_ENABLE
|
|
|
|
|
|
|
|
|
|
/**
|
2024-11-08 18:05:46 +00:00
|
|
|
* @ingroup logging
|
2014-03-10 10:57:50 -07:00
|
|
|
*
|
2024-11-08 18:05:46 +00:00
|
|
|
* @def NS3_LOG_ENABLE
|
2014-03-10 10:57:50 -07:00
|
|
|
*
|
|
|
|
|
* Enable logging at compile time.
|
|
|
|
|
*
|
2021-11-29 21:58:30 -03:00
|
|
|
* This is normally set by `./ns3 configure --build-profile=debug`.
|
2014-03-10 10:57:50 -07:00
|
|
|
*/
|
|
|
|
|
#define NS3_LOG_ENABLE
|
2017-09-17 19:43:27 -07:00
|
|
|
|
|
|
|
|
/**@}*/
|
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
|
|
|
|
|
*/
|