Commit Graph

2171 Commits

Author SHA1 Message Date
Eli Friedman 7983cb1dbe Minor formatting tweak.
llvm-svn: 73251
2009-06-12 20:11:05 +00:00
Eli Friedman 0f7d4455fe Fix a minor formatting mistake.
llvm-svn: 73250
2009-06-12 20:08:48 +00:00
Eli Friedman 4e20479de8 Some updates to the gcc extension sections of the users manual.
llvm-svn: 73249
2009-06-12 20:04:25 +00:00
Eli Friedman 4d38aeb372 Minor documentation update about Microsoft extensions.
llvm-svn: 73052
2009-06-08 06:21:03 +00:00
Eli Friedman 3a80fc3808 Say a bit about various architectures in the users manual.
llvm-svn: 73044
2009-06-08 05:12:39 +00:00
Daniel Dunbar 15b86228cf Mention unsupported GCC duplicate-definition-with-inline extension.
Also, link users manual from the main web page.

llvm-svn: 72878
2009-06-04 18:37:52 +00:00
Douglas Gregor b48c6eb794 PTH -> PCH in the user manual
llvm-svn: 72815
2009-06-03 22:37:00 +00:00
Douglas Gregor 277d4d355b HTML tweak to get the PCH internals documentation to display correctly
llvm-svn: 72813
2009-06-03 21:57:43 +00:00
Douglas Gregor 22c7d31a3f Finished the PCH design and implementation documentation
llvm-svn: 72812
2009-06-03 21:55:35 +00:00
Douglas Gregor 6c5d61ca09 Document the integration points for precompiled headers
llvm-svn: 72809
2009-06-03 21:41:31 +00:00
Douglas Gregor a3bd665e17 Add a table of contents to the PCH design document
llvm-svn: 72791
2009-06-03 18:35:59 +00:00
Douglas Gregor 8662d1ffd0 Document the PCH representation of statements and expressions
llvm-svn: 72790
2009-06-03 18:26:16 +00:00
Douglas Gregor 02a109f6d7 Fill in some gaps in the precompiled headers documentation
llvm-svn: 72779
2009-06-03 16:06:22 +00:00
Douglas Gregor f727bb18d9 More PCH documentation
llvm-svn: 72743
2009-06-02 22:08:07 +00:00
Eli Friedman 164da6618e A couple minor corrections to the "GCC extensions not implemented yet"
section of the users manual.

llvm-svn: 72725
2009-06-02 08:21:31 +00:00
Eli Friedman b5f33c1634 A few tweaks to the "Differences between various standard modes"
section.

llvm-svn: 72501
2009-05-27 23:02:57 +00:00
Douglas Gregor 95fc37fd8f Start documenting precompiled headers
llvm-svn: 72146
2009-05-20 00:16:32 +00:00
Daniel Dunbar f7a24e176c Several fixes to the clang man page.
- -emit-llvm isn't a stage selection option.

 - Document -O4 and -flto.

 - -ObjC++ and -ObjC apply to all inputs, not subsequent ones.

 - Some versions of pod2man aren't happy about the comment after =over=?

 - Some minor grammar fixes.

llvm-svn: 72044
2009-05-18 21:34:46 +00:00
Eli Friedman c3dcdd0980 A few minor updates to the user manual.
llvm-svn: 71964
2009-05-16 23:17:30 +00:00
Daniel Dunbar ffe4e63b40 Note that clang follows the MSVC definition for #pragma pack.
llvm-svn: 71725
2009-05-13 21:40:49 +00:00
Daniel Dunbar 98d7164ab0 Tweak wording
llvm-svn: 71611
2009-05-13 00:23:53 +00:00
Daniel Dunbar e83b560e06 Note a few more unsupported language extensions.
llvm-svn: 71607
2009-05-12 23:12:07 +00:00
Chris Lattner 32efff659c wrap up a version of the man page that is minimally helpful, but somewhat complete.
llvm-svn: 71524
2009-05-12 00:47:40 +00:00
Chris Lattner 66c64f9ba4 add some more content.
llvm-svn: 71518
2009-05-12 00:01:32 +00:00
Chris Lattner e3c3f40404 pull a bunch of options out of clang-cc.cpp. This doesn't include
options that the driver swizzles.

