From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 12815 invoked by alias); 12 Jun 2008 18:47:47 -0000 Received: (qmail 12807 invoked by uid 22791); 12 Jun 2008 18:47:46 -0000 X-Spam-Check-By: sourceware.org Received: from smtp-out.google.com (HELO smtp-out.google.com) (216.239.33.17) by sourceware.org (qpsmtpd/0.31) with ESMTP; Thu, 12 Jun 2008 18:47:19 +0000 Received: from spaceape7.eur.corp.google.com (spaceape7.eur.corp.google.com [172.28.16.141]) by smtp-out.google.com with ESMTP id m5CIlDTX015616 for ; Thu, 12 Jun 2008 19:47:13 +0100 Received: from fg-out-1718.google.com (fgg16.prod.google.com [10.86.7.16]) by spaceape7.eur.corp.google.com with ESMTP id m5CIlDY7016382 for ; Thu, 12 Jun 2008 19:47:13 +0100 Received: by fg-out-1718.google.com with SMTP id 16so2844619fgg.23 for ; Thu, 12 Jun 2008 11:47:13 -0700 (PDT) MIME-Version: 1.0 Received: by 10.86.98.10 with SMTP id v10mr2749639fgb.46.1213296432831; Thu, 12 Jun 2008 11:47:12 -0700 (PDT) Date: Thu, 12 Jun 2008 18:47:00 -0000 Message-ID: Subject: [tuples] API documentation From: Diego Novillo To: gcc@gcc.gnu.org Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: 7bit X-IsSubscribed: yes Mailing-List: contact gcc-help@gcc.gnu.org; run by ezmlm Precedence: bulk List-Id: List-Archive: List-Post: List-Help: Sender: gcc-owner@gcc.gnu.org X-SW-Source: 2008-06/txt/msg00301.txt.bz2 I just finished going through the API document adding missing content and updating stale information. While there are various aspects of GIMPLE that are not covered in the document, it is probably complete enough for converting/adding gimple code. At the moment I'm wondering what would be the best way to host this documentation. Do we leave it on some web-based form (wiki or google docs)? Do we move it to the source tree as .texi files? I can see advantages to both approaches. Leaving it on the web, makes it easier to edit and evolve. Moving to the source tree makes it easier to version but harder to edit. The document is now linked off of the tuples wiki (http://gcc.gnu.org/wiki/tuples). The direct link is http://docs.google.com/Doc?id=dgfkmttj_107hcr98sg3 I would also appreciate feedback in terms of what is missing and what would be useful to add. Thanks. Diego.