Organized in 4 parts. The last two are the same as before: LLVM Docs and

Mailing Lists.  The first two are ""Getting Started" and "Getting Help."

git-svn-id: https://llvm.org/svn/llvm-project/llvm/trunk@9457 91177308-0d34-0410-b5e6-96231b3b80d8

diff --git a/README.txt b/README.txt
index 60fd024e626f29e4e9500619b730aafa178cdacb..67182ecf9a941cfa08991fc7e3bbe137fa778884 100644 (file)
--- a/README.txt
+++ b/README.txt
@@ -1,32 +1,62 @@
+                       The LLVM Compiler Infrastructure
+                          http://llvm.cs.uiuc.edu
+
 Welcome to LLVM!
+-----------------
+This file is intended to do four things:
+(1) help you get started using LLVM;
+(2) tell you how to get questions about LLVM answered;
+(3) tell you where to find documentation for different kinds of questions; and
+(4) tell you about three LLVM-related mailing lists.
+
+
+Getting Started with LLVM
+-------------------------
 
-This file provides the location of all important LLVM documentation.  In
-particular, you should read the license information and the installation
-directions before you begin using LLVM.
+(1) For license information:
+       llvm/LICENSE.txt
 
-After that, there are several technical references that will help you use LLVM.
-Consult them as necessary.
+(2) Installing and compiling LLVM:
+       llvm/docs/GettingStarted.html
 
-Finally, you can find information on how to communicate with the LLVM
-developers and LLVM community.  This is of primary interest if you wish to
-submit a bug, supply a patch, or just keep current with what's going on with
-LLVM.
+(3) Learn about features and limitations of this release:
+       llvm/docs/ReleaseNotes.html
 
-Introductory Literature:
+(4) Learn how to write a pass within the LLVM system:
+       llvm/docs/WritingAnLLVMPass.html
 
-       LLVM Home Page:
-               http://llvm.cs.uiuc.edu
+(5) Learn how to start a new development project using LLVM, where your
+    new source code can live anywhere (outside or inside the LLVM tree),
+    while using LLVM header files and libraries:
+       llvm/docs/Projects.html
 
-       License Information:
-               llvm/LICENSE.txt
 
-       Release Notes:
-               llvm/docs/ReleaseNotes.html
+Getting Help with LLVM
+----------------------
+
+(1) If you have questions or development problems not answered in the
+    documentation, send e-mail to llvmdev@cs.uiuc.edu.  This mailing list is
+    monitored by all the people in the LLVM group at Illinois, and you should
+    expect prompt first responses.
+
+(2) To report a bug, submit a bug report as described in the document:
+               http://llvm.cs.uiuc.edu/docs/HowToSubmitABug.html
 
-LLVM Design:
+(3) We now use Bugzilla to track bugs, so you can check the status of
+    previous bugs at:
+            <FIXME: WHERE DO THEY GO???>
 
-        The LLVM Instruction Set and Compilation Strategy:
-               http://llvm.cs.uiuc.edu/pubs/2002-08-09-LLVMCompilationStrategy.html
+
+LLVM Documentation
+------------------
+
+All the documents mentioned below except the design overview tech report
+are include as part of the LLVM release (in llvm/docs/*):
+
+LLVM Design Overview:
+       LLVM : A Compilation Framework for Lifelong Program Analysis
+       and Transformation:
+         http://llvm.cs.uiuc.edu/pubs/2003-09-30-LifelongOptimizationTR.html
 
 LLVM User Guides:
 
@@ -59,7 +89,7 @@ LLVM Programming Documentation:
        Coding Standards:
                llvm/docs/CodingStandards.html
 
-LLVM Community:
+Other LLVM Resources:
 
        Submitting a Bug:
                http://llvm.cs.uiuc.edu/docs/HowToSubmitABug.html
@@ -70,37 +100,30 @@ LLVM Community:
        Creating a new LLVM Project:
                llvm/docs/Projects.html
 
-       Mailing Lists:
-               There are several mailing lists providing LLVM users with
-               information:
-
-                       o LLVM Announcements List:
-                       http://mail.cs.uiuc.edu/mailman/listinfo/llvm-announce
-
-                               This is a low volume list that provides
-                               important announcements regarding LLVM.  It is
-                               primarily intended to announce new releases,
-                               major updates to the software, etc.  This list
-                               is highly recommended for anyone that uses LLVM.
+Mailing Lists
+--------------
+There are three mailing lists for providing LLVM users with information:
 
+(1) LLVM Announcements List:
+    http://mail.cs.uiuc.edu/mailman/listinfo/llvm-announce
 
-                       o LLVM Developers List:
-                       http://mail.cs.uiuc.edu/mailman/listinfo/llvmdev
+    This is a low volume list that provides important announcements regarding
+    LLVM.  It is primarily intended to announce new releases, major updates to
+    the software, etc.  This list is highly recommended for anyone that uses
+    LLVM.
 
-                               This list is for people who want to be included
-                               in technical discussions of LLVM.  People post
-                               to this list when they have questions about
-                               writing code for or using the LLVM tools.  It
-                               is low volume.
+(2) LLVM Developers List:
+    http://mail.cs.uiuc.edu/mailman/listinfo/llvmdev
 
-                       o LLVM Commits List
-                       http://mail.cs.uiuc.edu/mailman/listinfo/llvm-commits
+    This list is for people who want to be included in technical discussions
+    of LLVM.  People post to this list when they have questions about writing
+    code for or using the LLVM tools.  It is relatively low volume.
 
-                               This list contains all commit messages that are
-                               made when LLVM developers commit code changes
-                               to the CVS archive.  It is useful for those who
-                               want to stay on the bleeding edge of LLVM
-                               development.
+(3) LLVM Commits List
+    http://mail.cs.uiuc.edu/mailman/listinfo/llvm-commits
 
-                               This list is very high volume.
+   This list contains all commit messages that are made when LLVM developers
+   commit code changes to the CVS archive.  It is useful for those who want to
+   stay on the bleeding edge of LLVM development. This list is very high
+   volume.