http://git-wip-us.apache.org/repos/asf/celix-site/blob/757e797e/site/doc/two/file_two.html ---------------------------------------------------------------------- diff --git a/site/doc/two/file_two.html b/site/doc/two/file_two.html new file mode 100644 index 0000000..c13a3c7 --- /dev/null +++ b/site/doc/two/file_two.html @@ -0,0 +1,427 @@ +<!DOCTYPE html> +<html lang="en"> +<head> +<!-- + Licensed to the Apache Software Foundation (ASF) under one or more + contributor license agreements. See the NOTICE file distributed with + this work for additional information regarding copyright ownership. + The ASF licenses this file to You under the Apache License, Version 2.0 + (the "License"); you may not use this file except in compliance with + the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE- 2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. +--> +<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> +<meta name="viewport" content="width=device-width, initial-scale=1.0"> +<link href="/import/style.css" rel="stylesheet"> +<link href="/import/friendly.css" rel="stylesheet"> +<!--page info--> +<title>Welcome to Apache Celix</title> +<meta name="description" content=""> +<meta name="author" content="me"> +</head> +<body> +<div id="imgbackground"></div> +<nav class = "shadowed"> + <a href="/"><img class="shadowed" src="/media/celix.png"></a> + <div id="mobmenu"> + <select class="mobbutton" onchange="if (this.value) window.location.href=this.value"> + <option value="">navigate</option> + <option value="/">Home</option> + <option value="/doc/">Documentation</option> + <option value="/downloads.html">Downloads</option> + <optgroup label="Community"> + <option value="/contributing.html">Contributing</option> + <option value="/boardreports.html">Board Reports</option> + <option value="/releasing.html">Releasing</option> + </optgroup> + <optgroup label="Support"> + <option value="/mailinglist.html">Mailing List</option> + <option value="/issuetracking.html">Issue Tracking</option> + </optgroup> + <optgroup label="ASF"> + <option value="http://www.apache.org/";>ASF Home</option> + <option value="http://www.apache.org/foundation/how-it-works.html";>How it works</option> + <option value="http://www.apache.org/licenses/";>License</option> + <option value="http://www.apache.org/foundation/sponsorship.html";>Sponsorship</option> + <option value="http://www.apache.org/foundation/thanks.html";>Thanks</option> + <option value="http://www.apache.org/security";>Security</option> + </optgroup> + </select> + <div id="dropmenu" class="shadowed"> + <a href="/"><div class="dropbutton"> + Home + </div></a><a href="/doc/"><div class="dropbutton"> + Documentation + </div></a><a href="/downloads.html"><div class="dropbutton"> + Download + </div></a><div class="dropdown"> + <div class="dropbutton">Community<div class="triangle"></div></div> + <div class="dropdown-content"> + <a href="/contributing.html">Contributing</a> + <a href="/boardreports.html">Board Reports</a> + <a href="/releasing.html">Releasing</a> + </div> + </div><div class="dropdown"> + <div class="dropbutton">Support<div class="triangle"></div></div> + <div class="dropdown-content"> + <a href="/mailinglist.html">Mailing List</a> + <a href="/issuetracking.html">Issue Tracking</a> + </div> + </div><div class="dropdown"> + <div class="dropbutton">ASF<div class="triangle"></div></div> + <div class="dropdown-content"> + <a href="http://www.apache.org/";>ASF Home</a> + <a href="http://www.apache.org/foundation/how-it-works.html";>How it works</a> + <a href="http://www.apache.org/licenses/";>License</a> + <a href="http://www.apache.org/foundation/sponsorship.html";>Sponsorship</a> + <a href="http://www.apache.org/foundation/thanks.html";>Thanks</a> + <a href="http://www.apache.org/security";>Security</a> + </div> + </div> + </div> + </div> +</nav> +<a href="https://github.com/apache/celix";> + <img class="GHImg shadowed" src="/media/forkmeongithub.png" alt="Fork me on GitHub" + data-canonical-src="https://s3.amazonaws.com/github/ribbons/forkme_left_orange_ff7600.png";> + <img class="GHImgSmall shadowed" src="/media/forkmesmall.png" alt="Fork me on GitHub"> +</a> +<a href="http://apache.org/";> + <img id="APbig" class="logoAP shadowed" src="/media/Apache_full.svg"> + <img id="APsmall" class="logoAP shadowed" src="/media/Apache_Feather.svg"> +</a> +<div class="spacer"> +<div id=docTable><table> + <tr><th>one</th></tr> + <tr><td><a href=/doc/index.html>main</a></td></tr> + <tr><td><a href=/doc/one/file_one.html>file one</a></td></tr> + <tr><th>two</th></tr> + <tr><td><a href=/doc/two/file_two.html>file two</a></td></tr> + <tr><td><a href=/doc/two/file_three.html>file three</a></td></tr> +</table></div> +<div id=docContent> +<h1>Apache Celix - Getting Started Guide: Creating a Simple Bundle</h1> + +<h2>Intro</h2> + +<p>This page is intended for first time users of Apache Celix. It should guide you through building & installing Apache Celix, setting up a new project, creating your first bundle, setting up the project for use with Eclipse project and finally running and debugging your bundle directly from eclipse workspace. </p> + +<p>If there are any uncertainties or question, don't hesitate to ask your questions in the <a href="https://celix.apache.org/support/mailinglist.html";>Apache Celix mailing</a>.</p> + +<h2>Prerequisite</h2> + +<p>Some experience with a command line interface (xterm) is expected to be able to follow this guide. </p> + +<h2>Building and Installing</h2> + +<p>For Apache Celix see <a href="../building/file_three.html">Building And Installing</a></p> + +<h2>Installing Eclipse CDT</h2> + +<p>Download the latest eclipse CDT at <a href="http://www.eclipse.org";>http://www.eclipse.org</a> and install it on your system. For more information on how the install eclipse on your system consult the eclipse documentation. For this getting started guide the luna version of eclipse was used (<a href="http://www.eclipse.org/downloads/download.php?file=/technology/epp/downloads/release/luna/R/eclipse-cpp-luna-R-linux-gtk-x86_64.tar.gz";>linux</a> <a href="http://www.eclipse.org/downloads/download.php?file=/technology/epp/downloads/release/luna/R/eclipse-cpp-luna-R-macosx-cocoa-x86_64.tar.gz";>mac</a>).</p> + +<h2>Apache Celix Bundle project</h2> + +<p>Now that Apache Celix and Eclipse is installed, we are ready to create a new Apache Celix Bundle project.<br /> +CMake is used as build tool for Apache Celix projects.</p> + +<p>To setup of the project, first create a new project dir to work in:</p> + +<div class="codehilite"><pre><span></span><code><span class="c1">#Create a new workspace to work in, e.g:</span> +mkdir <span class="si">${</span><span class="nv">HOME</span><span class="si">}</span>/workspace +<span class="nb">export</span> <span class="nv">WS</span><span class="o">=</span><span class="si">${</span><span class="nv">HOME</span><span class="si">}</span>/workspace + +mkdir <span class="si">${</span><span class="nv">WS</span><span class="si">}</span>/myproject +<span class="nb">cd</span> <span class="si">${</span><span class="nv">WS</span><span class="si">}</span>/myproject +</code></pre></div> + +<p>Then create a CMakeLists.txt file - the makefile variant of CMake -in project root directory:</p> + +<div class="codehilite"><pre><span></span><code><span class="c">#${WS}/myproject/CMakeLists.txt</span> + +<span class="c">#Part 1. setup project</span> +<span class="nb">cmake_minimum_required</span><span class="p">(</span><span class="s">VERSION</span> <span class="s">3.4</span><span class="p">)</span> +<span class="nb">project</span><span class="p">(</span><span class="s">myproject</span> <span class="s">C</span> <span class="s">CXX</span><span class="p">)</span> + +<span class="c">#Part 2. setup compilers</span> +<span class="nb">SET</span><span class="p">(</span><span class="s">CMAKE_C_FLAGS</span> <span class="s2">"-D_GNU_SOURCE -std=gnu99 -Wall -Werror -fPIC ${CMAKE_C_FLAGS}"</span><span class="p">)</span> +<span class="nb">SET</span><span class="p">(</span><span class="s">CMAKE_C_FLAGS_DEBUG</span> <span class="s2">"-g -DDEBUG"</span><span class="p">)</span> +<span class="nb">SET</span><span class="p">(</span><span class="s">CMAKE_CXX_FLAGS</span> <span class="s2">"-std=c++11 ${CMAKE_CXX_FLAGS}"</span><span class="p">)</span> +<span class="nb">SET</span><span class="p">(</span><span class="s">CMAKE_CXX_FLAGS_DEBUG</span> <span class="s2">"-g -DDEBUG"</span><span class="p">)</span> + +<span class="c">#Part 3. Setup Celix cmake files, include paths, libraries and library paths</span> +<span class="c">#Note. If celix is not installed in /usr/local dir, change the location accordingly.</span> +<span class="nb">set</span><span class="p">(</span><span class="s">CMAKE_MODULE_PATH</span> <span class="o">${</span><span class="nv">CMAKE_MODULE_PATH</span><span class="o">}</span> <span class="s2">"/usr/local/share/celix/cmake/modules"</span><span class="p">)</span> +<span class="nb">find_package</span><span class="p">(</span><span class="s">CELIX</span> <span class="s">REQUIRED</span><span class="p">)</span> +<span class="nb">include_directories</span><span class="p">(</span><span class="o">${</span><span class="nv">CELIX_INCLUDE_DIRS</span><span class="o">}</span><span class="p">)</span> + +<span class="c">#Part 4. Choose C, C++ or both</span> +<span class="nb">add_subdirectory</span><span class="p">(</span><span class="s">bundles/hello_world</span><span class="p">)</span> <span class="c">#C</span> +<span class="nb">add_subdirectory</span><span class="p">(</span><span class="s">bundles/HelloWorld</span><span class="p">)</span> <span class="c">#C++</span> +</code></pre></div> + +<p>This CMakeLists.txt file, sets up the following:</p> + +<ul> +<li>Part 1<br /> +<ul><br /> +<li>The minimum cmake version required. </li><br /> +<li>The project name</li><br /> +<li>The type of source files to expect, in this case C and C++.</li><br /> +</ul></li> +<li>Part 2<br /> +<ul><br /> +<li>Setup the compilers. c99 for C and C++11 for C++</li><br /> +</ul></li> +<li>Part 3<br /> +<ul><br /> +<li>The Celix package should be searched, configured and that the Celix package is required. </li><br /> +<li>For all build targets in this CMakeLists.txt file or any sub directory CMakeLists.txt files the Apache Celix headers directory should be included.</li><br /> +</ul></li> +<li>Part 4<br /> +<ul><br /> +<li>The CMakelists.txt file in the subdirectory bundles/hello_world and/or bundles/HelloWorld should also be processed.</li><br /> +</ul></li> +</ul> + +<p>It is a good practice to create a separate CMakeLists.txt file for every bundle you want to build. For the hello<em>world bundle a CMakeLists.txt file should be created in the bundles/hello</em>world sub directory.</p> + +<p>Create the sub directory:</p> + +<div class="codehilite"><pre><span></span><code><span class="c">#Create directory structure for the hello_world bundles</span> +<span class="err">cd</span> <span class="err">${WS}/myproject</span> +<span class="err">mkdir</span> <span class="err">-p</span> <span class="err">bundles/hello_world/private/src</span> +<span class="err">mkdir</span> <span class="err">-p</span> <span class="err">bundles/HelloWorld/private/src</span> +<span class="err">mkdir</span> <span class="err">-p</span> <span class="err">bundles/HelloWorld/private/include</span> +</code></pre></div> + +<p>And add the following CMakeLists.txt file for the C Bundle:</p> + +<div class="codehilite"><pre><span></span><code><span class="c">#${WS}/myproject/bundles/hello_world/CMakeLists.txt</span> + +<span class="nb">add_bundle</span><span class="p">(</span><span class="s">hello_world</span> + <span class="s">VERSION</span> <span class="s">1.0.0</span> + <span class="s">SOURCES</span> + <span class="s">private/src/hello_world_activator.c</span> +<span class="p">)</span> + +<span class="nb">if</span><span class="p">(</span><span class="s">APPLE</span><span class="p">)</span> + <span class="nb">target_link_libraries</span><span class="p">(</span><span class="s">hello_world</span> <span class="o">${</span><span class="nv">CELIX_LIBRARIES</span><span class="o">}</span> <span class="s">-Wl,-all_load</span> <span class="o">${</span><span class="nv">CELIX_DM_STATIC_LIB</span><span class="o">}</span><span class="p">)</span> +<span class="nb">else</span><span class="p">()</span> + <span class="nb">target_link_libraries</span><span class="p">(</span><span class="s">hello_world</span> <span class="s">-Wl,--no-undefined</span> <span class="s">-Wl,--whole-archive</span> <span class="o">${</span><span class="nv">CELIX_DM_STATIC_LIB</span><span class="o">}</span> <span class="s">-Wl,--no-whole-archive</span> <span class="o">${</span><span class="nv">CELIX_LIBRARIES</span><span class="o">}</span><span class="p">)</span> +<span class="nb">endif</span><span class="p">()</span> +</code></pre></div> + +<p>And/or the following CMakeLists.txt for the C++ bundle:</p> + +<div class="codehilite"><pre><span></span><code><span class="c">#${WS}/myproject/bundles/HelloWorld/CMakeLists.txt</span> + +<span class="nb">include_directories</span><span class="p">(</span> + <span class="s">private/include</span> +<span class="p">)</span> + +<span class="nb">add_bundle</span><span class="p">(</span><span class="s">HelloWorld</span> + <span class="s">VERSION</span> <span class="s">1.0.0</span> + <span class="s">SOURCES</span> + <span class="s">private/src/HelloWorldActivator.cc</span> +<span class="p">)</span> + +<span class="nb">IF</span><span class="p">(</span><span class="s">APPLE</span><span class="p">)</span> + <span class="nb">target_link_libraries</span><span class="p">(</span><span class="s">HelloWorld</span> <span class="o">${</span><span class="nv">CELIX_LIBRARIES</span><span class="o">}</span> <span class="s">-Wl,-all_load</span> <span class="o">${</span><span class="nv">CELIX_DM_CXX_STATIC_LIB</span><span class="o">}</span><span class="p">)</span> +<span class="nb">else</span><span class="p">()</span> + <span class="nb">target_link_libraries</span><span class="p">(</span><span class="s">HelloWorld</span> <span class="s">-Wl,--no-undefined</span> <span class="s">-Wl,--whole-archive</span> <span class="o">${</span><span class="nv">CELIX_DM_CXX_STATIC_LIB</span><span class="o">}</span> <span class="s">-Wl,--no-whole-archive</span> <span class="o">${</span><span class="nv">CELIX_LIBRARIES</span><span class="o">}</span><span class="p">)</span> +<span class="nb">endif</span><span class="p">()</span> +</code></pre></div> + +<p>These CMakeLists.txt files declare that the bundles should be build based on the build result (shared library) of the declared sources (in this case the <code>private/src/hello_world_activator.c</code> or <code>private/src/HelloWorldActivator.cc</code> source).<br /> +The add_bundle function is an Apache Celix specific CMake extension.<br /> +The library used for the bundle will also be linked against the dependency manager static library. </p> + +<p>The Celix framework will install the bundle, load the bundle shared library and call the bundle activator entry symbols. These entries need to be programmed by the user.<br /> +Note that in these examples we use the dependency manager libraries (C and C++ version) instead of developing a "vanilla" bundle activator;<br /> +The dependency manager uses a higher abstraction and is more simple to understand and maintain, but not part of the OSGi standard.</p> + +<p>The C Bundle Activator:</p> + +<div class="codehilite"><pre><span></span><code><span class="c1">//${WS}/myproject/bundles/hello_world/private/src/hello_world_activator.c</span> +<span class="cp">#include</span> <span class="cpf"><stdlib.h></span><span class="cp"></span> +<span class="cp">#include</span> <span class="cpf"><stdio.h></span><span class="cp"></span> + +<span class="cp">#include</span> <span class="cpf">"dm_activator.h"</span><span class="cp"></span> + + +<span class="k">struct</span> <span class="n">userData</span> <span class="p">{</span> + <span class="kt">char</span> <span class="o">*</span> <span class="n">word</span><span class="p">;</span> +<span class="p">};</span> + +<span class="n">celix_status_t</span> <span class="nf">dm_create</span><span class="p">(</span><span class="n">bundle_context_pt</span> <span class="n">context</span><span class="p">,</span> <span class="kt">void</span> <span class="o">**</span><span class="n">out</span><span class="p">)</span> <span class="p">{</span> + <span class="n">celix_status_t</span> <span class="n">status</span> <span class="o">=</span> <span class="n">CELIX_SUCCESS</span><span class="p">;</span> + <span class="k">struct</span> <span class="n">userData</span><span class="o">*</span> <span class="n">result</span> <span class="o">=</span> <span class="n">calloc</span><span class="p">(</span><span class="mi">1</span><span class="p">,</span> <span class="k">sizeof</span><span class="p">(</span><span class="o">*</span><span class="n">result</span><span class="p">));</span> + <span class="k">if</span> <span class="p">(</span><span class="n">result</span> <span class="o">!=</span> <span class="nb">NULL</span><span class="p">)</span> <span class="p">{</span> + <span class="n">result</span><span class="o">-></span><span class="n">word</span> <span class="o">=</span> <span class="s">"C World"</span><span class="p">;</span> + <span class="o">*</span><span class="n">out</span> <span class="o">=</span> <span class="n">result</span><span class="p">;</span> + <span class="p">}</span> <span class="k">else</span> <span class="p">{</span> + <span class="n">status</span> <span class="o">=</span> <span class="n">CELIX_START_ERROR</span><span class="p">;</span> + <span class="p">}</span> + <span class="k">return</span> <span class="n">status</span><span class="p">;</span> +<span class="p">}</span> + +<span class="n">celix_status_t</span> <span class="nf">dm_init</span><span class="p">(</span><span class="kt">void</span><span class="o">*</span> <span class="n">userData</span><span class="p">,</span> <span class="n">bundle_context_pt</span> <span class="n">context</span><span class="p">,</span> <span class="n">dm_dependency_manager_pt</span> <span class="n">manager</span><span class="p">)</span> <span class="p">{</span> + <span class="k">struct</span> <span class="n">userData</span><span class="o">*</span> <span class="n">data</span> <span class="o">=</span> <span class="p">(</span><span class="k">struct</span> <span class="n">userData</span> <span class="o">*</span><span class="p">)</span> <span class="n">userData</span><span class="p">;</span> + <span class="n">printf</span><span class="p">(</span><span class="s">"Hello %s</span><span class="se">\n</span><span class="s">"</span><span class="p">,</span> <span class="n">data</span><span class="o">-></span><span class="n">word</span><span class="p">);</span> + <span class="k">return</span> <span class="n">CELIX_SUCCESS</span><span class="p">;</span> +<span class="p">}</span> + +<span class="n">celix_status_t</span> <span class="nf">dm_destroy</span><span class="p">(</span><span class="kt">void</span><span class="o">*</span> <span class="n">userData</span><span class="p">,</span> <span class="n">bundle_context_pt</span> <span class="n">context</span><span class="p">,</span> <span class="n">dm_dependency_manager_pt</span> <span class="n">manager</span><span class="p">)</span> <span class="p">{</span> + <span class="n">free</span><span class="p">(</span><span class="n">userData</span><span class="p">);</span> + <span class="k">return</span> <span class="n">CELIX_SUCCESS</span><span class="p">;</span> +<span class="p">}</span> +</code></pre></div> + +<p>The C++ Bundle Activator (header + source):</p> + +<div class="codehilite"><pre><span></span><code><span class="c1">//${WS}/myproject/bundles/HelloWorld/private/include/HelloWorldActivator.h</span> +<span class="cp">#ifndef HELLOWORLDACTIVATOR_H_</span> +<span class="cp">#define HELLOWORLDACTIVATOR_H_</span> + +<span class="cp">#include</span> <span class="cpf">"celix/dm/DmActivator.h"</span><span class="cp"></span> + +<span class="k">using</span> <span class="k">namespace</span> <span class="n">celix</span><span class="o">::</span><span class="n">dm</span><span class="p">;</span> + +<span class="k">class</span> <span class="nc">HelloWorldActivator</span> <span class="o">:</span> <span class="k">public</span> <span class="n">DmActivator</span> <span class="p">{</span> +<span class="k">private</span><span class="o">:</span> + <span class="k">const</span> <span class="n">std</span><span class="o">::</span><span class="n">string</span> <span class="n">word</span> <span class="p">{</span><span class="s">"C++ World"</span><span class="p">};</span> +<span class="k">public</span><span class="o">:</span> + <span class="n">HelloWorldActivator</span><span class="p">(</span><span class="n">DependencyManager</span><span class="o">&</span> <span class="n">mng</span><span class="p">)</span> <span class="o">:</span> <span class="n">DmActivator</span> <span class="p">{</span><span class="n">mng</span><span class="p">}</span> <span class="p">{}</span> + <span class="k">virtual</span> <span class="kt">void</span> <span class="n">init</span><span class="p">();</span> + <span class="k">virtual</span> <span class="kt">void</span> <span class="nf">deinit</span><span class="p">();</span> +<span class="p">};</span> + +<span class="cp">#endif </span><span class="c1">//HELLOWORLDACTIVATOR_H_</span> + +<span class="c1">//${WS}/myproject/bundles/HelloWorld/private/src/HelloWorldActivator.cc</span> +<span class="cp">#include</span> <span class="cpf">"HelloWorldActivator.h"</span><span class="cp"></span> +<span class="cp">#include</span> <span class="cpf"><iostream></span><span class="cp"></span> + +<span class="k">using</span> <span class="k">namespace</span> <span class="n">celix</span><span class="o">::</span><span class="n">dm</span><span class="p">;</span> + +<span class="n">DmActivator</span><span class="o">*</span> <span class="n">DmActivator</span><span class="o">::</span><span class="n">create</span><span class="p">(</span><span class="n">DependencyManager</span><span class="o">&</span> <span class="n">mng</span><span class="p">)</span> <span class="p">{</span> + <span class="k">return</span> <span class="k">new</span> <span class="n">HelloWorldActivator</span><span class="p">(</span><span class="n">mng</span><span class="p">);</span> +<span class="p">}</span> + +<span class="kt">void</span> <span class="n">HelloWorldActivator</span><span class="o">::</span><span class="n">init</span><span class="p">()</span> <span class="p">{</span> + <span class="n">std</span><span class="o">::</span><span class="n">cout</span> <span class="o"><<</span> <span class="s">"Hello "</span> <span class="o"><<</span> <span class="k">this</span><span class="o">-></span><span class="n">word</span> <span class="o"><<</span> <span class="s">"</span><span class="se">\n</span><span class="s">"</span><span class="p">;</span> +<span class="p">}</span> + +<span class="kt">void</span> <span class="n">HelloWorldActivator</span><span class="o">::</span><span class="n">deinit</span><span class="p">()</span> <span class="p">{</span> + <span class="c1">//nothing to do</span> +<span class="p">}</span> +</code></pre></div> + +<h3>Building</h3> + +<p>One of the highly recommended features of CMake is the ability to do out of source builds, the benefit is that all of the build results will go in a separate directory without cluttering the (source) project.<br /> +CMake also needs to able to find the cmake files Celix provides. This can be achieved by providing a CMAKE<em>MODULE</em>PATH variable (or setting the CMAKE<em>MODULE</em>PATH in the top level CMakeLists.txt).<br /> +For this example it is assumed that Celix in installed in <code>/usr/local</code>.<br /> +To create the build directory and build the project execute the following commands:</p> + +<div class="codehilite"><pre><span></span><code><span class="nb">cd</span> <span class="si">${</span><span class="nv">WS</span><span class="si">}</span> +mkdir myproject-build +<span class="nb">cd</span> myproject-build +cmake ../myproject +make all +<span class="c1">#Or</span> +<span class="c1">#cmake -G Ninja ../myproject</span> +<span class="c1">#ninja</span> +</code></pre></div> + +<p>Hopefully you will some some build results scrolling over the screen and actual build results in the build directory. There should be a hello<em>world.zip in the bundles/hello</em>world directory, this the actual bundle.<br /> +A bundle on its own has no real value, so lets setup a deployment and run the Apache Celix framwork with these bundles.</p> + +<h3>Running</h3> + +<p>To create a deployment for the hello world bundles two things are needed: </p> + +<ol> +<li>Add a <code>add_deploy</code> statement in the <code>CMakeLists.txt</code> file declaring what to deploy and under which name.</li> +</ol> + +<div class="codehilite"><pre><span></span><code><span class="c">#${WS}/myproject/CMakeLists.txt</span> +<span class="nb">add_deploy</span><span class="p">(</span><span class="s">myproject</span> + <span class="s">BUNDLES</span> + <span class="o">${</span><span class="nv">CELIX_BUNDLES_DIR</span><span class="o">}</span><span class="s">/shell.zip</span> + <span class="o">${</span><span class="nv">CELIX_BUNDLES_DIR</span><span class="o">}</span><span class="s">/shell_tui.zip</span> + <span class="o">${</span><span class="nv">CELIX_BUNDLES_DIR</span><span class="o">}</span><span class="s">/dm_shell.zip</span> + <span class="s">hello_world</span> <span class="c">#C bundle</span> + <span class="s">HelloWorld</span> <span class="c">#C++ bundle</span> +<span class="p">)</span> +</code></pre></div> + +<p>Rerun make again form the build project. the make files generated by CMake will ensure cmake is run it again to update the actual make files.</p> + +<div class="codehilite"><pre><span></span><code><span class="nb">cd</span> <span class="si">${</span><span class="nv">WS</span><span class="si">}</span>/myproject-build +make -j +<span class="c1">#or</span> +<span class="c1">#ninja</span> +</code></pre></div> + +<p>Now a deploy directory myproject should be available in the deploy directory. This directory contains - among other files - a release.sh script. This can be used to setup the required environment variables (like LD<em>LIBRARY</em>PATH).</p> + +<div class="codehilite"><pre><span></span><code><span class="nb">cd</span> <span class="si">${</span><span class="nv">WS</span><span class="si">}</span>/myproject-build/deploy/myproject +. ./release.sh +celix +<span class="c1">#or ./hello</span> +</code></pre></div> + +<p>The hello<em>world bundle should be started with the famous "Hello World" text printed twice from the C and C++ bundle. The shell and shell</em>tui bundle are also deployed and these can be used to query and control the running framework. Below some commands are shown for querying the installed bundles, listing all known shell command, showing the help of a specific command and stopping a specific bundle (note that bundle 0 is the framework "bundle"):</p> + +<pre><code>lb +help +help inspect +stop 0 +</code></pre> + +<h2>Apache Celix Bundle Project in Eclipse</h2> + +<p>A nice feature of CMake is the ability to generate Eclipse project files, with this feature bundles can also be developed with use of Eclipse. This should help speed up the development process.<br /> +To get started change directory to the build directory and generate a eclipse project file.</p> + +<pre><code>cd ${WS}/myproject-build +cmake -G "Eclipse CDT4 - Unix Makefiles" . +</code></pre> + +<p>Startup the Eclipse EDI and a chose the <code>${WS}</code></p> + +<p><img src="getting_started_img1.png" alt="select workspace" /></p> + +<p>Import the project with existing project. </p> + +<p><img src="getting_started_img2.png" alt="import project" /></p> + +<p>To build the project, use Project->Build All. To run or debug from Eclipse navigate to the myproject deploy directory and right click on the 'myproject-deploy.launch' file. And select Run As or Debug As to run or debug the bundle.</p> + +<p><img src="getting_started_img3.png" alt="run project" /> </p> + +<h2>Next</h2> + +<p>The idea behind service oriented programming is that functionality is provided and used by abstract service, which hide implementation details.<br /> +For a guide how to provide and use services see</p> + +<ul> +<li><a href="using_services_with_c.md">Apache Celix - Getting Started Guide: Using Services with C</a></li> +<li><a href="using_services_with_cxx.md">Apache Celix - Getting Started Guide: Using Services with C++</a></li> +</ul> + +</div></div><div id="foot"> +<div id="footText"> +Copyright © 2011 The Apache Software Foundation, Licensed under the Apache License, Version 2.0. +Apache Celix, Celix, Apache, the Apache feather logo and the Apache Celix logo are trademarks of The Apache Software Foundation. +</div></div> +<script src='/import/javascript.js'></script>
http://git-wip-us.apache.org/repos/asf/celix-site/blob/757e797e/site/downloads.html ---------------------------------------------------------------------- diff --git a/site/downloads.html b/site/downloads.html new file mode 100644 index 0000000..aad5f75 --- /dev/null +++ b/site/downloads.html @@ -0,0 +1,138 @@ +<!DOCTYPE html> +<html lang="en"> +<head> +<!-- + Licensed to the Apache Software Foundation (ASF) under one or more + contributor license agreements. See the NOTICE file distributed with + this work for additional information regarding copyright ownership. + The ASF licenses this file to You under the Apache License, Version 2.0 + (the "License"); you may not use this file except in compliance with + the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE- 2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. +--> +<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> +<meta name="viewport" content="width=device-width, initial-scale=1.0"> +<link href="/import/style.css" rel="stylesheet"> +<link href="/import/friendly.css" rel="stylesheet"> +<!--page info--> +<title>Welcome to Apache Celix</title> +<meta name="description" content=""> +<meta name="author" content="me"> +</head> +<body> +<div id="imgbackground"></div> +<nav class = "shadowed"> + <a href="/"><img class="shadowed" src="/media/celix.png"></a> + <div id="mobmenu"> + <select class="mobbutton" onchange="if (this.value) window.location.href=this.value"> + <option value="">navigate</option> + <option value="/">Home</option> + <option value="/doc/">Documentation</option> + <option value="/downloads.html">Downloads</option> + <optgroup label="Community"> + <option value="/contributing.html">Contributing</option> + <option value="/boardreports.html">Board Reports</option> + <option value="/releasing.html">Releasing</option> + </optgroup> + <optgroup label="Support"> + <option value="/mailinglist.html">Mailing List</option> + <option value="/issuetracking.html">Issue Tracking</option> + </optgroup> + <optgroup label="ASF"> + <option value="http://www.apache.org/";>ASF Home</option> + <option value="http://www.apache.org/foundation/how-it-works.html";>How it works</option> + <option value="http://www.apache.org/licenses/";>License</option> + <option value="http://www.apache.org/foundation/sponsorship.html";>Sponsorship</option> + <option value="http://www.apache.org/foundation/thanks.html";>Thanks</option> + <option value="http://www.apache.org/security";>Security</option> + </optgroup> + </select> + <div id="dropmenu" class="shadowed"> + <a href="/"><div class="dropbutton"> + Home + </div></a><a href="/doc/"><div class="dropbutton"> + Documentation + </div></a><a href="/downloads.html"><div class="dropbutton"> + Download + </div></a><div class="dropdown"> + <div class="dropbutton">Community<div class="triangle"></div></div> + <div class="dropdown-content"> + <a href="/contributing.html">Contributing</a> + <a href="/boardreports.html">Board Reports</a> + <a href="/releasing.html">Releasing</a> + </div> + </div><div class="dropdown"> + <div class="dropbutton">Support<div class="triangle"></div></div> + <div class="dropdown-content"> + <a href="/mailinglist.html">Mailing List</a> + <a href="/issuetracking.html">Issue Tracking</a> + </div> + </div><div class="dropdown"> + <div class="dropbutton">ASF<div class="triangle"></div></div> + <div class="dropdown-content"> + <a href="http://www.apache.org/";>ASF Home</a> + <a href="http://www.apache.org/foundation/how-it-works.html";>How it works</a> + <a href="http://www.apache.org/licenses/";>License</a> + <a href="http://www.apache.org/foundation/sponsorship.html";>Sponsorship</a> + <a href="http://www.apache.org/foundation/thanks.html";>Thanks</a> + <a href="http://www.apache.org/security";>Security</a> + </div> + </div> + </div> + </div> +</nav> +<a href="https://github.com/apache/celix";> + <img class="GHImg shadowed" src="/media/forkmeongithub.png" alt="Fork me on GitHub" + data-canonical-src="https://s3.amazonaws.com/github/ribbons/forkme_left_orange_ff7600.png";> + <img class="GHImgSmall shadowed" src="/media/forkmesmall.png" alt="Fork me on GitHub"> +</a> +<a href="http://apache.org/";> + <img id="APbig" class="logoAP shadowed" src="/media/Apache_full.svg"> + <img id="APsmall" class="logoAP shadowed" src="/media/Apache_Feather.svg"> +</a> +<div class="spacer"> +<h1>Download Celix</h1> + +<p>Celix is an implementation of the OSGi specification adapted to C.</p> + +<h2>Releases</h2> + +<p>Apache Celix only releases source distributions, information about building and running van be found inside the release tarball.</p> + +<h3>Mirrors</h3> + +<p>The currently selected mirror is <strong>[preferred]</strong>. If you encounter a problem with this mirror, please select another mirror. If all mirrors are failing, there are <em>backup</em><br /> +mirrors (at the end of the mirrors list) that should be available. </p> + +<form action="[location]" method="get" id="SelectMirror">Other mirrors: + <select name="Preferred"> + [if-any http] [for http]<option value="[http]">[http]</option>[end] [end] + [if-any ftp] [for ftp]<option value="[ftp]">[ftp]</option>[end] [end] + [if-any backup] [for backup]<option value="[backup]">[backup] (backup)</option>[end] [end] + </select> + <input type="submit" value="Change"></input> +</form> + +<p>You may also consult the <a href="http://www.apache.org/mirrors/";>complete list of mirrors</a>.</p> + +<h3>Downloads</h3> + +<ul> +<li>Source: <a href="[preferred]/celix/celix-2.0.0/celix-2.0.0.tar.gz">celix-2.0.0.tar.gz</a><br /> +<a href="http://www.apache.org/dist/celix/celix-2.0.0/celix-2.0.0.tar.gz.asc";>PGP</a><br /> +<a href="http://www.apache.org/dist/celix/celix-2.0.0/celix-2.0.0.tar.gz.md5";>MD5</a><br /> +<a href="http://www.apache.org/dist/celix/celix-2.0.0/celix-2.0.0.tar.gz.sha";>SHA1</a></li> +</ul> +</div><div id="foot"> +<div id="footText"> +Copyright © 2011 The Apache Software Foundation, Licensed under the Apache License, Version 2.0. +Apache Celix, Celix, Apache, the Apache feather logo and the Apache Celix logo are trademarks of The Apache Software Foundation. +</div></div> +<script src='/import/javascript.js'></script> http://git-wip-us.apache.org/repos/asf/celix-site/blob/757e797e/site/import/friendly.css ---------------------------------------------------------------------- diff --git a/site/import/friendly.css b/site/import/friendly.css new file mode 100644 index 0000000..adb781c --- /dev/null +++ b/site/import/friendly.css @@ -0,0 +1,69 @@ +.codehilite .hll { background-color: #ffffcc } +.codehilite { background: #f0f0f0; } +.codehilite .c { color: #60a0b0; font-style: italic } /* Comment */ +.codehilite .err { border: 1px solid #FF0000 } /* Error */ +.codehilite .k { color: #007020; font-weight: bold } /* Keyword */ +.codehilite .o { color: #666666 } /* Operator */ +.codehilite .ch { color: #60a0b0; font-style: italic } /* Comment.Hashbang */ +.codehilite .cm { color: #60a0b0; font-style: italic } /* Comment.Multiline */ +.codehilite .cp { color: #007020 } /* Comment.Preproc */ +.codehilite .cpf { color: #60a0b0; font-style: italic } /* Comment.PreprocFile */ +.codehilite .c1 { color: #60a0b0; font-style: italic } /* Comment.Single */ +.codehilite .cs { color: #60a0b0; background-color: #fff0f0 } /* Comment.Special */ +.codehilite .gd { color: #A00000 } /* Generic.Deleted */ +.codehilite .ge { font-style: italic } /* Generic.Emph */ +.codehilite .gr { color: #FF0000 } /* Generic.Error */ +.codehilite .gh { color: #000080; font-weight: bold } /* Generic.Heading */ +.codehilite .gi { color: #00A000 } /* Generic.Inserted */ +.codehilite .go { color: #888888 } /* Generic.Output */ +.codehilite .gp { color: #c65d09; font-weight: bold } /* Generic.Prompt */ +.codehilite .gs { font-weight: bold } /* Generic.Strong */ +.codehilite .gu { color: #800080; font-weight: bold } /* Generic.Subheading */ +.codehilite .gt { color: #0044DD } /* Generic.Traceback */ +.codehilite .kc { color: #007020; font-weight: bold } /* Keyword.Constant */ +.codehilite .kd { color: #007020; font-weight: bold } /* Keyword.Declaration */ +.codehilite .kn { color: #007020; font-weight: bold } /* Keyword.Namespace */ +.codehilite .kp { color: #007020 } /* Keyword.Pseudo */ +.codehilite .kr { color: #007020; font-weight: bold } /* Keyword.Reserved */ +.codehilite .kt { color: #902000 } /* Keyword.Type */ +.codehilite .m { color: #40a070 } /* Literal.Number */ +.codehilite .s { color: #4070a0 } /* Literal.String */ +.codehilite .na { color: #4070a0 } /* Name.Attribute */ +.codehilite .nb { color: #007020 } /* Name.Builtin */ +.codehilite .nc { color: #0e84b5; font-weight: bold } /* Name.Class */ +.codehilite .no { color: #60add5 } /* Name.Constant */ +.codehilite .nd { color: #555555; font-weight: bold } /* Name.Decorator */ +.codehilite .ni { color: #d55537; font-weight: bold } /* Name.Entity */ +.codehilite .ne { color: #007020 } /* Name.Exception */ +.codehilite .nf { color: #06287e } /* Name.Function */ +.codehilite .nl { color: #002070; font-weight: bold } /* Name.Label */ +.codehilite .nn { color: #0e84b5; font-weight: bold } /* Name.Namespace */ +.codehilite .nt { color: #062873; font-weight: bold } /* Name.Tag */ +.codehilite .nv { color: #bb60d5 } /* Name.Variable */ +.codehilite .ow { color: #007020; font-weight: bold } /* Operator.Word */ +.codehilite .w { color: #bbbbbb } /* Text.Whitespace */ +.codehilite .mb { color: #40a070 } /* Literal.Number.Bin */ +.codehilite .mf { color: #40a070 } /* Literal.Number.Float */ +.codehilite .mh { color: #40a070 } /* Literal.Number.Hex */ +.codehilite .mi { color: #40a070 } /* Literal.Number.Integer */ +.codehilite .mo { color: #40a070 } /* Literal.Number.Oct */ +.codehilite .sa { color: #4070a0 } /* Literal.String.Affix */ +.codehilite .sb { color: #4070a0 } /* Literal.String.Backtick */ +.codehilite .sc { color: #4070a0 } /* Literal.String.Char */ +.codehilite .dl { color: #4070a0 } /* Literal.String.Delimiter */ +.codehilite .sd { color: #4070a0; font-style: italic } /* Literal.String.Doc */ +.codehilite .s2 { color: #4070a0 } /* Literal.String.Double */ +.codehilite .se { color: #4070a0; font-weight: bold } /* Literal.String.Escape */ +.codehilite .sh { color: #4070a0 } /* Literal.String.Heredoc */ +.codehilite .si { color: #70a0d0; font-style: italic } /* Literal.String.Interpol */ +.codehilite .sx { color: #c65d09 } /* Literal.String.Other */ +.codehilite .sr { color: #235388 } /* Literal.String.Regex */ +.codehilite .s1 { color: #4070a0 } /* Literal.String.Single */ +.codehilite .ss { color: #517918 } /* Literal.String.Symbol */ +.codehilite .bp { color: #007020 } /* Name.Builtin.Pseudo */ +.codehilite .fm { color: #06287e } /* Name.Function.Magic */ +.codehilite .vc { color: #bb60d5 } /* Name.Variable.Class */ +.codehilite .vg { color: #bb60d5 } /* Name.Variable.Global */ +.codehilite .vi { color: #bb60d5 } /* Name.Variable.Instance */ +.codehilite .vm { color: #bb60d5 } /* Name.Variable.Magic */ +.codehilite .il { color: #40a070 } /* Literal.Number.Integer.Long */ http://git-wip-us.apache.org/repos/asf/celix-site/blob/757e797e/site/import/style.css ---------------------------------------------------------------------- diff --git a/site/import/style.css b/site/import/style.css index dbcb978..849fa52 100755 --- a/site/import/style.css +++ b/site/import/style.css @@ -233,6 +233,12 @@ a { filter: drop-shadow(2px 2px 1px rgba(0,0,0,0.5)); } +.codehilite { + display: inline-block; + border-radius: 8px; + padding: 5px; +} + @media screen and (max-width: 1140px) { #APbig{display:none} #APsmall{display:block} http://git-wip-us.apache.org/repos/asf/celix-site/blob/757e797e/site/index.html ---------------------------------------------------------------------- diff --git a/site/index.html b/site/index.html new file mode 100644 index 0000000..9af2837 --- /dev/null +++ b/site/index.html @@ -0,0 +1,137 @@ +<!DOCTYPE html> +<html lang="en"> +<head> +<!-- + Licensed to the Apache Software Foundation (ASF) under one or more + contributor license agreements. See the NOTICE file distributed with + this work for additional information regarding copyright ownership. + The ASF licenses this file to You under the Apache License, Version 2.0 + (the "License"); you may not use this file except in compliance with + the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE- 2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. +--> +<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> +<meta name="viewport" content="width=device-width, initial-scale=1.0"> +<link href="/import/style.css" rel="stylesheet"> +<link href="/import/friendly.css" rel="stylesheet"> +<!--page info--> +<title>Welcome to Apache Celix</title> +<meta name="description" content=""> +<meta name="author" content="me"> +</head> +<body> +<div id="imgbackground"></div> +<nav class = "shadowed"> + <a href="/"><img class="shadowed" src="/media/celix.png"></a> + <div id="mobmenu"> + <select class="mobbutton" onchange="if (this.value) window.location.href=this.value"> + <option value="">navigate</option> + <option value="/">Home</option> + <option value="/doc/">Documentation</option> + <option value="/downloads.html">Downloads</option> + <optgroup label="Community"> + <option value="/contributing.html">Contributing</option> + <option value="/boardreports.html">Board Reports</option> + <option value="/releasing.html">Releasing</option> + </optgroup> + <optgroup label="Support"> + <option value="/mailinglist.html">Mailing List</option> + <option value="/issuetracking.html">Issue Tracking</option> + </optgroup> + <optgroup label="ASF"> + <option value="http://www.apache.org/";>ASF Home</option> + <option value="http://www.apache.org/foundation/how-it-works.html";>How it works</option> + <option value="http://www.apache.org/licenses/";>License</option> + <option value="http://www.apache.org/foundation/sponsorship.html";>Sponsorship</option> + <option value="http://www.apache.org/foundation/thanks.html";>Thanks</option> + <option value="http://www.apache.org/security";>Security</option> + </optgroup> + </select> + <div id="dropmenu" class="shadowed"> + <a href="/"><div class="dropbutton"> + Home + </div></a><a href="/doc/"><div class="dropbutton"> + Documentation + </div></a><a href="/downloads.html"><div class="dropbutton"> + Download + </div></a><div class="dropdown"> + <div class="dropbutton">Community<div class="triangle"></div></div> + <div class="dropdown-content"> + <a href="/contributing.html">Contributing</a> + <a href="/boardreports.html">Board Reports</a> + <a href="/releasing.html">Releasing</a> + </div> + </div><div class="dropdown"> + <div class="dropbutton">Support<div class="triangle"></div></div> + <div class="dropdown-content"> + <a href="/mailinglist.html">Mailing List</a> + <a href="/issuetracking.html">Issue Tracking</a> + </div> + </div><div class="dropdown"> + <div class="dropbutton">ASF<div class="triangle"></div></div> + <div class="dropdown-content"> + <a href="http://www.apache.org/";>ASF Home</a> + <a href="http://www.apache.org/foundation/how-it-works.html";>How it works</a> + <a href="http://www.apache.org/licenses/";>License</a> + <a href="http://www.apache.org/foundation/sponsorship.html";>Sponsorship</a> + <a href="http://www.apache.org/foundation/thanks.html";>Thanks</a> + <a href="http://www.apache.org/security";>Security</a> + </div> + </div> + </div> + </div> +</nav> +<a href="https://github.com/apache/celix";> + <img class="GHImg shadowed" src="/media/forkmeongithub.png" alt="Fork me on GitHub" + data-canonical-src="https://s3.amazonaws.com/github/ribbons/forkme_left_orange_ff7600.png";> + <img class="GHImgSmall shadowed" src="/media/forkmesmall.png" alt="Fork me on GitHub"> +</a> +<a href="http://apache.org/";> + <img id="APbig" class="logoAP shadowed" src="/media/Apache_full.svg"> + <img id="APsmall" class="logoAP shadowed" src="/media/Apache_Feather.svg"> +</a> +<div class="spacer"> +<div id="banner"> + +<p><img class="bannerImage shadowed" src="media/celix_notext.png"><br /> +<div class="bannertext"></p> + +<h1>Apache Celix</h1> + +<p>Apache Celix is an implementation of the OSGi specification adapted to C and C++. It is a provides a framework to develop (dynamic) modular software applications using component and/or service-oriented programming.</p> + +<p>Apache Celix is primarily developed in C and adds an additional abstraction, in the form of a library, to support for C++.<br /> +</div></div><div class="container"><div class="item"></p> + +<h3>How to install</h3> + +<p></div><div class="item"></p> + +<h3>Documentation</h3> + +<p></div><div class="item"></p> + +<h3>Tips</h3> + +<p></div><div class="item"></p> + +<h3>Contributing</h3> + +<p></div><div class="item"></p> + +<h3>Example projects</h3> + +</div></div> +</div><div id="foot"> +<div id="footText"> +Copyright © 2011 The Apache Software Foundation, Licensed under the Apache License, Version 2.0. +Apache Celix, Celix, Apache, the Apache feather logo and the Apache Celix logo are trademarks of The Apache Software Foundation. +</div></div> +<script src='/import/javascript.js'></script> http://git-wip-us.apache.org/repos/asf/celix-site/blob/757e797e/site/issuetracking.html ---------------------------------------------------------------------- diff --git a/site/issuetracking.html b/site/issuetracking.html new file mode 100644 index 0000000..d352f46 --- /dev/null +++ b/site/issuetracking.html @@ -0,0 +1,125 @@ +<!DOCTYPE html> +<html lang="en"> +<head> +<!-- + Licensed to the Apache Software Foundation (ASF) under one or more + contributor license agreements. See the NOTICE file distributed with + this work for additional information regarding copyright ownership. + The ASF licenses this file to You under the Apache License, Version 2.0 + (the "License"); you may not use this file except in compliance with + the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE- 2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. +--> +<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> +<meta name="viewport" content="width=device-width, initial-scale=1.0"> +<link href="/import/style.css" rel="stylesheet"> +<link href="/import/friendly.css" rel="stylesheet"> +<!--page info--> +<title>Welcome to Apache Celix</title> +<meta name="description" content=""> +<meta name="author" content="me"> +</head> +<body> +<div id="imgbackground"></div> +<nav class = "shadowed"> + <a href="/"><img class="shadowed" src="/media/celix.png"></a> + <div id="mobmenu"> + <select class="mobbutton" onchange="if (this.value) window.location.href=this.value"> + <option value="">navigate</option> + <option value="/">Home</option> + <option value="/doc/">Documentation</option> + <option value="/downloads.html">Downloads</option> + <optgroup label="Community"> + <option value="/contributing.html">Contributing</option> + <option value="/boardreports.html">Board Reports</option> + <option value="/releasing.html">Releasing</option> + </optgroup> + <optgroup label="Support"> + <option value="/mailinglist.html">Mailing List</option> + <option value="/issuetracking.html">Issue Tracking</option> + </optgroup> + <optgroup label="ASF"> + <option value="http://www.apache.org/";>ASF Home</option> + <option value="http://www.apache.org/foundation/how-it-works.html";>How it works</option> + <option value="http://www.apache.org/licenses/";>License</option> + <option value="http://www.apache.org/foundation/sponsorship.html";>Sponsorship</option> + <option value="http://www.apache.org/foundation/thanks.html";>Thanks</option> + <option value="http://www.apache.org/security";>Security</option> + </optgroup> + </select> + <div id="dropmenu" class="shadowed"> + <a href="/"><div class="dropbutton"> + Home + </div></a><a href="/doc/"><div class="dropbutton"> + Documentation + </div></a><a href="/downloads.html"><div class="dropbutton"> + Download + </div></a><div class="dropdown"> + <div class="dropbutton">Community<div class="triangle"></div></div> + <div class="dropdown-content"> + <a href="/contributing.html">Contributing</a> + <a href="/boardreports.html">Board Reports</a> + <a href="/releasing.html">Releasing</a> + </div> + </div><div class="dropdown"> + <div class="dropbutton">Support<div class="triangle"></div></div> + <div class="dropdown-content"> + <a href="/mailinglist.html">Mailing List</a> + <a href="/issuetracking.html">Issue Tracking</a> + </div> + </div><div class="dropdown"> + <div class="dropbutton">ASF<div class="triangle"></div></div> + <div class="dropdown-content"> + <a href="http://www.apache.org/";>ASF Home</a> + <a href="http://www.apache.org/foundation/how-it-works.html";>How it works</a> + <a href="http://www.apache.org/licenses/";>License</a> + <a href="http://www.apache.org/foundation/sponsorship.html";>Sponsorship</a> + <a href="http://www.apache.org/foundation/thanks.html";>Thanks</a> + <a href="http://www.apache.org/security";>Security</a> + </div> + </div> + </div> + </div> +</nav> +<a href="https://github.com/apache/celix";> + <img class="GHImg shadowed" src="/media/forkmeongithub.png" alt="Fork me on GitHub" + data-canonical-src="https://s3.amazonaws.com/github/ribbons/forkme_left_orange_ff7600.png";> + <img class="GHImgSmall shadowed" src="/media/forkmesmall.png" alt="Fork me on GitHub"> +</a> +<a href="http://apache.org/";> + <img id="APbig" class="logoAP shadowed" src="/media/Apache_full.svg"> + <img id="APsmall" class="logoAP shadowed" src="/media/Apache_Feather.svg"> +</a> +<div class="spacer"> +<h1>Issue Tracking</h1> + +<p>Celix uses Jira for bug reports, feature requests, enhancements and tasks of all kind.</p> + +<p>Anyone can use Jira to report bugs. But before doing so, please make sure that:</p> + +<ul> +<li>the bug isn't already reported,</li> +<li>the problem is actually a bug (the <a href="/support/mailinglist.html">mailing list</a> can be used for support),</li> +<li>you attach enough information to replicate the bug (preferably a unit test)</li> +</ul> + +<p>If you have fixed a bug, the patch can be attached to a bug report.</p> + +<p>The Celix Jira Issue Tracker can be found at:</p> + +<ul> +<li><a href="https://issues.apache.org/jira/browse/celix";>https://issues.apache.org/jira/browse/celix</a></li> +</ul> +</div><div id="foot"> +<div id="footText"> +Copyright © 2011 The Apache Software Foundation, Licensed under the Apache License, Version 2.0. +Apache Celix, Celix, Apache, the Apache feather logo and the Apache Celix logo are trademarks of The Apache Software Foundation. +</div></div> +<script src='/import/javascript.js'></script> http://git-wip-us.apache.org/repos/asf/celix-site/blob/757e797e/site/mailinglist.html ---------------------------------------------------------------------- diff --git a/site/mailinglist.html b/site/mailinglist.html new file mode 100644 index 0000000..e3e8721 --- /dev/null +++ b/site/mailinglist.html @@ -0,0 +1,133 @@ +<!DOCTYPE html> +<html lang="en"> +<head> +<!-- + Licensed to the Apache Software Foundation (ASF) under one or more + contributor license agreements. See the NOTICE file distributed with + this work for additional information regarding copyright ownership. + The ASF licenses this file to You under the Apache License, Version 2.0 + (the "License"); you may not use this file except in compliance with + the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE- 2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. +--> +<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> +<meta name="viewport" content="width=device-width, initial-scale=1.0"> +<link href="/import/style.css" rel="stylesheet"> +<link href="/import/friendly.css" rel="stylesheet"> +<!--page info--> +<title>Welcome to Apache Celix</title> +<meta name="description" content=""> +<meta name="author" content="me"> +</head> +<body> +<div id="imgbackground"></div> +<nav class = "shadowed"> + <a href="/"><img class="shadowed" src="/media/celix.png"></a> + <div id="mobmenu"> + <select class="mobbutton" onchange="if (this.value) window.location.href=this.value"> + <option value="">navigate</option> + <option value="/">Home</option> + <option value="/doc/">Documentation</option> + <option value="/downloads.html">Downloads</option> + <optgroup label="Community"> + <option value="/contributing.html">Contributing</option> + <option value="/boardreports.html">Board Reports</option> + <option value="/releasing.html">Releasing</option> + </optgroup> + <optgroup label="Support"> + <option value="/mailinglist.html">Mailing List</option> + <option value="/issuetracking.html">Issue Tracking</option> + </optgroup> + <optgroup label="ASF"> + <option value="http://www.apache.org/";>ASF Home</option> + <option value="http://www.apache.org/foundation/how-it-works.html";>How it works</option> + <option value="http://www.apache.org/licenses/";>License</option> + <option value="http://www.apache.org/foundation/sponsorship.html";>Sponsorship</option> + <option value="http://www.apache.org/foundation/thanks.html";>Thanks</option> + <option value="http://www.apache.org/security";>Security</option> + </optgroup> + </select> + <div id="dropmenu" class="shadowed"> + <a href="/"><div class="dropbutton"> + Home + </div></a><a href="/doc/"><div class="dropbutton"> + Documentation + </div></a><a href="/downloads.html"><div class="dropbutton"> + Download + </div></a><div class="dropdown"> + <div class="dropbutton">Community<div class="triangle"></div></div> + <div class="dropdown-content"> + <a href="/contributing.html">Contributing</a> + <a href="/boardreports.html">Board Reports</a> + <a href="/releasing.html">Releasing</a> + </div> + </div><div class="dropdown"> + <div class="dropbutton">Support<div class="triangle"></div></div> + <div class="dropdown-content"> + <a href="/mailinglist.html">Mailing List</a> + <a href="/issuetracking.html">Issue Tracking</a> + </div> + </div><div class="dropdown"> + <div class="dropbutton">ASF<div class="triangle"></div></div> + <div class="dropdown-content"> + <a href="http://www.apache.org/";>ASF Home</a> + <a href="http://www.apache.org/foundation/how-it-works.html";>How it works</a> + <a href="http://www.apache.org/licenses/";>License</a> + <a href="http://www.apache.org/foundation/sponsorship.html";>Sponsorship</a> + <a href="http://www.apache.org/foundation/thanks.html";>Thanks</a> + <a href="http://www.apache.org/security";>Security</a> + </div> + </div> + </div> + </div> +</nav> +<a href="https://github.com/apache/celix";> + <img class="GHImg shadowed" src="/media/forkmeongithub.png" alt="Fork me on GitHub" + data-canonical-src="https://s3.amazonaws.com/github/ribbons/forkme_left_orange_ff7600.png";> + <img class="GHImgSmall shadowed" src="/media/forkmesmall.png" alt="Fork me on GitHub"> +</a> +<a href="http://apache.org/";> + <img id="APbig" class="logoAP shadowed" src="/media/Apache_full.svg"> + <img id="APsmall" class="logoAP shadowed" src="/media/Apache_Feather.svg"> +</a> +<div class="spacer"> +<h1>Mailing List</h1> + +<p>Celix users and developers can be reached using mailing lists. Currently there is only one list for development and<br /> +support questions.</p> + +<ul> +<li><a href="mailto:[email protected]";>Celix Developers Mailing List</a><br /> +<ul><br /> +<li><a href="mailto:[email protected]";>Subscribe</a></li><br /> +<li><a href="mailto:[email protected]";>Unsubscribe</a></li><br /> +<li><a href="http://mail-archives.apache.org/mod_mbox/celix-dev/";>Archives</a></li><br /> +</ul></li> +</ul> + +<p>If the Celix community grows, and there is a need for a dedicated users mailing list, it will be created.</p> + +<p>There is a second mailing list which is used to publish changes from the<br /> +<a href="/support/issuetracking.html">Issue Tracker</a>.</p> + +<ul> +<li><a href="mailto:[email protected]";>Celix Commits Mailing List</a><br /> +<ul><br /> +<li><a href="mailto:[email protected]";>Subscribe</a></li><br /> +<li><a href="mailto:[email protected]";>Unsubscribe</a></li><br /> +<li><a href="http://mail-archives.apache.org/mod_mbox/celix-commits/";>Archives</a></li><br /> +</ul></li> +</ul> +</div><div id="foot"> +<div id="footText"> +Copyright © 2011 The Apache Software Foundation, Licensed under the Apache License, Version 2.0. +Apache Celix, Celix, Apache, the Apache feather logo and the Apache Celix logo are trademarks of The Apache Software Foundation. +</div></div> +<script src='/import/javascript.js'></script> http://git-wip-us.apache.org/repos/asf/celix-site/blob/757e797e/site/releasing.html ---------------------------------------------------------------------- diff --git a/site/releasing.html b/site/releasing.html new file mode 100644 index 0000000..ef70152 --- /dev/null +++ b/site/releasing.html @@ -0,0 +1,386 @@ +<!DOCTYPE html> +<html lang="en"> +<head> +<!-- + Licensed to the Apache Software Foundation (ASF) under one or more + contributor license agreements. See the NOTICE file distributed with + this work for additional information regarding copyright ownership. + The ASF licenses this file to You under the Apache License, Version 2.0 + (the "License"); you may not use this file except in compliance with + the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE- 2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. +--> +<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> +<meta name="viewport" content="width=device-width, initial-scale=1.0"> +<link href="/import/style.css" rel="stylesheet"> +<link href="/import/friendly.css" rel="stylesheet"> +<!--page info--> +<title>Welcome to Apache Celix</title> +<meta name="description" content=""> +<meta name="author" content="me"> +</head> +<body> +<div id="imgbackground"></div> +<nav class = "shadowed"> + <a href="/"><img class="shadowed" src="/media/celix.png"></a> + <div id="mobmenu"> + <select class="mobbutton" onchange="if (this.value) window.location.href=this.value"> + <option value="">navigate</option> + <option value="/">Home</option> + <option value="/doc/">Documentation</option> + <option value="/downloads.html">Downloads</option> + <optgroup label="Community"> + <option value="/contributing.html">Contributing</option> + <option value="/boardreports.html">Board Reports</option> + <option value="/releasing.html">Releasing</option> + </optgroup> + <optgroup label="Support"> + <option value="/mailinglist.html">Mailing List</option> + <option value="/issuetracking.html">Issue Tracking</option> + </optgroup> + <optgroup label="ASF"> + <option value="http://www.apache.org/";>ASF Home</option> + <option value="http://www.apache.org/foundation/how-it-works.html";>How it works</option> + <option value="http://www.apache.org/licenses/";>License</option> + <option value="http://www.apache.org/foundation/sponsorship.html";>Sponsorship</option> + <option value="http://www.apache.org/foundation/thanks.html";>Thanks</option> + <option value="http://www.apache.org/security";>Security</option> + </optgroup> + </select> + <div id="dropmenu" class="shadowed"> + <a href="/"><div class="dropbutton"> + Home + </div></a><a href="/doc/"><div class="dropbutton"> + Documentation + </div></a><a href="/downloads.html"><div class="dropbutton"> + Download + </div></a><div class="dropdown"> + <div class="dropbutton">Community<div class="triangle"></div></div> + <div class="dropdown-content"> + <a href="/contributing.html">Contributing</a> + <a href="/boardreports.html">Board Reports</a> + <a href="/releasing.html">Releasing</a> + </div> + </div><div class="dropdown"> + <div class="dropbutton">Support<div class="triangle"></div></div> + <div class="dropdown-content"> + <a href="/mailinglist.html">Mailing List</a> + <a href="/issuetracking.html">Issue Tracking</a> + </div> + </div><div class="dropdown"> + <div class="dropbutton">ASF<div class="triangle"></div></div> + <div class="dropdown-content"> + <a href="http://www.apache.org/";>ASF Home</a> + <a href="http://www.apache.org/foundation/how-it-works.html";>How it works</a> + <a href="http://www.apache.org/licenses/";>License</a> + <a href="http://www.apache.org/foundation/sponsorship.html";>Sponsorship</a> + <a href="http://www.apache.org/foundation/thanks.html";>Thanks</a> + <a href="http://www.apache.org/security";>Security</a> + </div> + </div> + </div> + </div> +</nav> +<a href="https://github.com/apache/celix";> + <img class="GHImg shadowed" src="/media/forkmeongithub.png" alt="Fork me on GitHub" + data-canonical-src="https://s3.amazonaws.com/github/ribbons/forkme_left_orange_ff7600.png";> + <img class="GHImgSmall shadowed" src="/media/forkmesmall.png" alt="Fork me on GitHub"> +</a> +<a href="http://apache.org/";> + <img id="APbig" class="logoAP shadowed" src="/media/Apache_full.svg"> + <img id="APsmall" class="logoAP shadowed" src="/media/Apache_Feather.svg"> +</a> +<div class="spacer"> +<h1>Releasing Apache Celix</h1> + +<p>Note: This information is only of use to Apache Celix Release Managers!</p> + +<p>Steps to follow:</p> + +<ul> +<li>Create signing KEYs</li> +<li>Update release related files</li> +<li>Compile and test</li> +<li>Create SVN tag</li> +<li>Create, sign and publish artefacts</li> +<li>Run the vote</li> +<li>Post the vote results</li> +<li>Roll out the release artefacts</li> +<li>Announce the release</li> +</ul> + +<p>Interesting links:</p> + +<ul> +<li><a href="http://www.apache.org/dev/release.html";>Apache Release Guide</a></li> +<li><a href="http://www.apache.org/dev/release-signing.html";>Apache Release Signing</a></li> +<li><a href="http://creadur.apache.org/rat/apache-rat/index.html";>Apache RAT</a></li> +<li><a href="http://www.apache.org/dev/openpgp.html";>Apache OpenPGP Howto</a></li> +</ul> + +<h2>Create signing KEYs</h2> + +<p>Each Release Manager must have his own signing keys. Information about and instruction for the generation of these keys can be found on the<br /> +<a href="http://www.apache.org/dev/release-signing.html#generate";>Signing Releases page</a> and <a href="http://www.apache.org/dev/openpgp.html#generate-key";>How To OpenPGP</a>. Be sure to follow the information provided on that site and its references.</p> + +<p>The generated key can be uploaded to the <a href="http://pgp.mit.edu";>MIT PGP Public Key Server</a>.</p> + +<p>Next, the public key signature must be added to the KEYS file. Again, read the <a href="http://www.apache.org/dev/release-signing.html#keys-policy";>Signing Releases page</a><br /> +for more information. This updated file needs to be uploaded to SVN, be sure to upload it to:</p> + +<ul> +<li><a href="https://dist.apache.org/repos/dist/dev/incubator/celix/KEYS";>Apache Celix release development area KEYS</a></li> +<li><a href="https://dist.apache.org/repos/dist/release/incubator/celix/KEYS";>Apache Celix release distribution area KEYS</a></li> +</ul> + +<h2>Update release related files</h2> + +<p>For every release the related files must be updated. The following files are relevant:</p> + +<ul> +<li><p>CHANGES</p> + +<p>Add a list of fixed issues which can be created using Jira.</p></li> +<li><p>RELEASE_NOTES</p> + +<p>Add additional notes regarding this release, eg known short comings.</p></li> +<li><p>BUILDING</p> + +<p>Even though the BUILDING file doesn't have any specific release information, it should be verified before making a release. </p></li> +<li><p>NOTICE</p> + +<p>If needed, add any new license related information to this file.</p></li> +</ul> + +<p>Besides this information, the version needs to be bumped. Even though every bundle has its own version, a release is made with one overall version. This version<br /> +is defined in the top-level CMakeLists.txt file.<br /> +Update the following pieces:</p> + +<pre><code>SET(CELIX_MAJOR "X") +SET(CELIX_MINOR "Y") +SET(CELIX_MICRO "Z") +</code></pre> + +<p>Note: The DEFAULT_VERSION property is used as default version for new bundles and as such does not need to be updated when making a release.</p> + +<h2>Compile and test</h2> + +<p>Before creating a branch, be sure that the source compiles and tests run successfully. If there are any known shortcomings, make sure they are listed in the<br /> +RELEASE_NOTES. Details for compiling and testing are available in the BUILDING file.</p> + +<pre><code>// Create a directory as sibling of the celix release directory +> mkdir celix-build +> cd celix-build +// Run CMake to generate the makefiles. Enable all BUILD options. +> ccmake ../celix +> make +> make deploy +> make test +</code></pre> + +<p>Also verify that the provides examples work as expected. If needed ask other committers to test parts, eg the GTK examples.</p> + +<pre><code>// Go to the deploy directory to see all examples +> cd deploy +// Test the different examples, eg +> cd hello_world +> sh run.sh +// Depending on the example the output might be different. Most examples provide a shell to inspect the framework. +// To list the commands use the "help" command. +-> help +.... +</code></pre> + +<p>After verifying the build, run Apache RAT to check for any licensing problems. If Apache RAT is configured in the CMake build the "rat" target can be used to run<br /> +the check.</p> + +<pre><code>// From the celix-build directory +// Run CMake to set the APACHE_RAT library (path to the JAR file). +> ccmake ../celix +// Run RAT +> make rat +</code></pre> + +<p>Apache RAT should not raise any concers, if there are, check the source files for<br /> +a license header. If it is a false positive update the rat-excludes.txt file in the root of the project. Be sure it is a false positive! If in doubt, ask the<br /> +mailing list! Third party licenses may need to be mentioned in the NOTICE file.</p> + +<h2>Create SVN tag</h2> + +<p>After changing all files a tag for the new release must be made. Before doing so, make sure all changed files are committed.</p> + +<p>The tag should be named like this: celix-X.Y.Z</p> + +<p>To make a tag use the following command:</p> + +<pre><code>svn copy http://svn.apache.org/repos/asf/celix/trunk/ \ + http://svn.apache.org/repos/asf/celix/tags/celix-X.Y.Z \ + -m "X.Y.Z release of the Apache Celix project." +</code></pre> + +<p>Note: Make sure there are no new changes made on trunk while working on the release. Discuss: Use a branch for staging the release and the files? Or possibly use a revision nr?</p> + +<h2>Create, sign and publish artefacts</h2> + +<p>Since Celix only releases source artefacts, creating the artefact is simple and straightforward</p> + +<pre><code>// Create symbolic link so the archive has a directory with version information +> ln -s celix celix-X.Y.Z +// Create GZip archive +> tar -hczf celix-X.Y.Z.tar.gz celix-X.Y.Z +// The create symbolic link can be removed +> celix celix-X.Y.Z +</code></pre> + +<p>After creating the artefact, the file has to be signed. More information about signing can be found at (http://www.apache.org/dev/release-signing.html).</p> + +<pre><code>// Generate MD5 checksum +> md5 celix-X.Y.Z.tar.gz > celix-X.Y.Z.tar.gz.md5 +// Generate SHA512 checksum +> gpg --print-md SHA512 celix-X.Y.Z.tar.gz > celix-X.Y.Z.tar.gz.sha +// Generate ASCII signature +> gpg --armor --output celix-X.Y.Z.tar.gz.asc --detach-sig celix-X.Y.Z.tar.gz +</code></pre> + +<p>Copy the archive of the source to the <a href="https://dist.apache.org/repos/dist/dev/incubator/celix/KEYS";>Apache Celix release development area</a> (using SVN).</p> + +<p>See the <a href="http://www.apache.org/dev/release.html#host-rc";>Apache Release Guide</a> for more information.</p> + +<h2>Run the vote</h2> + +<p>Before a release is official a vote has to be held. More information on voting can be found on <a href="http://www.apache.org/foundation/voting.html";>Apache Voting Process</a>.</p> + +<p>The first vote has to be done on the public mailinglist of the project itself ([email protected]). The following template must be used for this vote:</p> + +<p>================================================================================================================</p> + +<blockquote> + <p>To: [email protected]<br /> + Subject: [VOTE] Release Celix version X.Y.Z</p> + + <p>This is the release vote for Apache Celix, version X.Y.Z.</p> + + <p>It fixes the following issues:<br /> + {Create Release Note link using https://issues.apache.org/jira/secure/ReleaseNote.jspa?version=12323511}</p> + + <p>Source files:<br /> + https://dist.apache.org/repos/dist/dev/celix/celix-X.Y.Z/</p> + + <p>The tag to be voted upon:<br /> + http://svn.apache.org/repos/asf/celix/tags/celix-X.Y.Z/</p> + + <p>Celix's keys can be found at:<br /> + https://dist.apache.org/repos/dist/dev/incubator/celix/KEYS</p> + + <p>Information for voting on a release can be found at http://www.apache.org/dev/release.html#approving-a-release</p> + + <p>Please vote to approve this release:</p> + + <p>[ ] +1 Approve the release<br /> + [ ] -1 Disapprove the release (please provide specific comments)</p> + + <p>This vote will be open for at least 72 hours.</p> +</blockquote> + +<p>================================================================================================================</p> + +<p>After this first vote the results must be posted to the "dev" list, see below for more information.</p> + +<p>================================================================================================================</p> + +<p>Note: Be sure to use the [VOTE] tag, this is used by the automated vote tracking system to keep track of outstanding vote threads.</p> + +<h2>Post the vote results</h2> + +<p>As mentioned before, after each vote the results must be posted to the corresponding list. This "Result" vote contains the number of votes made, including<br /> +wether a vote is binding or not. For a successful vote the following template can be used.</p> + +<p>================================================================================================================</p> + +<blockquote> + <p>To: [email protected]<br /> + Subject: [RESULT][VOTE] Release Celix version X.Y.Z</p> + + <p>The vote has passed with the following result:</p> + + <p>+1 Name of Approver (apache ID) (binding|not binding)<br /> + +1 Name of Approver (apache ID) (binding|not binding)<br /> + ...</p> + + <p>{include additional details if needed}</p> + + <p>The released artifact will be moved to the release area for mirroring. After the mirroring period the release will be announced.</p> + + <p>Thanks for voting.</p> +</blockquote> + +<p>================================================================================================================</p> + +<p>Note: Be sure to post the vote result with the same topic as the original message. Also prepend the subject with [RESULT]. This is, again, needed to be able to keep track<br /> +of vote threads. </p> + +<h2>Roll out release artefacts</h2> + +<p>If the vote is passed successfully the release can be moved from the "dev" area to "release". The automated svnpubsub will move the artifact to the correct<br /> +server for mirroring. Mirroring typically can take up to 24 hours.</p> + +<p>Besides uploading the new release, the old release should be archived. Since archiving is already automated, it is only needed to delete the previous version from the release<br /> +area. See the <a href="http://www.apache.org/dev/release.html#when-to-archive";>Apache Release Guide</a> for more information.</p> + +<p>See the <a href="http://www.apache.org/dev/release.html#upload-ci";>Apache Release Guide</a> for more information.</p> + +<p>After these 24 hours the release can be announced.</p> + +<h2>Announce the release</h2> + +<p>Update website's <a href="http://celix.apache.org/index.html";>News</a> and <a href="http://celix.apache.org/download.html";>Download</a> sections to include the new release.</p> + +<p>On the "Download" page, the old release can be replaced with the new one, there is no need to keep a link to archived versions. The "News" section can simply be extended<br /> +with an additional entry.</p> + +<p>Additionally it is a good idea to post a message to "[email protected]" and "[email protected]". (note: the from address must be a [email protected] address).</p> + +<p>The following template must be used:</p> + +<p>================================================================================================================</p> + +<blockquote> + <p>To: [email protected], [email protected]<br /> + Subject: [ANNOUNCE] Apache Celix X.Y.Z released</p> + + <p>The Apache Celix team is pleased to announce the release of Celix X.Y.Z.</p> + + <p>Celix is an implementation of the OSGi specification adapted to C. It will follow the API<br /> + as close as possible, but since the OSGi specification is written primarily for Java, there<br /> + will be differences. An important aspect of the implementation is interoperability between<br /> + Java and C. This interoperability is achieved by porting and implementing the Remote<br /> + Services specification in Celix.</p> + + <p>This new release focusses on .... {add additional information for this release}</p> + + <p>The release is available here:<br /> + http://celix.apache.org/download.cgi</p> + + <p>The full change log is available here:<br /> + {Create Release Note link using https://issues.apache.org/jira/secure/ReleaseNote.jspa?version=12323511}</p> + + <p>We welcome your help and feedback. For more information on how to report problems,<br /> + and to get involved, visit the project website at http://celix.apache.org/</p> + + <p>The Apache Celix Team</p> +</blockquote> + +<p>================================================================================================================</p> +</div><div id="foot"> +<div id="footText"> +Copyright © 2011 The Apache Software Foundation, Licensed under the Apache License, Version 2.0. +Apache Celix, Celix, Apache, the Apache feather logo and the Apache Celix logo are trademarks of The Apache Software Foundation. +</div></div> +<script src='/import/javascript.js'></script> http://git-wip-us.apache.org/repos/asf/celix-site/blob/757e797e/site/support.html ---------------------------------------------------------------------- diff --git a/site/support.html b/site/support.html new file mode 100644 index 0000000..c95e14c --- /dev/null +++ b/site/support.html @@ -0,0 +1,117 @@ +<!DOCTYPE html> +<html lang="en"> +<head> +<!-- + Licensed to the Apache Software Foundation (ASF) under one or more + contributor license agreements. See the NOTICE file distributed with + this work for additional information regarding copyright ownership. + The ASF licenses this file to You under the Apache License, Version 2.0 + (the "License"); you may not use this file except in compliance with + the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE- 2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. +--> +<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> +<meta name="viewport" content="width=device-width, initial-scale=1.0"> +<link href="/import/style.css" rel="stylesheet"> +<link href="/import/friendly.css" rel="stylesheet"> +<!--page info--> +<title>Welcome to Apache Celix</title> +<meta name="description" content=""> +<meta name="author" content="me"> +</head> +<body> +<div id="imgbackground"></div> +<nav class = "shadowed"> + <a href="/"><img class="shadowed" src="/media/celix.png"></a> + <div id="mobmenu"> + <select class="mobbutton" onchange="if (this.value) window.location.href=this.value"> + <option value="">navigate</option> + <option value="/">Home</option> + <option value="/doc/">Documentation</option> + <option value="/downloads.html">Downloads</option> + <optgroup label="Community"> + <option value="/contributing.html">Contributing</option> + <option value="/boardreports.html">Board Reports</option> + <option value="/releasing.html">Releasing</option> + </optgroup> + <optgroup label="Support"> + <option value="/mailinglist.html">Mailing List</option> + <option value="/issuetracking.html">Issue Tracking</option> + </optgroup> + <optgroup label="ASF"> + <option value="http://www.apache.org/";>ASF Home</option> + <option value="http://www.apache.org/foundation/how-it-works.html";>How it works</option> + <option value="http://www.apache.org/licenses/";>License</option> + <option value="http://www.apache.org/foundation/sponsorship.html";>Sponsorship</option> + <option value="http://www.apache.org/foundation/thanks.html";>Thanks</option> + <option value="http://www.apache.org/security";>Security</option> + </optgroup> + </select> + <div id="dropmenu" class="shadowed"> + <a href="/"><div class="dropbutton"> + Home + </div></a><a href="/doc/"><div class="dropbutton"> + Documentation + </div></a><a href="/downloads.html"><div class="dropbutton"> + Download + </div></a><div class="dropdown"> + <div class="dropbutton">Community<div class="triangle"></div></div> + <div class="dropdown-content"> + <a href="/contributing.html">Contributing</a> + <a href="/boardreports.html">Board Reports</a> + <a href="/releasing.html">Releasing</a> + </div> + </div><div class="dropdown"> + <div class="dropbutton">Support<div class="triangle"></div></div> + <div class="dropdown-content"> + <a href="/mailinglist.html">Mailing List</a> + <a href="/issuetracking.html">Issue Tracking</a> + </div> + </div><div class="dropdown"> + <div class="dropbutton">ASF<div class="triangle"></div></div> + <div class="dropdown-content"> + <a href="http://www.apache.org/";>ASF Home</a> + <a href="http://www.apache.org/foundation/how-it-works.html";>How it works</a> + <a href="http://www.apache.org/licenses/";>License</a> + <a href="http://www.apache.org/foundation/sponsorship.html";>Sponsorship</a> + <a href="http://www.apache.org/foundation/thanks.html";>Thanks</a> + <a href="http://www.apache.org/security";>Security</a> + </div> + </div> + </div> + </div> +</nav> +<a href="https://github.com/apache/celix";> + <img class="GHImg shadowed" src="/media/forkmeongithub.png" alt="Fork me on GitHub" + data-canonical-src="https://s3.amazonaws.com/github/ribbons/forkme_left_orange_ff7600.png";> + <img class="GHImgSmall shadowed" src="/media/forkmesmall.png" alt="Fork me on GitHub"> +</a> +<a href="http://apache.org/";> + <img id="APbig" class="logoAP shadowed" src="/media/Apache_full.svg"> + <img id="APsmall" class="logoAP shadowed" src="/media/Apache_Feather.svg"> +</a> +<div class="spacer"> +<h1>Support</h1> + +<p>As detailed on the <a href="/community/community.html">Community</a> page, Celix is a community driven project. Support is<br /> +given by developers and users.</p> + +<p>To get in touch with developers and users, please use our:</p> + +<ul> +<li><a href="/support/mailinglist.html">Mailing List</a></li> +<li><a href="/support/issuetracking.html">Issue Tracking</a></li> +</ul> +</div><div id="foot"> +<div id="footText"> +Copyright © 2011 The Apache Software Foundation, Licensed under the Apache License, Version 2.0. +Apache Celix, Celix, Apache, the Apache feather logo and the Apache Celix logo are trademarks of The Apache Software Foundation. +</div></div> +<script src='/import/javascript.js'></script> http://git-wip-us.apache.org/repos/asf/celix-site/blob/757e797e/src/bottom.html ---------------------------------------------------------------------- diff --git a/src/bottom.html b/src/bottom.html index 8e2417f..8063802 100755 --- a/src/bottom.html +++ b/src/bottom.html @@ -3,4 +3,4 @@ Copyright © 2011 The Apache Software Foundation, Licensed under the Apache License, Version 2.0. Apache Celix, Celix, Apache, the Apache feather logo and the Apache Celix logo are trademarks of The Apache Software Foundation. </div></div> -<script src='import/javascript.js'></script> +<script src='/import/javascript.js'></script> http://git-wip-us.apache.org/repos/asf/celix-site/blob/757e797e/src/noprocess/import/friendly.css ---------------------------------------------------------------------- diff --git a/src/noprocess/import/friendly.css b/src/noprocess/import/friendly.css new file mode 100644 index 0000000..adb781c --- /dev/null +++ b/src/noprocess/import/friendly.css @@ -0,0 +1,69 @@ +.codehilite .hll { background-color: #ffffcc } +.codehilite { background: #f0f0f0; } +.codehilite .c { color: #60a0b0; font-style: italic } /* Comment */ +.codehilite .err { border: 1px solid #FF0000 } /* Error */ +.codehilite .k { color: #007020; font-weight: bold } /* Keyword */ +.codehilite .o { color: #666666 } /* Operator */ +.codehilite .ch { color: #60a0b0; font-style: italic } /* Comment.Hashbang */ +.codehilite .cm { color: #60a0b0; font-style: italic } /* Comment.Multiline */ +.codehilite .cp { color: #007020 } /* Comment.Preproc */ +.codehilite .cpf { color: #60a0b0; font-style: italic } /* Comment.PreprocFile */ +.codehilite .c1 { color: #60a0b0; font-style: italic } /* Comment.Single */ +.codehilite .cs { color: #60a0b0; background-color: #fff0f0 } /* Comment.Special */ +.codehilite .gd { color: #A00000 } /* Generic.Deleted */ +.codehilite .ge { font-style: italic } /* Generic.Emph */ +.codehilite .gr { color: #FF0000 } /* Generic.Error */ +.codehilite .gh { color: #000080; font-weight: bold } /* Generic.Heading */ +.codehilite .gi { color: #00A000 } /* Generic.Inserted */ +.codehilite .go { color: #888888 } /* Generic.Output */ +.codehilite .gp { color: #c65d09; font-weight: bold } /* Generic.Prompt */ +.codehilite .gs { font-weight: bold } /* Generic.Strong */ +.codehilite .gu { color: #800080; font-weight: bold } /* Generic.Subheading */ +.codehilite .gt { color: #0044DD } /* Generic.Traceback */ +.codehilite .kc { color: #007020; font-weight: bold } /* Keyword.Constant */ +.codehilite .kd { color: #007020; font-weight: bold } /* Keyword.Declaration */ +.codehilite .kn { color: #007020; font-weight: bold } /* Keyword.Namespace */ +.codehilite .kp { color: #007020 } /* Keyword.Pseudo */ +.codehilite .kr { color: #007020; font-weight: bold } /* Keyword.Reserved */ +.codehilite .kt { color: #902000 } /* Keyword.Type */ +.codehilite .m { color: #40a070 } /* Literal.Number */ +.codehilite .s { color: #4070a0 } /* Literal.String */ +.codehilite .na { color: #4070a0 } /* Name.Attribute */ +.codehilite .nb { color: #007020 } /* Name.Builtin */ +.codehilite .nc { color: #0e84b5; font-weight: bold } /* Name.Class */ +.codehilite .no { color: #60add5 } /* Name.Constant */ +.codehilite .nd { color: #555555; font-weight: bold } /* Name.Decorator */ +.codehilite .ni { color: #d55537; font-weight: bold } /* Name.Entity */ +.codehilite .ne { color: #007020 } /* Name.Exception */ +.codehilite .nf { color: #06287e } /* Name.Function */ +.codehilite .nl { color: #002070; font-weight: bold } /* Name.Label */ +.codehilite .nn { color: #0e84b5; font-weight: bold } /* Name.Namespace */ +.codehilite .nt { color: #062873; font-weight: bold } /* Name.Tag */ +.codehilite .nv { color: #bb60d5 } /* Name.Variable */ +.codehilite .ow { color: #007020; font-weight: bold } /* Operator.Word */ +.codehilite .w { color: #bbbbbb } /* Text.Whitespace */ +.codehilite .mb { color: #40a070 } /* Literal.Number.Bin */ +.codehilite .mf { color: #40a070 } /* Literal.Number.Float */ +.codehilite .mh { color: #40a070 } /* Literal.Number.Hex */ +.codehilite .mi { color: #40a070 } /* Literal.Number.Integer */ +.codehilite .mo { color: #40a070 } /* Literal.Number.Oct */ +.codehilite .sa { color: #4070a0 } /* Literal.String.Affix */ +.codehilite .sb { color: #4070a0 } /* Literal.String.Backtick */ +.codehilite .sc { color: #4070a0 } /* Literal.String.Char */ +.codehilite .dl { color: #4070a0 } /* Literal.String.Delimiter */ +.codehilite .sd { color: #4070a0; font-style: italic } /* Literal.String.Doc */ +.codehilite .s2 { color: #4070a0 } /* Literal.String.Double */ +.codehilite .se { color: #4070a0; font-weight: bold } /* Literal.String.Escape */ +.codehilite .sh { color: #4070a0 } /* Literal.String.Heredoc */ +.codehilite .si { color: #70a0d0; font-style: italic } /* Literal.String.Interpol */ +.codehilite .sx { color: #c65d09 } /* Literal.String.Other */ +.codehilite .sr { color: #235388 } /* Literal.String.Regex */ +.codehilite .s1 { color: #4070a0 } /* Literal.String.Single */ +.codehilite .ss { color: #517918 } /* Literal.String.Symbol */ +.codehilite .bp { color: #007020 } /* Name.Builtin.Pseudo */ +.codehilite .fm { color: #06287e } /* Name.Function.Magic */ +.codehilite .vc { color: #bb60d5 } /* Name.Variable.Class */ +.codehilite .vg { color: #bb60d5 } /* Name.Variable.Global */ +.codehilite .vi { color: #bb60d5 } /* Name.Variable.Instance */ +.codehilite .vm { color: #bb60d5 } /* Name.Variable.Magic */ +.codehilite .il { color: #40a070 } /* Literal.Number.Integer.Long */ http://git-wip-us.apache.org/repos/asf/celix-site/blob/757e797e/src/noprocess/import/style.css ---------------------------------------------------------------------- diff --git a/src/noprocess/import/style.css b/src/noprocess/import/style.css index dbcb978..849fa52 100755 --- a/src/noprocess/import/style.css +++ b/src/noprocess/import/style.css @@ -233,6 +233,12 @@ a { filter: drop-shadow(2px 2px 1px rgba(0,0,0,0.5)); } +.codehilite { + display: inline-block; + border-radius: 8px; + padding: 5px; +} + @media screen and (max-width: 1140px) { #APbig{display:none} #APsmall{display:block}
![https://s3.amazonaws.com/github/ribbons/forkme_left_orange_ff7600.png"](https://s3.amazonaws.com/github/ribbons/forkme_left_orange_ff7600.png"){kind=link}