Changes between Version 6 and Version 7 of StandardCppLibraryDocumentation
- Timestamp:
- Jul 18, 2007, 10:23:44 PM (15 years ago)
Legend:
- Unmodified
- Added
- Removed
- Modified
-
StandardCppLibraryDocumentation
v6 v7 18 18 [[Image(standard_cpp_boosted_documentation.png,nolink)]] 19 19 20 [[PageOutline(2-5,Table of contents,inline)]] 21 22 ---- 23 24 == Introduction == 25 20 26 The goal of this documentary subproject is to produce concept and reference documentation for the Standard Template Library. Although much of this is very nicely documented and made available by [http://www.sgi.com/tech/stl/ SGI], there are several reasons that Boost should provide a set of documents under its own umbrella. As a stated goal in the Boost charter, "We aim to establish 'existing practice'" and many libraries documents espouse "Best Practices". This project falls under these auspices. This project aims to establish existing practice for providing concept and reference documetnation for C++ libraries. 21 27 22 Additional benefits in developing these documents include, a) a unified look and feel for ST +Boost documents and b) closer control over their content and presentation of the information. Essentially, this gives us a chance to work out more effective ways of presenting concept and reference material - which could be interesting with concepts becoming a major part of the new C++0x standard.28 Additional benefits in developing these documents include, a) a unified look and feel for STL+Boost documents and b) closer control over their content and presentation of the information. Essentially, this gives us a chance to work out more effective ways of presenting concept and reference material - which could be interesting with concepts becoming a major part of the new C++0x standard. 23 29 24 30 Most documentation for generic libraries can be cleanly divided into two different parts: concept documents and reference documents. 25 31 32 ---- 33 26 34 == Concept Documents == 27 35 Concepts documents describe the requirements on types (both built-in and user-defined) in order for them to be used with classes and functions provided by the library. 36 37 ---- 28 38 29 39 == Reference Documents ==