llvm-svn: 71487
2009-05-11 22:45:37 +00:00
Daniel Dunbar 16af476c42 Document environment variables we handle, and don't mention -pipe (it
isn't yet supported... lazy developers).

llvm-svn: 71109
2009-05-06 19:18:09 +00:00
Chris Lattner 164ac10f82 More content.
llvm-svn: 71088
2009-05-06 17:22:08 +00:00
Chris Lattner 2080787636 add some content
llvm-svn: 71059
2009-05-06 02:47:51 +00:00
Daniel Dunbar 94fa27171b Override some pod2man defaults.
llvm-svn: 71045
2009-05-06 00:10:37 +00:00
Chris Lattner b732397343 257 -> FS
llvm-svn: 70996
2009-05-05 18:54:47 +00:00
Daniel Dunbar 6d0eecad6c Make install target actually work, dependencies FTW.
llvm-svn: 70599
2009-05-01 23:34:58 +00:00
Daniel Dunbar c52d01f8d9 Add ONLY_MAN_DOCS variable to only install the man page, not the html
and ps documentation.

llvm-svn: 70589
2009-05-01 23:11:42 +00:00
Daniel Dunbar c1b1658751 Add incredibly bare bones docs/tools.
- Mirroring LLVM's docs/CommandGuide, a place to put .pod files which
   are used to generate man/html/etc documentation for tools provided
   as part of clang.

llvm-svn: 70355
2009-04-29 01:00:32 +00:00
Eli Friedman 5406f5430b Add some text to the user manual describing the current state of C
support in clang.

