freebsd-dev/contrib/gcc/doc
Pedro F. Giffuni 5bfc7db451 gcc: Add support for Apple's Block extension
Block objects [1] are a C-level syntactic and runtime feature. They
are similar to standard C functions, but in addition to executable
code they may also contain variable bindings to automatic (stack)
or managed (heap) memory. A block can therefore maintain a set of
state (data) that it can use to impact behavior when executed.

This port is based on Apple's GCC 5646 with some bugfixes from
Apple GCC 5666.3. It has some small differences with the support
in clang, which remains the recommended compiler.

Perhaps the most notable difference is that in GCC that __block
is not actually a keyword, but a macro. There will be workaround
for this issue in a near future. Other issues can be consulted in
the clang documentation [2]

For better compatiblity with Apple's GCC and llvm-gcc some related
fixes and features from Apple have been included. Support for the
non-standard nested functions in GCC is now off by default.

No effort was made to update the ObjC support since FreeBSD doesn't
carry ObjC in the base system, but some of the code crept in and
was more difficult to remove than to adjust.

Reference:
[1]
https://developer.apple.com/library/mac/documentation/Cocoa/Conceptual/Blocks/Articles/00_Introduction.html
[2]
http://clang.llvm.org/compatibility.html#block-variable-initialization

Obtained from:	Apple GCC 4.2
MFC after:	3 weeks
2014-01-05 00:43:28 +00:00
..
include
bugreport.texi
c-tree.texi Revert r259619: 2013-12-20 18:16:02 +00:00
cfg.texi
collect2.texi
compat.texi
configfiles.texi
configterms.texi
contrib.texi
contribute.texi
cpp.1 Remove libobjc and other Objective-C related components, as these are 2011-04-17 21:03:23 +00:00
cpp.texi Remove libobjc and other Objective-C related components, as these are 2011-04-17 21:03:23 +00:00
cppenv.texi Remove libobjc and other Objective-C related components, as these are 2011-04-17 21:03:23 +00:00
cppinternals.texi Remove libobjc and other Objective-C related components, as these are 2011-04-17 21:03:23 +00:00
cppopts.texi gcc: small merges from upstream 2013-12-17 23:31:51 +00:00
extend.texi gcc: Add support for Apple's Block extension 2014-01-05 00:43:28 +00:00
fragments.texi
frontends.texi Remove libobjc and other Objective-C related components, as these are 2011-04-17 21:03:23 +00:00
gcc.1 Remove libobjc and other Objective-C related components, as these are 2011-04-17 21:03:23 +00:00
gcc.texi Remove libobjc and other Objective-C related components, as these are 2011-04-17 21:03:23 +00:00
gccint.texi
gcov.1
gcov.texi
gnu.texi
gty.texi
headerdirs.texi
hostconfig.texi
implement-c.texi
interface.texi
invoke.texi gcc: Add support for Apple's Block extension 2014-01-05 00:43:28 +00:00
languages.texi
libgcc.texi gcc: another round of merges from the gcc pre-43 branch. 2013-11-21 16:38:57 +00:00
loop.texi
makefile.texi
md.texi
options.texi
passes.texi
portability.texi
rtl.texi gcc: another round of merges from the gcc pre-43 branch. 2013-11-21 16:38:57 +00:00
service.texi
sourcebuild.texi Remove libobjc and other Objective-C related components, as these are 2011-04-17 21:03:23 +00:00
standards.texi Remove libobjc and other Objective-C related components, as these are 2011-04-17 21:03:23 +00:00
tm.texi gcc: more diff reductions against Apple GCC. 2013-12-20 14:56:52 +00:00
tree-ssa.texi
trouble.texi