You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@sling.apache.org by bu...@apache.org on 2015/08/11 18:25:55 UTC

svn commit: r961499 - in /websites/staging/sling/trunk/content: ./ documentation/bundles/configuration-installer-factory.html

Author: buildbot
Date: Tue Aug 11 16:25:55 2015
New Revision: 961499

Log:
Staging update by buildbot for sling

Modified:
    websites/staging/sling/trunk/content/   (props changed)
    websites/staging/sling/trunk/content/documentation/bundles/configuration-installer-factory.html

Propchange: websites/staging/sling/trunk/content/
------------------------------------------------------------------------------
--- cms:source-revision (original)
+++ cms:source-revision Tue Aug 11 16:25:55 2015
@@ -1 +1 @@
-1695296
+1695337

Modified: websites/staging/sling/trunk/content/documentation/bundles/configuration-installer-factory.html
==============================================================================
--- websites/staging/sling/trunk/content/documentation/bundles/configuration-installer-factory.html (original)
+++ websites/staging/sling/trunk/content/documentation/bundles/configuration-installer-factory.html Tue Aug 11 16:25:55 2015
@@ -39,7 +39,18 @@
     </div>
     
     <div class="menu"> 
-      <p><strong><a href="/documentation.html">Documentation</a></strong> <br />
+      <style type="text/css">
+/* The following code is added by mdx_elementid.py
+   It was originally lifted from http://subversion.apache.org/style/site.css */
+/*
+ * Hide class="elementid-permalink", except when an enclosing heading
+ * has the :hover property.
+ */
+.headerlink, .elementid-permalink {
+  visibility: hidden;
+}
+h2:hover > .headerlink, h3:hover > .headerlink, h1:hover > .headerlink, h6:hover > .headerlink, h4:hover > .headerlink, h5:hover > .headerlink, dt:hover > .elementid-permalink { visibility: visible }</style>
+<p><strong><a href="/documentation.html">Documentation</a></strong> <br />
 <a href="/documentation/getting-started.html">Getting Started</a> <br />
 <a href="/documentation/the-sling-engine.html">The Sling Engine</a> <br />
 <a href="/documentation/development.html">Development</a> <br />
@@ -90,8 +101,19 @@
       
       
       <h1>Configuration Installer Factory</h1>
