stdcxx-issues mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Eric Lemings (JIRA)" <>
Subject [jira] Created: (STDCXX-964) Convert, generate, and publish documentation
Date Thu, 05 Jun 2008 20:03:45 GMT
Convert, generate, and publish documentation

                 Key: STDCXX-964
             Project: C++ Standard Library
          Issue Type: Improvement
          Components: Documentation
            Reporter: Eric Lemings
             Fix For: 4.3

STDCXX maintainers are considering migrating the existing documentation from plain HTML maintained
by hand to inline documentation generated automatically using a tool -- most likely [Doxygen|].
 This issue covers 3 primary subtasks: converting the existing HTML documentation to a close
approximation of the inline comments, preferably using a conversion script or filter; generating
the documentation from the inline comments by adding special Makefile targets (e.g. make html,
make pdf, etc.); and finally publishing the generated documentation periodically on the STDCXX
web site under the respective pages for guides, tutorials, references, etc.

This message is automatically generated by JIRA.
You can reply to this email to add a comment to the issue online.

View raw message