From fe25144e6819d8ac47658afce4789c6029d7ad5c Mon Sep 17 00:00:00 2001 From: Sean Silva Date: Sun, 23 Dec 2012 01:19:35 +0000 Subject: docs: Convert ReleaseNotes to reST. This is the last of the "regular" documents to convert to reST, and so I'm declaring the initial clang reST conversion "done". However, - There are some documents in clang/www/ which probably should be migrated into clang/docs/, such as www/OpenProjects.html The primary thing blocking me from doing this right now is not knowing how to set up a redirect so that the old URL's continue to work. - LibASTMatchersReference.html is not reST. This page is auto-generated by clang/docs/tools/dump_ast_matchers.py from the source and has some collapse/expand logic that isn't expressible directly with Sphinx, so just converting it to reST is not really a good strategy. Manuel Klimek and I discussed this and the general agreed-upon direction is making that page data-driven so that it, say, pulls in an auto-generated blob of JSON which describes the matchers and builds up the "matcher reference" part of the page with a small amount of JS. - There are some rogue .txt files hanging around. Also, I dropped the little dragon logo at the top because Sphinx was warning about an external image reference (not sure why, but meh, I didn't want to fight it). If anything, we would want such a logo integrated into the site's overall theme, rather than hardcoded here. llvm-svn: 170994 --- clang/docs/ReleaseNotes.rst | 119 ++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 119 insertions(+) create mode 100644 clang/docs/ReleaseNotes.rst (limited to 'clang/docs/ReleaseNotes.rst') diff --git a/clang/docs/ReleaseNotes.rst b/clang/docs/ReleaseNotes.rst new file mode 100644 index 00000000000..27e42bc82ff --- /dev/null +++ b/clang/docs/ReleaseNotes.rst @@ -0,0 +1,119 @@ +======================= +Clang 3.3 Release Notes +======================= + +.. contents:: + :local: + :depth: 2 + +Written by the `LLVM Team `_ + +.. warning:: + + These are in-progress notes for the upcoming Clang 3.3 release. You may + prefer the `Clang 3.2 Release Notes + `_. + +Introduction +============ + +This document contains the release notes for the Clang C/C++/Objective-C +frontend, part of the LLVM Compiler Infrastructure, release 3.3. Here we +describe the status of Clang in some detail, including major +improvements from the previous release and new feature work. For the +general LLVM release notes, see `the LLVM +documentation `_. All LLVM +releases may be downloaded from the `LLVM releases web +site `_. + +For more information about Clang or LLVM, including information about +the latest release, please check out the main please see the `Clang Web +Site `_ or the `LLVM Web +Site `_. + +Note that if you are reading this file from a Subversion checkout or the +main Clang web page, this document applies to the *next* release, not +the current one. To see the release notes for a specific release, please +see the `releases page `_. + +What's New in Clang 3.3? +======================== + +Some of the major new features and improvements to Clang are listed +here. Generic improvements to Clang as a whole or to its underlying +infrastructure are described first, followed by language-specific +sections with improvements to Clang's support for those languages. + +Major New Features +------------------ + +Improvements to Clang's diagnostics +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +Clang's diagnostics are constantly being improved to catch more issues, +explain them more clearly, and provide more accurate source information +about them. The improvements since the 3.2 release include: + +- ... + +New Compiler Flags +------------------ + +- ... + +C Language Changes in Clang +--------------------------- + +C11 Feature Support +^^^^^^^^^^^^^^^^^^^ + +... + +C++ Language Changes in Clang +----------------------------- + +C++11 Feature Support +^^^^^^^^^^^^^^^^^^^^^ + +... + +Objective-C Language Changes in Clang +------------------------------------- + +... + +Internal API Changes +-------------------- + +These are major API changes that have happened since the 3.2 release of +Clang. If upgrading an external codebase that uses Clang as a library, +this section should help get you past the largest hurdles of upgrading. + +API change 1 +^^^^^^^^^^^^ + +... + +Python Binding Changes +---------------------- + +The following methods have been added: + +- ... + +Significant Known Problems +========================== + +Additional Information +====================== + +A wide variety of additional information is available on the `Clang web +page `_. The web page contains versions of the +API documentation which are up-to-date with the Subversion version of +the source code. You can access versions of these documents specific to +this release by going into the "``clang/docs/``" directory in the Clang +tree. + +If you have any questions or comments about Clang, please feel free to +contact us via the `mailing +list `_. -- cgit v1.2.3