-      <p>The configuration installer factory provides support for configurations to the <a href="/documentation/bundles/osgi-installer.html">OSGI installer</a>. The provisioning of artifacts is handled by installer providers like the file installer or the JCR installer.</p>
-<h2 id="configurations">Configurations</h2>
+      <style type="text/css">
+/* The following code is added by mdx_elementid.py
+   It was originally lifted from http://subversion.apache.org/style/site.css */
+/*
+ * Hide class="elementid-permalink", except when an enclosing heading
+ * has the :hover property.
+ */
+.headerlink, .elementid-permalink {
+  visibility: hidden;
+}
+h2:hover > .headerlink, h3:hover > .headerlink, h1:hover > .headerlink, h6:hover > .headerlink, h4:hover > .headerlink, h5:hover > .headerlink, dt:hover > .elementid-permalink { visibility: visible }</style>
+<p>The configuration installer factory provides support for configurations to the <a href="/documentation/bundles/osgi-installer.html">OSGI installer</a>. The provisioning of artifacts is handled by installer providers like the file installer or the JCR installer.</p>
+<h2 id="configurations">Configurations<a class="headerlink" href="#configurations" title="Permanent link">&para;</a></h2>
 <p>Configuration file names are related to the PID and factory PID. The structure of the file name is as follows:</p>
 <div class="codehilite"><pre><span class="n">filename</span> <span class="p">::=</span> <span class="o">&lt;</span><span class="n">pid</span><span class="o">&gt;</span> <span class="p">(</span> <span class="s">&#39;-&#39;</span> <span class="o">&lt;</span><span class="n">subname</span><span class="o">&gt;</span> <span class="p">)</span>? <span class="p">(</span><span class="s">&#39;.cfg&#39;</span><span class="o">|</span><span class="s">&#39;.config&#39;</span><span class="p">)</span>
 </pre></div>
@@ -107,7 +129,7 @@
 
 
 <p>If a configuration is modified, the file installer will write the configuration back to a file to ensure peristence across restarts (if <code>sling.fileinstall.writeback</code> is enabled).</p>
-<h3 id="property-files">Property Files</h3>
+<h3 id="property-files">Property Files<a class="headerlink" href="#property-files" title="Permanent link">&para;</a></h3>
 <p>Configuration files ending in '.cfg' are plain property files (<code>java.util.Property</code>). The format is simple:</p>
 <div class="codehilite"><pre><span class="n">file</span> <span class="p">::=</span> <span class="p">(</span> <span class="n">header</span> <span class="o">|</span> <span class="n">comment</span> <span class="p">)</span> <span class="o">*</span>
 <span class="n">header</span> <span class="p">::=</span> <span class="o">&lt;</span><span class="n">header</span><span class="o">&gt;</span> <span class="p">(</span> <span class="s">&#39;:&#39;</span> <span class="o">|</span> <span class="s">&#39;=&#39;</span> <span class="p">)</span> <span class="o">&lt;</span><span class="n">value</span><span class="o">&gt;</span> <span class="p">(</span> <span class="s">&#39;\&lt;nl&gt; &lt;value&gt; ) *</span>
@@ -121,7 +143,7 @@
 </pre></div>
 
 
-<h3 id="configuration-files">Configuration Files</h3>
+<h3 id="configuration-files">Configuration Files<a class="headerlink" href="#configuration-files" title="Permanent link">&para;</a></h3>
 <p>Configuration files ending in '.config' use the format of the Apache Felix ConfigAdmin implementation. It allows to specify the type and cardinality of a configuration property and is not limited to string values.</p>
 <p>The first line of such a file might start with a comment line (a line starting with a #). Comments within the file are not allowed.</p>
 <p>The format is:</p>
@@ -135,10 +157,11 @@
 <span class="n">values</span> <span class="p">::=</span> <span class="n">simple</span> <span class="p">{</span> <span class="s">&#39;,&#39;</span> <span class="n">simple</span> <span class="p">}</span> 
 <span class="n">simple</span> <span class="p">::=</span> <span class="s">&#39;&quot;&#39;</span> <span class="n">stringsimple</span> <span class="s">&#39;&quot;&#39;</span>
 <span class="n">type</span> <span class="p">::=</span> <span class="o">&lt;</span>1<span class="o">-</span><span class="n">char</span> <span class="n">type</span> <span class="n">code</span><span class="o">&gt;</span>
-<span class="n">stringsimple</span> <span class="p">::=</span> <span class="o">&lt;</span><span class="n">quoted</span> <span class="n">string</span> <span class="n">representation</span> <span class="n">of</span> <span class="n">the</span> <span class="n">value</span><span class="o">&gt;</span>
+<span class="n">stringsimple</span> <span class="p">::=</span> <span class="o">&lt;</span><span class="n">quoted</span> <span class="n">string</span> <span class="n">representation</span> <span class="n">of</span> <span class="n">the</span> <span class="n">value</span> <span class="n">where</span> <span class="n">both</span> <span class="s">&#39;&quot;&#39;</span> <span class="n">and</span> <span class="s">&#39;=&#39;</span> <span class="n">need</span> <span class="n">to</span> <span class="n">be</span> <span class="n">escaped</span><span class="o">&gt;</span>
 </pre></div>
 
 
+<p>The quoted string format is equal to the definition from HTTP 1.1 (<a href="http://www.w3.org/Protocols/rfc2616/rfc2616-sec2.html">RFC2616</a>), except that both '"' and '=' need to be escaped.</p>
 <p>The 1 character type code is one of:</p>
 <ul>
 <li>'T' : simple string</li>
@@ -151,12 +174,12 @@
 <li>'C' : Character</li>
 <li>'B' : Boolean</li>
 </ul>
-<h1 id="project-info">Project Info</h1>
+<h1 id="project-info">Project Info<a class="headerlink" href="#project-info" title="Permanent link">&para;</a></h1>
 <ul>
 <li>Configuration installer factory (<a href="http://svn.apache.org/repos/asf/sling/trunk/installer/factories/configuration">org.apache.sling.installer.factory.configuration</a>)</li>
 </ul>
       <div class="timestamp" style="margin-top: 30px; font-size: 80%; text-align: right;">
-        Rev. 1648494 by cziegeler on Tue, 30 Dec 2014 09:45:30 +0000
+        Rev. 1695337 by kwin on Tue, 11 Aug 2015 16:25:43 +0000
       </div>
       <div class="trademarkFooter"> 
         Apache Sling, Sling, Apache, the Apache feather logo, and the Apache Sling project