llvm-svn: 70314
2009-04-28 18:48:34 +00:00
Ted Kremenek dab465d820 Grammar fix.
llvm-svn: 69682
2009-04-21 17:14:24 +00:00
Chris Lattner a80b2bdb25 document new form of -fdiagnostics-print-source-range-in
llvm-svn: 69663
2009-04-21 05:35:32 +00:00
Zhongxing Xu 2f8198f82a update the doc.
llvm-svn: 69587
2009-04-20 10:09:10 +00:00
Chris Lattner 396b9c380a more stuff.
llvm-svn: 69576
2009-04-20 06:26:18 +00:00
Chris Lattner 5ed5e9a612 add a bunch of diagnostics options, add one example warning group.
llvm-svn: 69573
2009-04-20 06:00:23 +00:00
Chris Lattner 6840825137 slurp some content from the PTH doc into the user's doc.
llvm-svn: 69569
2009-04-20 04:37:38 +00:00
Chris Lattner f9d8913b80 initial skeleton of a user's manual.
llvm-svn: 69568
2009-04-20 04:23:09 +00:00
Daniel Dunbar 2355ea2625 Some more tweaks to driver documentation.
llvm-svn: 69504
2009-04-19 02:33:12 +00:00
Chris Lattner ecbcb3ab0b minor typographical fixes
llvm-svn: 69502
2009-04-19 02:02:45 +00:00
Chris Lattner 7de6456593 mention the non-standard builtin macros we support.
llvm-svn: 68935
2009-04-13 02:45:46 +00:00
Zhongxing Xu a720c8b1c9 update analyzer doc.
llvm-svn: 68773
2009-04-10 06:52:49 +00:00
Chris Lattner bb72f77416 typos
llvm-svn: 68770
2009-04-10 05:54:56 +00:00
Ted Kremenek 86ee059a3a Wording changes.
llvm-svn: 68766
2009-04-10 05:04:22 +00:00
Ted Kremenek a9deb97190 Add blurb about attribute "analyzer_noreturn"
llvm-svn: 68765
2009-04-10 05:03:33 +00:00
Chris Lattner c86ffc3583 document the x86 address space extension for GS.
llvm-svn: 68724
2009-04-09 19:58:15 +00:00
Ted Kremenek 11e13fae69 Fix grammar. Bold face feature points.
llvm-svn: 68720
2009-04-09 18:22:40 +00:00
Ted Kremenek 4adfee4ff7 More cleanup.
llvm-svn: 68719
2009-04-09 18:20:08 +00:00
Ted Kremenek 8918025272 More cleanups.
llvm-svn: 68718
2009-04-09 18:17:39 +00:00
Ted Kremenek df0d9070b8 Add link from internals manual to PTH documentation.
llvm-svn: 68717
2009-04-09 18:08:18 +00:00
Ted Kremenek 6b27a811c6 Minor cleanups. Added a blurb about the advantages of fast PTH file generation.
llvm-svn: 68716
2009-04-09 18:03:21 +00:00
Chris Lattner 937b68b201 use escapes.
llvm-svn: 68600
2009-04-08 06:00:32 +00:00
Chris Lattner 1659301bed some minor edits
llvm-svn: 68599
2009-04-08 05:50:25 +00:00
Ted Kremenek d969f5fb6f Initial draft of PTH internals.
llvm-svn: 68594
2009-04-08 05:07:30 +00:00
Ted Kremenek 5d71204390 Convert region-design document to HTML.
llvm-svn: 68366
2009-04-03 01:38:55 +00:00
Zhongxing Xu 43533c7f40 update docs. Replace 'lattice' with 'tree'.
llvm-svn: 68271
2009-04-02 01:14:56 +00:00
Zhongxing Xu 034247130e Update docs.
llvm-svn: 68191
2009-04-01 06:01:08 +00:00
Zhongxing Xu dcb7a35294 Adjust doc format.
llvm-svn: 68190
2009-04-01 05:26:39 +00:00
Zhongxing Xu 1b1d3f6b0c update docs.
llvm-svn: 68188
2009-04-01 05:05:22 +00:00
Zhongxing Xu c473a44507 Update docs.
llvm-svn: 68183
2009-04-01 03:23:38 +00:00
Daniel Dunbar 1cd3f8c54f Some very rough Driver documentation.
llvm-svn: 68030
2009-03-30 06:50:01 +00:00
Ted Kremenek 2f41ffe825 Add a high-level intro to the memory regions design document.
llvm-svn: 67759
2009-03-26 16:19:54 +00:00
Ted Kremenek a32f7a124a Move "regions" analyzer design document to 'docs'.
llvm-svn: 67752
2009-03-26 15:29:38 +00:00
Chris Lattner 14aea9a39c link to blocks dox
llvm-svn: 66414
2009-03-09 07:03:22 +00:00
Chris Lattner d6daa1dafd add some description of the block language extension.
llvm-svn: 66413
2009-03-09 07:01:20 +00:00
Chris Lattner da84e0d516 The long-rumored blocks implementation document.
llvm-svn: 66410
2009-03-09 06:57:46 +00:00
Chris Lattner 9605a55076 minor wording changes.
llvm-svn: 65648
2009-02-27 19:31:12 +00:00
Douglas Gregor 96977da72c Clean up and document code modification hints.
llvm-svn: 65641
2009-02-27 17:53:17 +00:00
Douglas Gregor 7f74112756 Implement parsing of nested-name-specifiers that involve template-ids, e.g.,
std::vector<int>::allocator_type

When we parse a template-id that names a type, it will become either a
template-id annotation (which is a parsed representation of a
template-id that has not yet been through semantic analysis) or a
typename annotation (where semantic analysis has resolved the
template-id to an actual type), depending on the context. We only
produce a type in contexts where we know that we only need type
information, e.g., in a type specifier. Otherwise, we create a
template-id annotation that can later be "upgraded" by transforming it
into a typename annotation when the parser needs a type. This occurs,
for example, when we've parsed "std::vector<int>" above and then see
the '::' after it. However, it means that when writing something like
this:

  template<> class Outer::Inner<int> { ... };

