svn commit: r1416354 - /karaf/trunk/manual/src/main/webapp/users-guide/deployer.conf

[ff...@apache.org]

Author: ffang
Date: Mon Dec  3 06:09:03 2012
New Revision: 1416354

URL: http://svn.apache.org/viewvc?rev=1416354&view=rev
Log:
[KARAF-2043]Document caveats of Pax Url Wrap when used in Karaf Shell

Modified:
    karaf/trunk/manual/src/main/webapp/users-guide/deployer.conf

Modified: karaf/trunk/manual/src/main/webapp/users-guide/deployer.conf
URL: http://svn.apache.org/viewvc/karaf/trunk/manual/src/main/webapp/users-guide/deployer.conf?rev=1416354&r1=1416353&r2=1416354&view=diff
==============================================================================
--- karaf/trunk/manual/src/main/webapp/users-guide/deployer.conf (original)
+++ karaf/trunk/manual/src/main/webapp/users-guide/deployer.conf Mon Dec  3 06:09:03 2012
@@ -206,8 +206,23 @@ Export-Package =
         org.apache.commons.lang.text;uses:=org.apache.commons.lang,
         org.apache.commons.lang.time;uses:=org.apache.commons.lang
 
+{code}
+
+You may set the manifest headers by specifying them as URL parameters, '$' is used separate the hierarch path and query parts of the URL, with standard URL syntax for query parameters of key=value pairs joined by '&'.
+
+On the command line you must use single quotes around the URL to prevent the shell from attempting variable expansion, and if present, you must escape exclamation marks with a backslash.
 
 {code}
+install -s 'wrap:mvn:jboss/jbossall-client/4.2.3.GA/$Bundle-SymbolicName=jbossall-client&Bundle-Version=4.2.3.GA&Export-Package=org.jboss.remoting;version="4.2.3.GA",\!*'
+{code}
+
+When defined in a features.xml file, it's necessary to escape any ampersands and quotes, or use a CDATA tag.
+
+{code:lang=xml}
+<bundle>wrap:mvn:jboss/jbossall-client/4.3.2.GA/$Bundle-SymbolicName=jbossall-client&amp;Bundle-Version=4.3.2.GA&amp;Export-Package=org.jboss.remoting;version=&quot;4.3.2.GA&quot;,!*</bundle>
+{code}
+
+
 
 h2. Kar deployer