# libstdc++ Source Documentation

## Documentation Overview

Generated on @DATE@.

There are two types of documentation for libstdc++. One is the distribution documentation, which can be read online here or offline from the file doc/html/index.html in the library source directory.

The other type is the source documentation, of which this is the first page.

Here are entry points to all the pages generated by Doxygen:

- Modules
- Namespaces
  - List
  - Members
- Classes
  - List
  - Hierarchy
  - Members
- Source Files
- TODO List

If you are using Doxygen for your own projects, you can use a tag file for the appropriate version and an entry such as

> TAGFILES = "libstdc++.tag = http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen"

Be sure to adjust the URL for the right version. If you download a local copy of the source documentation for faster viewing, you can use the doxytag/installdox programs (part of Doxygen) to adjust the links for you.

## Generating the documentation

These HTML pages are automatically generated, along with the man pages. See the section "Documentation Style" in `doc/xml/manual/appendix_contributing.xml` in the source tree for how to create (and write) the doxygen markup. This style guide can also be viewed on the web.

## License, Copyright, and Other Lawyerly Verbosity

The libstdc++ documentation is released under these terms.

Part of the generated documentation involved comments and notes from SGI, who says we gotta say this:

> Permission to use, copy, modify, distribute and sell this software and its documentation for any purpose is hereby granted without fee, provided that the below copyright notice appears in all copies and that both the copyright notice and this permission notice appear in supporting documentation. Silicon Graphics makes no representations about the suitability of this software for any purpose. It is provided "as is" without express or implied warranty.
> Copyright © 1994 Hewlett-Packard Company

Part of the generated documentation is quoted from the ISO C++ Standard, which is Copyright © 1998 by Information Technology Industry Council.