We have two tokens to represent Outer::Inner<int>: one token for the
nested name specifier Outer::, and one template-id annotation token
for Inner<int>, which will be passed to semantic analysis to define
the class template specialization.

Most of the churn in the template tests in this patch come from an
improvement in our error recovery from ill-formed template-ids.

llvm-svn: 65467
2009-02-25 19:37:18 +00:00
Chris Lattner faca7d9842 fix typo
llvm-svn: 64966
2009-02-18 22:27:46 +00:00
Douglas Gregor 94349fd8cb Allow "overloadable" functions in C to be declared as variadic without
any named parameters, e.g., this is accepted in C:

  void f(...) __attribute__((overloadable));

although this would be rejected:

  void f(...);

To do this, moved the checking of the "ellipsis without any named
arguments" condition from the parser into Sema (where it belongs anyway).

llvm-svn: 64902
2009-02-18 07:07:28 +00:00
Daniel Dunbar 393900ef52 Grammar tweak.
llvm-svn: 64765
2009-02-17 15:49:03 +00:00
Chris Lattner 1156f18175 clarify the behavior of note.
llvm-svn: 64748
2009-02-17 07:07:29 +00:00
Chris Lattner b3ef533286 wrap some crazy long lines.
llvm-svn: 64489
2009-02-13 21:51:45 +00:00
Chris Lattner 9631dfd1c1 document __builtin_shufflevector
llvm-svn: 64485
2009-02-13 20:00:20 +00:00
Douglas Gregor 725de57b7d Add documentation for overloaded functions in C
llvm-svn: 64423
2009-02-13 00:57:04 +00:00
Chris Lattner b8ec6bbb6a new document.
llvm-svn: 64127
2009-02-09 08:46:11 +00:00
Chris Lattner 9d6c4408d1 document fatal
llvm-svn: 63895
2009-02-05 22:49:08 +00:00
Douglas Gregor 2ada048975 Some name-lookup-related fixes, from Piotr Rak!
- Changes Lookup*Name functions to return NamedDecls, instead of
Decls. Unfortunately my recent statement that it will simplify lot of
code, was not quite right, but it simplifies some...
- Makes MergeLookupResult SmallPtrSet instead of vector, following
Douglas suggestions.
- Adds %qN format for printing qualified names to Diagnostic.
- Avoids searching for using-directives in Scopes, which are not
DeclScope, during unqualified name lookup.

llvm-svn: 63739
2009-02-04 17:27:36 +00:00
Steve Naroff 16c8e598ae Name change (isTypeName->getTypeName).
Since it doesn't return a bool, is shouldn't be prefixed with 'is'.

llvm-svn: 63226
2009-01-28 19:39:02 +00:00
Douglas Gregor 6e6ad602e5 Remove ScopedDecl, collapsing all of its functionality into Decl, so
that every declaration lives inside a DeclContext.

Moved several things that don't have names but were ScopedDecls (and,
therefore, NamedDecls) to inherit from Decl rather than NamedDecl,
including ObjCImplementationDecl and LinkageSpecDecl. Now, we don't
store empty DeclarationNames for these things, nor do we try to insert
them into DeclContext's lookup structure.

The serialization tests are temporarily disabled. We'll re-enable them
once we've sorted out the remaining ownership/serialiazation issues
between DeclContexts and TranslationUnion, DeclGroups, etc.

llvm-svn: 62562
2009-01-20 01:17:11 +00:00
Chris Lattner 3c91971b33 rename "virtual location" of a macro to "instantiation location".
llvm-svn: 62315
2009-01-16 07:15:35 +00:00
Chris Lattner ca0c7e5a34 update for terminology change.
llvm-svn: 62310
2009-01-16 07:00:50 +00:00
Cedric Venet 9fee535c84 Fix a typo.
llvm-svn: 61815
2009-01-06 16:22:54 +00:00
Chris Lattner 479ecd7151 document annotation tokens.
llvm-svn: 61792
2009-01-06 06:02:08 +00:00
Douglas Gregor 07665a69e8 Introduce support for "transparent" DeclContexts, which are
DeclContexts whose members are visible from enclosing DeclContexts up
to (and including) the innermost enclosing non-transparent
DeclContexts. Transparent DeclContexts unify the mechanism to be used
for various language features, including C enumerations, anonymous
unions, C++0x inline namespaces, and C++ linkage
specifications. Please refer to the documentation in the Clang
internals manual for more information.

