From issues-return-2134-apmail-stdcxx-issues-archive=stdcxx.apache.org@stdcxx.apache.org Thu Jun 05 20:04:19 2008 Return-Path: Delivered-To: apmail-stdcxx-issues-archive@locus.apache.org Received: (qmail 95582 invoked from network); 5 Jun 2008 20:04:19 -0000 Received: from hermes.apache.org (HELO mail.apache.org) (140.211.11.2) by minotaur.apache.org with SMTP; 5 Jun 2008 20:04:19 -0000 Received: (qmail 93573 invoked by uid 500); 5 Jun 2008 20:04:22 -0000 Delivered-To: apmail-stdcxx-issues-archive@stdcxx.apache.org Received: (qmail 93553 invoked by uid 500); 5 Jun 2008 20:04:22 -0000 Mailing-List: contact issues-help@stdcxx.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: dev@stdcxx.apache.org Delivered-To: mailing list issues@stdcxx.apache.org Received: (qmail 93542 invoked by uid 99); 5 Jun 2008 20:04:22 -0000 Received: from nike.apache.org (HELO nike.apache.org) (192.87.106.230) by apache.org (qpsmtpd/0.29) with ESMTP; Thu, 05 Jun 2008 13:04:22 -0700 X-ASF-Spam-Status: No, hits=-2000.0 required=10.0 tests=ALL_TRUSTED X-Spam-Check-By: apache.org Received: from [140.211.11.140] (HELO brutus.apache.org) (140.211.11.140) by apache.org (qpsmtpd/0.29) with ESMTP; Thu, 05 Jun 2008 20:03:23 +0000 Received: from brutus (localhost [127.0.0.1]) by brutus.apache.org (Postfix) with ESMTP id 1C4B0234C12E for ; Thu, 5 Jun 2008 13:03:45 -0700 (PDT) Message-ID: <1706075765.1212696225100.JavaMail.jira@brutus> Date: Thu, 5 Jun 2008 13:03:45 -0700 (PDT) From: "Eric Lemings (JIRA)" To: issues@stdcxx.apache.org Subject: [jira] Created: (STDCXX-964) Convert, generate, and publish documentation MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 7bit X-Virus-Checked: Checked by ClamAV on apache.org Convert, generate, and publish documentation -------------------------------------------- Key: STDCXX-964 URL: https://issues.apache.org/jira/browse/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|http://www.doxygen.org]. 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.