You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@felix.apache.org by cz...@apache.org on 2016/09/26 09:54:12 UTC
svn commit: r1762306 - in /felix/site/trunk/content/documentation:
development/ faqs/ subprojects/ subprojects/apache-felix-commons/
subprojects/apache-felix-dependency-manager/guides/
subprojects/apache-felix-dependency-manager/reference/ subprojects/...
Author: cziegeler
Date: Mon Sep 26 09:54:12 2016
New Revision: 1762306
URL: http://svn.apache.org/viewvc?rev=1762306&view=rev
Log:
FELIX-5361 : Felix Site: Fix external links to bndtools website. Apply patch from Stefan Seifert
Modified:
felix/site/trunk/content/documentation/development/bnd-testing-harness.mdtext
felix/site/trunk/content/documentation/faqs/apache-felix-bundle-plugin-faq.mdtext
felix/site/trunk/content/documentation/subprojects/apache-felix-commons/creating-bundles-using-bnd.mdtext
felix/site/trunk/content/documentation/subprojects/apache-felix-dependency-manager/guides/annotations.mdtext
felix/site/trunk/content/documentation/subprojects/apache-felix-dependency-manager/reference/component-factory-configuration-adapter.mdtext
felix/site/trunk/content/documentation/subprojects/apache-felix-dependency-manager/reference/dependency-configuration.mdtext
felix/site/trunk/content/documentation/subprojects/apache-felix-ipojo/apache-felix-ipojo-gettingstarted/ipojo-in-10-minutes.mdtext
felix/site/trunk/content/documentation/subprojects/apache-felix-maven-bundle-plugin-bnd.mdtext
felix/site/trunk/content/documentation/subprojects/apache-felix-sigil/sigil-user-guide/sigil-ivy/apache-felix-sigil-ivy-quickstart.mdtext
felix/site/trunk/content/documentation/subprojects/apache-felix-sigil/sigil-user-guide/sigil-properties.mdtext
Modified: felix/site/trunk/content/documentation/development/bnd-testing-harness.mdtext
URL: http://svn.apache.org/viewvc/felix/site/trunk/content/documentation/development/bnd-testing-harness.mdtext?rev=1762306&r1=1762305&r2=1762306&view=diff
==============================================================================
--- felix/site/trunk/content/documentation/development/bnd-testing-harness.mdtext (original)
+++ felix/site/trunk/content/documentation/development/bnd-testing-harness.mdtext Mon Sep 26 09:54:12 2016
@@ -1,6 +1,6 @@
Title: BND Testing Harness
-The latest versions of [BND](http://www.aqute.biz/Code/Bnd) have testing harness capabilities for JUnit built in. In fact, the OSGi Alliance uses BND for its own build and testing system. BND already provided lots of support for creating bundles, so testing is perhaps a logical progression of those capabilities. This task was simplified by a proposed standard framework launching and embedding API for the OSGi R4.2 specification, which BND uses to configure and launch OSGi frameworks in a platform-independent way. I should note that this BND functionality is in its early stages, so there are some rough edges.
+The latest versions of [BND](http://bnd.bndtools.org/) have testing harness capabilities for JUnit built in. In fact, the OSGi Alliance uses BND for its own build and testing system. BND already provided lots of support for creating bundles, so testing is perhaps a logical progression of those capabilities. This task was simplified by a proposed standard framework launching and embedding API for the OSGi R4.2 specification, which BND uses to configure and launch OSGi frameworks in a platform-independent way. I should note that this BND functionality is in its early stages, so there are some rough edges.
This document describes an example BND project used to test Felix' Framework and Logger subprojects. This document is not intended as a BND tutorial, since it is beyond my capabilities to describe how BND works. The goal is to document my hacked up example sufficiently so that other people can try it out for themselves. The original build files and configuration for this example are based on an example from Peter Kriens. BND also has an Eclipse plugin which makes it easy to run the test cases, but I have not experimented with that; this document works solely with the command line.
Modified: felix/site/trunk/content/documentation/faqs/apache-felix-bundle-plugin-faq.mdtext
URL: http://svn.apache.org/viewvc/felix/site/trunk/content/documentation/faqs/apache-felix-bundle-plugin-faq.mdtext?rev=1762306&r1=1762305&r2=1762306&view=diff
==============================================================================
--- felix/site/trunk/content/documentation/faqs/apache-felix-bundle-plugin-faq.mdtext (original)
+++ felix/site/trunk/content/documentation/faqs/apache-felix-bundle-plugin-faq.mdtext Mon Sep 26 09:54:12 2016
@@ -81,7 +81,7 @@ The latest maven-bundle-plugin (2.0.0) u
## When I build a bundle, some classes are built in "target/classes" but they're not included in the final jar.
-The only classes that will appear in the bundle are the ones you ask it to include using Export-Package, Private-Package, Include-Resource, and Embed-Dependency - so just because a file exists under target/classes does NOT mean it will end up in the bundle. This is because this is the way the underlying [BND](http://aqute.biz/Code/Bnd) tool works (it is primarily pull-based).
+The only classes that will appear in the bundle are the ones you ask it to include using Export-Package, Private-Package, Include-Resource, and Embed-Dependency - so just because a file exists under target/classes does NOT mean it will end up in the bundle. This is because this is the way the underlying [BND](http://bnd.bndtools.org/) tool works (it is primarily pull-based).
Now the bundleplugin will look at your Maven project and add appropriate BND instructions to pull in resource files - and version 2.0.0 will also look at your source directory to set reasonable defaults for Export-Package and Private-Package (unless you set these yourself). So when using bundleplugin 2.0.0 I'd use the default Private-Package and Export-Package to begin with - I would then move towards using an explicit list of packages in Export-Package to add versioning, directives, etc.
Modified: felix/site/trunk/content/documentation/subprojects/apache-felix-commons/creating-bundles-using-bnd.mdtext
URL: http://svn.apache.org/viewvc/felix/site/trunk/content/documentation/subprojects/apache-felix-commons/creating-bundles-using-bnd.mdtext?rev=1762306&r1=1762305&r2=1762306&view=diff
==============================================================================
--- felix/site/trunk/content/documentation/subprojects/apache-felix-commons/creating-bundles-using-bnd.mdtext (original)
+++ felix/site/trunk/content/documentation/subprojects/apache-felix-commons/creating-bundles-using-bnd.mdtext Mon Sep 26 09:54:12 2016
@@ -2,7 +2,7 @@ Title: Creating Bundles Using BND
##### Purpose
-Provide the list of steps required to create a library bundle by wrapping the library jar using bnd (http://www.aqute.biz/Code/Bnd).
+Provide the list of steps required to create a library bundle by wrapping the library jar using bnd (http://bnd.bndtools.org/).
##### Steps
@@ -78,7 +78,7 @@ Provide the list of steps required to cr
##### Resources
Bnd - Bundle Tool
-http://www.aqute.biz/Code/Bnd
+http://bnd.bndtools.org/
Bundle Plugin for Maven
http://felix.apache.org/site/maven-bundle-plugin-bnd.html
Modified: felix/site/trunk/content/documentation/subprojects/apache-felix-dependency-manager/guides/annotations.mdtext
URL: http://svn.apache.org/viewvc/felix/site/trunk/content/documentation/subprojects/apache-felix-dependency-manager/guides/annotations.mdtext?rev=1762306&r1=1762305&r2=1762306&view=diff
==============================================================================
--- felix/site/trunk/content/documentation/subprojects/apache-felix-dependency-manager/guides/annotations.mdtext (original)
+++ felix/site/trunk/content/documentation/subprojects/apache-felix-dependency-manager/guides/annotations.mdtext Mon Sep 26 09:54:12 2016
@@ -211,7 +211,7 @@ unless the properties starting with a d
a dot (".") are considered private and are not propagated.
Notice that you can mix standard bnd metatype annotations with DM annotations, in order
-describe configurations meta data (default values, property labels, etc ... see http://www.aqute.biz/Bnd/MetaType).
+describe configurations meta data (default values, property labels, etc ... see http://bnd.bndtools.org/chapters/210-metatype.html).
So, let's revisit our DisctionaryImpl service, but this time with meta type support:
First, we define an interface for describing our configuration metadata, with bnd metatype annotations:
Modified: felix/site/trunk/content/documentation/subprojects/apache-felix-dependency-manager/reference/component-factory-configuration-adapter.mdtext
URL: http://svn.apache.org/viewvc/felix/site/trunk/content/documentation/subprojects/apache-felix-dependency-manager/reference/component-factory-configuration-adapter.mdtext?rev=1762306&r1=1762305&r2=1762306&view=diff
==============================================================================
--- felix/site/trunk/content/documentation/subprojects/apache-felix-dependency-manager/reference/component-factory-configuration-adapter.mdtext (original)
+++ felix/site/trunk/content/documentation/subprojects/apache-felix-dependency-manager/reference/component-factory-configuration-adapter.mdtext Mon Sep 26 09:54:12 2016
@@ -84,7 +84,7 @@ annotated service class.
Returns the factory pid from a class name. The full class name will be used as the
configuration PID. You can use this method when you use an interface annoted with
-standard bndtols metatype annotations. (see http://www.aqute.biz/Bnd/MetaType).
+standard bndtols metatype annotations. (see http://bnd.bndtools.org/chapters/210-metatype.html).
----
**`updated`**
@@ -154,7 +154,7 @@ factory configuration instance matching
Here is the same example as above, but using a configuration type as well as meta types (the DM annotations metatype attributes are deprecated and
it's better to use standard bnd metatype annotations):
-First, we declare our factory configuration metadata using standard bndtools metatype annotations (see http://www.aqute.biz/Bnd/MetaType):
+First, we declare our factory configuration metadata using standard bndtools metatype annotations (see http://bnd.bndtools.org/chapters/210-metatype.html):
:::java
package sample;
Modified: felix/site/trunk/content/documentation/subprojects/apache-felix-dependency-manager/reference/dependency-configuration.mdtext
URL: http://svn.apache.org/viewvc/felix/site/trunk/content/documentation/subprojects/apache-felix-dependency-manager/reference/dependency-configuration.mdtext?rev=1762306&r1=1762305&r2=1762306&view=diff
==============================================================================
--- felix/site/trunk/content/documentation/subprojects/apache-felix-dependency-manager/reference/dependency-configuration.mdtext (original)
+++ felix/site/trunk/content/documentation/subprojects/apache-felix-dependency-manager/reference/dependency-configuration.mdtext Mon Sep 26 09:54:12 2016
@@ -111,7 +111,7 @@ In the following example, the "Printer"
This other example shows how to specify a configuration dependency, as well as meta data used to customize the
WebConsole GUI. Using these meta data, you can specify for example the default value for your
configurations data, some descriptions, the cardinality of configuration values, etc ...
-(we use here standard bnd metatype annotations, [see bnd metatype documentation here](http://www.aqute.biz/Bnd/MetaType).
+(we use here standard bnd metatype annotations, [see bnd metatype documentation here](http://bnd.bndtools.org/chapters/210-metatype.html).
First, we define our PrinterConfiguration interface annotated with standard bndtools metatatype annotations:
Modified: felix/site/trunk/content/documentation/subprojects/apache-felix-ipojo/apache-felix-ipojo-gettingstarted/ipojo-in-10-minutes.mdtext
URL: http://svn.apache.org/viewvc/felix/site/trunk/content/documentation/subprojects/apache-felix-ipojo/apache-felix-ipojo-gettingstarted/ipojo-in-10-minutes.mdtext?rev=1762306&r1=1762305&r2=1762306&view=diff
==============================================================================
--- felix/site/trunk/content/documentation/subprojects/apache-felix-ipojo/apache-felix-ipojo-gettingstarted/ipojo-in-10-minutes.mdtext (original)
+++ felix/site/trunk/content/documentation/subprojects/apache-felix-ipojo/apache-felix-ipojo-gettingstarted/ipojo-in-10-minutes.mdtext Mon Sep 26 09:54:12 2016
@@ -111,7 +111,7 @@ Once created, you can build the project
BUILD SUCCESSFUL
Total time: 0 seconds
-The created bundle is inside the output directory (spell.services.jar). The build process uses [BND](http://www.aqute.biz/Code/Bnd). The bundle manifest is described in the spell.services.bnd file.
+The created bundle is inside the output directory (spell.services.jar). The build process uses [BND](http://bnd.bndtools.org/). The bundle manifest is described in the spell.services.bnd file.
Once this project is done, we are able to implement a Dictionary service.
Modified: felix/site/trunk/content/documentation/subprojects/apache-felix-maven-bundle-plugin-bnd.mdtext
URL: http://svn.apache.org/viewvc/felix/site/trunk/content/documentation/subprojects/apache-felix-maven-bundle-plugin-bnd.mdtext?rev=1762306&r1=1762305&r2=1762306&view=diff
==============================================================================
--- felix/site/trunk/content/documentation/subprojects/apache-felix-maven-bundle-plugin-bnd.mdtext (original)
+++ felix/site/trunk/content/documentation/subprojects/apache-felix-maven-bundle-plugin-bnd.mdtext Mon Sep 26 09:54:12 2016
@@ -1,6 +1,6 @@
Title: Apache Felix Maven Bundle Plugin (BND)
-This plugin for Maven 2/3 is based on the [BND](http://www.aqute.biz/Bnd/Bnd) tool from Peter Kriens. The way BND works is by treating your project as a big collection of classes (e.g., project code, dependencies, and the class path). The way you create a bundle with BND is to tell it the content of the bundle's JAR file as a subset of the available classes. This plugin wraps BND to make it work specifically with the Maven 2 project structure and to provide it with reasonable default behavior for Maven 2 projects.
+This plugin for Maven 2/3 is based on the [BND](http://bnd.bndtools.org/) tool from Peter Kriens. The way BND works is by treating your project as a big collection of classes (e.g., project code, dependencies, and the class path). The way you create a bundle with BND is to tell it the content of the bundle's JAR file as a subset of the available classes. This plugin wraps BND to make it work specifically with the Maven 2 project structure and to provide it with reasonable default behavior for Maven 2 projects.
<div class="info" markdown="1">If you have questions about the maven-bundle-plugin please read the <a href="../faqs/apache-felix-bundle-plugin-faq.html" class="external-link" rel="nofollow">FAQ</a> first. If you still have questions you can ask them on the <a href="http://felix.apache.org/site/mailinglists.html" class="external-link" rel="nofollow">Felix user list</a>.</div>
@@ -12,7 +12,7 @@ Since the 1.4.0 release, this plugin als
<a href="http://felix.apache.org/components/bundle-plugin/index.html" class="external-link" rel="nofollow">
Full Maven Site Plugin documentation for the current release of the maven-bundle-plugin</a></div>
-<div class="tip" markdown="1"><a href="http://www.aqute.biz/Bnd/Format" class="external-link" rel="nofollow">A complete list of instructions and their format is available from the BND website</a></div>
+<div class="tip" markdown="1"><a href="http://bnd.bndtools.org/chapters/790-format.html" class="external-link" rel="nofollow">A complete list of instructions and their format is available from the BND website</a></div>
# Simple Example
@@ -59,7 +59,7 @@ The BND library underlying the plugin de
1. *Variables* \- Any instruction starting with a lowercase letter is assumed to be a variable in the form of a name-value pair, such as `version=3.0`, that can be used for property substitution, but is not copied to the manifest.
1. *Directives* \- Any instruction starting with a '-' character is considered to be a directive that informs BND to perform some special processing and is not copied to the manifest.
-The remainder of this section covers the most important aspects of BND's instructions; for complete details refer to the [BND documentation](http://www.aqute.biz/Code/Bnd).
+The remainder of this section covers the most important aspects of BND's instructions; for complete details refer to the [BND documentation](http://bnd.bndtools.org/).
@@ -482,7 +482,7 @@ configuration options:
* *`obrDeploymentRepository`* optional OBR specific deployment repository.
* *`ignoreLock`* ignore remote locking when updating the OBR
-There are also new instructions available from the underlying BND tool, which continues to be improved independently; for the latest see [BND documentation](http://aqute.biz/Code/Bnd).
+There are also new instructions available from the underlying BND tool, which continues to be improved independently; for the latest see [BND documentation](http://bnd.bndtools.org/).
The default goal *`bundle`* will be initialized by setting the <packaging> entry to "bundle".
Modified: felix/site/trunk/content/documentation/subprojects/apache-felix-sigil/sigil-user-guide/sigil-ivy/apache-felix-sigil-ivy-quickstart.mdtext
URL: http://svn.apache.org/viewvc/felix/site/trunk/content/documentation/subprojects/apache-felix-sigil/sigil-user-guide/sigil-ivy/apache-felix-sigil-ivy-quickstart.mdtext?rev=1762306&r1=1762305&r2=1762306&view=diff
==============================================================================
--- felix/site/trunk/content/documentation/subprojects/apache-felix-sigil/sigil-user-guide/sigil-ivy/apache-felix-sigil-ivy-quickstart.mdtext (original)
+++ felix/site/trunk/content/documentation/subprojects/apache-felix-sigil/sigil-user-guide/sigil-ivy/apache-felix-sigil-ivy-quickstart.mdtext Mon Sep 26 09:54:12 2016
@@ -10,7 +10,7 @@ Sigil provides a custom Ivy resolver, wh
The plugin works by intercepting the ivy.xml parser and dynamically replacing any dependencies with the results of resolving the OSGi Package-Imports specified in sigil.properties. Sigil can resolve dependencies using a local directory of OSGi bundles, or using an [OBR repository](http://www.osgi.org/Repository/).
-The plugin also provides an Ant task to generate (multiple) OSGi bundles from each sigil.properties file using [Bnd](http://www.aqute.biz/Code/Bnd). sigil.properties is similar to .bnd instruction files, but it supports multiple bundles.
+The plugin also provides an Ant task to generate (multiple) OSGi bundles from each sigil.properties file using [Bnd](http://bnd.bndtools.org/). sigil.properties is similar to .bnd instruction files, but it supports multiple bundles.
This Quick Start is based on the Ivy [project dependencies](http://ant.apache.org/ivy/history/latest-milestone/tutorial/dependence.html) tutorial, modified to use Sigil. The modified example is in `example/dependence` in the Sigil download.
Modified: felix/site/trunk/content/documentation/subprojects/apache-felix-sigil/sigil-user-guide/sigil-properties.mdtext
URL: http://svn.apache.org/viewvc/felix/site/trunk/content/documentation/subprojects/apache-felix-sigil/sigil-user-guide/sigil-properties.mdtext?rev=1762306&r1=1762305&r2=1762306&view=diff
==============================================================================
--- felix/site/trunk/content/documentation/subprojects/apache-felix-sigil/sigil-user-guide/sigil-properties.mdtext (original)
+++ felix/site/trunk/content/documentation/subprojects/apache-felix-sigil/sigil-user-guide/sigil-properties.mdtext Mon Sep 26 09:54:12 2016
@@ -19,7 +19,7 @@ The sub-property type allows values to b
The -defaults mechanism allows projects to share common bundle headers and default package import versions.
-Most values are passed to [Bnd](http://www.aqute.biz/Code/Bnd), so Bnd syntax can usually be used, for example: -resources: @lib, to embed a library.
+Most values are passed to [Bnd](http://bnd.bndtools.org/), so Bnd syntax can usually be used, for example: -resources: @lib, to embed a library.
## Reference