[llvm-commits] [polly] r161928 - in /polly/trunk/www: documentation.html example_load_Polly_into_clang.html example_load_Polly_into_dragonegg.html

Tue Aug 14 22:02:26 PDT 2012

Author: grosser
Date: Wed Aug 15 00:02:25 2012
New Revision: 161928

URL: http://llvm.org/viewvc/llvm-project?rev=161928&view=rev
Log:
www documentation for using Polly with dragonegg.

Added a file that explains how to load Polly in dragonegg.
Also fixed a typo in the document for clang.

Committed with a typo fix and a change to make this website available from
the documentation section.

Contributed by: Sameer Sahasrabuddhe  <Sameer.Sahasrabuddhe at amd.com>

Added:
    polly/trunk/www/example_load_Polly_into_dragonegg.html   (with props)
Modified:
    polly/trunk/www/documentation.html
    polly/trunk/www/example_load_Polly_into_clang.html   (contents, props changed)

Modified: polly/trunk/www/documentation.html
URL: http://llvm.org/viewvc/llvm-project/polly/trunk/www/documentation.html?rev=161928&r1=161927&r2=161928&view=diff
==============================================================================

--- polly/trunk/www/documentation.html (original)
+++ polly/trunk/www/documentation.html Wed Aug 15 00:02:25 2012
@@ -26,6 +26,9 @@
 compilation. Using Polly is not more complicated than just adding a new flag
 to CFLAGS.
 </li>
+<li><h2><a href="example_load_Polly_into_dragonegg.html">Use Polly in dragonegg</a></h2>
+How to load and use Polly within dragonegg.
+</li>
 
 <li>
 <h2><a href="example_manual_matmul.html">Execute the individual Polly passes

Modified: polly/trunk/www/example_load_Polly_into_clang.html
URL: http://llvm.org/viewvc/llvm-project/polly/trunk/www/example_load_Polly_into_clang.html?rev=161928&r1=161927&r2=161928&view=diff
==============================================================================
--- polly/trunk/www/example_load_Polly_into_clang.html (original)
+++ polly/trunk/www/example_load_Polly_into_clang.html Wed Aug 15 00:02:25 2012
@@ -99,7 +99,7 @@
 <h3>Change/Disable the Optimizer</h3>
 Polly uses by default the isl scheduling optimizer. The isl optimizer optimizes
 for data-locality and parallelism using the <a
-href=http://pluto-compiler.sf.net">Pluto</a> algorithm. For research it is also
+href="http://pluto-compiler.sf.net">Pluto</a> algorithm. For research it is also
 possible to run <a
 href="http://www-rocq.inria.fr/~pouchet/software/pocc/">PoCC</a> as external
 optimizer. PoCC provides access to the original Pluto implementation. To use

Propchange: polly/trunk/www/example_load_Polly_into_clang.html
------------------------------------------------------------------------------
    svn:executable = *

Added: polly/trunk/www/example_load_Polly_into_dragonegg.html
URL: http://llvm.org/viewvc/llvm-project/polly/trunk/www/example_load_Polly_into_dragonegg.html?rev=161928&view=auto
==============================================================================
--- polly/trunk/www/example_load_Polly_into_dragonegg.html (added)
+++ polly/trunk/www/example_load_Polly_into_dragonegg.html Wed Aug 15 00:02:25 2012
@@ -0,0 +1,69 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"
+          "http://www.w3.org/TR/html4/strict.dtd">
+<!-- Material used from: HTML 4.01 specs: http://www.w3.org/TR/html401/ -->
+<html>
+<head>
+  <META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+  <title>Polly - Load Polly into dragonegg</title>
+  <link type="text/css" rel="stylesheet" href="menu.css">
+  <link type="text/css" rel="stylesheet" href="content.css">
+</head>
+<body>
+<!--#include virtual="menu.html.incl"-->
+<div id="content">
+<!--=====================================================================-->
+<h1>Load Polly into dragonegg and automatically run it at -O3</h1>
+<!--=====================================================================-->
+
+<p><b>Note:</b>This is a quick note on how to load Polly into
+  dragonegg. The choice of front-end does not affect the passes
+  available with Polly, only the syntax is different.
+  The <a href="example_load_Polly_into_clang.html">examples for use
+  with clang</a> can also be performed with Polly, with suitable
+  corrections in the syntax.
+
+<h2>Compile dragonegg with support for LLVM plugins</h2>
+
+The support for LLVM plugins in dragonegg is still experimental, and
+hence protected by a build option. You must rebuild dragonegg with the
+following options:
+
+<pre class="code">
+$ GCC=${PATH_TO_GCC} LLVM_CONFIG=${PATH_TO_LLVM_CONFIG} ENABLE_LLVM_PLUGINS=1 make
+</pre>
+
+<h2>Load Polly into dragonegg</h2>
+
+By loading Polly into dragonegg, the Polly options become automatically
+available. You can load Polly either by adding the relevant commands to
+the CPPFLAGS or by creating an alias.
+
+<pre class="code">
+$ export CPPFLAGS="-fplugin=/path/to/dragonegg.so -fplugin-arg-dragonegg-llvm-option=load:${POLLY_BUILD_DIR}/lib/LLVMPolly.so"
+</pre>
+
+or
+
+<pre class="code">
+$ alias pollycc gcc -fplugin=/path/to/dragonegg.so -fplugin-arg-dragonegg-llvm-option=load:${POLLY_BUILD_DIR}/lib/LLVMPolly.so
+</pre>
+
+<h2>Optimizing with Polly</h2>
+
+Optimizing with Polly is as easy as adding <b>-O3 -fplugin-arg-dragonegg-llvm-option=-polly</b> to your
+compiler flags (Polly is only available at -O3).
+
+<pre class="code">pollycc -O3 -fplugin-arg-dragonegg-llvm-option=-polly file.c</pre>
+
+<h2>Passing various options to Polly</h2>
+
+As must be evident from the examples so far, options to LLVM and its
+plugins are passed via the <b>-fplugin-arg-dragonegg-llvm-option</b>
+commandline argment.
+The <a href="example_load_Polly_into_clang.html">examples for use with
+clang</a> can be executed with dragonegg by replacing
+the <b>-mllvm</b> syntax with the dragonegg syntax.
+
+</div>
+</body>
+</html>

Propchange: polly/trunk/www/example_load_Polly_into_dragonegg.html
------------------------------------------------------------------------------
    svn:executable = *



