From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 32610 invoked by alias); 27 Jan 2004 21:23:14 -0000 Mailing-List: contact gcc-help@gcc.gnu.org; run by ezmlm Precedence: bulk List-Archive: List-Post: List-Help: Sender: gcc-owner@gcc.gnu.org Received: (qmail 32586 invoked from network); 27 Jan 2004 21:23:13 -0000 Received: from unknown (HELO nile.gnat.com) (205.232.38.5) by sources.redhat.com with SMTP; 27 Jan 2004 21:23:13 -0000 Received: from [205.232.38.235] (dhcp13.gnat.com [205.232.38.235]) by nile.gnat.com (Postfix) with ESMTP id A7D07F2841; Tue, 27 Jan 2004 16:23:11 -0500 (EST) In-Reply-To: <1074569238.25137.206.camel@frodo.toronto.redhat.com> References: <10401170324.AA15949@vlsi1.ultra.nyu.edu> <20040119153026.A21678@synopsys.com> <476C5192-4AD9-11D8-8DB8-000A95DA505C@dberlin.org> <8DCDA992-4AF6-11D8-AE43-000A959A128E@gnat.com> <1074569238.25137.206.camel@frodo.toronto.redhat.com> Mime-Version: 1.0 (Apple Message framework v612) Content-Type: text/plain; charset=US-ASCII; format=flowed Message-Id: <02E55118-510F-11D8-82A4-000A959A128E@gnat.com> Content-Transfer-Encoding: 7bit Cc: Joe Buck , gcc@gcc.gnu.org, Richard Kenner From: Geert Bosch Subject: tree-ssa/13756 Documentation issues Date: Tue, 27 Jan 2004 21:24:00 -0000 To: Diego Novillo X-SW-Source: 2004-01/txt/msg02064.txt.bz2 On Jan 19, 2004, at 22:27, Diego Novillo wrote: > This goes again to my request for peer review. All the API > documentation is available online. You don't need to even check-out > the > branch. Follow the links from http://gcc.gnu.org/projects/tree-ssa/ > You will find high-level design documents and API documentation. We > need bugzilla reports that point out specific bits that are missing. I > have created PR13756 to begin tracking documentation issues. Feel free > to add what you think is missing. First comment: There is no global overview of tree-ssa. The "main page" of the documentation is empty, and there is no single place that describes what tree-ssa is and what the overall structure is. The most useful piece of high-level info is in the proceedings of the 2003 GCC Summit, page 171-195, but I agree with Richard Kenner that most of this information should be contained in the various files that make up tree-ssa. Unfortunately, the referenced information is in PDF format, so I cannot easily cut and paste some of it to illustrate my point. -Geert