Only enumerations and linkage specifications currently use transparent
DeclContexts.

Still to do: use transparent DeclContexts to implement anonymous
unions and GCC's anonymous structs extension, and, later, the C++0x
features. We also need to tighten up the DeclContext/ScopedDecl link
to ensure that every ScopedDecl is in a single DeclContext, which
will ensure that we can then enforce ownership and reduce the memory
footprint of DeclContext.

llvm-svn: 61735
2009-01-05 19:45:36 +00:00
Chris Lattner 04397358ec Implement the final (hopefully) wrinkle to i-c-e + builtin_constant_p
processing: it allows arbitrary foldable constants as the operand of ?: when
builtin_constant_p is the condition.

llvm-svn: 60954
2008-12-12 18:00:51 +00:00
Chris Lattner 85b25bc344 implement rdar://6091492 - ?: with __builtin_constant_p as the operand is an i-c-e.
llvm-svn: 60934
2008-12-12 06:55:44 +00:00
Chris Lattner e4b95698df Rename Selector::getName() to Selector::getAsString(), and add
a new NamedDecl::getAsString() method.

Change uses of Selector::getName() to just pass in a Selector 
where possible (e.g. to diagnostics) instead of going through
an std::string.

This also adds new formatters for objcinstance and objcclass
as described in the dox.

llvm-svn: 59933
2008-11-24 03:33:13 +00:00
Chris Lattner d125393d24 inserting a qualtype adds quotes implicitly
llvm-svn: 59915
2008-11-23 20:27:13 +00:00
Chris Lattner 4e2e9f1a5d other minor edits.
llvm-svn: 59906
2008-11-23 08:32:53 +00:00
Chris Lattner c788a8bdec minor cleanups.
llvm-svn: 59905
2008-11-23 08:16:56 +00:00
Chris Lattner 1fea89ccb1 finish up the diagnostics documentation. We don't
support QualType and DeclarationName yet, so some of it
is lies, however, this will be fixed shortly.

llvm-svn: 59896
2008-11-23 00:42:53 +00:00
Chris Lattner 80bec16f14 more updates
llvm-svn: 59895
2008-11-23 00:28:33 +00:00
Chris Lattner cc6147cd3b finish documentation of %select.
llvm-svn: 59892
2008-11-22 23:50:47 +00:00
Sebastian Redl 6cae80da20 Documentation for the plural modifier.
llvm-svn: 59885
2008-11-22 22:16:45 +00:00
Chris Lattner e72a8a3048 start documenting Diagnostics. Sebastian, I'd appreciate it
if you can fill in the section for %plural.

llvm-svn: 59883
2008-11-22 21:41:31 +00:00
Douglas Gregor 163c58502a Extend DeclarationName to support C++ overloaded operators, e.g.,
operator+, directly, using the same mechanism as all other special
names.

Removed the "special" identifiers for the overloaded operators from
the identifier table and IdentifierInfo data structure. IdentifierInfo
is back to representing only real identifiers.

