X-Git-Url: http://demsky.eecs.uci.edu/git/?a=blobdiff_plain;f=docs%2FCodingStandards.rst;h=0552c7117e2a89ef4c3104e7525f7268006de292;hb=3a8b98c9846f5632035fc2e31359cc662d948b24;hp=edbef3ace53c13d8e081c018e4ae305abca918e6;hpb=64cd55a12676cf108f89438dfa7b47b9c1cf0b75;p=oota-llvm.git diff --git a/docs/CodingStandards.rst b/docs/CodingStandards.rst index edbef3ace53..0552c7117e2 100644 --- a/docs/CodingStandards.rst +++ b/docs/CodingStandards.rst @@ -107,10 +107,7 @@ unlikely to be supported by our host compilers. * Trailing return types: N2541_ * Lambdas: N2927_ - * But *not* ``std::function``, until Clang implements `MSVC-compatible RTTI`_. - In many cases, you may be able to use ``llvm::function_ref`` instead, and it - is a superior choice in those cases. - * And *not* lambdas with default arguments. + * But *not* lambdas with default arguments. * ``decltype``: N2343_ * Nested closing right angle brackets: N1757_ @@ -165,6 +162,8 @@ being aware of: * ``std::initializer_list`` (and the constructors and functions that take it as an argument) are not always available, so you cannot (for example) initialize a ``std::vector`` with a braced initializer list. +* ``std::equal()`` (and other algorithms) incorrectly assert in MSVC when given + ``nullptr`` as an iterator. Other than these areas you should assume the standard library is available and working as expected until some build bot tells you otherwise. If you're in an @@ -177,6 +176,25 @@ traits header to emulate it. .. _the libstdc++ manual: http://gcc.gnu.org/onlinedocs/gcc-4.7.3/libstdc++/manual/manual/status.html#status.iso.2011 +Other Languages +--------------- + +Any code written in the Go programming language is not subject to the +formatting rules below. Instead, we adopt the formatting rules enforced by +the `gofmt`_ tool. + +Go code should strive to be idiomatic. Two good sets of guidelines for what +this means are `Effective Go`_ and `Go Code Review Comments`_. + +.. _gofmt: + https://golang.org/cmd/gofmt/ + +.. _Effective Go: + https://golang.org/doc/effective_go.html + +.. _Go Code Review Comments: + https://code.google.com/p/go-wiki/wiki/CodeReviewComments + Mechanical Source Issues ========================