| Jeffrey Yasskin | 0c0f4b6 | 2010-02-26 00:54:42 +0000 | [diff] [blame] | 1 | <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" |
| 2 | "http://www.w3.org/TR/html4/strict.dtd"> |
| 3 | <html> |
| 4 | <head> |
| 5 | <title>Advice on Packaging LLVM</title> |
| 6 | <link rel="stylesheet" href="llvm.css" type="text/css"> |
| 7 | </head> |
| 8 | <body> |
| 9 | |
| 10 | <div class="doc_title">Advice on Packaging LLVM</div> |
| 11 | <ol> |
| 12 | <li><a href="#overview">Overview</a></li> |
| 13 | <li><a href="#cxx-features">C++ Features</a></li> |
| 14 | <li><a href="#shared-library">Shared Library</a></li> |
| 15 | </ol> |
| 16 | |
| 17 | <!--=========================================================================--> |
| 18 | <div class="doc_section"><a name="overview">Overview</a></div> |
| 19 | <!--=========================================================================--> |
| 20 | <div class="doc_text"> |
| 21 | |
| 22 | <p>LLVM sets certain default configure options to make sure our developers don't |
| 23 | break things for constrained platforms. These settings are not optimal for most |
| 24 | desktop systems, and we hope that packagers (i.e., Redhat, Debian, MacPorts, |
| 25 | etc.) will tweak them. This document lists settings we suggest you tweak. |
| 26 | </p> |
| 27 | </div> |
| 28 | |
| 29 | <!--=========================================================================--> |
| 30 | <div class="doc_section"><a name="cxx-features">C++ Features</a></div> |
| 31 | <!--=========================================================================--> |
| 32 | <div class="doc_text"> |
| 33 | |
| 34 | <dl> |
| 35 | <dt>RTTI</dt><dd>LLVM disables RTTI by default. Add <tt>REQUIRES_RTTI=1</tt> |
| 36 | to your environment while running <tt>make</tt> to re-enable it. This will |
| 37 | allow users to build with RTTI enabled and inherit from LLVM classes.</dd> |
| 38 | <dt>Exceptions</dt><dd>LLVM disables exceptions by default. Add |
| 39 | <tt>REQUIRES_EH=1</tt> to your environment while running <tt>make</tt> to |
| 40 | re-enable them. This will allow users to link LLVM and exception-using code. |
| 41 | It also re-enables RTTI.</dd> |
| 42 | </dl> |
| 43 | </div> |
| 44 | |
| 45 | <!--=========================================================================--> |
| 46 | <div class="doc_section"><a name="shared-library">Shared Library</a></div> |
| 47 | <!--=========================================================================--> |
| 48 | <div class="doc_text"> |
| 49 | |
| 50 | <p>Configure with <tt>--enable-shared</tt> to build |
| 51 | <tt>libLLVM-<var>major</var>.<var>minor</var>.(so|dylib)</tt> and link the tools |
| 52 | against it. This saves lots of binary size at the cost of some startup time. |
| 53 | </p> |
| 54 | </div> |
| 55 | |
| 56 | <!-- *********************************************************************** --> |
| 57 | <hr> |
| 58 | <address> |
| 59 | <a href="http://jigsaw.w3.org/css-validator/check/referer"><img |
| 60 | src="http://jigsaw.w3.org/css-validator/images/vcss-blue" alt="Valid CSS"></a> |
| 61 | <a href="http://validator.w3.org/check/referer"><img |
| 62 | src="http://www.w3.org/Icons/valid-html401-blue" alt="Valid HTML 4.01"></a> |
| 63 | <a href="http://llvm.org">The LLVM Compiler Infrastructure</a><br> |
| 64 | Last modified: $Date: 2009-01-01 23:10:51 -0800 (Thu, 01 Jan 2009) $ |
| 65 | </address> |
| 66 | </body> |
| 67 | </html> |