Added a new Action, ActOnOperatorFunctionIdExpr, that builds an
expression from an parsed operator-function-id (e.g., "operator
+"). ActOnIdentifierExpr used to do this job, but
operator-function-ids are no longer represented by IdentifierInfo's.

Extended Declarator to store overloaded operator names. 
Sema::GetNameForDeclarator now knows how to turn the operator
name into a DeclarationName for the overloaded operator. 

Except for (perhaps) consolidating the functionality of
ActOnIdentifier, ActOnOperatorFunctionIdExpr, and
ActOnConversionFunctionExpr into a common routine that builds an
appropriate DeclRefExpr by looking up a DeclarationName, all of the
work on normalizing declaration names should be complete with this
commit.

llvm-svn: 59526
2008-11-18 14:39:36 +00:00
Douglas Gregor ae2fbad373 Updated IdentifierResolver to deal with DeclarationNames. The names of
C++ constructors, destructors, and conversion functions now have a
FETokenInfo field that IdentifierResolver can access, so that these
special names are handled just like ordinary identifiers. A few other
Sema routines now use DeclarationNames instead of IdentifierInfo*'s.

To validate this design, this code also implements parsing and
semantic analysis for id-expressions that name conversion functions,
e.g.,

  return operator bool();

The new parser action ActOnConversionFunctionExpr takes the result of
parsing "operator type-id" and turning it into an expression, using
the IdentifierResolver with the DeclarationName of the conversion
function. ActOnDeclarator pushes those conversion function names into
scope so that the IdentifierResolver can find them, of course.

llvm-svn: 59462
2008-11-17 20:34:05 +00:00
Douglas Gregor 77324f3854 Introduction the DeclarationName class, as a single, general method of
representing the names of declarations in the C family of
languages. DeclarationName is used in NamedDecl to store the name of
the declaration (naturally), and ObjCMethodDecl is now a NamedDecl.

llvm-svn: 59441
2008-11-17 14:58:09 +00:00
Chris Lattner 807e8c5d63 Describe how constant folding and i-c-e diagnosing should work.
Unfortunately, we're not here yet, but eventually Expr::isConstantExpr
and friends should go away.

llvm-svn: 59427
2008-11-16 21:48:07 +00:00
Mike Stump b9d50b23a8 Unbreak clang install.
llvm-svn: 54663
2008-08-12 00:32:59 +00:00
Chris Lattner 613fdff902 clean up the footer a bit more.
llvm-svn: 54113
2008-07-26 23:54:49 +00:00
Chris Lattner e3bbfffa5b remove SSIs.
llvm-svn: 54112
2008-07-26 23:52:26 +00:00
Chris Lattner 9213f5d947 Add the right path to the lines image.
llvm-svn: 54111
2008-07-26 23:51:08 +00:00
Daniel Dunbar 086fe1ac79 Add doxygen support
- Stolen from LLVM with minor modifications

llvm-svn: 54103
2008-07-26 21:32:24 +00:00
Ted Kremenek d2c8970a9a Use same CSS as the rest of the clang website.
llvm-svn: 52208
2008-06-11 06:19:49 +00:00
Chris Lattner d5917cef95 update documentation
llvm-svn: 48074
2008-03-09 02:27:26 +00:00
Ted Kremenek efc244722f Minor grammar fix.
llvm-svn: 43154
2007-10-18 22:50:52 +00:00
Ted Kremenek a1cf09f51d Commented out header with no section body. Will write this eventually.
llvm-svn: 42844
2007-10-10 23:22:00 +00:00
Ted Kremenek 035b0cd34a Added some documentation on clang CFGs. It is very rough.
llvm-svn: 42843
2007-10-10 23:01:43 +00:00
Bill Wendling bc03521fc9 Fix spacing issues.
llvm-svn: 42676
2007-10-06 01:56:01 +00:00
Chris Lattner ac81722ff6 Fix html problem, patch by Justin Handville
llvm-svn: 42011
2007-09-16 19:25:23 +00:00
Chris Lattner 5070523a07 Owen pointed out that this made no sense :)
llvm-svn: 40644
2007-07-31 18:54:50 +00:00
Chris Lattner 578611857d update name
llvm-svn: 40637
2007-07-31 16:50:51 +00:00
Chris Lattner 49820d63dc Oops, I committed the wrong file before. This expands the description of
type.

llvm-svn: 40620
2007-07-31 06:37:39 +00:00
Chris Lattner c6684bc0c5 Add a start at a clang internals manual, documenting some
of the more subtle and interesting classes.

llvm-svn: 40615
2007-07-31 05:42:17 +00:00
Chris Lattner 0443a76b11 add documentation skeleton
llvm-svn: 40471
2007-07-24 18:03:18 +00:00