From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 976 invoked by alias); 20 Jan 2004 16:14:31 -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 716 invoked from network); 20 Jan 2004 16:14:12 -0000 Received: from unknown (HELO mx1.redhat.com) (66.187.233.31) by sources.redhat.com with SMTP; 20 Jan 2004 16:14:12 -0000 Received: from int-mx1.corp.redhat.com (int-mx1.corp.redhat.com [172.16.52.254]) by mx1.redhat.com (8.11.6/8.11.6) with ESMTP id i0KGD7l19856; Tue, 20 Jan 2004 11:13:07 -0500 Received: from pobox.toronto.redhat.com (pobox.toronto.redhat.com [172.16.14.4]) by int-mx1.corp.redhat.com (8.11.6/8.11.6) with ESMTP id i0KGD5a24119; Tue, 20 Jan 2004 11:13:05 -0500 Received: from dnovillo.cipe.redhat.com (dnovillo.cipe.redhat.com [10.0.0.106]) by pobox.toronto.redhat.com (8.12.8/8.12.8) with ESMTP id i0KGD1Xd002853; Tue, 20 Jan 2004 11:13:02 -0500 Subject: Re: [RFC] Contributing tree-ssa to mainline From: Diego Novillo To: Richard Kenner Cc: Steven Bosscher , "gcc@gcc.gnu.org" In-Reply-To: <10401201238.AA06794@vlsi1.ultra.nyu.edu> References: <10401201238.AA06794@vlsi1.ultra.nyu.edu> Content-Type: text/plain Organization: Red Hat Canada Message-Id: <1074615177.14606.3.camel@frodo.toronto.redhat.com> Mime-Version: 1.0 Date: Tue, 20 Jan 2004 16:14:00 -0000 Content-Transfer-Encoding: 7bit X-SW-Source: 2004-01/txt/msg01512.txt.bz2 On Tue, 2004-01-20 at 07:38, Richard Kenner wrote: > It's not a replacement for real documentation (that we're also working > on) but it makes the code much easier to understand. And you don't > have to grep so much, if you see a functions you don't know yet, just > follow a link and see what it does. > > I would *much* prefer to see all documentation in the sources. The code needs > to be self-contained and not to web pages someplace. If you print out > a set of files to read on an airplane, for example, you want to have all > the necessary documentation in those files. > The documentation is *extracted* from the sources using doxygen. Please, do follow the documentation links from http://gcc.gnu.org/projects/tree-ssa/ Diego.