You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@sling.apache.org by bd...@apache.org on 2017/11/21 17:38:33 UTC

[sling-site] branch asf-site updated: Document the Attic for retired code

This is an automated email from the ASF dual-hosted git repository.

bdelacretaz pushed a commit to branch asf-site
in repository https://gitbox.apache.org/repos/asf/sling-site.git


The following commit(s) were added to refs/heads/asf-site by this push:
     new 8f71432  Document the Attic for retired code
8f71432 is described below

commit 8f71432257864449191b5574212abecb8a600ea8
Author: Bertrand Delacretaz <bd...@apache.org>
AuthorDate: Tue Nov 21 18:31:24 2017 +0100

    Document the Attic for retired code
---
 documentation/the-sling-engine/resources.html | 6 ++++--
 project-information.html                      | 5 ++++-
 releases.html                                 | 2 +-
 3 files changed, 9 insertions(+), 4 deletions(-)

diff --git a/documentation/the-sling-engine/resources.html b/documentation/the-sling-engine/resources.html
index 93627ae..de815fc 100644
--- a/documentation/the-sling-engine/resources.html
+++ b/documentation/the-sling-engine/resources.html
@@ -226,11 +226,13 @@
 <p><em>This API is only available since Sling API 2.11.0 (<a href="https://issues.apache.org/jira/browse/SLING-4751">SLING-4751</a>).</em></p>
 <p>Register an OSGi service for <a href="https://svn.apache.org/repos/asf/sling/trunk/bundles/api/src/main/java/org/apache/sling/api/resource/observation/ResourceChangeListener.java"><code>org.apache.sling.api.resource.observation.ResourceChangeListener</code></a> to be notified about local changes. To be also notified about external changes (i.e. changes triggered by another Sling instance leveraging a clustered repository make sure that your service implementation also implements the m [...]
 <h3><a href="#osgi-event-admin" name="osgi-event-admin">OSGi Event Admin</a></h3>
-<p>Resource events are sent out via the OSGi Event Admin. You can subscribe to those event by registering an OSGi service for <a href="https://osgi.org/javadoc/r6/cmpn/org/osgi/service/event/EventHandler.html"><code>org.osgi.service.event.EventHandler</code></a>. Several properties should be used to restrict the subscription to only the relevant event. The event topics which are used for resources are listed as constants in <a href="http://sling.apache.org/apidocs/sling8/org/apache/sling [...]
+<p>Resource events are sent out via the OSGi Event Admin. You can subscribe to those event by registering an OSGi service for <a href="https://osgi.org/javadoc/r6/cmpn/org/osgi/service/event/EventHandler.html"><code>org.osgi.service.event.EventHandler</code></a>. Several properties should be used to restrict the subscription to only the relevant event. The event topics which are used for resources are listed as constants in <a href="http://sling.apache.org/apidocs/sling8/org/apache/sling [...]
+<p>You receive events no matter whether they originate from the local repository or from a remote clustered repository. You can check though in your event listener for the <a href="/apache-sling-eventing-and-job-handling.html#basic-principles">event attribute <code>event.application</code></a>, which is only set in case the event was triggered from an external resource modification (compare with <a href="https://sling.apache.org/apidocs/sling9/org/apache/sling/event/dea/DEAConstants.html [...]
+<p>The OSGi event handlers may be <a href="http://felix.apache.org/documentation/subprojects/apache-felix-event-admin.html#configuration">blacklisted by Apache Felix</a> in case the processing takes too long. Therefore dispatch all long-lasting operations to a new thread or start a new Sling Job.</p>
 <h2><a href="#wrap-decorate-resources" name="wrap-decorate-resources">Wrap/Decorate Resources</a></h2>
 <p>The Sling API provides an easy way to wrap or decorate a resource before returning. Details see <a href="/documentation/the-sling-engine/wrap-or-decorate-resources.html">Wrap or Decorate Resources</a>.</p></section></div></div>            
             <div class="footer">
-<div class="revisionInfo">Last modified by <span class="author">Konrad Windszus</span> on <span class="comment">Thu Oct 12 13:43:47 2017 +0200</span></div>                <p>
+<div class="revisionInfo">Last modified by <span class="author">Konrad Windszus</span> on <span class="comment">Tue Nov 21 15:59:55 2017 +0100</span></div>                <p>
                     Apache Sling, Sling, Apache, the Apache feather logo, and the Apache Sling project logo are trademarks of The Apache Software Foundation. All other marks mentioned may be trademarks or registered trademarks of their respective owners.
                 </p><p>
                     Copyright © 2011-2017 The Apache Software Foundation.
diff --git a/project-information.html b/project-information.html
index 3f15537..fe142e1 100644
--- a/project-information.html
+++ b/project-information.html
@@ -137,6 +137,9 @@
 <p>To check out the Sling source code, see the instructions from <a href="/documentation/development/getting-and-building-sling.html#getting-the-sling-source">Getting and building Sling</a>.</p>
 <h3><a href="#web-access" name="web-access">Web Access</a></h3>
 <p>The source code can be accessed using either the GitHub or GitBox setup, but the most convenient way is to use the GitHub search to display all Sling projects: <a href="https://github.com/apache/?q=sling">https://github.com/apache/?q=sling</a>.</p>
+<h3><a href="#attic" name="attic">Attic</a></h3>
+<p>A number of Sling modules that are not being developed further have been moved to the <a href="https://svn.apache.org/repos/asf/sling/attic/">Sling Attic</a> in the svn repository that we used until late 2017.</p>
+<p>Now that the Sling codebase is split in multiple Git repositories, we'll probably keep such modules in place but mark them as being retired. We haven't had such a case since the move to Git, we will clarify once that happens.</p>
 <h2><a href="#continuous-integration" name="continuous-integration">Continuous Integration</a></h2>
 <p>Sling builds run automatically on the <a href="https://builds.apache.org/">ASF's Jenkins instance</a>, triggered by commits.</p>
 <p>We maintain multiple build jobs, typically one or two per module. These are grouped into two views:</p>
@@ -170,7 +173,7 @@
   <li>Watch a <a href="http://s.apache.org/cms-anonymous-tutorial">video tutorial by Rob Weir for anonymous users</a>.</li>
 </ol></section></div></div>            
             <div class="footer">
-<div class="revisionInfo">Last modified by <span class="author">Robert Munteanu</span> on <span class="comment">Fri Nov 17 11:47:07 2017 +0200</span></div>                <p>
+<div class="revisionInfo">Last modified by <span class="author">Bertrand Delacretaz</span> on <span class="comment">Tue Nov 21 18:26:28 2017 +0100</span></div>                <p>
                     Apache Sling, Sling, Apache, the Apache feather logo, and the Apache Sling project logo are trademarks of The Apache Software Foundation. All other marks mentioned may be trademarks or registered trademarks of their respective owners.
                 </p><p>
                     Copyright © 2011-2017 The Apache Software Foundation.
diff --git a/releases.html b/releases.html
index 187a632..831022a 100644
--- a/releases.html
+++ b/releases.html
@@ -1627,7 +1627,7 @@
   <li>Commons LogService 2.0.6 (5th)</li>
 </ul></section></div></div>
             <div class="footer">
-<div class="revisionInfo">Last modified by <span class="author">Antonio Sanso</span> on <span class="comment">Mon Nov 20 13:18:33 2017 +0100</span></div>                <p>
+<div class="revisionInfo">Last modified by <span class="author">Radu Cotescu</span> on <span class="comment">Tue Nov 21 11:50:09 2017 +0100</span></div>                <p>
                     Apache Sling, Sling, Apache, the Apache feather logo, and the Apache Sling project logo are trademarks of The Apache Software Foundation. All other marks mentioned may be trademarks or registered trademarks of their respective owners.
                 </p><p>
                     Copyright © 2011-2017 The Apache Software Foundation.

-- 
To stop receiving notification emails like this one, please contact
['"commits@sling.apache.org" <co...@sling.apache.org>'].