X-Git-Url: http://plrg.eecs.uci.edu/git/?p=oota-llvm.git;a=blobdiff_plain;f=README.txt;h=2dd797399ac2245413b7e030bacb78c6a28876cc;hp=60fd024e626f29e4e9500619b730aafa178cdacb;hb=9059158b5613f9d87d2571ea67cef83d5f879106;hpb=ddf31f7a8b8c6c3ad7fa1f5caba3b7584b7a7fe7 diff --git a/README.txt b/README.txt index 60fd024e626..2dd797399ac 100644 --- a/README.txt +++ b/README.txt @@ -1,106 +1,128 @@ + 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. -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. -After that, there are several technical references that will help you use LLVM. -Consult them as necessary. +Getting Started with LLVM +------------------------- -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. +(1) For license information: + llvm/LICENSE.txt -Introductory Literature: +(2) Installing and compiling LLVM: + llvm/docs/GettingStarted.html - LLVM Home Page: - http://llvm.cs.uiuc.edu +(3) Learn about features and limitations of this release: + llvm/docs/ReleaseNotes.html - License Information: - llvm/LICENSE.txt +(4) Learn how to write a pass within the LLVM system: + llvm/docs/WritingAnLLVMPass.html - Release Notes: - llvm/docs/ReleaseNotes.html +(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 -LLVM Design: - The LLVM Instruction Set and Compilation Strategy: - http://llvm.cs.uiuc.edu/pubs/2002-08-09-LLVMCompilationStrategy.html +Getting Help with LLVM +---------------------- -LLVM User Guides: +(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. - Download and Installation Instructions: - llvm/docs/GettingStarted.html +(2) To report a bug, submit a bug report as described in the document: + http://llvm.cs.uiuc.edu/docs/HowToSubmitABug.html - LLVM Command Guide: - llvm/docs/CommandGuide/CommandGuide.html +(3) We now use Bugzilla to track bugs, so you can check the status of + previous bugs at: + http://llvm.cs.uiuc.edu/bugs/query.cgi - LLVM Assembly Language: - llvm/docs/LangRef.html +LLVM Documentation +------------------ - LLVM Test Suite Guide: - llvm/docs/TestingGuide.html +All the documents mentioned below except the design overview tech report +are included as part of the LLVM release (in llvm/docs/*): -LLVM Programming Documentation: +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: - LLVM Programmers Manual: - llvm/docs/ProgrammersManual.html + Download and Installation Instructions: + llvm/docs/GettingStarted.html - Writing an LLVM Pass: - llvm/docs/WritingAnLLVMPass.html + LLVM Command Guide: + llvm/docs/CommandGuide/index.html + + LLVM Assembly Language: + llvm/docs/LangRef.html + + LLVM Test Suite Guide: + llvm/docs/TestingGuide.html + +LLVM Programming Documentation: - Alias Analysis in LLVM: - llvm/docs/AliasAnalysis.html + LLVM Programmers Manual: + llvm/docs/ProgrammersManual.html - Command Line Library: - llvm/docs/CommandLine.html + Writing an LLVM Pass: + llvm/docs/WritingAnLLVMPass.html - Coding Standards: - llvm/docs/CodingStandards.html + Alias Analysis in LLVM: + llvm/docs/AliasAnalysis.html -LLVM Community: + Command Line Library: + llvm/docs/CommandLine.html - Submitting a Bug: - http://llvm.cs.uiuc.edu/docs/HowToSubmitABug.html + Coding Standards: + llvm/docs/CodingStandards.html - Open Projects: - llvm/docs/OpenProjects.html +Other LLVM Resources: - Creating a new LLVM Project: - llvm/docs/Projects.html + Submitting a Bug: + http://llvm.cs.uiuc.edu/docs/HowToSubmitABug.html - Mailing Lists: - There are several mailing lists providing LLVM users with - information: + Open Projects: + llvm/docs/OpenProjects.html - o LLVM Announcements List: - http://mail.cs.uiuc.edu/mailman/listinfo/llvm-announce + Creating a new LLVM Project: + llvm/docs/Projects.html - 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.