.github/pull_request_template.md

@@ -1,7 +0,0 @@
-Thank you for your contribution!
-
-Before creating a Pull Request, please make sure to
-* read https://github.com/igniterealtime/Smack/wiki/Guidelines-for-Smack-Developers-and-Contributors
-* run `gradle check` successfully in order to make sure that your code does not break any JUnit tests and is conform to the projects code style.
-* (if applicable) mention any Jira issue codes (eg. `SMACK-XXX`) in the *body* of your commit message (not the header), so that Jira automatically links the PR to the issue.
-* squash your commits if possible/sensible.

.github/workflows/ci.yml

@@ -1,96 +0,0 @@
-name: CI
-
-on: [push, pull_request]
-
-jobs:
-  build:
-    name: Build Smack
-
-    runs-on: ubuntu-24.04
-    strategy:
-      matrix:
-        java:
-          - 17
-          - 21
-    env:
-      PRIMARY_JAVA_VERSION: 21
-
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v3
-
-      - name: Set up JDK ${{ matrix.java }}
-        uses: actions/setup-java@v3
-        with:
-          java-version: ${{ matrix.java }}
-          distribution: temurin
-
-      # Caches
-      - name: Cache Maven
-        uses: actions/cache@v2
-        with:
-          path: ~/.m2/repository
-          key: maven-${{ hashFiles('**/build.gradle') }}
-          restore-keys: |
-            maven-
-      - name: Cache Gradle
-        uses: actions/cache@v2
-        with:
-          path: ~/.gradle/caches
-          key: gradle-caches-${{ hashFiles('**/build.gradle') }}
-          restore-keys:
-            gradle-caches
-      - name: Cache Android SDK
-        uses: actions/cache@v2
-        with:
-          path: |
-            ~/.android/sdk
-          key: android-${{ hashFiles('build.gradle') }}
-          restore-keys: |
-            android-
-
-      # Pre-reqs
-      - name: Install GraphViz
-        run: sudo apt update && sudo apt install graphviz
-      - name: Install Android SDK Manager
-        uses: android-actions/setup-android@v3
-      - name: Install Android SDK
-        run: |
-          sdkmanager "platforms;android-23"
-
-      # Testing
-      - name: Gradle Check
-        run: ./gradlew check --stacktrace
-
-      # Test local publish
-      - name: Gradle publish
-        run: ./gradlew publishToMavenLocal --stacktrace
-
-      # Javadoc
-      - name: Javadoc
-        if: ${{ matrix.java == env.PRIMARY_JAVA_VERSION }}
-        run: ./gradlew javadocAll --stacktrace
-
-      # Test Coverage Report
-      - name: Aggregated Jacoco Test Coverage Report
-        if: ${{ matrix.java == env.PRIMARY_JAVA_VERSION }}
-        run: |
-          ./gradlew smack-java11-full:testCodeCoverageReport
-
-      # Coveralls
-      - name: Report coverage stats to Coveralls
-        if: ${{ matrix.java == env.PRIMARY_JAVA_VERSION }}
-        uses: coverallsapp/github-action@v2
-        with:
-          format: jacoco
-          file: smack-java11-full/build/reports/jacoco/testCodeCoverageReport/testCodeCoverageReport.xml
-
-      # Upload build artifacts
-      - name: Upload build artifacts
-        uses: actions/upload-artifact@v4
-        with:
-          name: smack-java-${{ matrix.java }}
-          path: |
-            smack-*/build/libs/*.jar
-            !**/*-test-fixtures.jar
-            !**/*-tests.jar

.gitignore

@@ -1,9 +1,6 @@
 # IntelliJ
 .idea
 *.iml
-*.ipr
-*.iws
-!.idea/icon.svg
 
 # Mac OS X
 .DS_Store
@@ -12,13 +9,13 @@
 .project
 .settings
 .gradle
+gradle.properties
 
 build/
 core/build/
 debug/build/
 experimental/build/
 extensions/build/
-out/
 
 bin/
 core/bin
@@ -28,5 +25,3 @@ extensions/bin
 
 target/
 .metadata
-
-local.properties

.idea/icon.svg

@@ -1,89 +0,0 @@
-<?xml version="1.0" encoding="UTF-8" standalone="no"?>
-<svg
-   xmlns:dc="http://purl.org/dc/elements/1.1/"
-   xmlns:cc="http://creativecommons.org/ns#"
-   xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
-   xmlns:svg="http://www.w3.org/2000/svg"
-   xmlns="http://www.w3.org/2000/svg"
-   xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd"
-   xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape"
-   viewBox="0 0 399.2693 389.25732"
-   height="389.25732"
-   width="399.26932"
-   xml:space="preserve"
-   id="svg2"
-   version="1.1"
-   inkscape:version="0.91 r13725"
-   sodipodi:docname="smack-logo-plain.svg"><sodipodi:namedview
-     pagecolor="#ffffff"
-     bordercolor="#666666"
-     borderopacity="1"
-     objecttolerance="10"
-     gridtolerance="10"
-     guidetolerance="10"
-     inkscape:pageopacity="0"
-     inkscape:pageshadow="2"
-     inkscape:window-width="834"
-     inkscape:window-height="1044"
-     id="namedview3432"
-     showgrid="false"
-     fit-margin-top="0"
-     fit-margin-left="0"
-     fit-margin-right="0"
-     fit-margin-bottom="0"
-     inkscape:zoom="0.65684805"
-     inkscape:cx="238.37045"
-     inkscape:cy="159.12321"
-     inkscape:window-x="2520"
-     inkscape:window-y="0"
-     inkscape:window-maximized="0"
-     inkscape:current-layer="svg2" /><metadata
-     id="metadata8"><rdf:RDF><cc:Work
-         rdf:about=""><dc:format>image/svg+xml</dc:format><dc:type
-           rdf:resource="http://purl.org/dc/dcmitype/StillImage" /><dc:title></dc:title></cc:Work></rdf:RDF></metadata><defs
-     id="defs6"><clipPath
-       id="clipPath18"
-       clipPathUnits="userSpaceOnUse"><path
-         id="path16"
-         d="M 0,600 800,600 800,0 0,0 Z"
-         inkscape:connector-curvature="0" /></clipPath><clipPath
-       id="clipPath30"
-       clipPathUnits="userSpaceOnUse"><path
-         id="path28"
-         d="m 351.001,359.31 c -17.234,-7.3 -51.945,15.909 -51.945,15.909 l 0,0 c 0,0 31.115,-33.702 27.068,-47.102 l 0,0 c -4.048,-13.401 -44.827,-30.694 -44.827,-30.694 l 0,0 c 0,0 51.173,5.823 53.705,-8.205 l 0,0 c 2.528,-14.031 -3.951,-54.186 -3.951,-54.186 l 0,0 c 0,0 25.887,37.471 39.897,36.872 l 0,0 c 14.012,-0.597 39.902,-36.872 39.902,-36.872 l 0,0 c 0,0 -14.178,43.955 -3.952,54.186 l 0,0 c 10.225,10.229 53.706,8.205 53.706,8.205 l 0,0 c 0,0 -43.02,12.932 -44.827,30.694 l 0,0 c -1.81,17.759 27.07,47.102 27.07,47.102 l 0,0 c 0,0 -35.718,-23.04 -51.948,-15.909 l 0,0 c -16.232,7.13 -19.951,50.533 -19.951,50.533 l 0,0 c 0,0 -2.718,-43.232 -19.947,-50.533"
-         inkscape:connector-curvature="0" /></clipPath><radialGradient
-       id="radialGradient40"
-       spreadMethod="pad"
-       gradientTransform="matrix(89.254456,0,0,-89.254456,370.9502,322.4375)"
-       gradientUnits="userSpaceOnUse"
-       r="1"
-       cy="0"
-       cx="0"
-       fy="0"
-       fx="0"><stop
-         id="stop36"
-         offset="0"
-         style="stop-opacity:1;stop-color:#fdbe10" /><stop
-         id="stop38"
-         offset="1"
-         style="stop-opacity:1;stop-color:#f16422" /></radialGradient></defs><g
-     transform="matrix(1.3333333,0,0,-1.3333333,-294.96293,630.13412)"
-     id="g10"><g
-       id="g12"><g
-         clip-path="url(#clipPath18)"
-         id="g14"><g
-           transform="translate(370.9482,472.6006)"
-           id="g20"><path
-             id="path22"
-             style="fill:#fdbe10;fill-opacity:1;fill-rule:nonzero;stroke:none"
-             d="m 0,0 c 0,0 6.213,-72.485 33.318,-84.392 27.104,-11.905 86.753,26.569 86.753,26.569 0,0 -48.228,-49.006 -45.209,-78.665 3.022,-29.661 74.864,-51.262 74.864,-51.262 0,0 -72.61,3.382 -89.688,-13.703 -17.078,-17.084 6.597,-90.49 6.597,-90.49 0,0 -43.237,60.579 -66.635,61.578 -23.4,1.003 -66.633,-61.578 -66.633,-61.578 0,0 10.826,67.062 6.601,90.49 -4.229,23.431 -89.694,13.703 -89.694,13.703 0,0 68.108,28.882 74.865,51.262 6.757,22.378 -45.21,78.665 -45.21,78.665 0,0 57.978,-38.76 86.757,-26.569 C -4.54,-72.2 0,0 0,0"
-             inkscape:connector-curvature="0" /></g></g></g><g
-       id="g24"><g
-         clip-path="url(#clipPath30)"
-         id="g26"><g
-           id="g32"><g
-             id="g34"><path
-               id="path42"
-               style="fill:url(#radialGradient40);stroke:none"
-               d="m 351.001,359.31 c -17.234,-7.3 -51.945,15.909 -51.945,15.909 l 0,0 c 0,0 31.115,-33.702 27.068,-47.102 l 0,0 c -4.048,-13.401 -44.827,-30.694 -44.827,-30.694 l 0,0 c 0,0 51.173,5.823 53.705,-8.205 l 0,0 c 2.528,-14.031 -3.951,-54.186 -3.951,-54.186 l 0,0 c 0,0 25.887,37.471 39.897,36.872 l 0,0 c 14.012,-0.597 39.902,-36.872 39.902,-36.872 l 0,0 c 0,0 -14.178,43.955 -3.952,54.186 l 0,0 c 10.225,10.229 53.706,8.205 53.706,8.205 l 0,0 c 0,0 -43.02,12.932 -44.827,30.694 l 0,0 c -1.81,17.759 27.07,47.102 27.07,47.102 l 0,0 c 0,0 -35.718,-23.04 -51.948,-15.909 l 0,0 c -16.232,7.13 -19.951,50.533 -19.951,50.533 l 0,0 c 0,0 -2.718,-43.232 -19.947,-50.533"
-               inkscape:connector-curvature="0" /></g></g></g></g></g></svg>

.mailmap

@@ -1,27 +0,0 @@
-Paul Schaub <vanitasvitae@fsfe.org>
-Aditya Borikar <adityaborikar2@gmail.com>
-Anno van Vliet <annovanvliet@gmail.com>
-Daryl E. Herzmann <akrherz@iastate.edu>
-Damian Minkov <damencho@jitsi.org>
-Craig Hesling <craig@hesling.com>
-Dave Stanley <dave.stanley@gossinteractive.com>
-Marcel Heckel <marcel.heckel@ivi.fraunhofer.de>
-Candy Lohse <candy.lohse@ivi.fraunhofer.de>
-Luca Stucchi <stucchi@skebby.it>
-Luke Granger-Brown <git@lukegb.com>
-Florian Kimmann <florian.kimmann@tu-dortmund.de>
-Adam Stawicki <adamstawicki91@gmail.homas>
-Andrey Sokolov <andrey.sokolov@billing.ru>
-Andri Khrisharyadi <andri.khrisharyadi@gmail.com>
-Andriy Tsykholyas <andriy.tsykholyas@gmail.com>
-Fernando Ramirez <f.e.ramirez94@gmail.com>
-Marcel Heckel <marcel.heckel@ivi.fraunhofer.de>
-Robin Collier <rcollier@b35dd754-fafc-0310-a699-88a17e54d16e>
-Thibaut Le Guilly <leguilly.thibaut@gmail.com>
-Thomas Pocreau <thomas.pocreau@iadvize.com>
-Vadim Fite <vadim.fite@quickblox.com>
-Vaibhav Ranglani <vaibhav.ranglani@talentica.com>
-Xiaowei YAN <xwyan@minigui.org>
-
-Guus der Kinderen <guus.der.kinderen@gmail.com> guus <guus@b35dd754-fafc-0310-a699-88a17e54d16e>
-Jesus Fuentes <fuentes.jesus1010010@gmail.com> Jesus <fuentes31j@gmail.com>

.travis.yml

@@ -0,0 +1,7 @@
+language: android
+android:
+  components:
+    - android-8
+install: gradle assemble
+script: gradle check
+

DEVELOPING.md

@@ -1,163 +0,0 @@
-# Building Smack
-
-## Linux
-
-Building Smack is as simple as
-
-```
-git clone git@github.com:igniterealtime/Smack.git
-cd Smack
-gradle assemble
-```
-
-## Mac
-
-Smack requires a case-sensitive file system in order to build. Unfortunately, the macOS operating system is case-insensitive by default.
-To get around this, you can create a case-sensitive disk image to work from.
-
-1. Launch Disk Utility (Applications > Utilities)
-2. Click the +, or go to Edit > Add APFS Volume
-3. Give it a name, e.g. "Smack"
-4. Change the format to "APFS (Case-sensitive)"
-5. Click Add
-
-It'll auto-mount into /Volumes, e.g. /Volumes/Smack
-
-```bash
-cd /Volumes/Smack
-git clone git@github.com:igniterealtime/Smack.git
-cd Smack
-gradle assemble
-```
-
-## Windows
-
-Smack requires a case-sensitive file system in order to build. Unfortunately, Windows NTFS is case-insensitive by default.
-To get around this, you can set specific folders as case-sensitive (requires Windows 10 v1803 or higher).
-
-In an Administrator console:
-
-```batch
-fsutil.exe file SetCaseSensitiveInfo C:\git\Smack enable
-cd \git\Smack
-git clone git@github.com:igniterealtime/Smack.git
-cd Smack
-gradle assemble
-```
-
-# IDE Config
-
-### Eclipse
-
-Import IDE settings from `./resources/eclipse/` to configure proper ordering of imports and correct formatting that should pass the CheckStyle rules.
-
-### IntelliJ IDEA
-
-Import Java Code Style settings from `./resources/intellij/smack_formatter.xml` to configure import optimisation and code formatting to pass the CheckStyle rules when building or submitting PRs.
-
-_We've noticed, at time of writing, that IntelliJ often requires a restart when applying new rules - no amount of OK/Apply will do the trick._
-
-# Smack Providers
-
-Providers are responsible for parsing the XMPP XML stream into new Java objects.
-
-## Provider Design
-
-Assume you want to parse the following stanza extension element
-
-```xml
-<myExtension attrFoo='fourthyTwo'>
-  <myElement>Foo is greater then Bar</myElement>
-  <myInfo alpha='true' delta='-1337'/>
-</myExtension>
-```
-
-then the related provider would look like this
-
-```java
-public MyExtension parse(XmlPullParser parser, int initialDepth) {
-  MyElement myElement = null;
-  MyInfo myInfo = null;
-  String attrFoo = parser.getAttributeValue("", "attrFoo");
-
-  // Main parsing loop, use a loop label instead of "boolean done"
-  outerloop: while(true) {
-    // Make sure to have already parse all attributes of the outermost element,
-    // i.e. 'attrFoo' of 'myExtension' in this example. Then advance the parser
-    XmlPullParser.Event event = parser.next();
-
-    // Use switch/case of int instead of a if/else-if cascade
-    switch (event) {
-    case START_ELEMENT:
-      // Determine the name of the element which start tag we are seeing
-      String name = parser.getName();
-      // We can use switch/case of Strings since Java7, make use of its advantages
-      // and collect the values of the sub elements. If the sub elements are more
-      // complex then those of this example, consider creating extra *private static*
-      // parsing methods for them.
-      switch(name) {
-      case "myElement":
-        // You should only use XmlPullParser.nextText() when the element is
-        // required to have a text.
-        myElement = new MyElement(parser.nextText());
-        break;
-      case "myInfo";
-        // Use ParserUtils to parse Java primitives
-        boolenan alpha = ParserUtils.getBooleanAttribute(parser, "alpha");
-        int delta = ParserUtils.getIntegerAttribute(parser, "delta");
-        myInfo = new MyInfo(alpha, delta);
-        break;
-      }
-      break;
-    case END_ELEMENT:
-      // The abort condition with the break labeled loop statement
-      if (parser.getDepth() == initialDepth) {
-        break outerloop;
-      }
-      break;
-    default:
-      // Catch all for incomplete switch (MissingCasesInEnumSwitch) statement.
-      break;
-    }
-  }
-
-  // Create the actual class at the very end, design the classes as immutable as possible
-  return new MyExtension(attrFoo, myElement, myInfo);
-}
-```
-
-## Common Pitfalls
-
-Use a `long` instead of `int` when the XML schema says `xs:unsignedInt`, because Java's `int` range is to small for this XML numeric data type.
-
-# Stanzas
-## General Rules
-
-All classes which subclass `TopLevelStreamElement` and `ExtensionElement` must either
-
-1. be immutable (and ideally provide a Builder)
-2. implement `TypedCloneable`
-
-and must be `Serializable`.
-The reason that it must be either 1. or 2. is that it makes no sense to clone an inmutable instance.
-The preferred option is 1.
-
-Note that there is legacy code in Smack which does not follow these rules. Patches are welcome.
-
-## ExtensionElement
-
-Extension elements are XML elements that are used in various parts and levels of stanzas.
-
-## The static `from(Stanza)` Method
-
-Every ExtensionElement class must have a static `from()` method that retrieves that extension for a given Stanza (if any).
-
-Sample Code
-
-```java
-public static RSMSet from(Stanza) {
-  return packet.getExtension(ELEMENT, NAMESPACE);
-}
-```
-
-Sometimes certain ExtensionElement's are only found in one stanza type, in that case, specify the parameter type. For example `public static CarbonExtension getFrom(Message)`.

LICENSE

@@ -175,28 +175,3 @@
       of your accepting any such warranty or additional liability.
 
    END OF TERMS AND CONDITIONS
-
-   APPENDIX: How to apply the Apache License to your work.
-
-      To apply the Apache License to your work, attach the following
-      boilerplate notice, with the fields enclosed by brackets "[]"
-      replaced with your own identifying information. (Don't include
-      the brackets!)  The text should be enclosed in the appropriate
-      comment syntax for the file format. We also recommend that a
-      file or class name and description of purpose be included on the
-      same "printed page" as the copyright notice for easier
-      identification within third-party archives.
-
-   Copyright [yyyy] [name of copyright owner]
-
-   Licensed 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.

Makefile

@@ -1,30 +0,0 @@
-GRADLE ?= ./gradlew
-
-.PHONY: all
-all: check jacocoRootReport javadocAll sinttest
-
-.PHONY: codecov
-codecov:
-	$(GRADLE) smack-java11-full:testCodeCoverageReport
-	echo "Report available at smack-java11-full/build/reports/jacoco/testCodeCoverageReport/html/index.html"
-
-.PHONY: check
-check:
-	$(GRADLE) $@
-
-.PHONY: eclipse
-eclipse:
-	$(GRADLE) $@
-
-.PHONY: sinttest
-sinttest:
-	$(GRADLE) $@
-
-.PHONY: jacocoRootReport
-jacocoRootReport:
-	$(GRADLE) $@
-
-.PHONY: javadocAll
-javadocAll:
-	$(GRADLE) $@
-	echo "Smack javadoc available at build/javadoc/index.html"

NOTICE

@@ -1,105 +0,0 @@
-                 Smack
-
-       An open-source XMPP library
-      maintained by Florian Schmaus
-
- https://igniterealtime.org/projects/smack
-
-
-Authors:
-
-Abmar Barros
-Aditya Borikar
-Alexander Tovstonozhenko
-Alex Wenckus
-Andrew Wright
-Andrey Prokopenko
-Andrey Sokolov
-Andrey Starodubtsev
-Andri Khrisharyadi
-Andriy Tsykholyas
-Anno van Vliet
-Bastien Rouiller
-Benjamin JALON
-Bill Lynch
-Boris Grozev
-Candy Lohse
-Cem Yabansu
-Chris Deering
-Christoph Fiehe
-Craig Hesling
-Damian Minkov
-Dan Caseley
-Daniele Ricci
-Daniel Henninger
-Daniel Hintze
-Daryl E. Herzmann
-Dave Cridland
-Dave Stanley
-David Black
-Derek DeMoro
-Dmitry Deshevoy
-Eng ChongMeng
-Fernando Martinez Herrera
-Fernando Ramirez
-Florian Kimmann
-Florian Schmaus
-Francisco Vives
-Frank Matheron
-Gaston Dombiak
-Georg Lukas
-Gilles Cornu
-Gligor Selimovic
-Greg Thomas
-Grigory Fedorov
-Günther Niess
-Guus der Kinderen
-Henning Staib
-Holger Bergunde
-Hugues Bruant
-Ingo Bauersachs
-Ishan Khanna
-Jae Jang
-Jared DiCioccio
-Jason Sipula
-Jay Kline
-Jeff Williams
-Jesus Fuentes
-John Haubrich
-Jonathan Lennox
-Júlio Cesar Bueno Cotta
-Lars Noschinski
-Luca Stucchi
-Luke Granger-Brown
-Marcel Heckel
-Marilyn Daum
-Matteo Campana
-Matthew Wild
-Matt Tucker
-Michael Will
-Miguel Hincapie
-Mohsen Hariri
-Oliver Mihatsch
-Paul Schaub
-Pete Matern
-Piotr Nosek
-Rajat Kumar Gupta
-Robin Collier
-Simon Abykov
-Simon Schuster
-Son Goku
-Tairs Rzajevs
-Thiago Camargo
-Thibaut Le Guilly
-Thomas Pocreau
-Tim Jentz
-Timothy Pitt
-Tomáš Havlas
-Tomas Nosek
-Vadim Fite
-Vaibhav Ranglani
-V Lau
-Vyacheslav Blinov
-Wolf Posdorfer
-Xiaowei YAN
-Yash Thakkar

README.md

@@ -1,99 +1,75 @@
 Smack
 =====
 
-[![Build Status](https://github.com/igniterealtime/Smack/workflows/CI/badge.svg)](https://github.com/igniterealtime/Smack/actions?query=workflow%3A%22CI%22)  [![Coverage Status](https://coveralls.io/repos/igniterealtime/Smack/badge.svg)](https://coveralls.io/r/igniterealtime/Smack)  [![Project Stats](https://www.openhub.net/p/smack/widgets/project_thin_badge.gif)](https://www.openhub.net/p/smack)  [![Link to XMPP chat smack@conference.igniterealtime.org](https://search.jabber.network/api/1.0/badge?address=smack@conference.igniterealtime.org)](https://inverse.chat/#converse/room?jid=smack@conference.igniterealtime.org)
+[![Build Status](https://travis-ci.org/igniterealtime/Smack.svg?branch=master)](https://travis-ci.org/igniterealtime/Smack)  [![Project Stats](https://www.openhub.net/p/smackxmpp/widgets/project_thin_badge.gif)](https://www.openhub.net/p/smackxmpp) [![Flattr this git repo](http://api.flattr.com/button/flattr-badge-large.png)](https://flattr.com/thing/3480125)
 
 About
 -----
 
-[Smack] is an open-source, highly modular, easy to use, XMPP client library written in Java for Java SE compatible JVMs and Android.
+[Smack] is an Open Source, cross-platform, easy to use Java XMPP
+client library.
 
-Being a pure Java library, it can be embedded into your applications to create anything from a full XMPP instant messaging client to simple XMPP integrations such as sending notification messages and presence-enabling devices.
-Smack and XMPP allow you to easily exchange data in various ways e.g., fire-and-forget, publish-subscribe, between human and non-human endpoints (M2M, IoT, …).
+[Smack] is an Open Source [XMPP (Jabber)] client library for instant
+messaging and presence. A pure Java library, it can be embedded into
+your applications to create anything from a full XMPP client to simple
+XMPP integrations such as sending notification messages and
+presence-enabling devices.
 
-More information is provided by the [Overview](documentation/overview.md).
+Confused? Have a look at the [Overview](documentation/overview.md).
 
-Getting started
----------------
-
-Start with having a look at the **[Documentation]** and the **[Javadoc]**.
-
-Instructions on how to use Smack in your Java or Android project are provided in the [Smack Readme and Upgrade Guide](https://igniterealtime.org/projects/smack/readme).
-
-License
--------
-
-Most of Smack is governed by the Apache License 2.0 (SPDX License Identifier: Apache 2.0). This license requires that the contents of a NOTICE text file are shown "…within a display generated by the Derivative Works, if and wherever such third-party notices normally appear.".
-
-Smack comes which such a NOTICE file. Moreover, since `smack-core` is licensed under the Apache License 2.0, the conditions apply to every project using Smack. The content of Smack's NOTICE file can conveniently be retrieved using `Smack.getNoticeStream()`.
-
-Some subprojects of Smack are governed by other licenses. Please refer to the individual subprojects.
-
-Professional Services
----------------------
-
-Smack is a collaborative effort of many people.
-Some are paid, e.g., by their employer or a third party, for their contributions.
-But many contribute in their spare time for free.
-While we try to provide the best possible XMPP library for Android and Java SE-compatible execution environments by following state-of-the-art software engineering practices, the API may not always perfectly fit your requirements.
-Hence welcome contributions and encourage discussion about how Smack can be further improved.
-We also provide **paid services** ranging from **XMPP/Smack related consulting** to **designing and developing features** to accommodate your needs.
-Please contact [Florian Schmaus](mailto:flo@geekplace.eu) for further information.
+[Smack] - an [Ignite Realtime] community project.
 
 Bug Reporting
 -------------
 
-Only a few users have access for filling bugs in the tracker. New
+Only a few users have access for for filling bugs in the tracker. New
 users should:
 
-1. Read ["How to ask for help or report an issue"](https://github.com/igniterealtime/Smack/wiki/How-to-ask-for-help,-report-an-issue-and-possible-solve-the-problem-yourself)
-2. [Create a discourse account](https://discourse.igniterealtime.org/signup) (you can also sign up with your Google account).
-3. Login to the forum account
-4. Press "New Topic" in your toolbar and choose the 'Smack Support' sub-category.
+1. [Create a forums account](https://community.igniterealtime.org/login!input.jspa?registerOnly=true) (only e-mail is a requirement, you can skip all the other fields).
+2. Login to the forum account
+3. Press New in your toolbar and choose Discussion
+4. Choose the [Smack Developers Forum] of Smack and add the tag 'bug_report' to your new post
 
 Please search for your issues in the bug tracker before reporting.
 
 Contact
 -------
 
-The developers hang around in [smack@conference.igniterealtime.org](xmpp:smack@conference.igniterealtime.org?join). You may use [this link](https://inverse.chat/badge.svg?room=smack@conference.igniterealtime.org) to join the room via [inverse.chat](https://inverse.chat).
+The developers hang around in `#smack` (freenode, IRC) and `open_chat@conference.igniterealtime.org` (XMPP MUC room).
 Remember that it may take some time (~hours) to get a response.
  
-You can also reach us via the [Smack Support Forum] if you have questions or need support, or the [Smack Developers Forum] if you want to discuss Smack development.
-
-Contributing
-------------
-
-If you want to start developing for Smack and eventually contribute code back, then please have a look at the [Guidelines for Smack Developers and Contributors](https://github.com/igniterealtime/Smack/wiki/Guidelines-for-Smack-Developers-and-Contributors).
-The guidelines also contain development quickstart instructions.
+You can also reach us via the [Smack Users Forum] if you have questions or need support, or the [Smack Developers Forum] if you want to discuss Smack development.
 
 Resources
 ---------
 
-- Current Readme: https://igniterealtime.org/projects/smack/readme
-- Bug Tracker: https://issues.igniterealtime.org/browse/SMACK
-- JaCoCo Coverage Reports: https://www.igniterealtime.org/builds/smack/dailybuilds/jacoco/html/
+- Bug Tracker: http://issues.igniterealtime.org/browse/SMACK
+- Nightly Builds: http://www.igniterealtime.org/downloads/nightly_smack.jsp
 - Nightly Javadoc: http://www.igniterealtime.org/builds/smack/dailybuilds/javadoc/
 - Nightly Documentation: http://www.igniterealtime.org/builds/smack/dailybuilds/documentation/
-- User Forum: https://discourse.igniterealtime.org/c/smack/smack-support
-- Dev Forum: https://discourse.igniterealtime.org/c/smack/smack-dev
+- User Forum: http://community.igniterealtime.org/community/support/smack_users
+- Dev Forum: http://community.igniterealtime.org/community/developers/smack
 - Maven Releases: https://oss.sonatype.org/content/repositories/releases/org/igniterealtime/smack/
 - Maven Snapshots: https://oss.sonatype.org/content/repositories/snapshots/org/igniterealtime/smack/
-- Nightly Unique Maven Snapshots: https://www.igniterealtime.org/archiva/repository/maven/
+
+Donate
+------
+
+If you find Smack useful and feel like donating, then you can use one of the following systems:
+
+- [Donate via Flattr](https://flattr.com/thing/3480125)
+- Donate via Bitcoin: 1D4k11bsPxRB6rS51fxDty8QYfRVUt5JMB
 
 Ignite Realtime
 ===============
 
-[Ignite Realtime] is an Open Source community composed of end-users and developers around the world who are interested in applying innovative, open-standards-based RealTime Collaboration to their businesses and organizations. 
+[Ignite Realtime] is an Open Source community composed of end-users and developers around the world who 
+are interested in applying innovative, open-standards-based Real Time Collaboration to their businesses and organizations. 
 We're aimed at disrupting proprietary, non-open standards-based systems and invite you to participate in what's already one 
 of the biggest and most active Open Source communities.
 
-[Smack] - an [Ignite Realtime] community project.
-
-[Smack]: https://www.igniterealtime.org/projects/smack/index.jsp
-[Ignite Realtime]: https://www.igniterealtime.org
-[XMPP (Jabber)]: https://xmpp.org/
-[Smack Developers Forum]: https://discourse.igniterealtime.org/c/smack/smack-dev
-[Smack Support Forum]: https://discourse.igniterealtime.org/c/smack/smack-support
-[Documentation]: https://download.igniterealtime.org/smack/docs/latest/documentation/
-[Javadoc]: https://download.igniterealtime.org/smack/docs/latest/javadoc/
+[Smack]: http://www.igniterealtime.org/projects/smack/index.jsp
+[Ignite Realtime]: http://www.igniterealtime.org
+[XMPP (Jabber)]: http://xmpp.org/
+[Smack Developers Forum]: http://community.igniterealtime.org/community/developers/smack
+[Smack Users Forum]: https://community.igniterealtime.org/community/support/smack_users

build-logic/build.gradle

@@ -1,14 +0,0 @@
-plugins {
-	id 'groovy-gradle-plugin'
-}
-
-repositories {
-	gradlePluginPortal()
-}
-
-dependencies {
-	implementation "biz.aQute.bnd:biz.aQute.bnd.gradle:7.0.0"
-	implementation "me.champeau.jmh:jmh-gradle-plugin:0.7.2"
-	implementation "net.ltgt.gradle:gradle-errorprone-plugin:4.0.1"
-	implementation "ru.vyarus:gradle-animalsniffer-plugin:1.7.1"
-}

build-logic/settings.gradle

@@ -1 +0,0 @@
-rootProject.name = 'smack-build-logic'

build-logic/src/main/groovy/org.igniterealtime.smack.android-boot-classpath-conventions.gradle

@@ -1,6 +0,0 @@
-compileJava {
-	options.bootstrapClasspath = files(androidBootClasspath)
-}
-javadoc {
-	classpath += files(androidBootClasspath)
-}

build-logic/src/main/groovy/org.igniterealtime.smack.android-conventions.gradle

@@ -1,10 +0,0 @@
-plugins {
-	id 'ru.vyarus.animalsniffer'
-	id 'org.igniterealtime.smack.global-conventions'
-}
-dependencies {
-	signature "net.sf.androidscents.signature:android-api-level-${smackMinAndroidSdk}:6.0_r3@signature"
-}
-animalsniffer {
-	sourceSets = [sourceSets.main]
-}

build-logic/src/main/groovy/org.igniterealtime.smack.application-conventions.gradle

@@ -1,12 +0,0 @@
-plugins {
-	id 'application'
-}
-
-application {
-	applicationDefaultJvmArgs = ["-enableassertions"]
-}
-
-run {
-	// Pass all system properties down to the "application" run
-	systemProperties System.getProperties()
-}

build-logic/src/main/groovy/org.igniterealtime.smack.global-conventions.gradle

@@ -1,37 +0,0 @@
-ext {
-	javaVersion = JavaVersion.VERSION_11
-	javaMajor = javaVersion.getMajorVersion()
-	smackMinAndroidSdk = 23
-
-	androidBootClasspath = { getAndroidRuntimeJar() }
-}
-
-repositories {
-	mavenLocal()
-	mavenCentral()
-}
-
-def getAndroidRuntimeJar() {
-	def androidApiLevel = ext.smackMinAndroidSdk
-	def androidHome = getAndroidHome()
-	def androidJar = new File("$androidHome/platforms/android-${androidApiLevel}/android.jar")
-	if (androidJar.isFile()) {
-		return androidJar
-	} else {
-		throw new Exception("Can't find android.jar for API level ${androidApiLevel}. Please install corresponding SDK platform package")
-	}
-}
-def getAndroidJavadocOffline() {
-	def androidHome = getAndroidHome()
-	return androidHome.toString() + "/docs/reference"
-}
-
-def getAndroidHome() {
-	def androidHomeEnv = System.getenv("ANDROID_HOME")
-	if (androidHomeEnv == null) {
-		throw new Exception("ANDROID_HOME environment variable is not set")
-	}
-	def androidHome = new File(androidHomeEnv)
-	if (!androidHome.isDirectory()) throw new Exception("Environment variable ANDROID_HOME is not pointing to a directory")
-	return androidHome
-}

build-logic/src/main/groovy/org.igniterealtime.smack.java-common-conventions.gradle

@@ -1,367 +0,0 @@
-plugins {
-	id 'biz.aQute.bnd.builder'
-	id 'checkstyle'
-	id 'eclipse'
-	id 'idea'
-	id 'jacoco'
-	id 'java'
-	id 'java-library'
-	id 'java-test-fixtures'
-	id 'maven-publish'
-	id 'net.ltgt.errorprone'
-	id 'signing'
-
-	id 'jacoco-report-aggregation'
-	id 'test-report-aggregation'
-
-	id 'org.igniterealtime.smack.global-conventions'
-	id 'org.igniterealtime.smack.javadoc-conventions'
-}
-
-version readVersionFile()
-
-ext {
-	isSnapshot = version.endsWith('-SNAPSHOT')
-	gitCommit = getGitCommit()
-	rootConfigDir = new File(rootDir, 'config')
-	sonatypeCredentialsAvailable = project.hasProperty('sonatypeUsername') && project.hasProperty('sonatypePassword')
-	isReleaseVersion = !isSnapshot
-	isContinuousIntegrationEnvironment = Boolean.parseBoolean(System.getenv('CI'))
-	signingRequired = !(isSnapshot || isContinuousIntegrationEnvironment)
-	sonatypeSnapshotUrl = 'https://oss.sonatype.org/content/repositories/snapshots'
-	sonatypeStagingUrl = 'https://oss.sonatype.org/service/local/staging/deploy/maven2'
-	builtDate = (new java.text.SimpleDateFormat("yyyy-MM-dd")).format(new Date())
-	oneLineDesc = 'An Open Source XMPP (Jabber) client library'
-
-	jxmppVersion = '[1.1.0-beta1, 1.1.999]'
-	miniDnsVersion = '[1.1.0-alpha3, 1.1.999]'
-	junitVersion = '5.9.2'
-	commonsIoVersion = '2.6'
-	bouncyCastleVersion = '1.73'
-	guavaVersion = '30.1-jre'
-	mockitoVersion = '5.13.0'
-	orgReflectionsVersion = '0.9.11'
-
-	if (project.hasProperty("useSonatype")) {
-		useSonatype = project.getProperty("useSonatype").toBoolean()
-	} else {
-		// Default to true
-		useSonatype = true
-	}
-
-	gplLicensedProjects = [
-			':smack-examples',
-			':smack-omemo-signal',
-			':smack-omemo-signal-integration-test',
-			':smack-repl'
-		].collect{ project(it) }
-}
-
-group = 'org.igniterealtime.smack'
-
-java {
-	sourceCompatibility = javaVersion
-	targetCompatibility = sourceCompatibility
-}
-
-eclipse {
-	classpath {
-		downloadJavadoc = true
-	}
-}
-
-// Make all project's 'test' target depend on javadoc, so that
-// javadoc is also linted.
-test.dependsOn javadoc
-
-tasks.withType(JavaCompile) {
-	// Some systems may not have set their platform default
-	// converter to 'utf8', but we use unicode in our source
-	// files. Therefore ensure that javac uses unicode
-	options.encoding = "utf8"
-	options.compilerArgs = [
-		'-Xlint:all',
-		// Set '-options' because a non-java7 javac will emit a
-		// warning if source/target is set to 1.7 and
-		// bootclasspath is *not* set.
-		'-Xlint:-options',
-		// TODO: Enable xlint serial
-		'-Xlint:-serial',
-		'-Werror',
-	]
-}
-if (JavaVersion.current().isJava8Compatible()) {
-	tasks.withType(Javadoc) {
-		// The '-quiet' as second argument is actually a hack,
-		// since the one parameter addStringOption doesn't seem to
-		// work, we extra add '-quiet', which is added anyway by
-		// gradle.
-		// We disable 'missing' as we do most of javadoc checking via checkstyle.
-		options.addStringOption('Xdoclint:all,-missing', '-quiet')
-		// Abort on javadoc warnings.
-		// See JDK-8200363 (https://bugs.openjdk.java.net/browse/JDK-8200363)
-		// for information about the -Xwerror option.
-		options.addStringOption('Xwerror', '-quiet')
-	}
-}
-
-if (JavaVersion.current().isJava9Compatible()) {
-	tasks.withType(JavaCompile) {
-		options.compilerArgs.addAll([
-			'--release', javaMajor,
-		])
-	}
-}
-
-jacoco {
-	toolVersion = "0.8.12"
-}
-
-jacocoTestReport {
-	dependsOn test
-	reports {
-		xml.required = true
-	}
-}
-
-dependencies {
-	testImplementation "org.junit.jupiter:junit-jupiter-api:$junitVersion"
-	testRuntimeOnly "org.junit.jupiter:junit-jupiter-engine:$junitVersion"
-
-	testFixturesApi "org.junit.jupiter:junit-jupiter-api:$junitVersion"
-	testImplementation "org.junit.jupiter:junit-jupiter-params:$junitVersion"
-	testRuntimeOnly "org.junit.jupiter:junit-jupiter-engine:$junitVersion"
-	// https://stackoverflow.com/a/77274251/194894
-	testRuntimeOnly "org.junit.platform:junit-platform-launcher:1.11.0"
-
-	// The smack-extensions subproject uses mockito in its fest
-	// fixtures, and we want to have mockito also available in
-	// test, so we use API here.
-	testFixturesApi "org.mockito:mockito-core:${mockitoVersion}"
-
-	testImplementation 'com.jamesmurty.utils:java-xmlbuilder:1.2'
-
-	errorprone 'com.google.errorprone:error_prone_core:2.32.0'
-}
-
-test {
-	useJUnitPlatform()
-
-	maxParallelForks = Runtime.runtime.availableProcessors().intdiv(2) ?: 1
-
-	// Enable full stacktraces of failed tests. Especially handy
-	// for CI environments.
-	testLogging {
-		events "failed"
-		exceptionFormat "full"
-	}
-}
-
-jar {
-	manifest {
-		attributes(
-			'Implementation-Version': version,
-			'Implementation-GitRevision': gitCommit,
-			'Built-JDK': System.getProperty('java.version'),
-			'Built-Gradle': gradle.gradleVersion,
-			'Built-By': System.getProperty('user.name')
-		)
-	}
-
-	bundle {
-		bnd(
-				'-removeheaders': 'Tool, Bnd-*',
-				'-exportcontents': '*',
-		)
-	}
-}
-
-checkstyle {
-	toolVersion = '8.27'
-
-	if (project in gplLicensedProjects) {
-		configProperties.checkstyleLicenseHeader = "${project.name}-gplv3-license-header"
-	} else {
-		configProperties.checkstyleLicenseHeader = "header"
-	}
-}
-task sourcesJar(type: Jar, dependsOn: classes) {
-	archiveClassifier = 'sources'
-	from sourceSets.main.allSource
-}
-task javadocJar(type: Jar, dependsOn: javadoc) {
-	archiveClassifier = 'javadoc'
-	from javadoc.destinationDir
-}
-task testsJar(type: Jar) {
-	archiveClassifier = 'tests'
-	from sourceSets.test.output
-}
-configurations {
-	testRuntime
-}
-artifacts {
-	// Add a 'testRuntime' configuration including the tests so that
-	// it can be consumed by other projects (smack-omemo-signal for
-	// example).  See http://stackoverflow.com/a/21946676/194894
-	testRuntime testsJar
-}
-
-publishing {
-	publications {
-		mavenJava(MavenPublication) {
-			from components.java
-			artifact sourcesJar
-			artifact javadocJar
-			artifact testsJar
-			pom {
-				name = 'Smack'
-				packaging = 'jar'
-				inceptionYear = '2003'
-				url = 'http://www.igniterealtime.org/projects/jxmpp/'
-				afterEvaluate {
-					description = project.description
-				}
-
-				issueManagement {
-					system = 'JIRA'
-					url = 'http://issues.igniterealtime.org/browse/SMACK'
-				}
-
-				scm {
-					url = 'https://github.com/igniterealtime/Smack'
-					connection = 'scm:git:https://github.com/igniterealtime/Smack.git'
-					developerConnection = 'scm:git:https://github.com/igniterealtime/Smack.git'
-				}
-
-				licenses {
-					if (project in gplLicensedProjects) {
-						license {
-							name = 'GNU General Public License, version 3 or any later version'
-							url = 'https://www.gnu.org/licenses/gpl.txt'
-							distribution = 'repo'
-						}
-					} else {
-						license {
-							name = 'The Apache Software License, Version 2.0'
-							url = 'http://www.apache.org/licenses/LICENSE-2.0.txt'
-							distribution = 'repo'
-						}
-					}
-				}
-
-				developers {
-					developer {
-						id = 'flow'
-						name = 'Florian Schmaus'
-						email = 'flow@igniterealtime.org'
-					}
-				}
-			}
-		}
-	}
-	repositories {
-		if (sonatypeCredentialsAvailable && useSonatype) {
-			maven {
-				url isSnapshot ? sonatypeSnapshotUrl : sonatypeStagingUrl
-				credentials {
-					username = sonatypeUsername
-					password = sonatypePassword
-				}
-			}
-		}
-		// Use
-		// gradle publish -P customRepoUrl=https://www.igniterealtime.org/archiva/repository/maven -P customRepoUsername=bamboo -P customRepoPassword=hidden -P useSonatype=false
-		// to deploy to this repo.
-		if (project.hasProperty("customRepoUrl")) {
-			maven {
-				name 'customRepo'
-				url customRepoUrl
-				if (project.hasProperty("customRepoUsername")) {
-					credentials {
-						username customRepoUsername
-						password customRepoPassword
-					}
-				}
-			}
-		}
-	}
-}
-
-// Workaround for gpg signatory not supporting the 'required' option
-// See https://github.com/gradle/gradle/issues/5064#issuecomment-381924984
-// Note what we use 'signing.gnupg.keyName' instead of 'signing.keyId'.
-tasks.withType(Sign) {
-	onlyIf {
-		project.hasProperty('signing.gnupg.keyName')
-	}
-}
-signing {
-	required { signingRequired }
-	useGpgCmd()
-	sign publishing.publications.mavenJava
-}
-
-tasks.withType(JavaCompile) {
-	options.errorprone {
-		disableWarningsInGeneratedCode = true
-		excludedPaths = ".*/jmh_generated/.*"
-		error(
-			"UnusedVariable",
-			"UnusedMethod",
-			"MethodCanBeStatic",
-		)
-		errorproneArgs = [
-			// Disable MissingCasesInEnumSwitch error prone check
-			// because this check is already done by javac as incomplete-switch.
-			'-Xep:MissingCasesInEnumSwitch:OFF',
-			'-Xep:StringSplitter:OFF',
-			'-Xep:JavaTimeDefaultTimeZone:OFF',
-			'-Xep:InlineMeSuggester:OFF',
-		]
-	}
-}
-
-// Work around https://github.com/gradle/gradle/issues/4046
-task copyJavadocDocFiles(type: Copy) {
-	from('src/javadoc')
-	into 'build/docs/javadoc'
-	include '**/doc-files/*.*'
-}
-javadoc.dependsOn copyJavadocDocFiles
-
-def getGitCommit() {
-	def projectDirFile = new File("$projectDir")
-
-	def cmd = 'git describe --always --tags --dirty=+'
-	def proc = cmd.execute(null, projectDirFile)
-
-	def exitStatus = proc.waitFor()
-	if (exitStatus != 0) return "non-git build"
-
-	def gitCommit = proc.text.trim()
-	assert !gitCommit.isEmpty()
-	gitCommit
-}
-
-def getAndroidRuntimeJar() {
-	def androidHome = new File("$System.env.ANDROID_HOME")
-	if (!androidHome.isDirectory()) throw new Exception("ANDROID_HOME not found or set")
-	def androidJar = new File("$androidHome/platforms/android-$smackMinAndroidSdk/android.jar")
-	if (androidJar.isFile()) {
-		return androidJar
-	} else {
-		throw new Exception("Can't find android.jar for $smackMinAndroidSdk API. Please install corresponding SDK platform package")
-	}
-}
-
-def readVersionFile() {
-	def versionFile = new File(rootDir, 'version')
-	if (!versionFile.isFile()) {
-		throw new Exception("Could not find version file")
-	}
-	if (versionFile.text.isEmpty()) {
-		throw new Exception("Version file does not contain a version")
-	}
-	versionFile.text.trim()
-}

build-logic/src/main/groovy/org.igniterealtime.smack.javadoc-conventions.gradle

@@ -1,30 +0,0 @@
-plugins {
-	// Javadoc linking requires repositories to bet configured. And
-	// those are declared in global-conventions, hence we add it here.
-	id 'org.igniterealtime.smack.global-conventions'
-}
-
-if (JavaVersion.current().isJava8Compatible()) {
-	tasks.withType(Javadoc) {
-		// The '-quiet' as second argument is actually a hack,
-		// since the one parameter addStringOption doesn't seem to
-		// work, we extra add '-quiet', which is added anyway by
-		// gradle.
-		// We disable 'missing' as we do most of javadoc checking via checkstyle.
-		options.addStringOption('Xdoclint:all,-missing', '-quiet')
-		// Abort on javadoc warnings.
-		// See JDK-8200363 (https://bugs.openjdk.java.net/browse/JDK-8200363)
-		// for information about the -Xwerror option.
-		options.addStringOption('Xwerror', '-quiet')
-	}
-}
-
-if (JavaVersion.current().isJava9Compatible()) {
-	tasks.withType(Javadoc) {
-		options.addStringOption('-release', javaMajor)
-	}
-}
-
-tasks.withType(Javadoc) {
-	options.charSet = "UTF-8"
-}

build.gradle

@@ -1,103 +1,336 @@
-plugins {
-	// The scalastyle plugin of smack-repl wants the root project to
-	// have a ideaProject task, so let's add one.
-	id 'idea'
+import org.gradle.plugins.signing.Sign
 
-	id 'org.igniterealtime.smack.javadoc-conventions'
+buildscript {
+    repositories {
+        jcenter()
+        maven { url 'http://dl.bintray.com/content/aalmiray/kordamp' }
+    }
+    dependencies {
+        classpath 'org.kordamp:markdown-gradle-plugin:1.0.0'
+		classpath 'org.kordamp.gradle:clirr-gradle-plugin:0.2.0'
+    }
 }
+apply plugin: 'org.kordamp.gradle.markdown'
 
-ext {
-	javadocAllDir = new File(buildDir, 'javadoc')
-	integrationTestProjects = [
-		':smack-integration-test',
-		':smack-omemo-signal-integration-test',
-	].collect{ project(it) }
-	javadocAllProjects = subprojects - integrationTestProjects
-}
+apply from: 'version.gradle'
 
-evaluationDependsOnChildren()
-task javadocAll(type: Javadoc) {
-	source javadocAllProjects.collect {project ->
-		project.sourceSets.main.allJava.findAll {
-			// Filter out symbolic links to avoid
-			// "warning: a package-info.java file has already been seen for package"
-			// javadoc warnings.
-			!java.nio.file.Files.isSymbolicLink(it.toPath())
+allprojects {
+	apply plugin: 'java'
+	apply plugin: 'eclipse'
+
+	ext {
+		gitCommit = getGitCommit()
+		javadocAllDir = new File(buildDir, 'javadoc')
+		documentationDir = new File(buildDir, 'documentation')
+		releasedocsDir = new File(buildDir, 'releasedocs')
+		rootConfigDir = new File(rootDir, 'config')
+		sonatypeCredentialsAvailable = project.hasProperty('sonatypeUsername') && project.hasProperty('sonatypePassword')
+		isReleaseVersion = !isSnapshot
+		signingRequired = isReleaseVersion
+		sonatypeSnapshotUrl = 'https://oss.sonatype.org/content/repositories/snapshots'
+		sonatypeStagingUrl = 'https://oss.sonatype.org/service/local/staging/deploy/maven2'
+		// Returns only the date in yyyy-MM-dd format, as otherwise, with
+		// hh:mm:ss information, the manifest files would change with every
+		// build, causing unnecessary rebuilds.
+		builtDate = (new java.text.SimpleDateFormat("yyyy-MM-dd")).format(new Date())
+		oneLineDesc = 'An Open Source XMPP (Jabber) client library'
+		androidProjects = [
+			':smack-tcp',
+			':smack-bosh',
+			':smack-core',
+			':smack-im',
+			':smack-resolver-minidns',
+			':smack-sasl-provided',
+			':smack-extensions',
+			':smack-experimental',
+		].collect{ project(it) }
+		androidBootClasspath = getAndroidRuntimeJar()
+		androidJavadocOffline = getAndroidJavadocOffline()
+	}
+	group = 'org.igniterealtime.smack'
+	sourceCompatibility = 1.7
+	targetCompatibility = sourceCompatibility
+	version = shortVersion
+	if (isSnapshot) {
+		version += '-SNAPSHOT'
+	}
+
+	ext.sharedManifest = manifest {
+		attributes('Implementation-Version': version,
+				   'Implementation-GitRevision': ext.gitCommit,
+				   // According to OSGi core 5.0 section 3.2.5 the qualifier (the fourth
+				   // version element) must begin with a dot. So we replace only the
+				   // first occurence of an dash with a dot.
+				   // For example 4.0.0-rc1 becomes 4.0.0.rc1, but
+				   // 4.0.0-SNAPSHOT-2014-05-01 becomes 4.0.0.SNAPSHOT-2014-05-01
+				   'Bundle-Version': version.replaceFirst("-", "."),
+				   'Built-Date': ext.builtDate,
+				   'Built-JDK': System.getProperty('java.version'),
+				   'Built-Gradle': gradle.gradleVersion,
+				   'Built-By': System.getProperty('user.name')
+				  )
+	}
+
+	eclipse {
+		classpath {
+			downloadJavadoc = true
 		}
 	}
+
+	repositories {
+		// Add OSS Sonatype Snapshot repository
+		maven {
+			url 'https://oss.sonatype.org/content/repositories/snapshots'
+		}
+	}
+
+	compileJava {
+		// Some systems may not have set their platform default
+		// converter to 'utf8', but we use unicode in our source
+		// files. Therefore ensure that javac uses unicode
+		options.encoding = "utf8"
+	}
+
+	if (JavaVersion.current().isJava8Compatible()) {
+		tasks.withType(Javadoc) {
+			options.addStringOption('Xdoclint:none', '-quiet')
+		}
+	}
+}
+
+gradle.taskGraph.whenReady { taskGraph ->
+	if (signingRequired
+		&& taskGraph.allTasks.any { it instanceof Sign }) {
+		// Use Java 6's console to read from the console (no good for a CI environment)
+		Console console = System.console()
+		console.printf '\n\nWe have to sign some things in this build.\n\nPlease enter your signing details.\n\n'
+		def password = console.readPassword('GnuPG Private Key Password: ')
+
+		allprojects { ext.'signing.password' = password }
+
+		console.printf '\nThanks.\n\n'
+	}
+}
+
+task javadocAll(type: Javadoc) {
+	source subprojects.collect {project ->
+		project.sourceSets.main.allJava }
 	destinationDir = javadocAllDir
 	// Might need a classpath
 	classpath = files(subprojects.collect {project ->
 		project.sourceSets.main.compileClasspath})
-	classpath += files(androidBootClasspath)
-	def staticJxmppVersion = getResolvedVersion('org.jxmpp:jxmpp-core')
-	def staticMiniDnsVersion = getResolvedVersion('org.minidns:minidns-core')
-	options {
-		linkSource = true
-		use = true
-		links = [
-		"https://docs.oracle.com/en/java/javase/${javaMajor}/docs/api/",
-		"https://jxmpp.org/releases/${staticJxmppVersion}/javadoc/",
-		"https://minidns.org/releases/${staticMiniDnsVersion}/javadoc/",
-		] as String[]
-		overview = "$projectDir/resources/javadoc-overview.html"
+	options.linkSource = true
+	options.use = true
+	options.links = ["http://docs.oracle.com/javase/$sourceCompatibility/docs/api/"] as String[]
+}
+
+import org.apache.tools.ant.filters.ReplaceTokens
+task prepareReleasedocs(type: Copy) {
+	from 'resources/releasedocs'
+	into releasedocsDir
+	filter(ReplaceTokens, tokens: [version: version, releasedate: builtDate, targetCompatibility: targetCompatibility.toString()])
+}
+
+markdownToHtml {
+	sourceDir = new File(projectDir, "/documentation")
+	outputDir documentationDir
+	configuration = [tables: true, fencedCodeBlocks: true]
+}
+
+task distributionZip(type: Zip, dependsOn: [javadocAll, prepareReleasedocs, markdownToHtml]) {
+	classifier builtDate
+	into ('javadoc') {
+		from(javadocAllDir)
+	}
+	into ('releasedocs') {
+		from(releasedocsDir)
+	}
+	into ('releasedocs/documentation') {
+		from(documentationDir)
+	}
+}
+
+task maybeCheckForSnapshotDependencies {
+	// Don't check for Snapshot dependencies if this is a snapshot.
+	if (isSnapshot) return
+	allprojects { project ->
+		project.configurations.runtime.each {
+			if (it.toString().contains("-SNAPSHOT"))
+				throw new Exception("Release build contains snapshot dependencies: " + it)
+		}
+	}
+}
+
+test { dependsOn maybeCheckForSnapshotDependencies }
+
+jar {
+	// Root project should not create empty jar artifact
+	enabled = false
+}
+
+// Disable upload archives for the root project
+uploadArchives.enabled = false
+
+description = """\
+Smack ${version}
+${oneLineDesc}."""
+
+evaluationDependsOnChildren()
+subprojects {
+	apply plugin: 'maven'
+	apply plugin: 'osgi'
+	apply plugin: 'signing'
+	apply plugin: 'checkstyle'
+	apply plugin: 'org.kordamp.gradle.clirr'
+
+	checkstyle {
+		configFile = new File(rootConfigDir, 'checkstyle.xml')
+	}
+	repositories {
+		mavenLocal()
+		mavenCentral()
+	}
+	task sourcesJar(type: Jar, dependsOn: classes) {
+		classifier = 'sources'
+		from sourceSets.main.allSource
+	}
+	task javadocJar(type: Jar, dependsOn: javadoc) {
+		classifier = 'javadoc'
+		from javadoc.destinationDir
+	}
+	task testJar(type: Jar) {
+		classifier = 'tests'
+		from sourceSets.test.output
+	}
+	artifacts {
+		archives sourcesJar
+		archives javadocJar
+		archives testJar
 	}
 
-	// Finally copy the javadoc doc-files from the subprojects, which
-	// are potentially generated, to the javadocAll directory. Note
-	// that we use a copy *method* and not a *task* because the inputs
-	// of copy tasks is determined within the configuration phase. And
-	// since some of the inputs are generated, they will not get
-	// picked up if we used a copy method. See also
-	// https://stackoverflow.com/a/40518516/194894
-	doLast {
-		copy {
-			javadocAllProjects.each {
-				from ("${it.projectDir}/src/javadoc") {
-					include '**/doc-files/*.*'
+	uploadArchives {
+		repositories {
+			mavenDeployer {
+				if (signingRequired) {
+					beforeDeployment { MavenDeployment deployment -> signing.signPom(deployment) }
+				}
+				repository(url: project.sonatypeStagingUrl) {
+					if (sonatypeCredentialsAvailable) {
+						authentication(userName: sonatypeUsername, password: sonatypePassword)
+					}
+				}
+				snapshotRepository(url: project.sonatypeSnapshotUrl) {
+					if (sonatypeCredentialsAvailable) {
+						authentication(userName: sonatypeUsername, password: sonatypePassword)
+					}
+				}
+
+				pom.project {
+					name 'Smack'
+					packaging 'jar'
+					inceptionYear '2003'
+					url 'http://www.igniterealtime.org/projects/smack/'
+					description project.description
+
+					issueManagement {
+						system 'JIRA'
+						url 'https://igniterealtime.org/issues/browse/SMACK'
+					}
+
+					distributionManagement {
+						snapshotRepository {
+							id 'smack.snapshot'
+							url project.sonatypeSnapshotUrl
+						}
+					}
+
+					scm {
+						url 'https://github.com/igniterealtime/Smack'
+						connection 'scm:git:https://github.com/igniterealtime/Smack.git'
+						developerConnection 'scm:git:https://github.com/igniterealtime/Smack.git'
+					}
+
+					licenses {
+						license {
+							name 'The Apache Software License, Version 2.0'
+							url 'http://www.apache.org/licenses/LICENSE-2.0.txt'
+							distribution 'repo'
+						}
+					}
+
+					developers {
+						developer {
+							id 'flow'
+							name 'Florian Schmaus'
+							email 'flow@igniterealtime.org'
+						}
+					}
 				}
 			}
-
-			into javadocAllDir
 		}
 	}
+	rootProject.distributionZip {
+		dependsOn build
+		from(buildDir) {
+			include "$libsDirName/*${version}.jar"
+			include "$libsDirName/*${version}-javadoc.jar"
+			include "$libsDirName/*${version}-sources.jar"
+		}
+	}
+	signing {
+		required { signingRequired }
+		sign configurations.archives
+	}
+
+	clirr {
+		semver false
+	}
 }
 
-task integrationTest {
-	description 'Verify correct functionality of Smack by running some integration tests.'
-	dependsOn project(':smack-integration-test').tasks.run
+subprojects*.jar {
+   manifest {
+       from sharedManifest
+   }
 }
 
-task omemoSignalIntTest {
-	description 'Run integration tests of the smack-omemo module in combination with smack-omemo-signal.'
-	dependsOn 'smack-omemo-signal-integration-test:run'
+// Important to specify this task after the subprojects block
+task clirrRootReport(type: org.kordamp.gradle.clirr.ClirrReportTask) {
+	dependsOn = subprojects.tasks.clirr
+	reports = files((subprojects.findAll { it.clirr.enabled == true }).tasks.clirr.xmlReport)
 }
 
-task sinttestAll {
-	description 'Run all of Smack\'s integration tests.'
-	dependsOn {[
-		integrationTest,
-		omemoSignalIntTest,
-	]}
+def getGitCommit() {
+	def dotGit = new File("$projectDir/.git")
+	if (!dotGit.isDirectory()) return 'non-git build'
+
+	def cmd = 'git describe --always --tags --dirty=+'
+	def proc = cmd.execute()
+	def gitCommit = proc.text.trim()
+	assert !gitCommit.isEmpty()
+	gitCommit
 }
 
-def getResolvedVersion(queriedProject = 'smack-core', component) {
-	def configuration = project(queriedProject)
-		.configurations
-		.compileClasspath
-
-	def artifact = configuration
-		.resolvedConfiguration
-		.resolvedArtifacts
-		.findAll {
-			// 'it' is of type ResolvedArtifact, 'id' of
-			// Component*Artifact*Identifier, and we check the
-			// ComponentIdentifier.
-			it.id.getComponentIdentifier() instanceof org.gradle.api.artifacts.component.ModuleComponentIdentifier
-		}
-	    .find {
-			it.id.getComponentIdentifier().toString().startsWith(component + ':')
-		}
-
-	artifact.getModuleVersion().getId().getVersion()
+def getAndroidRuntimeJar() {
+	def androidHome = getAndroidHome()
+	def androidJar = new File("$androidHome/platforms/android-$smackMinAndroidSdk/android.jar")
+	if (androidJar.isFile()) {
+		return androidJar
+	} else {
+		throw new Exception("Can't find android.jar for $smackMinAndroidSdk API. Please install corresponding SDK platform package")
+	}
+}
+
+def getAndroidJavadocOffline() {
+	def androidHome = getAndroidHome()
+	return androidHome.toString() + "/docs/reference"
+}
+
+def getAndroidHome() {
+	def androidHomeEnv = System.getenv("ANDROID_HOME")
+	if (androidHomeEnv == null) {
+		throw new Exception("ANDROID_HOME environment variable is not set")
+	}
+	def androidHome = new File(androidHomeEnv)
+	if (!androidHome.isDirectory()) throw new Exception("Environment variable ANDROID_HOME is not pointing to a directory")
+	return androidHome
 }

config/checkstyle.xml

@@ -0,0 +1,34 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE module PUBLIC
+    "-//Puppy Crawl//DTD Check Configuration 1.3//EN"
+     "http://www.puppycrawl.com/dtds/configuration_1_3.dtd">
+<module name="Checker">
+	<module name="SuppressionFilter">
+		<property name="file" value="config/suppressions.xml"/>
+	</module>
+	<module name="Header">
+		<property name="headerFile" value="config/header.txt"/>
+		<property name="ignoreLines" value="3"/>
+		<property name="fileExtensions" value="java"/>
+	</module>
+	<module name="NewlineAtEndOfFile">
+		<property name="lineSeparator" value="lf"/>
+	</module>
+	<module name="RegexpSingleline">
+		<property name="format" value="MXParser"/>
+		<property name="message" value="Must not use MXParser, use XmlPullParserFactory instead"/>
+	</module>
+	<module name="TreeWalker">
+		<module name="UnusedImports">
+			<property name="processJavadoc" value="true"/>
+		</module>
+		<module name="AvoidStarImport"/>
+		<module name="IllegalImport"/>
+		<module name="RedundantImport"/>
+		<module name="UpperEll"/>
+		<module name="ArrayTypeStyle"/>
+		<module name="GenericWhitespace"/>
+		<module name="EmptyStatement"/>
+		<module name="PackageDeclaration"/>
+	</module>
+</module>

config/checkstyle/checkstyle.xml

@@ -1,210 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE module PUBLIC
-    "-//Puppy Crawl//DTD Check Configuration 1.3//EN"
-     "http://www.puppycrawl.com/dtds/configuration_1_3.dtd">
-<module name="Checker">
-	<module name="SuppressionFilter">
-		<property name="file" value="${config_loc}/suppressions.xml"/>
-	</module>
-	<module name="SuppressWithPlainTextCommentFilter">
-		<property name="offCommentFormat" value="CHECKSTYLE\:OFF\:(\w+)"/>
-		<property name="onCommentFormat" value="CHECKSTYLE\:ON\:(\w+)"/>
-		<property name="checkFormat" value="$1"/>
-	</module>
-	<module name="Header">
-		<property name="headerFile" value="${config_loc}/${checkstyleLicenseHeader}.txt"/>
-		<property name="ignoreLines" value="3"/>
-		<property name="fileExtensions" value="java"/>
-	</module>
-	<module name="NewlineAtEndOfFile">
-		<property name="lineSeparator" value="lf"/>
-	</module>
-	<module name="RegexpSingleline">
-		<property name="format" value="MXParser"/>
-		<property name="message" value="Must not use MXParser, use XmlPullParserFactory instead"/>
-	</module>
-	<module name="RegexpSingleline">
-	  <!--
-		  Matches StringBuilder.append(String) calls where the
-		  argument is a String of length one. Those should be replaced
-		  with append(char) for performance reasons.
-
-		  TODO: This could be more advanced in order to match also
-		  - .append("\u1234")
-	  -->
-		<property name="format" value="\.append\(&quot;(.|\\.)&quot;\)"/>
-		<property name="message" value="Don&apos;t use StringBuilder.append(String) when you can use StringBuilder.append(char). Solution: Replace double quotes of append&apos;s argument with single quotes."/>
-	</module>
-	<module name="FileTabCharacter"/>
-	<module name="RegexpSingleline">
-		<!--
-			Explaining the following Regex
-
-			           \s+   $
-			            |    +- End of Line (2)
-			            +- At least one whitespace (1)
-
-			Rationale:
-			Matches trailing whitespace (2) in lines containing at least one (1) non-whitespace character
-		-->
-		<property name="format" value="\s+$"/>
-		<property name="message" value="Line containing trailing whitespace character(s)"/>
-	</module>
-	<!-- <module name="RegexpSingleline"> -->
-	<!--   <property name="format" value="fqdn"/> -->
-	<!-- </module> -->
-	<module name="RegexpSingleline">
-		<property name="format" value="^\s*//[^\s]"/>
-		<property name="message" value="Comment start ('//') followed by non-space character. You would not continue after a punctuation without a space, would you?"/>
-	</module>
-	<!-- Check for synchronized keyword on Manager's static
-	     getInstanceFor() method. Note that if XMPPConnection is every
-	     replaced with something else, then we need to change it here
-	     too. -->
-	<module name="RegexpSingleline">
-		<property name="format" value="^\s*public(?!.*synchronized).*getInstanceFor\(XMPPConnection.*$"/>
-		<property name="message" value="getInstanceFor() should be synchronized"/>
-	</module>
-	<module name="JavadocPackage"/>
-	<module name="TreeWalker">
-		<module name="SuppressionCommentFilter"/>
-		<module name="FinalClass"/>
-		<module name="UnusedImports">
-			<property name="processJavadoc" value="true"/>
-		</module>
-		<module name="AvoidStarImport"/>
-		<module name="IllegalImport"/>
-		<module name="RedundantImport"/>
-		<module name="RedundantModifier"/>
-		<module name="ModifierOrder"/>
-		<module name="UpperEll"/>
-		<module name="ArrayTypeStyle"/>
-		<module name="GenericWhitespace"/>
-		<module name="EmptyStatement"/>
-		<module name="PackageDeclaration"/>
-		<module name="LeftCurly"/>
-		<module name="RegexpSinglelineJava">
-			<property name="format" value="printStackTrace"/>
-			<property name="message" value="Usage of printStackTrace"/>
-			<property name="ignoreComments" value="true"/>
-		</module>
-		<module name="RegexpSinglelineJava">
-			<property name="format" value="println"/>
-			<property name="message" value="Usage of println"/>
-			<property name="ignoreComments" value="true"/>
-		</module>
-		<module name="RegexpSinglelineJava">
-			<property name="format" value="Boolean\.valueOf\("/>
-			<property name="message" value="Usage Boolean.valueOf(), consider using ParserUtils.parseXmlBoolean() instead (if you want to parse xs:boolean values)"/>
-			<property name="ignoreComments" value="true"/>
-		</module>
-		<module name="RegexpSinglelineJava">
-			<property name="format" value="^\t+"/>
-			<property name="message" value="Indent must not use tab characters. Use space instead."/>
-		</module>
-		<module name="JavadocMethod">
-			<!-- TODO stricten those checks -->
-			<property name="scope" value="protected"/>
-		</module>
-		<module name="JavadocStyle">
-			<property name="scope" value="public"/>
-			<property name="checkEmptyJavadoc" value="true"/>
-			<property name="checkHtml" value="false"/>
-		</module>
-		<module name="ParenPad">
-		</module>
-		<module name="NoWhitespaceAfter">
-		  <property name="tokens" value="INC
-										 , DEC
-										 , UNARY_MINUS
-										 , UNARY_PLUS
-										 , BNOT, LNOT
-										 , DOT
-										 , ARRAY_DECLARATOR
-										 , INDEX_OP
-										 "/>
-		</module>
-		<module name="WhitespaceAfter">
-		  <property name="tokens" value="TYPECAST
-										 , LITERAL_IF
-										 , LITERAL_ELSE
-										 , LITERAL_WHILE
-										 , LITERAL_DO
-										 , LITERAL_FOR
-										 , DO_WHILE
-										 , COMMA
-										 "/>
-		</module>
-		<module name="WhitespaceAround">
-		  <property
-			  name="ignoreEnhancedForColon"
-			  value="false"
-			  />
-		  <!-- Currently disabled tokens: LCURLY, RCURLY, WILDCARD_TYPE, GENERIC_START, GENERIC_END -->
-		  <property
-			  name="tokens"
-			  value="ASSIGN
-					 , ARRAY_INIT
-					 , BAND
-					 , BAND_ASSIGN
-					 , BOR
-					 , BOR_ASSIGN
-					 , BSR
-					 , BSR_ASSIGN
-					 , BXOR
-					 , BXOR_ASSIGN
-					 , COLON
-					 , DIV
-					 , DIV_ASSIGN
-					 , DO_WHILE
-					 , EQUAL
-					 , GE
-					 , GT
-					 , LAMBDA
-					 , LAND
-					 , LE
-					 , LITERAL_CATCH
-					 , LITERAL_DO
-					 , LITERAL_ELSE
-					 , LITERAL_FINALLY
-					 , LITERAL_FOR
-					 , LITERAL_IF
-					 , LITERAL_RETURN
-					 , LITERAL_SWITCH
-					 , LITERAL_SYNCHRONIZED
-					 , LITERAL_TRY
-					 , LITERAL_WHILE
-					 , LOR
-					 , LT
-					 , MINUS
-					 , MINUS_ASSIGN
-					 , MOD
-					 , MOD_ASSIGN
-					 , NOT_EQUAL
-					 , PLUS
-					 , PLUS_ASSIGN
-					 , QUESTION
-					 , SL
-					 , SLIST
-					 , SL_ASSIGN
-					 , SR
-					 , SR_ASSIGN
-					 , STAR
-					 , STAR_ASSIGN
-					 , LITERAL_ASSERT
-					 , TYPE_EXTENSION_AND
-					 "/>
-		</module>
-		<module name="CustomImportOrder">
-			<property name="customImportOrderRules"
-					  value="STATIC###STANDARD_JAVA_PACKAGE###SPECIAL_IMPORTS###THIRD_PARTY_PACKAGE"/>
-			<property name="specialImportsRegExp" value="^org\.jivesoftware\.smack"/>
-			<property name="sortImportsInGroupAlphabetically" value="true"/>
-			<property name="separateLineBetweenGroups" value="true"/>
-		</module>
-		<module name="MissingJavadocPackage"/>
-		<module name="UnnecessaryParentheses"/>
-		<module name="UnnecessarySemicolonInEnumeration"/>
-		<module name="UnnecessarySemicolonInTryWithResources"/>
-	</module>
-</module>

config/checkstyle/smack-examples-gplv3-license-header.txt

@@ -1,20 +0,0 @@
-/**
- *
- * Copyright 20XX John Doe
- *
- * This file is part of smack-examples.
- *
- * smack-examples is free software; you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published by
- * the Free Software Foundation; either version 3 of the License, or
- * (at your option) any later version.
- *
- * This program is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- * GNU General Public License for more details.
- *
- * You should have received a copy of the GNU General Public License
- * along with this program; if not, write to the Free Software Foundation,
- * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301  USA
- */

config/checkstyle/smack-omemo-signal-gplv3-license-header.txt

@@ -1,20 +0,0 @@
-/**
- *
- * Copyright 20XX John Doe
- *
- * This file is part of smack-omemo-signal.
- *
- * smack-omemo-signal is free software; you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published by
- * the Free Software Foundation; either version 3 of the License, or
- * (at your option) any later version.
- *
- * This program is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- * GNU General Public License for more details.
- *
- * You should have received a copy of the GNU General Public License
- * along with this program; if not, write to the Free Software Foundation,
- * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301  USA
- */

config/checkstyle/smack-omemo-signal-integration-test-gplv3-license-header.txt

@@ -1,20 +0,0 @@
-/**
- *
- * Copyright 20XX John Doe
- *
- * This file is part of smack-omemo-signal-integration-test.
- *
- * smack-omemo-signal-integration-test is free software; you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published by
- * the Free Software Foundation; either version 3 of the License, or
- * (at your option) any later version.
- *
- * This program is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- * GNU General Public License for more details.
- *
- * You should have received a copy of the GNU General Public License
- * along with this program; if not, write to the Free Software Foundation,
- * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301  USA
- */

config/checkstyle/smack-repl-gplv3-license-header.txt

@@ -1,20 +0,0 @@
-/**
- *
- * Copyright 20XX John Doe
- *
- * This file is part of smack-repl.
- *
- * smack-repl is free software; you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published by
- * the Free Software Foundation; either version 3 of the License, or
- * (at your option) any later version.
- *
- * This program is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- * GNU General Public License for more details.
- *
- * You should have received a copy of the GNU General Public License
- * along with this program; if not, write to the Free Software Foundation,
- * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301  USA
- */

config/scalaStyle.xml

@@ -1,144 +0,0 @@
-<scalastyle commentFilter="enabled">
- <name>Scalastyle standard configuration</name>
- <check level="error" class="org.scalastyle.file.FileTabChecker" enabled="true"></check>
- <check level="error" class="org.scalastyle.file.FileLengthChecker" enabled="true">
-  <parameters>
-   <parameter name="maxFileLength"><![CDATA[800]]></parameter>
-  </parameters>
- </check>
- <check level="error" class="org.scalastyle.file.HeaderMatchesChecker" enabled="true">
-   <parameters>
-    <parameter name="regex">true</parameter>
-    <parameter name="header"><![CDATA[/\*\*
- \*
- \* Copyright 2.*
- \*
- \* Licensed 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.
- \*/]]></parameter>
-  </parameters>
- </check>
- <check level="error" class="org.scalastyle.scalariform.SpacesAfterPlusChecker" enabled="true"></check>
- <check level="error" class="org.scalastyle.file.WhitespaceEndOfLineChecker" enabled="true"></check>
- <check level="error" class="org.scalastyle.scalariform.SpacesBeforePlusChecker" enabled="true"></check>
- <check level="error" class="org.scalastyle.file.FileLineLengthChecker" enabled="true">
-  <parameters>
-   <parameter name="maxLineLength"><![CDATA[160]]></parameter>
-   <parameter name="tabSize"><![CDATA[4]]></parameter>
-  </parameters>
- </check>
- <check level="error" class="org.scalastyle.scalariform.ClassNamesChecker" enabled="true">
-  <parameters>
-   <parameter name="regex"><![CDATA[[A-Z][A-Za-z]*]]></parameter>
-  </parameters>
- </check>
- <check level="error" class="org.scalastyle.scalariform.ObjectNamesChecker" enabled="true">
-  <parameters>
-   <parameter name="regex"><![CDATA[[A-Z][A-Za-z]*]]></parameter>
-  </parameters>
- </check>
- <check level="error" class="org.scalastyle.scalariform.PackageObjectNamesChecker" enabled="true">
-  <parameters>
-   <parameter name="regex"><![CDATA[^[a-z][A-Za-z]*$]]></parameter>
-  </parameters>
- </check>
- <check level="error" class="org.scalastyle.scalariform.EqualsHashCodeChecker" enabled="true"></check>
- <check level="error" class="org.scalastyle.scalariform.IllegalImportsChecker" enabled="true">
-  <parameters>
-   <parameter name="illegalImports"><![CDATA[sun._,java.awt._]]></parameter>
-  </parameters>
- </check>
- <check level="error" class="org.scalastyle.scalariform.ParameterNumberChecker" enabled="true">
-  <parameters>
-   <parameter name="maxParameters"><![CDATA[8]]></parameter>
-  </parameters>
- </check>
- <check level="error" class="org.scalastyle.scalariform.MagicNumberChecker" enabled="true">
-  <parameters>
-   <parameter name="ignore"><![CDATA[-1,0,1,2,3]]></parameter>
-  </parameters>
- </check>
- <check level="error" class="org.scalastyle.scalariform.NoWhitespaceBeforeLeftBracketChecker" enabled="true"></check>
- <check level="error" class="org.scalastyle.scalariform.NoWhitespaceAfterLeftBracketChecker" enabled="true"></check>
- <check level="error" class="org.scalastyle.scalariform.ReturnChecker" enabled="true"></check>
- <check level="error" class="org.scalastyle.scalariform.NullChecker" enabled="true"></check>
- <check level="error" class="org.scalastyle.scalariform.NoCloneChecker" enabled="true"></check>
- <check level="error" class="org.scalastyle.scalariform.NoFinalizeChecker" enabled="true"></check>
- <check level="error" class="org.scalastyle.scalariform.CovariantEqualsChecker" enabled="true"></check>
- <check level="error" class="org.scalastyle.scalariform.StructuralTypeChecker" enabled="true"></check>
- <check level="error" class="org.scalastyle.file.RegexChecker" enabled="true">
-  <parameters>
-   <parameter name="regex"><![CDATA[println]]></parameter>
-  </parameters>
- </check>
- <check level="error" class="org.scalastyle.scalariform.NumberOfTypesChecker" enabled="true">
-  <parameters>
-   <parameter name="maxTypes"><![CDATA[30]]></parameter>
-  </parameters>
- </check>
- <check level="error" class="org.scalastyle.scalariform.CyclomaticComplexityChecker" enabled="true">
-  <parameters>
-   <parameter name="maximum"><![CDATA[10]]></parameter>
-  </parameters>
- </check>
- <check level="error" class="org.scalastyle.scalariform.UppercaseLChecker" enabled="true"></check>
- <check level="error" class="org.scalastyle.scalariform.SimplifyBooleanExpressionChecker" enabled="true"></check>
- <check level="error" class="org.scalastyle.scalariform.IfBraceChecker" enabled="true">
-  <parameters>
-   <parameter name="singleLineAllowed"><![CDATA[true]]></parameter>
-   <parameter name="doubleLineAllowed"><![CDATA[false]]></parameter>
-  </parameters>
- </check>
- <check level="error" class="org.scalastyle.scalariform.MethodLengthChecker" enabled="true">
-  <parameters>
-   <parameter name="maxLength"><![CDATA[50]]></parameter>
-  </parameters>
- </check>
- <check level="error" class="org.scalastyle.scalariform.MethodNamesChecker" enabled="true">
-  <parameters>
-   <parameter name="regex"><![CDATA[^[a-z][A-Za-z0-9]*$]]></parameter>
-  </parameters>
- </check>
- <check level="error" class="org.scalastyle.scalariform.NumberOfMethodsInTypeChecker" enabled="true">
-  <parameters>
-   <parameter name="maxMethods"><![CDATA[30]]></parameter>
-  </parameters>
- </check>
- <check level="error" class="org.scalastyle.scalariform.PublicMethodsHaveTypeChecker" enabled="true"></check>
- <check level="error" class="org.scalastyle.file.NewLineAtEofChecker" enabled="true"></check>
- <check level="error" class="org.scalastyle.file.NoNewLineAtEofChecker" enabled="false"></check>
- <check level="error" class="org.scalastyle.scalariform.WhileChecker" enabled="false"></check>
- <check level="error" class="org.scalastyle.scalariform.VarFieldChecker" enabled="false"></check>
- <check level="error" class="org.scalastyle.scalariform.VarLocalChecker" enabled="false"></check>
- <check level="error" class="org.scalastyle.scalariform.RedundantIfChecker" enabled="false"></check>
- <check level="error" class="org.scalastyle.scalariform.TokenChecker" enabled="false">
-  <parameters>
-   <parameter name="regex"><![CDATA[println]]></parameter>
-  </parameters>
- </check>
- <check level="error" class="org.scalastyle.scalariform.DeprecatedJavaChecker" enabled="true"></check>
- <check level="error" class="org.scalastyle.scalariform.EmptyClassChecker" enabled="true"></check>
- <check level="error" class="org.scalastyle.scalariform.ClassTypeParameterChecker" enabled="true">
-  <parameters>
-   <parameter name="regex"><![CDATA[^[A-Z_]$]]></parameter>
-  </parameters>
- </check>
- <check level="error" class="org.scalastyle.scalariform.UnderscoreImportChecker" enabled="true"></check>
- <check level="error" class="org.scalastyle.scalariform.LowercasePatternMatchChecker" enabled="true"></check>
- <check level="error" class="org.scalastyle.scalariform.MultipleStringLiteralsChecker" enabled="true">
-  <parameters>
-   <parameter name="allowed"><![CDATA[2]]></parameter>
-   <parameter name="ignoreRegex"><![CDATA[^""$]]></parameter>
-  </parameters>
- </check>
- <check level="error" class="org.scalastyle.scalariform.ImportGroupingChecker" enabled="true"></check>
-</scalastyle>

config/suppressions.xml

@@ -3,11 +3,11 @@
     "-//Puppy Crawl//DTD Suppressions 1.1//EN"
     "http://www.puppycrawl.com/dtds/suppressions_1_1.dtd">
 <suppressions>
+	<suppress checks="IllegalImport"
+			  files="Java7HostnameVerifier.java"/>
 	<!-- GenericWhitespace has some problems with false postive, leave
 it disabled until gradle uses a checkstyle version where this is fixed
 -->
 	<suppress checks="GenericWhitespace"
 			  files="Protocol.java" />
-	<!-- Suppress JavadocPackage in the test packages -->
-	<suppress checks="JavadocPackage" files="[\\/]test(Fixtures)?[\\/]"/>
 </suppressions>

documentation/README.md

@@ -0,0 +1 @@
+index.md

documentation/connections.md

@@ -0,0 +1,60 @@
+Smack: XMPPConnection Management
+================================
+
+[Back](index.md)
+
+Creating a Connection
+---------------------
+
+The `org.jivesoftware.smack.XMPPConnection` class manages your connection to
+an XMPP server. The default implementation is the
+`org.jivesoftware.smack.XMPPTCPConnection` class. Two constructors are mainly
+used. The first, `XMPPTCPConnection(String)` takes the server name you'd like
+to connect to as an argument. All default connection settings will be used:
+
+  * A DNS SRV lookup will be performed to find the exact address and port (typically 5222) that the server resides at.
+  * The maximum security possible will be negotiated with the server, including TLS encryption, but the connection will fall back to lower security settings if necessary.
+  * The XMPP resource name "Smack" will be used for the connection.
+Alternatively, you can use the `XMPPTCPConnection(ConnectionConfiguration)`
+constructor to specify advanced connection settings. Some of these settings
+include:
+
+  * Manually specify the server address and port of the server rather than using a DNS SRV lookup.
+  * Enable connection compression.
+  * Customize security settings, such as flagging the connection to require TLS encryption in order to connect.
+  * Specify a custom connection resource name such as "Work" or "Home". Every connection by a user to a server must have a unique resource name. For the user "jsmith@example.com", the full address with resource might be "jsmith@example.com/Smack". With unique resource names, a user can be logged into the server from multiple locations at once, or using multiple devices. The presence priority value used with each resource will determine which particular connection receives messages to the bare address ("jsmith@example.com" in our example).
+
+Connect and Disconnect
+----------------------
+
+```
+// Create the configuration for this new connection
+XMPPTCPConnectionConfiguration.Builder configBuilder = XMPPTCPConnectionConfiguration.builder();
+configBuilder.setUsernameAndPassword("username", "password");
+configBuilder.setResource("SomeResource");
+configBuilder.setServiceName("jabber.org");
+
+AbstractXMPPConnection connection = new XMPPTCPConnection(configBuilder.build());
+// Connect to the server
+connection.connect();
+// Log into the server
+connection.login();
+
+...
+
+// Disconnect from the server
+connection.disconnect();
+```
+
+By default Smack will try to reconnect the connection in case it was abruptly
+disconnected. Use _ConnectionConfiguration#setReconnectionAllowed(boolean) to
+turn on/off this feature. The reconnection manager will try to immediately
+reconnect to the server and increase the delay between attempts as successive
+reconnections keep failing._
+
+In case you want to force a reconnection while the reconnetion manager is
+waiting for the next reconnection, you can just use _AbstractXMPPConnection#connect()_
+and a new attempt will be made. If the manual attempt also failed then the
+reconnection manager will still continue the reconnection job.
+
+Copyright (C) Jive Software 2002-2008

documentation/debugging.md

@@ -0,0 +1,62 @@
+Debugging with Smack
+====================
+
+[Back](index.md)
+
+Smack includes two built-in debugging consoles that will let you track
+all XML traffic between the client and server. A lite debugger and an
+enhanced debugger contained in `smack-debug.jar`, and a console debugger in `smack-core.jar`.
+
+Debugging mode can be enabled in two different ways:
+
+  1. Add the following line of code **before** creating new connections:
+
+`SmackConfiguration.DEBUG = true;`
+
+  2. Set the Java system property `smack.debugEnabled` to true. The system property can be set on the command line such as:
+
+`java -Dsmack.debugEnabled=true SomeApp `
+
+If you wish to explicitly disable debug mode in your application, including
+using the command-line parameter, add the following line to your application
+before opening new connections:
+
+`SmackConfiguration.DEBUG = false;`
+
+Smack uses the following logic to decide the debugger console to use:
+
+  1. It will first try use the debugger class specified in the Java system property `smack.debuggerClass`. If you need to develop your own debugger, implement the `SmackDebugger` interface and then set the system property on the command line such as:
+
+`java -Dsmack.debuggerClass=my.company.com.MyDebugger SomeApp `
+
+  2. If step 1 fails then Smack will try to use the enhanced debugger. The file `smackx-debug.jar` contains the enhanced debugger. Therefore you will need to place the jar file in the classpath. For situations where space is an issue you may want to only deploy `smack-core.jar` in which case the enhanced and lite debugger won't be available, but only the console debugger.
+
+  3. The last option if the previous two steps fail is to use the console debugger. The console debugger is a very good option for situations where you need to have low memory footprint.
+
+Enhanced Debugger
+-----------------
+
+![Full Debug Window](images/enhanceddebugger.png) When debugging mode is
+enabled, a debug window will appear containing tabs for each new created
+connection. The window will contain the following information:
+
+  * XMPPConnection tabs -- each tab shows debugging information related to the connection.
+  * Smack info tab -- shows information about Smack (e.g. Smack version, installed components, etc.).  The connection tab will contain the following information:
+  * All Stanzas -- shows sent and received packets information parsed by Smack.
+  * Raw Sent Stanzas -- raw XML traffic generated by Smack and sent to the server.
+  * Raw Received Stanzas -- raw XML traffic sent by the server to the client.
+  * Ad-hoc message -- allows to send ad-hoc packets of any type.
+  * Information -- shows connection state and statistics.
+
+Lite Debugger
+-------------
+
+![Lite Debug Window](images/debugwindow.gif) When debugging mode is enabled, a
+debug window will appear when each new connection is created. The window will
+contain the following information:
+
+  * Client Traffic (red text) -- raw XML traffic generated by Smack and sent to the server.
+  * Server Traffic (blue text) -- raw XML traffic sent by the server to the client.
+  * Interpreted Stanzas (green text) -- shows XML packets from the server as parsed by Smack.  Right click on any of the panes to bring up a menu with the choices to copy of the contents to the system clipboard or to clear the contents of the pane.
+
+Copyright (C) Jive Software 2002-2008

documentation/developer/provider.md

@@ -0,0 +1,72 @@
+Smack Providers
+===============
+
+Providers are responsible for parsing the XMPP XML stream into new Java objects.
+
+Provider Design
+---------------
+
+Assume you want to parse the following stanza extension element
+
+```xml
+<myExtension attrFoo='fourthyTwo'>
+  <myElement>Foo is greater then Bar</myElement>
+  <myInfo alpha='true' delta='-1337'/>
+</myExtension>
+```
+
+then the related provider would look like this
+
+```java
+public MyExtension parse(XmlPullParser parser, int initialDepth) {
+  MyElement myElement = null;
+  MyInfo myInfo = null;
+  String attrFoo = parser.getAttributeValue("", "attrFoo");
+
+  // Main parsing loop, use a loop label instead of "boolean done"
+  outerloop: while(true) {
+    // Make sure to have already parse all attributes of the outermost element,
+    // i.e. 'attrFoo' of 'myExtension' in this example. Then advance the parser
+    int event = parser.next();
+
+    // Use switch/case of int instead of a if/else-if cascade
+    switch (event) {
+    case XmlPullParser.START_TAG:
+      // Determine the name of the element which start tag we are seeing
+      String name = parser.getName();
+      // We can use switch/case of Strings since Java7, make use of its advantages
+      // and collect the values of the sub elements. If the sub elements are more
+      // complex then those of this example, consider creating extra *private static*
+      // parsing methods for them.
+      switch(name) {
+      case "myElement":
+        // You should only use XmlPullParser.nextText() when the element is
+        // required to have a text.
+        myElement = new MyElement(parser.nextText());
+        break;
+      case "myInfo";
+        // Use ParserUtils to parse Java primitives
+        boolenan alpha = ParserUtils.getBooleanAttribute(parser, "alpha");
+        int delta = ParserUtils.getIntegerAttribute(parser, "delta");
+        myInfo = new MyInfo(alpha, delta);
+        break;
+      }
+      break;
+    case XmlPullParser.END_TAG:
+      // The abort condition with the break labeled loop statement
+      if (parser.getDepth() == initialDepth) {
+        break outerloop;
+      }
+      break;
+    }
+  }
+
+  // Create the actual class at the very end, design the classes as immutable as possible
+  return new MyExtension(attrFoo, myElement, myInfo);
+}
+```
+
+Common Pitfalls
+---------------
+
+Use a `long` instead of `int` when the XML schema says `xs:unsignedInt`, because Java's `int` range is to small for this XML numeric data type.

documentation/developer/stanzas.md

@@ -0,0 +1,17 @@
+PacketExtension
+===============
+
+The static `from(Stanza)` Method
+--------------------------------
+
+Every PacketExtension class must have a static `from()` method that retrieves that extension for a given Stanza (if any).
+
+Sample Code
+
+```java
+public static RSMSet from(Stanza) {
+  return packet.getExtension(ELEMENT, NAMESPACE);
+}
+```
+
+Sometimes certain PacketExtension's are only found in one stanza type, in that case, specify the parameter type. For example `public static CarbonExtension getFrom(Message)`.

documentation/extensions/caps.md

@@ -0,0 +1,47 @@
+Entity Capabilities
+===================
+
+This section details the usage of Smacks implementation of Entity
+Capabilities.
+
+**XEP related:** [XEP-0115: Entity Capabilities](http://xmpp.org/extensions/xep-0115.html)
+
+**Description**
+
+Entity Capabilities is an XMPP Protocol extension, which, in order to minimize
+network impact, caches the capabilities of XMPP entities. Those capabilities
+are determined with the help of the Service Discovery Protocol
+([XEP-0030](http://xmpp.org/extensions/xep-0030.html)).
+
+**Usage**
+
+Entity Capabilities work silenty in background when enabled. If the remote
+XMPP entity does not support XEP-0115 but XEP-0030 then XEP-0030 mechanisms
+are transparently used. You can enable or disable Entity Capabilities by using
+_**EntityCapsManager**_.
+
+The cache used by Smack for Entity Capabilities is non-persistent as default.
+That is, the cache only uses memory. But it is also possible to set a
+persistent Entity Capabilities cache, which is recommended.
+
+**Examples**
+
+Enable Entity Capabilities
+
+```
+// Get an instance of entity caps manager for the specified connection
+EntityCapsManager mgr = EntityCapsManager.getInstanceFor(connection);
+// Enable entity capabilities
+mgr.enableEntityCaps();
+```
+
+Configure a persistent cache for Entity Capabilities
+
+```
+// Get an instance of entity caps manager for the specified connection
+EntityCapsManager mgr = EntityCapsManager.getInstanceFor(connection);
+// Create an cache, see smackx.entitycaps.cache for pre-defined cache implementations
+EntityCapsPersistentCache cache = new SimpleDirectoryPersistentCache(new File("/foo/cachedir"));
+// Set the cache
+mgr.setPersistentCache(cache);
+```

documentation/extensions/dataforms.md

@@ -0,0 +1,127 @@
+Data Forms
+==========
+
+Allows to exchange structured data between users and applications for common
+tasks such as registration and searching using Forms.
+
+  * Create a Form to fill out
+  * Answer a Form
+
+**XEP related:** [XEP-4](http://www.xmpp.org/extensions/xep-0004.html)
+
+Create a Form to fill out
+-------------------------
+
+**Description**
+
+An XMPP entity may need to gather data from another XMPP entity. Therefore,
+the data-gathering entity will need to create a new Form, specify the fields
+that will conform the Form and finally send the Form to the data-providing
+entity.
+
+**Usage**
+
+In order to create a Form to fill out use the _**Form**_'s constructor passing
+the constant **DataForm.type.form** as the parameter. The next step is to create
+the form fields and add them to the form. In order to create and customize a
+_**FormField**_ use the _**FormField**_'s constructor specifying the variable
+name of the field as the parameter. Then use **setType(String type)** to set
+the field's type (e.g. FormField.type.hidden, FormField.type.text_single).
+Once we have the _**Form**_ instance and the _**FormFields**_ the last step is
+to send **addField(FormField field)** for each field that we want to add to
+the form.
+
+Once the form to fill out is finished we will want to send it in a message.
+Send **getDataFormToSend()** to the form and add the answer as an extension to
+the message to send.
+
+**Examples**
+
+In this example we can see how to create and send a form to fill out:
+
+```
+// Create a new form to gather data
+Form formToSend = new Form(DataForm.type.form);
+formToSend.setInstructions(Fill out this form to report your case.\nThe case will be created automatically.");
+formToSend.setTitle("Case configurations");
+// Add a hidden variable to the form
+FormField field = new FormField("hidden_var");
+field.setType(FormField.type.hidden);
+field.addValue("Some value for the hidden variable");
+formToSend.addField(field);
+// Add a fixed variable to the form
+field = new FormField();
+field.addValue("Section 1: Case description");
+formToSend.addField(field);
+// Add a text-single variable to the form
+field = new FormField("name");
+field.setLabel("Enter a name for the case");
+field.setType(FormField.type.text_single);
+formToSend.addField(field);
+// Add a text-multi variable to the form
+field = new FormField("description");
+field.setLabel("Enter a description");
+field.setType(FormField.type.text_multi);
+formToSend.addField(field);
+// Create a chat with "user2@host.com"
+Chat chat = conn1.createChat("user2@host.com" );
+Message msg = chat.createMessage();
+msg.setBody("To enter a case please fill out this form and send it back");
+// Add the form to fill out to the message to send
+msg.addExtension(formToSend.getDataFormToSend());
+// Send the message with the form to fill out
+chat.sendMessage(msg);
+```
+
+Answer a Form
+-------------
+
+**Description**
+
+Under many situations an XMPP entity could receive a form to fill out. For
+example, some hosts may require to fill out a form in order to register new
+users. Smack lets the data-providing entity to complete the form in an easy
+way and send it back to the data-gathering entity.
+
+**Usage**
+
+The form to fill out contains useful information that could be used for
+rendering the form. But it cannot be used to actually complete it. Instead
+it's necessary to create a new form based on the original form whose purpose
+is to hold all the answers.
+
+In order to create a new _**Form**_ to complete based on the original
+_**Form**_ just send **createAnswerForm()** to the original _**Form**_. Once
+you have a valid form that could be actually completed all you have to do is
+send **setAnswer(String variable, String value)** to the form where variable
+is the variable of the _**FormField**_ that you want to answer and value is
+the String representation of the answer. If the answer consist of several
+values you could then use **setAnswer(String variable, List values)** where
+values is a List of Strings.
+
+Once the form has been completed we will want to send it back in a message.
+Send **getDataFormToSend()** to the form and add the answer as an extension to
+the message to send back.
+
+**Examples**
+
+In this example we can see how to retrieve a form to fill out, complete the
+form and send it back:
+
+```
+// Get the message with the form to fill out
+Message msg2 = chat2.nextMessage();
+// Retrieve the form to fill out from the message
+Form formToRespond = Form.getFormFrom(msg2);
+// Obtain the form to send with the replies
+Form completedForm = formToRespond.createAnswerForm();
+// Add the answers to the form
+completedForm.setAnswer("name", "Credit card number invalid");
+completedForm.setAnswer("description", "The ATM says that my credit card number is invalid");
+msg2 = chat2.createMessage();
+msg2.setBody("To enter a case please fill out this form and send it back"):
+// Add the completed form to the message to send back
+msg2.addExtension(completedForm.getDataFormToSend());
+// Send the message with the completed form
+chat2.sendMessage(msg2);
+```

documentation/extensions/disco.md

@@ -0,0 +1,224 @@
+Service Discovery
+=================
+
+The service discovery extension allows to discover items and information about
+XMPP entities. Follow these links to learn how to use this extension.
+
+  * Manage XMPP entity features
+  * Provide node information
+  * Discover items associated with an XMPP entity
+  * Discover information about an XMPP entity
+  * Publish publicly available items
+  
+**XEP related:** [XEP-30](http://www.xmpp.org/extensions/xep-0030.html)
+
+Manage XMPP entity features
+---------------------------
+
+**Description**
+
+Any XMPP entity may receive a discovery request and must answer with its
+associated items or information. Therefore, your Smack client may receive a
+discovery request that must respond to (i.e., if your client supports XHTML-
+IM). This extension automatically responds to a discovery request with the
+information that you previously configured.
+
+**Usage**
+
+In order to configure the supported features by your client you should first
+obtain the ServiceDiscoveryManager associated with your XMPPConnection. To get
+your ServiceDiscoveryManager send **getInstanceFor(connection)** to the class
+_**ServiceDiscoveryManager**_ where connection is your XMPPConnection.
+
+Once you have your ServiceDiscoveryManager you will be able to manage the
+supported features. To register a new feature send **addFeature(feature)** to
+your _**ServiceDiscoveryManager**_ where feature is a String that represents
+the supported feature. To remove a supported feature send
+**removeFeature(feature)** to your _**ServiceDiscoveryManager**_ where feature
+is a String that represents the feature to remove.
+
+**Examples**
+
+In this example we can see how to add and remove supported features:
+
+```
+// Obtain the ServiceDiscoveryManager associated with my XMPP connection
+ServiceDiscoveryManager discoManager = ServiceDiscoveryManager.getInstanceFor(connection);
+// Register that a new feature is supported by this XMPP entity
+discoManager.addFeature(namespace1);
+// Remove the specified feature from the supported features
+discoManager.removeFeature(namespace2);
+```
+
+Provide node information
+------------------------
+
+**Description**
+
+Your XMPP entity may receive a discovery request for items non-addressable as
+a JID such as the MUC rooms where you are joined. In order to answer the
+correct information it is necessary to configure the information providers
+associated to the items/nodes within the Smack client.
+
+**Usage**
+
+In order to configure the associated nodes within the Smack client you will
+need to create a NodeInformationProvider and register it with the
+_**ServiceDiscoveryManager**_. To get your ServiceDiscoveryManager send
+**getInstanceFor(connection)** to the class _**ServiceDiscoveryManager**_
+where connection is your XMPPConnection.
+
+Once you have your ServiceDiscoveryManager you will be able to register
+information providers for the XMPP entity's nodes. To register a new node
+information provider send **setNodeInformationProvider(String node,
+NodeInformationProvider listener)** to your _**ServiceDiscoveryManager**_
+where node is the item non-addressable as a JID and listener is the
+_**NodeInformationProvider**_ to register. To unregister a
+_**NodeInformationProvider**_ send **removeNodeInformationProvider(String
+node)** to your _**ServiceDiscoveryManager**_ where node is the item non-
+addressable as a JID whose information provider we want to unregister.
+
+**Examples**
+
+In this example we can see how to register a NodeInformationProvider with a
+ServiceDiscoveryManager that will provide information concerning a node named
+"http://jabber.org/protocol/muc#rooms":
+
+```
+// Set the NodeInformationProvider that will provide information about the
+// joined rooms whenever a disco request is received
+ServiceDiscoveryManager.getInstanceFor(connection).setNodeInformationProvider(
+	"http://jabber.org/protocol/muc#rooms",
+	new NodeInformationProvider() {
+		public List getNodeItems() {
+			ArrayList answer = new ArrayList();
+			Iterator rooms = MultiUserChat.getJoinedRooms(connection);
+			while (rooms.hasNext()) {
+				answer.add(new DiscoverItems.Item((String)rooms.next()));
+			}
+			return answer;
+		}
+});
+```
+
+Discover items associated with an XMPP entity
+---------------------------------------------
+
+**Description**
+
+In order to obtain information about a specific item you have to first
+discover the items available in an XMPP entity.
+
+**Usage**
+
+Once you have your ServiceDiscoveryManager you will be able to discover items
+associated with an XMPP entity. To discover the items of a given XMPP entity
+send **discoverItems(entityID)** to your _**ServiceDiscoveryManager**_ where
+entityID is the ID of the entity. The message **discoverItems(entityID)** will
+answer an instance of _**DiscoverItems**_ that contains the discovered items.
+
+**Examples**
+
+In this example we can see how to discover the items associated with an online
+catalog service:
+
+```
+// Obtain the ServiceDiscoveryManager associated with my XMPPConnection
+ServiceDiscoveryManager discoManager = ServiceDiscoveryManager.getInstanceFor(connection);
+// Get the items of a given XMPP entity
+// This example gets the items associated with online catalog service
+DiscoverItems discoItems = discoManager.discoverItems("plays.shakespeare.lit");
+// Get the discovered items of the queried XMPP entity
+Iterator it = discoItems.getItems();
+// Display the items of the remote XMPP entity
+while (it.hasNext()) {
+	DiscoverItems.Item item = (DiscoverItems.Item) it.next();
+	System.out.println(item.getEntityID());
+	System.out.println(item.getNode());
+	System.out.println(item.getName());
+}
+```
+
+Discover information about an XMPP entity
+-----------------------------------------
+
+**Description**
+
+Once you have discovered the entity ID and name of an item, you may want to
+find out more about the item. The information desired generally is of two
+kinds: 1) The item's identity and 2) The features offered by the item.
+
+This information helps you determine what actions are possible with regard to
+this item (registration, search, join, etc.) as well as specific feature types
+of interest, if any (e.g., for the purpose of feature negotiation).
+
+**Usage**
+
+Once you have your ServiceDiscoveryManager you will be able to discover
+information associated with an XMPP entity. To discover the information of a
+given XMPP entity send **discoverInfo(entityID)** to your
+_**ServiceDiscoveryManager**_ where entityID is the ID of the entity. The
+message **discoverInfo(entityID)** will answer an instance of
+_**DiscoverInfo**_ that contains the discovered information.
+
+**Examples**
+
+In this example we can see how to discover the information of a conference
+room:
+
+```
+// Obtain the ServiceDiscoveryManager associated with my XMPPConnection
+ServiceDiscoveryManager discoManager = ServiceDiscoveryManager.getInstanceFor(connection);
+// Get the information of a given XMPP entity
+// This example gets the information of a conference room
+DiscoverInfo discoInfo = discoManager.discoverInfo("balconyscene@plays.shakespeare.lit");
+// Get the discovered identities of the remote XMPP entity
+Iterator it = discoInfo.getIdentities();
+// Display the identities of the remote XMPP entity
+while (it.hasNext()) {
+	DiscoverInfo.Identity identity = (DiscoverInfo.Identity) it.next();
+	System.out.println(identity.getName());
+	System.out.println(identity.getType());
+	System.out.println(identity.getCategory());
+}
+// Check if room is password protected
+discoInfo.containsFeature("muc_passwordprotected");
+```
+
+Publish publicly available items
+--------------------------------
+
+**Description**
+
+Publish your entity items to some kind of persistent storage. This enables
+other entities to query that entity using the disco#items namespace and
+receive a result even when the entity being queried is not online (or
+available).
+
+**Usage**
+
+Once you have your ServiceDiscoveryManager you will be able to publish items
+to some kind of persistent storage. To publish the items of a given XMPP
+entity you have to first create an instance of _**DiscoverItems**_ and
+configure it with the items to publish. Then you will have to send
+**publishItems(String entityID, DiscoverItems discoverItems)** to your
+_**ServiceDiscoveryManager**_ where entityID is the address of the XMPP entity
+that will persist the items and discoverItems contains the items to publish.
+
+**Examples**
+
+In this example we can see how to publish new items:
+
+```
+// Obtain the ServiceDiscoveryManager associated with my XMPPConnection
+ServiceDiscoveryManager discoManager = ServiceDiscoveryManager.getInstanceFor(connection);
+// Create a DiscoverItems with the items to publish
+DiscoverItems itemsToPublish = new DiscoverItems();
+DiscoverItems.Item itemToPublish = new DiscoverItems.Item("pubsub.shakespeare.lit");
+itemToPublish.setName("Avatar");
+itemToPublish.setNode("romeo/avatar");
+itemToPublish.setAction(DiscoverItems.Item.UPDATE_ACTION);
+itemsToPublish.addItem(itemToPublish);
+// Publish the new items by sending them to the server
+discoManager.publishItems("host", itemsToPublish);
+```

documentation/extensions/filetransfer.md

@@ -0,0 +1,147 @@
+File Transfer
+=============
+
+The file transfer extension allows the user to transmit and receive files.
+
+  * Send a file to another user
+  * Recieving a file from another user
+  * Monitoring the progress of a file transfer
+
+**XEP related:** [XEP-95](http://www.xmpp.org/extensions/xep-0095.html) [XEP-96](http://www.xmpp.org/extensions/xep-0096.html) [XEP-65](http://www.xmpp.org/extensions/xep-0065.html) [XEP-47](http://www.xmpp.org/extensions/xep-0047.html)
+
+Send a file to another user
+---------------------------
+
+**Description**
+
+A user may wish to send a file to another user. The other user has the option
+of acception, rejecting, or ignoring the users request. Smack provides a
+simple interface in order to enable the user to easily send a file. **Usage**
+
+In order to send a file you must first construct an instance of the
+**_FileTransferManager_** class. In order to instantiate the manager
+you should call _FileTransferManager.getInstanceFor(connection)_
+
+Once you have your **_FileTransferManager_** you will need to create an
+outgoing file transfer to send a file. The method to use on the
+**_FileTransferManager_** is the **createOutgoingFileTransfer(userID)**
+method. The userID you provide to this method is the fully-qualified jabber ID
+of the user you wish to send the file to. A fully-qualified jabber ID consists
+of a node, a domain, and a resource, the user must be connected to the
+resource in order to be able to recieve the file transfer.
+
+Now that you have your **_OutgoingFileTransfer_** instance you will want to
+send the file. The method to send a file is **sendFile(file, description)**.
+The file you provide to this method should be a readable file on the local
+file system, and the description is a short description of the file to help
+the user decide whether or not they would like to recieve the file.
+
+For information on monitoring the progress of a file transfer see the
+monitoring progress section of this document.
+
+Other means to send a file are also provided as part of the
+**_OutgoingFileTransfer_**. Please consult the Javadoc for more information.
+**Examples**
+
+In this example we can see how to send a file:
+
+```
+// Create the file transfer manager
+FileTransferManager manager = FileTransferManager.getInstanceFor(connection);
+// Create the outgoing file transfer
+OutgoingFileTransfer transfer = manager.createOutgoingFileTransfer("romeo@montague.net");
+// Send the file
+transfer.sendFile(new File("shakespeare_complete_works.txt"), "You won't believe this!");
+```
+
+Recieving a file from another user
+----------------------------------
+
+**Description**
+
+The user may wish to recieve files from another user. The process of recieving
+a file is event driven, new file transfer requests are recieved from other
+users via a listener registered with the file transfer manager.
+
+**Usage**
+
+In order to recieve a file you must first construct an instance of the
+**_FileTransferManager_** class. This class has one constructor with one
+parameter which is your XMPPConnection. In order to instantiate the manager
+you should call _FileTransferManager.getInstanceFor(connection)_
+
+Once you have your **_FileTransferManager_** you will need to register a
+listener with it. The FileTransferListner interface has one method,
+**fileTransferRequest(request)**. When a request is recieved through this
+method, you can either accept or reject the request. To help you make your
+decision there are several methods in the **_FileTransferRequest_** class that
+return information about the transfer request.
+
+To accept the file transfer, call the **accept()**, this method will create an
+**_IncomingFileTransfer_**. After you have the file transfer you may start to
+transfer the file by calling the **recieveFile(file)** method. The file
+provided to this method will be where the data from thefile transfer is saved.
+
+Finally, to reject the file transfer the only method you need to call is
+**reject()** on the **_IncomingFileTransfer_**.
+
+For information on monitoring the progress of a file transfer see the
+monitoring progress section of this document.
+
+Other means to recieve a file are also provided as part of the
+**_IncomingFileTransfer_**. Please consult the Javadoc for more information.
+**Examples**
+
+In this example we can see how to approve or reject a file transfer request:
+
+```
+// Create the file transfer manager
+final FileTransferManager manager = FileTransferManager.getInstanceFor(connection);
+// Create the listener
+manager.addFileTransferListener(new FileTransferListener() {
+	public void fileTransferRequest(FileTransferRequest request) {
+	// Check to see if the request should be accepted
+	if(shouldAccept(request)) {
+		// Accept it
+		IncomingFileTransfer transfer = request.accept();
+		transfer.recieveFile(new File("shakespeare_complete_works.txt"));
+	} else {
+		// Reject it
+		request.reject();
+	}
+}
+});
+```
+
+Monitoring the progress of a file transfer
+------------------------------------------
+
+**Description**
+
+While a file transfer is in progress you may wish to monitor the progress of a
+file transfer.
+
+**Usage**
+
+Both the **_IncomingFileTransfer_** and the **_OutgoingFileTransfer_** extend
+the **_FileTransfer_** class which provides several methods to monitor how a
+file transfer is progressing:
+
+  * **getStatus()** - The file transfer can be in several states, negotiating, rejected, canceled, in progress, error, and complete. This method will return which state the file transfer is currently in. 
+  * **getProgress()** - if the status of the file transfer is in progress this method will return a number between 0 and 1, 0 being the transfer has not yet started and 1 being the transfer is complete. It may also return a -1 if the transfer is not in progress. 
+  * **isDone()** - Similar to getProgress() except it returns a _boolean_. If the state is rejected, canceled, error, or complete then true will be returned and false otherwise. 
+  * **getError()** - If there is an error during the file transfer this method will return the type of error that occured.  **Examples**
+
+In this example we can see how to monitor a file transfer:
+
+```
+while(!transfer.isDone()) {
+	if(transfer.getStatus().equals(Status.ERROR)) {
+		System.out.println("ERROR!!! " + transfer.getError());
+	} else {
+		System.out.println(transfer.getStatus());
+		System.out.println(transfer.getProgress());
+	}
+	sleep(1000);
+}
+```

documentation/extensions/hoxt.md

@@ -0,0 +1,108 @@
+HTTP over XMPP transport
+========================
+
+Allows to transport HTTP communication over XMPP peer-to-peer networks.
+
+  * Discover HOXT support
+  * IQ exchange
+
+
+Discover HOXT support
+---------------------
+
+**Description**
+
+Before using this extension you must ensure that your counterpart supports it
+also.
+
+**Usage**
+
+Once you have your _**ServiceDiscoveryManager**_ you will be able to discover
+information associated with an XMPP entity. To discover the information of a
+given XMPP entity send **discoverInfo(entityID)** to your
+_**ServiceDiscoveryManager**_ where entityID is the ID of the entity. The
+message **discoverInfo(entityID)** will answer an instance of
+_**DiscoverInfo**_ that contains the discovered information.
+
+**Examples**
+
+In this example we can see how to check if the counterpart supports HOXT:
+
+```
+// Obtain the ServiceDiscoveryManager associated with my XMPPConnection
+ServiceDiscoveryManager discoManager = ServiceDiscoveryManager.getInstanceFor(connection);
+// Get the information of a given XMPP entity
+DiscoverInfo discoInfo = discoManager.discoverInfo("juliet@capulet.com");
+// Check if room is HOXT is supported
+discoInfo.containsFeature("urn:xmpp:http");
+```
+IQ exchange
+-----------
+
+**Description**
+
+You can use IQ's to perform HTTP requests and responses. This is applicable to
+relatively short requests and responses (due to limitation of XMPP message
+size).
+
+**Usage**
+
+First you need to register a _**PacketListener**_ to be able to handle
+intended IQs.
+
+For the HTTP client you:
+
+  * You create and send _**HttpOverXmppReq**_ request.
+  * Then you handle the _**HttpOverXmppResp**_ response in your _**PacketListener**_.
+For the HTTP server you:
+
+  * You handle the _**HttpOverXmppReq**_ requests in your _**PacketListener**_.
+  * And create and send _**HttpOverXmppResp**_ responses.
+
+**Examples**
+
+In this example we are HTTP client, so we send request (POST) and handle the
+response:
+
+```
+// create a request body
+String urlEncodedMessage = "I_love_you";
+
+// create request
+HttpOverXmppReq req = new HttpOverXmppReq(HttpMethod.POST, "/mailbox");
+req.setVersion("1.1");
+
+// prepare headers
+Set<Header> set = new HashSet<Header>();
+set.add(new Header("Host", "juliet.capulet.com"));
+set.add(new Header("Content-Type", "application/x-www-form- urlencoded"));
+set.add(new Header("Content-Length", Integer.toString(urlEncodedMessage.length())));
+req.setHeaders(new HeadersExtension(set));
+
+// provide body or request (not mandatory, - empty body is used for GET)
+AbstractHttpOverXmpp.Text child = new AbstractHttpOverXmpp.Text(urlEncodedMessage);
+AbstractHttpOverXmpp.Data data = new AbstractHttpOverXmpp.Data(child);
+req.setData(data);
+
+// add to
+req.setTo("juliet@capulet.com/balcony");
+
+// send it
+connection.sendIqWithResponseCallback(req, new PacketListener() {
+   public void processPacket(Stanza packet) {
+		HttpOverXmppResp resp = (HttpOverXmppResp) iq;
+		// check HTTP response code
+		if (resp.getStatusCode() == 200) {
+			// get content of the response
+			NamedElement child = resp.getData().getChild();
+			// check which type of content of the response arrived
+			if (child instanceof AbstractHttpOverXmpp.Xml) {
+				// print the message and anxiously read if from console ;)
+				System.out.println(((AbstractHttpOverXmpp.Xml) child).getText());
+			} else {
+				// process other AbstractHttpOverXmpp.DataChild subtypes
+			}
+		}
+	}
+});
+```

documentation/extensions/index.md

@@ -0,0 +1,86 @@
+Smack Extensions User Manual
+============================
+
+The XMPP protocol includes a base protocol and many optional extensions
+typically documented as "XEP's". Smack provides the org.jivesoftware.smack
+package for the core XMPP protocol, and the org.jivesoftware.smackx package
+for many of the protocol extensions.
+
+This manual provides details about each of the "smackx" extensions, including
+what it is, how to use it, and some simple example code.
+
+Currently supported XEPs of smack-tcp
+-------------------------------------
+
+| Name                                        | XEP                                                      | Description |
+|---------------------------------------------|----------------------------------------------------------|----------------------------------------------------------------------------------------------------------|
+| [Stream Management](streammanagement.md)  | [XEP-0198](http://xmpp.org/extensions/xep-0198.html) | Allows active management of an XML Stream between two XMPP entities (stanza acknowledgement, stream resumption). |
+
+
+Smack Extensions and currently supported XEPs by Smack (smack-extensions)
+-------------------------------------------------------------------------
+
+| Name                                        | XEP                                                      | Description |
+|---------------------------------------------|----------------------------------------------------------|----------------------------------------------------------------------------------------------------------|
+| [Data Forms](dataforms.md)                | [XEP-0004](http://xmpp.org/extensions/xep-0004.html) | Allows to gather data using Forms. |
+| Last Activity                               | [XEP-0012](http://xmpp.org/extensions/xep-0012.html)     | Communicating information about the last activity associated with an XMPP entity. |
+| Flexible Offline Message Retrieval          | [XEP-0013](http://xmpp.org/extensions/xep-0013.html)  | Extension for flexible, POP3-like handling of offline messages. |
+| [Privacy Lists](privacy.md)               | [XEP-0016](http://xmpp.org/extensions/xep-0016.html) | Enabling or disabling communication with other entities. |
+| [Service Discovery](disco.md)             | [XEP-0030](http://xmpp.org/extensions/xep-0030.html) | Allows to discover services in XMPP entities. |
+| Extended Stanza Addressing                  | [XEP-0033](http://xmpp.org/extensions/xep-0033.html) | Allows to include headers in stanzas in order to specifiy multiple recipients or sub-addresses. |
+| [Multi User Chat](muc.md)                 | [XEP-0045](http://xmpp.org/extensions/xep-0045.html) | Allows configuration of, participation in, and administration of individual text-based conference rooms. |
+| In-Band Bytestreams                         | [XEP-0047](http://xmpp.org/extensions/xep-0047.html) | Enables any two entities to establish a one-to-one bytestream between themselves using plain XMPP. |
+| Bookmarks                                   | [XEP-0048](http://xmpp.org/extensions/xep-0048.html)     | Bookmarks, for e.g. MUC and web pages. |
+| [Private Data](privatedata.md)            | [XEP-0049](http://xmpp.org/extensions/xep-0049.html) | Manages private data. |
+| Ad-Hoc Commands                             | [XEP-0050](http://xmpp.org/extensions/xep-0050.html) | Advertising and executing application-specific commands. |
+| vcard-temp                                  | [XEP-0054](http://xmpp.org/extensions/xep-0054.html) | The vCard-XML format currently in use. |
+| Jabber Search                               | [XEP-0055](http://xmpp.org/extensions/xep-0055.html) | Search information repositories on the XMPP network. |
+| Result Set Management                       | [XEP-0059](http://xmpp.org/extensions/xep-0059.html) | Page through and otherwise manage the receipt of large result sets |
+| [PubSub](pubsub.md)                       | [XEP-0060](http://xmpp.org/extensions/xep-0060.html) | Generic publish and subscribe functionality. |
+| SOCKS5 Bytestrams                           | [XEP-0065](http://xmpp.org/extensions/xep-0065.html) | Out-of-band bytestream between any two XMPP entities. |
+| [XHTML-IM](xhtml.md)                      | [XEP-0071](http://xmpp.org/extensions/xep-0071.html) | Allows send and receiving formatted messages using XHTML. |
+| In-Band Registration                        | [XEP-0077](http://xmpp.org/extensions/xep-0077.html) | In-band registration with XMPP services. |
+| Advanced Message Processing                 | [XEP-0079](http://xmpp.org/extensions/xep-0079.html) | Enables entities to request, and servers to perform, advanced processing of XMPP message stanzas. |
+| XMPP Date Time Profiles                     | [XEP-0082](http://xmpp.org/extensions/xep-0082.html)     | Standardization of Date and Time representation in XMPP. |
+| Chat State Notifications                    | [XEP-0085](http://xmpp.org/extensions/xep-0085.html) | Communicating the status of a user in a chat session. |
+| [Time Exchange](time.md)                  | [XEP-0090](http://xmpp.org/extensions/xep-0090.html) | Allows local time information to be shared between users. |
+| Software Version                            | [XEP-0092](http://xmpp.org/extensions/xep-0092.html)     | Retrieve and announce the software application of an XMPP entity. |
+| Stream Initation                            | [XEP-0095](http://xmpp.org/extensions/xep-0095.html) | Initiating a data stream between any two XMPP entities. |
+| [SI File Transfer](filetransfer.md)       | [XEP-0096](http://xmpp.org/extensions/xep-0096.html) | Transfer files between two users over XMPP. |
+| [Entity Capabilities](caps.md)            | [XEP-0115](http://xmpp.org/extensions/xep-0115.html) | Broadcasting and dynamic discovery of entity capabilities. |
+| Data Forms Validation                       | [XEP-0122](http://xmpp.org/extensions/xep-0122.html) | Enables an application to specify additional validation guidelines . |
+| Stream Compression                          | [XEP-0138](http://xmpp.org/extensions/xep-0138.html) | Support for optional compression of the XMPP stream.
+| Data Forms Layout                           | [XEP-0141](http://xmpp.org/extensions/xep-0141.html) | Enables an application to specify form layouts. |
+| Personal Eventing Protocol                  | [XEP-0163](http://xmpp.org/extensions/xep-0163.html) | Using the XMPP publish-subscribe protocol to broadcast state change events associated with an XMPP account. |
+| Message Delivery Receipts                   | [XEP-0184](http://xmpp.org/extensions/xep-0184.html) | Extension for message delivery receipts. The sender can request notification that the message has been delivered. |
+| XMPP Ping                                   | [XEP-0199](http://xmpp.org/extensions/xep-0199.html) | Sending application-level pings over XML streams.
+| Entity Time                                 | [XEP-0202](http://xmpp.org/extensions/xep-0202.html) | Allows entities to communicate their local time |
+| Delayed Delivery                            | [XEP-0203](http://xmpp.org/extensions/xep-0203.html) | Extension for communicating the fact that an XML stanza has been delivered with a delay. |
+| XMPP Over BOSH                              | [XEP-0206](http://xmpp.org/extensions/xep-0206.html) | Use Bidirectional-streams Over Synchronous HTTP (BOSH) to transport XMPP stanzas. |
+| Attention                                   | [XEP-0224](http://xmpp.org/extensions/xep-0224.html) | Getting attention of another user. |
+| [Group Chat Invitations](invitation.md)   | n/a                                                      | Send invitations to other users to join a group chat room. |
+| [Jive Properties](properties.md)          | n/a                                                      | TODO |
+
+
+Experimental Smack Extensions and currently supported XEPs by Smack (smack-experimental)
+----------------------------------------------------------------------------------------
+
+| Name                                        | XEP                                                      | Description |
+|---------------------------------------------|----------------------------------------------------------|----------------------------------------------------------------------------------------------------------|
+| Message Carbons                             | [XEP-0280](http://xmpp.org/extensions/xep-0280.html) | Keep all IM clients for a user engaged in a conversation, by carbon-copy outbound messages to all interested resources.
+| [HTTP over XMPP transport](hoxt.md)       | [XEP-0332](http://xmpp.org/extensions/xep-0332.html) | Allows to transport HTTP communication over XMPP peer-to-peer networks. |
+| JSON Containers                             | [XEP-0335](http://xmpp.org/extensions/xep-0335.html) | Encapsulation of JSON data within XMPP Stanzas. |
+| Google GCM JSON payload                     | n/a                                                  | Semantically the same as XEP-0335: JSON Containers |
+| Client State Indication                     | [XEP-0352](http://xmpp.org/extensions/xep-0352.html) | A way for the client to indicate its active/inactive state. |
+
+
+Legacy Smack Extensions and currently supported XEPs by Smack (smack-legacy)
+----------------------------------------------------------------------------
+
+If a XEP becomes 'Deprecated' or 'Obsolete' the code will be moved to the *smack-legacy* subproject.
+
+| Name                                        | XEP                                                      | Description |
+|---------------------------------------------|----------------------------------------------------------|----------------------------------------------------------------------------------------------------------|
+| [Message Events](messageevents.md)        | [XEP-0022](http://xmpp.org/extensions/xep-0022.html) | Requests and responds to message events. |
+
+| [Roster Item Exchange](rosterexchange.md) | [XEP-0093](http://xmpp.org/extensions/xep-0093.html) | Allows roster data to be shared between users. |

documentation/extensions/intro.md

@@ -0,0 +1,99 @@
+Smack Extensions Manual
+
+Current Extensions
+
+**Name**
+**XEP #**
+**Description**
+
+[Private Data](privatedata.md)
+
+[XEP-0049](http://www.xmpp.org/extensions/xep-0049.html)
+
+Manages private data.
+
+[XHTML Messages](xhtml.md)
+
+[XEP-0071](http://www.xmpp.org/extensions/xep-0071.html)
+
+Allows send and receiving formatted messages using XHTML.
+
+[Message Events](messageevents.md)
+
+[XEP-0022](http://www.xmpp.org/extensions/xep-0022.html)
+
+Requests and responds to message events.
+
+[Data Forms](dataforms.md)
+
+[XEP-0004](http://www.xmpp.org/extensions/xep-0004.html)
+
+Allows to gather data using Forms.
+
+[Multi User Chat](muc.md)
+
+[XEP-0045](http://www.xmpp.org/extensions/xep-0045.html)
+
+Allows configuration of, participation in, and administration of individual
+text-based conference rooms.
+
+[Roster Item Exchange](rosterexchange.md)
+
+[XEP-0093](http://www.xmpp.org/extensions/xep-0093.html)
+
+Allows roster data to be shared between users.
+
+[Time Exchange](time.md)
+
+[XEP-0090](http://www.xmpp.org/extensions/xep-0090.html)
+
+Allows local time information to be shared between users.
+
+[Group Chat Invitations](invitation.md)
+
+N/A
+
+Send invitations to other users to join a group chat room.
+
+[Service Discovery](disco.md)
+
+[XEP-0030](http://www.xmpp.org/extensions/xep-0030.html)
+
+Allows to discover services in XMPP entities.
+
+[File Transfer](filetransfer.md)
+
+[XEP-0096](http://www.xmpp.org/extensions/xep-0096.html)
+
+Transfer files between two users over XMPP.
+
+[PubSub](pubsub.md)
+
+[XEP-0060](http://www.xmpp.org/extensions/xep-0060.html)
+
+Generic publish and subscribe functionality.
+
+[Entity Capabilities](caps.md)
+
+[XEP-0115](http://www.xmpp.org/extensions/xep-0115.html)
+
+Broadcasting and dynamic discovery of entity capabilities.
+
+[Privacy Lists](privacy.md)
+
+[XEP-0016](http://www.xmpp.org/extensions/xep-0016.html)
+
+Enabling or disabling communication with other entities.
+
+[HTTP over XMPP transport](hoxt.md)
+
+[XEP-0332](http://www.xmpp.org/extensions/xep-0332.html)
+
+Allows to transport HTTP communication over XMPP peer-to-peer networks.
+
+[Jive Properties](properties.md)
+
+N/A
+
+TODO
+

documentation/extensions/invitation.md

@@ -0,0 +1,42 @@
+Group Chat Invitations
+======================
+
+The group chat invitation extension is used to invite other users to a
+group chat room.
+
+  * Inviting Other Users
+  * Listen for Invitations
+
+**XEP related:** N/A -- this protocol is outdated now that the Multi-User Chat (MUC) XEP is available ([XEP-45](http://www.xmpp.org/extensions/xep-0045.html)). However, most existing clients still use this older protocol. Once MUC support becomes more widespread, this API may be deprecated. 
+
+Inviting Other Users
+--------------------
+
+To use the GroupChatInvitation packet extension to invite another user to a
+group chat room, address a new message to the user and set the room name
+appropriately, as in the following code example:
+
+```
+Message message = new Message("user@chat.example.com");
+message.setBody("Join me for a group chat!");
+message.addExtension(new GroupChatInvitation("room@chat.example.com"));
+con.sendStanza(message);
+```
+
+The XML generated for the invitation portion of the code above would be:
+
+```
+<x xmlns="jabber:x:conference" jid="room@chat.example.com"/>
+```
+
+Listening for Invitations
+-------------------------
+
+To listen for group chat invitations, use a StanzaExtensionFilter for the `x`
+element name and `jabber:x:conference` namespace, as in the following code
+example:
+
+```
+StanzaFilter filter = new StanzaExtensionFilter("x", "jabber:x:conference");
+// Create a packet collector or packet listeners using the filter...
+```

documentation/extensions/muc.md

@@ -0,0 +1,652 @@
+Multi User Chat
+===============
+
+Allows configuration of, participation in, and administration of individual
+text-based conference rooms.
+
+  * Create a new Room
+  * Join a room
+  * Manage room invitations
+  * Discover MUC support
+  * Discover joined rooms
+  * Discover room information
+  * Start a private chat
+  * Manage changes on room subject
+  * Manage role modifications
+  * Manage affiliation modifications
+
+**XEP related:** [XEP-45](http://www.xmpp.org/extensions/xep-0045.html)
+
+Create a new Room
+-----------------
+
+**Description**
+
+Allowed users may create new rooms. There are two types of rooms that you can
+create. **Instant rooms** which are available for immediate access and are
+automatically created based on some default configuration and **Reserved
+rooms** which are manually configured by the room creator before anyone is
+allowed to enter.
+
+**Usage**
+
+In order to create a room you will need to first create an instance of
+_**MultiUserChat**_.
+In order to do so, get a instance of `MultiUserChatManager` and call `getMultiUserChat(String)` to retrieve a `MultiUserChat` instance.
+The next step is to send **create(String nickname)** to
+the _**MultiUserChat**_ instance where nickname is the nickname to use when
+joining the room.
+
+Depending on the type of room that you want to create you will have to use
+different configuration forms. In order to create an Instant room just send
+**sendConfigurationForm(Form form)** where form is an empty form. But if you
+want to create a Reserved room then you should first get the room's
+configuration form, complete the form and finally send it back to the server.
+
+**Examples**
+
+In this example we can see how to create an instant room:
+
+```java
+// Get the MultiUserChatManager
+MultiUserChatManager manager = MultiUserChatManager.getInstanceFor(connection);
+
+// Get a MultiUserChat using MultiUserChatManager
+MultiUserChat muc = manager.getMultiUserChat("myroom@conference.jabber.org");
+
+// Create the room
+muc.create("testbot");
+
+// Send an empty room configuration form which indicates that we want
+// an instant room
+muc.sendConfigurationForm(new Form(DataForm.Type.submit));
+```
+
+In this example we can see how to create a reserved room. The form is
+completed with default values:
+
+```java
+// Get the MultiUserChatManager
+MultiUserChatManager manager = MultiUserChatManager.getInstanceFor(connection);
+
+// Create a MultiUserChat using an XMPPConnection for a room
+MultiUserChat muc = = manager.getMultiUserChat("myroom@conference.jabber.org");
+
+// Create the room
+muc.create("testbot");
+
+// Get the the room's configuration form
+Form form = muc.getConfigurationForm();
+// Create a new form to submit based on the original form
+Form submitForm = form.createAnswerForm();
+// Add default answers to the form to submit
+for (Iterator fields = form.getFields(); fields.hasNext();) {
+	FormField field = (FormField) fields.next();
+	if (!FormField.type.hidden.equals(field.getType()) && field.getVariable() != null) {
+		// Sets the default value as the answer
+		submitForm.setDefaultAnswer(field.getVariable());
+}
+}
+// Sets the new owner of the room
+List owners = new ArrayList();
+owners.add("johndoe@jabber.org");
+submitForm.setAnswer("muc#roomconfig_roomowners", owners);
+// Send the completed form (with default values) to the server to configure the room
+muc.sendConfigurationForm(submitForm);
+```
+
+Join a room
+-----------
+
+**Description**
+
+Your usual first step in order to send messages to a room is to join the room.
+Multi User Chat allows to specify several parameter while joining a room.
+Basically you can control the amount of history to receive after joining the
+room as well as provide your nickname within the room and a password if the
+room is password protected.
+
+**Usage**
+
+In order to join a room you will need to first get an instance of
+_**MultiUserChat**_.
+In order to do so, get a instance of `MultiUserChatManager` and call `getMultiUserChat(String)` to retrieve a `MultiUserChat` instance.
+The next step is to send **join(...)** to the
+_**MultiUserChat**_ instance. But first you will have to decide which join
+message to send. If you want to just join the room without a password and
+without specifying the amount of history to receive then you could use
+**join(String nickname)** where nickname if your nickname in the room. In case
+the room requires a password in order to join you could then use **join(String
+nickname, String password)**. And finally, the most complete way to join a
+room is to send **join(String nickname, String password, DiscussionHistory
+history, long timeout)** where nickname is your nickname in the room, ,
+password is your password to join the room, history is an object that
+specifies the amount of history to receive and timeout is the milliseconds to
+wait for a response from the server.
+
+**Examples**
+
+In this example we can see how to join a room with a given nickname:
+
+```java
+// Get the MultiUserChatManager
+MultiUserChatManager manager = MultiUserChatManager.getInstanceFor(connection);
+
+// Create a MultiUserChat using an XMPPConnection for a room
+MultiUserChat muc2 = manager.getMultiUserChat("myroom@conference.jabber.org");
+
+// User2 joins the new room
+// The room service will decide the amount of history to send
+muc2.join("testbot2");
+```
+
+In this example we can see how to join a room with a given nickname and
+password:
+
+```java
+// Get the MultiUserChatManager
+MultiUserChatManager manager = MultiUserChatManager.getInstanceFor(connection);
+
+// Create a MultiUserChat using an XMPPConnection for a room
+MultiUserChat muc2 = manager.getMultiUserChat("myroom@conference.jabber.org");
+
+// User2 joins the new room using a password
+// The room service will decide the amount of history to send
+muc2.join("testbot2", "password");
+```
+
+In this example we can see how to join a room with a given nickname specifying
+the amount of history to receive:
+
+```java
+// Get the MultiUserChatManager
+MultiUserChatManager manager = MultiUserChatManager.getInstanceFor(connection);
+
+// Create a MultiUserChat using an XMPPConnection for a room
+MultiUserChat muc2 = manager.getMultiUserChat("myroom@conference.jabber.org");
+
+// User2 joins the new room using a password and specifying
+// the amount of history to receive. In this example we are requesting the last 5 messages.
+DiscussionHistory history = new DiscussionHistory();
+history.setMaxStanzas(5);
+muc2.join("testbot2", "password", history, conn1.getPacketReplyTimeout());
+```
+
+Manage room invitations
+-----------------------
+
+**Description**
+
+It can be useful to invite another user to a room in which one is an occupant.
+Depending on the room's type the invitee could receive a password to use to
+join the room and/or be added to the member list if the room is of type
+members-only. Smack allows to send room invitations and let potential invitees
+to listening for room invitations and inviters to listen for invitees'
+rejections.
+
+**Usage**
+
+In order to invite another user to a room you must be already joined to the
+room. Once you are joined just send **invite(String participant, String
+reason)** to the _**MultiUserChat**_ where participant is the user to invite
+to the room (e.g. hecate@shakespeare.lit) and reason is the reason why the
+user is being invited.
+
+If potential invitees want to listen for room invitations then the invitee
+must add an _**InvitationListener**_ to the _**MultiUserChatManager**_ class. Since
+the _**InvitationListener**_ is an _interface_, it is necessary to create a
+class that implements this _interface_. If an inviter wants to listen for room
+invitation rejections, just add an _**InvitationRejectionListener**_ to the
+_**MultiUserChat**_. _**InvitationRejectionListener**_ is also an interface so
+you will need to create a class that implements this interface.
+
+**Examples**
+
+In this example we can see how to invite another user to the room and lister
+for possible rejections:
+
+```java
+// Get the MultiUserChatManager
+MultiUserChatManager manager = MultiUserChatManager.getInstanceFor(connection);
+
+// Create a MultiUserChat using an XMPPConnection for a room
+MultiUserChat muc2 = manager.getMultiUserChat("myroom@conference.jabber.org");
+
+muc2.join("testbot2");
+// User2 listens for invitation rejections
+muc2.addInvitationRejectionListener(new InvitationRejectionListener() {
+	public void invitationDeclined(String invitee, String reason) {
+		// Do whatever you need here...
+	}
+});
+// User2 invites user3 to join to the room
+muc2.invite("user3@host.org/Smack", "Meet me in this excellent room");
+```
+
+In this example we can see how to listen for room invitations and decline
+invitations:
+
+```java
+// User3 listens for MUC invitations
+MultiUserChatManager.getInstanceFor(connection).addInvitationListener(new InvitationListener() {
+	public void invitationReceived(XMPPConnection conn, String room, String inviter, String reason, String password) {
+		// Reject the invitation
+		MultiUserChat.decline(conn, room, inviter, "I'm busy right now");
+	}
+});
+```
+
+Discover MUC support
+--------------------
+
+**Description**
+
+A user may want to discover if one of the user's contacts supports the Multi-
+User Chat protocol.
+
+**Usage**
+
+In order to discover if one of the user's contacts supports MUC just send
+**isServiceEnabled(String user)** to the
+_**MultiUserChatManager**_ class where user is a fully qualified XMPP ID, e.g.
+jdoe@example.com. You will receive a boolean indicating whether the user
+supports MUC or not.
+
+**Examples**
+
+In this example we can see how to discover support of MUC:
+
+```java
+// Discover whether user3@host.org supports MUC or not
+boolean supports = MultiUserChatManager.getInstanceFor(connection).isServiceEnabled("user3@host.org/Smack");
+```
+
+Discover joined rooms
+---------------------
+
+**Description**
+
+A user may also want to query a contact regarding which rooms the contact is
+in.
+
+**Usage**
+
+In order to get the rooms where a user is in just send
+**getJoinedRooms(String user)** to the
+_**MultiUserChatManager**_ class where user is a fully qualified XMPP ID, e.g.
+jdoe@example.com. You will get an Iterator of Strings as an answer where each
+String represents a room name.
+
+**Examples**
+
+In this example we can see how to get the rooms where a user is in:
+
+```java
+// Get the MultiUserChatManager
+MultiUserChatManager manager = MultiUserChatManager.getInstanceFor(connection);
+
+// Get the rooms where user3@host.org has joined
+List<String> joinedRooms = manager.getJoinedRooms("user3@host.org/Smack");
+```
+
+Discover room information
+-------------------------
+
+**Description**
+
+A user may need to discover information about a room without having to
+actually join the room. The server will provide information only for public
+rooms.
+
+**Usage**
+
+In order to discover information about a room just send
+**getRoomInfo(String room)** to the
+_**MultiUserChatManager**_ class where room is the XMPP ID of the room, e.g.
+roomName@conference.myserver. You will get a RoomInfo object that contains the
+discovered room information.
+
+**Examples**
+
+In this example we can see how to discover information about a room:
+
+```java
+// Get the MultiUserChatManager
+MultiUserChatManager manager = MultiUserChatManager.getInstanceFor(connection);
+
+// Discover information about the room roomName@conference.myserver
+RoomInfo info = manager.getRoomInfo("roomName@conference.myserver");
+System.out.println("Number of occupants:" + info.getOccupantsCount());
+System.out.println("Room Subject:" + info.getSubject());
+```
+
+Start a private chat
+--------------------
+
+**Description**
+
+A room occupant may want to start a private chat with another room occupant
+even though they don't know the fully qualified XMPP ID (e.g.
+jdoe@example.com) of each other.
+
+**Usage**
+
+To create a private chat with another room occupant just send
+**createPrivateChat(String participant)** to the _**MultiUserChat**_ that you
+used to join the room. The parameter participant is the occupant unique room
+JID (e.g. 'darkcave@macbeth.shakespeare.lit/Paul'). You will receive a regular
+_**Chat**_ object that you can use to chat with the other room occupant.
+
+**Examples**
+
+In this example we can see how to start a private chat with another room
+occupant:
+
+```
+// Start a private chat with another participant
+Chat chat = muc2.createPrivateChat("myroom@conference.jabber.org/johndoe");
+chat.sendMessage("Hello there");
+```
+
+Manage changes on room subject
+------------------------------
+
+**Description**
+
+A common feature of multi-user chat rooms is the ability to change the subject
+within the room. As a default, only users with a role of "moderator" are
+allowed to change the subject in a room. Although some rooms may be configured
+to allow a mere participant or even a visitor to change the subject.
+
+Every time the room's subject is changed you may want to be notified of the
+modification. The new subject could be used to display an in-room message.
+
+**Usage**
+
+In order to modify the room's subject just send **changeSubject(String
+subject)** to the _**MultiUserChat**_ that you used to join the room where
+subject is the new room's subject. On the other hand, if you want to be
+notified whenever the room's subject is modified you should add a
+_**SubjectUpdatedListener**_ to the _**MultiUserChat**_ by sending
+**addSubjectUpdatedListener(SubjectUpdatedListener listener)** to the
+_**MultiUserChat**_. Since the _**SubjectUpdatedListener**_ is an _interface_,
+it is necessary to create a class that implements this _interface_.
+
+**Examples**
+
+In this example we can see how to change the room's subject and react whenever
+the room's subject is modified:
+
+```
+// An occupant wants to be notified every time the room's subject is changed
+muc3.addSubjectUpdatedListener(new SubjectUpdatedListener() {
+	public void subjectUpdated(String subject, String from) {
+		....
+	}
+});
+// A room's owner changes the room's subject
+muc2.changeSubject("New Subject");
+```
+
+Manage role modifications
+-------------------------
+
+**Description**
+
+There are four defined roles that an occupant can have:
+
+  1. Moderator
+  2. Participant
+  3. Visitor
+  4. None (the absence of a role)
+
+These roles are temporary in that they do not persist across a user's visits
+to the room and can change during the course of an occupant's visit to the
+room.
+
+A moderator is the most powerful occupant within the context of the room, and
+can to some extent manage other occupants' roles in the room. A participant
+has fewer privileges than a moderator, although he or she always has the right
+to speak. A visitor is a more restricted role within the context of a
+moderated room, since visitors are not allowed to send messages to all
+occupants.
+
+Roles are granted, revoked, and maintained based on the occupant's room
+nickname or full JID. Whenever an occupant's role is changed Smack will
+trigger specific events.
+
+**Usage**
+
+In order to grant voice (i.e. make someone a _participant_) just send the
+message **grantVoice(String nickname)** to _**MultiUserChat**_. Use
+**revokeVoice(String nickname)** to revoke the occupant's voice (i.e. make the
+occupant a _visitor_).
+
+In order to grant moderator privileges to a participant or visitor just send
+the message **grantModerator(String nickname)** to _**MultiUserChat**_. Use
+**revokeModerator(String nickname)** to revoke the moderator privilege from
+the occupant thus making the occupant a participant.
+
+Smack allows you to listen for role modification events. If you are interested
+in listening role modification events of any occupant then use the listener
+**_ParticipantStatusListener_**. But if you are interested in listening for
+your own role modification events, use the listener **_UserStatusListener_**.
+Both listeners should be added to the _**MultiUserChat**_ by using
+**addParticipantStatusListener(ParticipantStatusListener listener)** or
+**addUserStatusListener(UserStatusListener listener)** respectively. These
+listeners include several notification events but you may be interested in
+just a few of them. Smack provides default implementations for these listeners
+avoiding you to implement all the interfaces' methods. The default
+implementations are **_DefaultUserStatusListener_** and
+**_DefaultParticipantStatusListener_**. Below you will find the sent messages
+to the listeners whenever an occupant's role has changed.
+
+These are the triggered events when the role has been upgraded:
+
+| Old | New | Events |
+|-----|-----|--------|
+| None | Visitor | -- |
+| Visitor | Participant | voiceGranted |
+| Participant | Moderator | moderatorGranted |
+| None | Participant | voiceGranted |
+| None | Moderator | voiceGranted + moderatorGranted |
+| Visitor | Moderator | voiceGranted + moderatorGranted |
+
+These are the triggered events when the role has been downgraded:
+
+| Old | New | Events |
+|-----|-----|--------|
+| Moderator | Participant | moderatorRevoked |
+| Participant | Visitor | voiceRevoked |
+| Visitor | None | kicked |
+| Moderator | Visitor | voiceRevoked + moderatorRevoked |
+| Moderator | None | kicked |
+| Participant | None | kicked |
+
+**Examples**
+
+In this example we can see how to grant voice to a visitor and listen for the
+notification events:
+
+```java
+// User1 creates a room
+muc = manager.getMultiUserChat("myroom@conference.jabber.org");
+muc.create("testbot");
+// User1 (which is the room owner) configures the room as a moderated room
+Form form = muc.getConfigurationForm();
+Form answerForm = form.createAnswerForm();
+answerForm.setAnswer("muc#roomconfig_moderatedroom", "1");
+muc.sendConfigurationForm(answerForm);
+
+// User2 joins the new room (as a visitor)
+MultiUserChat muc2 = manager2.getMultiUserChat("myroom@conference.jabber.org");
+muc2.join("testbot2");
+// User2 will listen for his own "voice" notification events
+muc2.addUserStatusListener(new DefaultUserStatusListener() {
+	public void voiceGranted() {
+		super.voiceGranted();
+		...
+	}
+	public void voiceRevoked() {
+		super.voiceRevoked();
+		...
+	}
+});
+
+// User3 joins the new room (as a visitor)
+MultiUserChat muc3 = manager3.getMultiUserChat("myroom@conference.jabber.org");
+muc3.join("testbot3");
+// User3 will lister for other occupants "voice" notification events
+muc3.addParticipantStatusListener(new DefaultParticipantStatusListener() {
+	public void voiceGranted(String participant) {
+		super.voiceGranted(participant);
+		...
+	}
+	public void voiceRevoked(String participant) {
+		super.voiceRevoked(participant);
+		...
+	}
+});
+
+// The room's owner grants voice to user2
+muc.grantVoice("testbot2");
+```
+
+Manage affiliation modifications
+--------------------------------
+
+**Description**
+
+There are five defined affiliations that a user can have in relation to a
+room:
+
+  1. Owner
+  2. Admin
+  3. Member
+  4. Outcast
+  5. None (the absence of an affiliation)
+
+These affiliations are semi-permanent in that they persist across a user's
+visits to the room and are not affected by happenings in the room.
+Affiliations are granted, revoked, and maintained based on the user's bare
+JID.
+
+If a user without a defined affiliation enters a room, the user's affiliation
+is defined as "none"; however, this affiliation does not persist across
+visits.
+
+Owners and admins are by definition immune from certain actions. Specifically,
+an owner or admin cannot be kicked from a room and cannot be banned from a
+room. An admin must first lose his or her affiliation (i.e., have an
+affiliation of "none" or "member") before such actions could be performed on
+them.
+
+The member affiliation provides a way for a room owner or admin to specify a
+"whitelist" of users who are allowed to enter a members-only room. When a
+member enters a members-only room, his or her affiliation does not change, no
+matter what his or her role is. The member affiliation also provides a way for
+users to effectively register with an open room and thus be permanently
+associated with that room in some way (one result may be that the user's
+nickname is reserved in the room).
+
+An outcast is a user who has been banned from a room and who is not allowed to
+enter the room. Whenever a user's affiliation is changed Smack will trigger
+specific events.
+
+**Usage**
+
+In order to grant membership to a room, administrator privileges or owner
+priveliges just send **grantMembership(String jid)**, **grantAdmin(String
+jid)** or **grantOwnership(String jid)** to _**MultiUserChat**_ respectively.
+Use **revokeMembership(String jid)**, **revokeAdmin(String jid)** or
+**revokeOwnership(String jid)** to revoke the membership to a room,
+administrator privileges or owner priveliges respectively.
+
+In order to ban a user from the room just send the message **banUser(String
+jid, String reason)** to _**MultiUserChat**_.
+
+Smack allows you to listen for affiliation modification events. If you are
+interested in listening affiliation modification events of any user then use
+the listener **_ParticipantStatusListener_**. But if you are interested in
+listening for your own affiliation modification events, use the listener
+**_UserStatusListener_**. Both listeners should be added to the
+_**MultiUserChat**_ by using
+**addParticipantStatusListener(ParticipantStatusListener listener)** or
+**addUserStatusListener(UserStatusListener listener)** respectively. These
+listeners include several notification events but you may be interested in
+just a few of them. Smack provides default implementations for these listeners
+avoiding you to implement all the interfaces' methods. The default
+implementations are **_DefaultUserStatusListener_** and
+**_DefaultParticipantStatusListener_**. Below you will find the sent messages
+to the listeners whenever a user's affiliation has changed.
+
+These are the triggered events when the affiliation has been upgraded:
+
+| Old | New | Events |
+|-----|-----|--------|
+| None | Member | membershipGranted |
+| Member | Admin | membershipRevoked + adminGranted |
+| Admin | Owner | adminRevoked + ownershipGranted |
+| None | Admin | adminGranted |
+| None | Owner | ownershipGranted |
+| Member | Owner | membershipRevoked + ownershipGranted |
+
+These are the triggered events when the affiliation has been downgraded:
+
+| Old | New | Events |
+|-----|-----|--------|
+| Owner | Admin | ownershipRevoked + adminGranted |
+| Admin | Member | adminRevoked + membershipGranted |
+| Member | None | membershipRevoked |
+| Owner | Member | ownershipRevoked + membershipGranted |
+| Owner | None | ownershipRevoked |
+| Admin | None | adminRevoked |
+| _Anyone_ | Outcast | banned |
+
+**Examples**
+
+In this example we can see how to grant admin privileges to a user and listen
+for the notification events:
+
+```java
+// User1 creates a room
+muc = manager.getMultiUserChat("myroom@conference.jabber.org");
+muc.create("testbot");
+// User1 (which is the room owner) configures the room as a moderated room
+Form form = muc.getConfigurationForm();
+Form answerForm = form.createAnswerForm();
+answerForm.setAnswer("muc#roomconfig_moderatedroom", "1");
+muc.sendConfigurationForm(answerForm);
+
+// User2 joins the new room (as a visitor)
+MultiUserChat muc2 = manager2.getMultiUserChat("myroom@conference.jabber.org");
+muc2.join("testbot2");
+// User2 will listen for his own admin privileges
+muc2.addUserStatusListener(new DefaultUserStatusListener() {
+	public void membershipRevoked() {
+		super.membershipRevoked();
+		...
+	}
+	public void adminGranted() {
+		super.adminGranted();
+		...
+	}
+});
+
+// User3 joins the new room (as a visitor)
+MultiUserChat muc3 = manager3.getMultiUserChat("myroom@conference.jabber.org");
+muc3.join("testbot3");
+// User3 will lister for other users admin privileges
+muc3.addParticipantStatusListener(new DefaultParticipantStatusListener() {
+	public void membershipRevoked(String participant) {
+		super.membershipRevoked(participant);
+		...
+	}
+	public void adminGranted(String participant) {
+		super.adminGranted(participant);
+		...
+	}
+});
+// The room's owner grants admin privileges to user2
+muc.grantAdmin("user2@jabber.org");
+```

documentation/extensions/privacy.md

@@ -0,0 +1,139 @@
+Privacy Lists
+============
+
+[XEP-0016: Privacy Lists](http://xmpp.org/extensions/xep-0016.html)
+
+What is?
+--------
+
+`Privacy` is a method for users to block communications from particular other
+users. In XMPP this is done by managing one's privacy lists.
+
+Server-side privacy lists enable successful completion of the following use
+cases:
+
+  * Retrieving one's privacy lists.
+  * Adding, removing, and editing one's privacy lists.
+  * Setting, changing, or declining active lists.
+  * Setting, changing, or declining the default list (i.e., the list that is active by default).
+  * Allowing or blocking messages based on JID, group, or subscription type (or globally).
+  * Allowing or blocking inbound presence notifications based on JID, group, or subscription type (or globally).
+  * Allowing or blocking outbound presence notifications based on JID, group, or subscription type (or globally).
+  * Allowing or blocking IQ stanzas based on JID, group, or subscription type (or globally).
+  * Allowing or blocking all communications based on JID, group, or subscription type (or globally).
+
+How can I use it?
+-----------------
+
+The API implementation releases three main public classes:
+
+  * `PrivacyListManager`: this is the main API class to retrieve and handle server privacy lists.
+  * `PrivacyList`: witch represents one privacy list, with a name, a set of privacy items. For example, the list with visible or invisible.
+  * `PrivacyItem`: block or allow one aspect of privacy. For example, to allow my friend to see my presence.
+
+1. Right from the start, a client MAY **get his/her privacy list** that is stored in the server:
+
+```
+// Create a privacy manager for the current connection._
+PrivacyListManager privacyManager = PrivacyListManager.getInstanceFor(myConnection);
+// Retrieve server privacy lists_
+PrivacyList[] lists = privacyManager.getPrivacyLists();
+```
+
+Now the client is able to show every `PrivacyItem` of the server and also for
+every list if it is active, default or none of them. The client is a listener
+of privacy changes.
+
+
+
+2. In order to **add a new list in the server**, the client MAY implement something like:
+
+```
+// Set the name of the list_
+String listName = "newList";
+
+// Create the list of PrivacyItem that will allow or deny some privacy aspect_
+String user = "tybalt@example.com";
+String groupName = "enemies";
+ArrayList privacyItems = new ArrayList();
+
+PrivacyItem item = new PrivacyItem(PrivacyItem.Type.jid, user, true, 1);
+privacyItems.add(item);
+
+item = new PrivacyItem(PrivacyItem.Type.subscription, PrivacyItem.SUBSCRIPTION_BOTH, true, 2);
+privacyItems.add(item);
+
+item = new PrivacyItem(PrivacyItem.Type.group, groupName, false, 3);
+item.setFilterMessage(true);
+privacyItems.add(item);
+
+// Get the privacy manager for the current connection._
+PrivacyListManager privacyManager = PrivacyListManager.getInstanceFor(myConnection);
+// Create the new list._
+privacyManager.createPrivacyList(listName, privacyItems);
+```
+
+3. To **modify an existent list**, the client code MAY be like:
+
+```
+// Set the name of the list_
+String listName = "existingList";
+// Get the privacy manager for the current connection._
+PrivacyListManager privacyManager = PrivacyListManager.getInstanceFor(myConnection);
+// Sent the new list to the server._
+privacyManager.updatePrivacyList(listName, items);
+```
+
+Notice `items` was defined at the example 2 and MUST contain all the elements
+in the list (not the "delta").
+
+4. In order to **delete an existing list**, the client MAY perform something like:
+
+```
+// Set the name of the list_
+String listName = "existingList";
+// Get the privacy manager for the current connection._
+PrivacyListManager privacyManager = PrivacyListManager.getInstanceFor(myConnection);
+// Remove the list._
+privacyManager.deletePrivacyList(listName);
+```
+
+5. In order to **decline the use of an active list**, the client MAY perform something like:
+
+```
+// Get the privacy manager for the current connection._
+PrivacyListManager privacyManager = PrivacyListManager.getInstanceFor(myConnection);
+// Decline the use of the active list._
+privacyManager.declineActiveList();
+```
+
+6. In order to **decline the use of a default list**, the client MAY perform something like:
+
+```
+// Get the privacy manager for the current connection._
+PrivacyListManager privacyManager = PrivacyListManager.getInstanceFor(myConnection);
+// Decline the use of the default list._
+privacyManager.declineDefaultList();
+```
+
+Listening for Privacy Changes
+
+In order to handle privacy changes, clients SHOULD listen manager's updates.
+When a list is changed the manager notifies every added listener. Listeners
+MUST implement the `PrivacyListListener` interface. Clients may need to react
+when a privacy list is modified. The `PrivacyListManager` lets you add
+listerners that will be notified when a list has been changed. Listeners
+should implement the `PrivacyListListener` interface.
+
+The most important notification is `updatedPrivacyList` that is performed when
+a privacy list changes its privacy items.
+
+The listener becomes notified after performing:
+
+```
+// Get the privacy manager for the current connection._
+PrivacyListManager privacyManager = PrivacyListManager.getInstanceFor(myConnection);
+// Add the listener (this) to get notified_
+privacyManager.addListener(this);
+```
+Copyright (C) Jive Software 2002-2008

documentation/extensions/privatedata.md

@@ -0,0 +1,17 @@
+Private Data
+============
+
+Manages private data, which is a mechanism to allow users to store arbitrary
+XML data on an XMPP server. Each private data chunk is defined by a element
+name and XML namespace. Example private data:
+
+```
+<color xmlns="http://example.com/xmpp/color">
+	<favorite>blue</blue>
+	<leastFavorite>puce</leastFavorite>
+</color>
+```
+
+**XEP related:** [XEP-49](http://www.xmpp.org/extensions/xep-0049.html)
+
+_More coming soon._

documentation/extensions/properties.md

@@ -0,0 +1,83 @@
+Stanza Properties
+=================
+
+Smack provides an easy mechanism for attaching arbitrary properties to
+packets. Each property has a String name, and a value that is a Java primitive
+(int, long, float, double, boolean) or any Serializable object (a Java object
+is Serializable when it implements the Serializable interface).
+
+Using the API
+-------------
+
+All major objects have property support, such as Message objects. The
+following code demonstrates how to set properties:
+
+```
+Message message = chat.createMessage();
+JivePropertiesExtension jpe = new JivePropertiesExtension();
+// Add a Color object as a property._
+jpe.setProperty("favoriteColor", new Color(0, 0, 255));
+// Add an int as a property._
+jpe.setProperty("favoriteNumber", 4);
+// Add the JivePropertiesExtension to the message packet_
+message.addStanzaExtension(jpe);
+chat.sendMessage(message);
+```
+
+Getting those same properties would use the following code:
+
+```
+Message message = chat.nextMessage();
+// Get the JivePropertiesExtension_
+JivePropertiesExtension jpe = message.getExtension(JivePropertiesExtension.NAMESPACE);
+// Get a Color object property._
+Color favoriteColor = (Color)jpe.getProperty("favoriteColor");
+// Get an int property. Note that properties are always returned as
+// Objects, so we must cast the value to an Integer, then convert
+// it to an int._
+int favoriteNumber = ((Integer)jpe.getProperty("favoriteNumber")).intValue();
+```
+
+For convenience `JivePropertiesManager` contains two helper methods namely
+`addProperty(Stanza packet, String name, Object value)` and
+`getProperty(Stanza packet, String name)`.
+
+Objects as Properties
+---------------------
+
+Using objects as property values is a very powerful and easy way to exchange
+data. However, you should keep the following in mind:
+
+  * When you send a Java object as a property, only clients running Java will be able to interpret the data. So, consider using a series of primitive values to transfer data instead.
+  * Objects sent as property values must implement Serialiable. Additionally, both the sender and receiver must have identical versions of the class, or a serialization exception will occur when de-serializing the object.
+  * Serialized objects can potentially be quite large, which will use more bandwidth and server resources.
+
+XML Format
+----------
+
+The current XML format used to send property data is not a standard, so will
+likely not be recognized by clients not using Smack. The XML looks like the
+following (comments added for clarity):
+
+
+
+    <!-- All properties are in a x block. -->
+    <properties xmlns="http://www.jivesoftware.com/xmlns/xmpp/properties">
+        <!-- First, a property named "prop1" that's an integer. -->
+        <property>
+            <name>prop1</name>
+            <value type="integer">123</value>
+        <property>
+        <!-- Next, a Java object that's been serialized and then converted
+             from binary data to base-64 encoded text. -->
+        <property>
+            <name>blah2</name>
+            <value type="java-object">adf612fna9nab</value>
+        <property>
+    </properties>
+
+
+The currently supported types are: `integer`, `long`, `float`, `double`,
+`boolean`, `string`, and `java-object`.
+
+Copyright (C) Jive Software 2002-2008

documentation/extensions/pubsub.md

@@ -0,0 +1,402 @@
+Pubsub
+======
+
+This section details the usage of an API designed for accessing an XMPP based
+implementation of a [publish and
+subscribe](http://en.wikipedia.org/wiki/Publish/subscribe) based messaging
+system. It has functionality for creation, configuration of, subscription and
+publishing to pubsub nodes.
+
+  * Node creation and configuration
+  * Publishing to a node
+  * Receiving pubsub messages
+  * Retrieving persisted pubsub messages
+  * Discover pubsub information
+
+**XEP related:** [XEP-0060](http://xmpp.org/extensions/xep-0060.html)
+
+Node creation and configuration
+-------------------------------
+
+### Description
+
+Allowed users may create and configure pubsub nodes. There are two types of
+nodes that can be created, leaf nodes and collection nodes.
+
+* Leaf Nodes - contains only messages
+* Collection Nodes - contains only nodes (both Leaf and Collection are allowed), but no messages
+The current version of this API only supports Leaf Nodes. There are many
+configuration options available for nodes, but the two main options are
+whether the node is **persistent** or not and whether it will deliver payload
+or not.
+
+### Usage
+
+In order to create a node you will need to first create an instance of
+_**PubSubManager**_. There are several options for node creation which range
+from creating an instant node, default configuration, or a fully configured
+node.
+
+### Examples
+
+Create an instant node:
+
+```
+// Create a pubsub manager using an existing XMPPConnection
+PubSubManager mgr = new PubSubManager(con);
+
+// Create the node
+LeafNode leaf = mgr.createNode();
+```
+
+Create a node with default configuration and then configure it:
+
+```
+// Create a pubsub manager using an existing XMPPConnection
+PubSubManager mgr = new PubSubManager(con);
+
+// Create the node
+LeafNode leaf = mgr.createNode("testNode");
+ConfigureForm form = new ConfigureForm(FormType.submit);
+form.setAccessModel(AccessModel.open);
+form.setDeliverPayloads(false);
+form.setNotifyRetract(true);
+form.setPersistentItems(true);
+form.setPublishModel(PublishModel.open);
+
+leaf.sendConfigurationForm(form);
+```
+
+Create and configure a node:
+
+```
+// Create a pubsub manager using an existing XMPPConnection
+PubSubManager mgr = new PubSubManager(con);
+
+// Create the node
+ConfigureForm form = new ConfigureForm(FormType.submit);
+form.setAccessModel(AccessModel.open);
+form.setDeliverPayloads(false);
+form.setNotifyRetract(true);
+form.setPersistentItems(true);
+form.setPublishModel(PublishModel.open);
+LeafNode leaf = mgr.createNode("testNode", form);
+```
+
+Publishing to a node
+--------------------
+
+**Description**
+
+This section deals with the **publish** portion of pubsub. Usage of a node
+typically involves either sending or receiving data, referred to as items.
+Depending on the context of the nodes usage, the item being sent to it can
+have different properties. It can contain application data known as payload,
+or the publisher may choose to supply meaningful unique id's. Determination of
+an items acceptable properties is defined by a combination of node
+configuration and its purpose.
+
+**Usage**
+
+To publish to a node, you will have to either create or retrieve an existing
+node and then create and send items to that node. The ability for any given
+person to publish to the node will be dependent on its configuration.
+
+**Examples**
+
+In this example we publish an item to a node that does not take payload:
+
+```
+// Create a pubsub manager using an existing XMPPConnection
+PubSubManager mgr = new PubSubManager(con);
+
+// Get the node
+LeafNode node = mgr.getNode("testNode");
+
+// Publish an Item, let service set the id
+node.send(new Item());
+
+// Publish an Item with the specified id
+node.send(new Item("123abc"));
+```
+
+In this example we publish an item to a node that does take payload:
+
+```
+// Create a pubsub manager using an existing XMPPConnection
+PubSubManager mgr = new PubSubManager(con);
+
+// Get the node
+LeafNode node = mgr.getNode("testNode");
+
+// Publish an Item with payload
+node.send(new PayloadItem("test" + System.currentTimeMillis(),
+new SimplePayload("book", "pubsub:test:book", "Two Towers")));
+```
+
+Receiving pubsub messages
+-------------------------
+
+**Description**
+
+This section deals with the **subscribe** portion of pubsub. As mentioned in
+the last section, usage of a node typically involves either sending or
+receiving items. Subscribers are interested in being notified when items are
+published to the pubsub node. These items may or may not have application
+specific data (payload), as that is dependent on the context in which the node
+is being used.
+
+**Usage**
+
+To get messages asynchronously when items are published to a node, you will
+have to
+
+* Get a node.
+* Create and register a listener.
+* Subscribe to the node.
+
+Please note that you should register the listener before subscribing so that
+all messages sent after subscribing are received. If done in the reverse
+order, messages that are sent after subscribing but before registering a
+listener may not be processed as expected.
+
+**Examples**
+
+In this example we can see how to create a listener and register it and then
+subscribe for messages.
+
+```
+// Create a pubsub manager using an existing XMPPConnection
+PubSubManager mgr = new PubSubManager(con);
+
+// Get the node
+LeafNode node = mgr.getNode("testNode");
+
+node.addItemEventListener(new ItemEventCoordinator&ltItem;>());
+node.subscribe(myJid);
+```
+
+Where the listener is defined like so:
+
+```
+class ItemEventCoordinator  implements ItemEventListener {
+	@Override
+	public void handlePublishedItems(ItemPublishEvent items) {
+		System.out.println("Item count: " + System.out.println(items);
+	}
+}
+```
+
+In addition to receiving published items, there are notifications for several
+other events that occur on a node as well.
+
+* Deleting items or purging all items from a node
+* Changing the node configuration
+
+In this example we can see how to create a listener, register it and then
+subscribe for item deletion messages.
+
+```
+// Create a pubsub manager using an existing XMPPConnection
+PubSubManager mgr = new PubSubManager(con);
+
+// Get the node
+LeafNode node = mgr.getNode("testNode");
+
+node.addItemDeleteListener(new ItemDeleteCoordinator&ltItem;>());
+node.subscribe(myJid);
+node.deleteItem("id_one");
+```
+
+Where the handler is defined like so:
+
+```
+class ItemDeleteCoordinator implements ItemDeleteListener {
+	@Override
+	public void handleDeletedItems(ItemDeleteEvent items) {
+		System.out.println("Item count: " + items.getItemIds().size());
+		System.out.println(items);
+	}
+
+	@Override
+	public void handlePurge() {
+		System.out.println("All items have been deleted from node");
+	}
+}
+```
+
+In this example we can see how to create a listener, register it and then
+subscribe for node configuration messages.
+
+```
+// Create a pubsub manager using an existing XMPPConnection
+PubSubManager mgr = new PubSubManager(con);
+
+// Get the node
+Node node = mgr.getNode("testNode");
+
+node.addConfigurationListener(new NodeConfigCoordinator());
+node.subscribe(myJid);
+
+ConfigureForm form = new ConfigureForm(FormType.submit);
+form.setAccessModel(AccessModel.open);
+form.setDeliverPayloads(false);
+form.setNotifyRetract(true);
+form.setPersistentItems(true);
+form.setPublishModel(PublishModel.open);
+
+node.sendConfigurationForm(form);
+```
+
+Where the handler is defined like so:
+
+```
+class NodeConfigCoordinator implements NodeConfigListener {
+	@Override
+	public void handleNodeConfiguration(ConfigurationEvent config) {
+		System.out.println("New configuration");
+		System.out.println(config.getConfiguration());
+	}
+}
+```
+
+Retrieving persisted pubsub messages
+------------------------------------
+
+**Description**
+
+When persistent nodes are used, the subscription and registration methods
+described in the last section will not enable the retrieval of items that
+already exist in the node. This section deals with the specific methods for
+retrieving these items. There are several means of retrieving existing items.
+You can retrieve all items at once, the last N items, or the items specified
+by a collection of id's. Please note that the service may, according to the
+pubsub specification, reply with a list of items that contains only the item
+id's (no payload) to save on bandwidth. This will not occur when the id's are
+specified since this is the means of guaranteeing retrieval of payload.
+
+**Usage**
+
+To synchronously retrieve existing items from a persistent node, you will have
+to get an instance of a _**LeafNode**_ and call one of the retrieve methods.
+
+**Examples**
+
+In this example we can see how to retrieve the existing items from a node:
+
+```
+// Create a pubsub manager using an existing XMPPConnection
+PubSubManager mgr = new PubSubManager(con);
+
+// Get the node
+LeafNode node = mgr.getNode("testNode");
+
+Collection<? extends Item> items = node.getItems();
+```
+
+In this example we can see how to retrieve the last N existing items:
+
+```
+// Create a pubsub manager using an existing XMPPConnection
+PubSubManager mgr = new PubSubManager(con);
+
+// Get the node
+LeafNode node = mgr.getNode("testNode");
+
+List<? extends Item> items = node.getItems(100);
+```
+
+In this example we can see how to retrieve the specified existing items:
+
+```
+// Create a pubsub manager using an existing XMPPConnection
+PubSubManager mgr = new PubSubManager(con);
+
+// Get the node
+LeafNode node = mgr.getNode("testNode");
+Collection&ltString;> ids = new ArrayList&ltString;>(3);
+ids.add("1");
+ids.add("3");
+ids.add("4");
+
+List<? extends Item> items = node.getItems(ids);
+```
+
+Discover pubsub information
+---------------------------
+
+**Description**
+
+A user may want to query a server or node for a variety of pubsub related
+information.
+
+**Usage**
+
+To retrieve information, a user will simply use either the _**PubSubManager**_
+or _**Node**_ classes depending on what type of information is required.
+
+**Examples**
+
+In this example we can see how to get pubsub capabilities:
+
+```
+// Create a pubsub manager using an existing XMPPConnection
+PubSubManager mgr = new PubSubManager(con);
+
+// Get the pubsub features that are supported
+DiscoverInfo supportedFeatures = mgr.getSupportedFeatures();
+```
+
+In this example we can see how to get pubsub subscriptions for all nodes:
+
+```
+// Create a pubsub manager using an existing XMPPConnection
+PubSubManager mgr = new PubSubManager(con);
+
+// Get all the subscriptions in the pubsub service
+List&ltSubscription;> subscriptions = mgr.getSubscriptions();
+```
+
+In this example we can see how to get all affiliations for the users bare JID
+on the pubsub service:
+
+```
+// Create a pubsub manager using an existing XMPPConnection
+PubSubManager mgr = new PubSubManager(con);
+
+// Get the affiliations for the users bare JID
+List&ltAffiliation;> affiliations = mgr.getAffiliations();
+```
+
+In this example we can see how to get information about the node:
+
+```
+// Create a pubsub manager using an existing XMPPConnection
+PubSubManager mgr = new PubSubManager(con);
+Node node = mgr.getNode("testNode");
+
+// Get the node information
+DiscoverInfo nodeInfo = node.discoverInfo();
+```
+
+In this example we can see how to discover the node items:
+
+```
+// Create a pubsub manager using an existing XMPPConnection
+PubSubManager mgr = new PubSubManager(con);
+Node node = mgr.getNode("testNode");
+
+// Discover the node items
+DiscoverItems nodeItems = node.discoverItems();
+```
+
+In this example we can see how to get node subscriptions:
+
+```
+// Create a pubsub manager using an existing XMPPConnection
+PubSubManager mgr = new PubSubManager(con);
+Node node = mgr.getNode("testNode");
+
+// Discover the node subscriptions
+List&ltSubscription;> subscriptions = node.getSubscriptions();
+```

documentation/extensions/rosterexchange.md

@@ -0,0 +1,160 @@
+Roster Item Exchange
+====================
+
+This extension is used to send rosters, roster groups and roster entries from
+one XMPP Entity to another. It also provides an easy way to hook up custom
+logic when entries are received from other XMPP clients.
+
+Follow these links to learn how to send and receive roster items:
+
+  * Send a complete roster
+  * Send a roster's group
+  * Send a roster's entry
+  * Receive roster entries
+
+**XEP related:** [XEP-93](http://www.xmpp.org/extensions/xep-0093.html)
+
+Send a entire roster
+-------------------
+
+**Description**
+
+Sometimes it is useful to send a whole roster to another user. Smack provides
+a very easy way to send a complete roster to another XMPP client.
+
+**Usage**
+
+Create an instance of _**RosterExchangeManager**_ and use the **#send(Roster,
+String)** message to send a roster to a given user. The first parameter is the
+roster to send and the second parameter is the id of the user that will
+receive the roster entries.
+
+**Example**
+
+In this example we can see how user1 sends his roster to user2.
+
+```
+XMPPConnection conn1 = …
+
+// Create a new roster exchange manager on conn1
+RosterExchangeManager rosterExchangeManager = new RosterExchangeManager(conn1);
+// Send user1's roster to user2
+rosterExchangeManager.send(Roster.getInstanceFor(conn1), user2);
+```
+
+Send a roster group
+-------------------
+
+**Description**
+
+It is also possible to send a roster group to another XMPP client. A roster
+group groups a set of roster entries under a name.
+
+**Usage**
+
+Create an instance of _**RosterExchangeManager**_ and use the
+**#send(RosterGroup, String)** message to send a roster group to a given user.
+The first parameter is the roster group to send and the second parameter is
+the id of the user that will receive the roster entries.
+
+**Example**
+
+In this example we can see how user1 sends his roster groups to user2.
+
+```
+XMPPConnection conn1 = …
+
+// Create a new roster exchange manager on conn1
+RosterExchangeManager rosterExchangeManager = new RosterExchangeManager(conn1);
+// Send user1's RosterGroups to user2
+for (Iterator it = Roster.getInstanceFor(conn1).getGroups(); it.hasNext(); )
+rosterExchangeManager.send((RosterGroup)it.next(), user2);
+```
+
+Send a roster entry
+-------------------
+
+**Description**
+
+Sometimes you may need to send a single roster entry to another XMPP client.
+Smack also lets you send items at this granularity level.
+
+**Usage**
+
+Create an instance of _**RosterExchangeManager**_ and use the
+**#send(RosterEntry, String)** message to send a roster entry to a given user.
+The first parameter is the roster entry to send and the second parameter is
+the id of the user that will receive the roster entries.
+
+**Example**
+
+In this example we can see how user1 sends a roster entry to user2.
+
+```
+XMPPConnection conn1 = …
+
+// Create a new roster exchange manager on conn1
+RosterExchangeManager rosterExchangeManager = new RosterExchangeManager(conn1);
+// Send a roster entry (any) to user2
+rosterExchangeManager1.send((RosterEntry)Roster.getInstanceFor(conn1).getEntries().next(), user2);
+```
+
+Receive roster entries
+----------------------
+
+**Description**
+
+Since roster items are sent between XMPP clients, it is necessary to listen to
+possible roster entries receptions. Smack provides a mechanism that you can
+use to execute custom logic when roster entries are received.
+
+**Usage**
+
+  1. Create a class that implements the _**RosterExchangeListener**_ interface.
+  2. Implement the method **entriesReceived(String, Iterator)** that will be called when new entries are received with custom logic.
+  3. Add the listener to the _RosterExchangeManager_ that works on the desired _XMPPConnection_.
+
+**Example**
+
+In this example we can see how user1 sends a roster entry to user2 and user2
+adds the received entries to his roster.
+
+```
+// Connect to the server and log in the users
+XMPPConnection conn1 = …
+XMPPConnection conn2 = …
+
+final Roster user2_roster = Roster.getInstanceFor(conn2);
+
+// Create a RosterExchangeManager that will help user2 to listen and accept
+the entries received
+RosterExchangeManager rosterExchangeManager2 = new RosterExchangeManager(conn2);
+// Create a RosterExchangeListener that will iterate over the received roster entries
+RosterExchangeListener rosterExchangeListener = new RosterExchangeListener() {
+public void entriesReceived(String from, Iterator remoteRosterEntries) {
+while (remoteRosterEntries.hasNext()) {
+try {
+// Get the received entry
+RemoteRosterEntry remoteRosterEntry = (RemoteRosterEntry) remoteRosterEntries.next();
+// Display the remote entry on the console
+System.out.println(remoteRosterEntry);
+// Add the entry to the user2's roster
+user2_roster.createEntry(
+remoteRosterEntry.getUser(),
+remoteRosterEntry.getName(),
+remoteRosterEntry.getGroupArrayNames());
+}
+catch (XMPPException e) {
+e.printStackTrace();
+}
+}
+}
+};
+// Add the RosterExchangeListener to the RosterExchangeManager that user2 is using
+rosterExchangeManager2.addRosterListener(rosterExchangeListener);
+
+// Create a RosterExchangeManager that will help user1 to send his roster
+RosterExchangeManager rosterExchangeManager1 = new RosterExchangeManager(conn1);
+// Send user1's roster to user2
+rosterExchangeManager1.send(Roster.getInstanceFor(conn1), user2);
+```

documentation/extensions/streammanagement.md

@@ -0,0 +1,37 @@
+Stream Management
+=================
+
+XMPPTCPConnection comes with support for Stream Management (SM).
+
+**XEP related:** [XEP-0198](http://xmpp.org/extensions/xep-0198.html)
+
+Known interoperability issues
+-----------------------------
+
+- SM resumption failes on prosody when compression in sync flush mode is used with prosody. See [Prosody issue #433](https://code.google.com/p/lxmppd/issues/detail?id=433).
+
+Enabling stream management
+------------------------
+
+TODO
+
+Getting notifications about acknowledges stanzas
+------------------------------------------------
+
+TODO
+
+Requisting stanza acknowledgements from the server
+--------------------------------------------------
+
+### By using predicates
+
+TODO
+
+### Manually
+
+TODO
+
+Enable stream resumption
+------------------------
+
+TODO

documentation/extensions/time.md

@@ -0,0 +1,10 @@
+Entity Time Exchange
+====================
+
+Supports a protocol that XMPP clients use to exchange their respective local
+times and time zones.
+
+**XEP related:** [XEP-90](http://www.xmpp.org/extensions/xep-0090.html)
+
+_More coming soon._
+

documentation/extensions/xhtml.md

@@ -0,0 +1,202 @@
+XHTML Messages
+==============
+
+Provides the ability to send and receive formatted messages using XHTML.
+
+Follow these links to learn how to compose, send, receive and discover support
+for XHTML messages:
+
+  * Compose an XHTML Message
+  * Send an XHTML Message
+  * Receive an XHTML Message
+  * Discover support for XHTML Messages
+
+**XEP related:** [XEP-71](http://www.xmpp.org/extensions/xep-0071.html)
+
+Compose an XHTML Message
+------------------------
+
+**Description**
+
+The first step in order to send an XHTML message is to compose it. Smack
+provides a special class that helps to build valid XHTML messages hiding any
+low level complexity. For special situations, advanced users may decide not to
+use the helper class and generate the XHTML by themselves. Even for these
+situations Smack provides a well defined entry point in order to add the
+generated XHTML content to a given message.
+
+Note: not all clients are able to view XHTML formatted messages. Therefore,
+it's recommended that you include a normal body in that message that is either
+an unformatted version of the text or a note that XHTML support is required to
+view the message contents.
+
+**Usage**
+
+Create an instance of _**XHTMLText**_ specifying the style and language of the
+body. You can add several XHTML bodies to the message but each body should be
+for a different language. Once you have an XHTMLText you can start to append
+tags and text to it. In order to append tags there are several messages that
+you can use. For each XHTML defined tag there is a message that you can send.
+In order to add text you can send the message **#append(String
+textToAppend)**.
+
+After you have configured the XHTML text, the last step you have to do is to
+add the XHTML text to the message you want to send. If you decided to create
+the XHTML text by yourself, you will have to follow this last step too. In
+order to add the XHTML text to the message send the message **#addBody(Message
+message, String body)** to the _**XHTMLManager**_ class where _message_ is the
+message that will receive the XHTML body and _body_ is the string to add as an
+XHTML body to the message.**
+
+**Example**
+
+In this example we can see how to compose the following XHTML message:
+
+```
+<body>
+	<p style='font-size:large'>Hey John, this is my new
+		<span style='color:green'>green</span>
+		<em>!!!!</em>
+	</p>
+</body>
+```
+
+```
+// Create a message to send
+Message msg = chat.createMessage();
+msg.setSubject("Any subject you want");
+msg.setBody("Hey John, this is my new green!!!!");
+
+// Create an XHTMLText to send with the message
+XHTMLText xhtmlText = new XHTMLText(null, null);
+xhtmlText.appendOpenParagraphTag("font-size:large");
+xhtmlText.append("Hey John, this is my new ");
+xhtmlText.appendOpenSpanTag("color:green");
+xhtmlText.append("green");
+xhtmlText.appendCloseSpanTag();
+xhtmlText.appendOpenEmTag();
+xhtmlText.append("!!!!");
+xhtmlText.appendCloseEmTag();
+xhtmlText.appendCloseParagraphTag();
+xhtmlText.appendCloseBodyTag();
+
+// Add the XHTML text to the message
+XHTMLManager.addBody(msg, xhtmlText);
+```
+
+Send an XHTML Message
+---------------------
+
+**Description**
+
+After you have composed an XHTML message you will want to send it. Once you
+have added the XHTML content to the message you want to send you are almost
+done. The last step is to send the message as you do with any other message.
+
+**Usage**
+
+An XHTML message is like any regular message, therefore to send the message
+you can follow the usual steps you do in order to send a message. For example,
+to send a message as part of a chat just use the message **#send(Message)** of
+_**Chat**_ or you can use the message **#send(Stanza)** of
+_**XMPPConnection**_.
+
+**Example**
+
+In this example we can see how to send a message with XHTML content as part of
+a chat.
+
+```
+// Create a message to send
+Message msg = chat.createMessage();
+// Obtain the XHTML text to send from somewhere
+XHTMLText xhtmlBody = getXHTMLTextToSend();
+
+// Add the XHTML text to the message
+XHTMLManager.addBody(msg, xhtmlBody);
+
+// Send the message that contains the XHTML
+chat.sendMessage(msg);
+```
+
+Receive an XHTML Message
+------------------------
+
+**Description**
+
+It is also possible to obtain the XHTML content from a received message.
+Remember that the specification defines that a message may contain several
+XHTML bodies where each body should be for a different language.
+
+**Usage**
+
+To get the XHTML bodies of a given message just send the message
+**#getBodies(Message)** to the class _**XHTMLManager**_. The answer of this
+message will be an _**List**_ with the different XHTML bodies of the
+message or null if none.
+
+**Example**
+
+In this example we can see how to create a PacketListener that obtains the
+XHTML bodies of any received message.
+
+```
+// Create a listener for the chat and display any XHTML content
+PacketListener packetListener = new PacketListener() {
+public void processPacket(Stanza packet) {
+    Message message = (Message) packet;
+    // Obtain the XHTML bodies of the message
+    List<CharSequence> bodies = XHTMLManager.getBodies(message);
+    if (bodies != null) {
+	    // Display the bodies on the console
+        for (CharSequence body : bodies) {
+		    System.out.println(body);
+        }
+    }
+};
+chat.addMessageListener(packetListener);
+```
+
+Discover support for XHTML Messages
+-----------------------------------
+
+**Description**
+
+Before you start to send XHTML messages to a user you should discover if the
+user supports XHTML messages. There are two ways to achieve the discovery,
+explicitly and implicitly. Explicit is when you first try to discover if the
+user supports XHTML before sending any XHTML message. Implicit is when you
+send XHTML messages without first discovering if the conversation partner's
+client supports XHTML and depenging on the answer (normal message or XHTML
+message) you find out if the user supports XHTML messages or not. This section
+explains how to explicitly discover for XHTML support.
+
+**Usage**
+
+In order to discover if a remote user supports XHTML messages send
+**#isServiceEnabled(XMPPConnection connection, String userID)** to the class
+_**XHTMLManager**_ where connection is the connection to use to perform the
+service discovery and userID is the user to check (A fully qualified xmpp ID,
+e.g. jdoe@example.com). This message will return true if the specified user
+handles XHTML messages.
+
+**Example**
+
+In this example we can see how to discover if a remote user supports XHTML
+Messages.
+
+```
+Message msg = chat.createMessage();
+// Include a normal body in the message
+msg.setBody(getTextToSend());
+// Check if the other user supports XHTML messages
+if (XHTMLManager.isServiceEnabled(connection, chat.getParticipant())) {
+	// Obtain the XHTML text to send from somewhere
+	String xhtmlBody = getXHTMLTextToSend();
+	// Include an XHTML body in the message
+	qHTMLManager.addBody(msg, xhtmlBody);
+}
+
+// Send the message
+chat.sendMessage(msg);
+```

documentation/gettingstarted.md

@@ -0,0 +1,114 @@
+Smack: Getting Started
+======================
+
+[Back](index.md)
+
+This document will introduce you to the Smack API and provide an overview of
+important classes and concepts.
+
+JAR Files and Requirements
+--------------------------
+
+Smack is meant to be easily embedded into any existing Java application. The
+library ships as several JAR files to provide more flexibility over which
+features applications require:
+
+  * `smack-core.jar` -- provides core XMPP functionality. All XMPP features that are part of the XMPP RFCs are included.
+  * `smack-tcp.jar` -- support for XMPP over TCP. Includes XMPPTCPConnection class, which you usually want to use
+  * `smack-extensions.jar` -- support for many of the extensions (XEPs) defined by the XMPP Standards Foundation, including multi-user chat, file transfer, user search, etc. The extensions are documented in the [extensions manual](extensions/index.md).
+  * `smack-experimental.jar` -- support for experimental extensions (XEPs) defined by the XMPP Standards Foundation. The API and functionality of those extensions should be considered as unstable.
+  * `smack-legacy.jar` -- support for legacy extensions (XEPs) defined by the XMPP Standards Foundation.
+  * `smack-bosh.jar` -- support for BOSH (XEP-0124). This code should be considered as beta.
+  * `smack-jingle.jar` -- support for Jingle. This code is old and currenlty unmaintained.
+  * `smack-resolver-dnsjava.jar` -- support for resolving DNS SRV records with the help of dnsjava. Ideal for platforms that do not support the javax.naming API.
+  * `smack-resolver-javax.jar` -- support for resolving DNS SRV records with the javax namespace API.
+  * `smack-debug.jar` -- an enhanced GUI debugger for protocol traffic. It will automatically be used when found in the classpath and when [debugging](debugging.md) is enabled.
+
+Configuration
+-------------
+
+Smack has an initialization process that involves 2 phases.
+
+  * Initializing system properties - Initializing all the system properties accessible through the class **SmackConfiguration**. These properties are retrieve by the _getXXX_ methods on that class.
+  * Initializing startup classes - Initializing any classes meant to be active at startup by instantiating the class, and then calling the _initialize_ method on that class if it extends **SmackInitializer**. If it does not extend this interface, then initialization will have to take place in a static block of code which is automatically executed when the class is loaded.
+
+Initialization is accomplished via a configuration file. By default, Smack
+will load the one embedded in the Smack jar at _org.jivesoftware.smack/smack-
+config.xml_. This particular configuration contains a list of initializer
+classes to load. All manager type classes that need to be initialized are
+contained in this list of initializers.
+
+Establishing a Connection
+-------------------------
+
+The `XMPPTCPConnection` class is used to create a connection to an XMPP
+server. Below are code examples for making a connection:
+
+```
+// Create a connection to the jabber.org server.
+AbstractXMPPConnection conn1 = **new** XMPPTCPConnection("username", "password" "jabber.org");
+conn1.connect();
+
+// Create a connection to the jabber.org server on a specific port.
+XMPPTCPConnectionConfiguration config = XMPPTCPConnectionConfiguration.builder()
+  .setUsernameAndPassword("username", "password")
+  .setServiceName("jabber.org")
+  .setHost("earl.jabber.org")
+  .setPort("8222")
+  .build();
+
+AbstractXMPPConnection conn2 = **new** XMPPTCPConnection(config);
+conn2.connect();
+```
+
+Note that maximum security will be used when connecting to the server by
+default (and when possible), including use of TLS encryption. The
+ConnectionConfiguration class provides advanced control over the connection
+created, such as the ability to disable or require encryption. See
+[XMPPConnection Management](connections.md) for full details.
+
+Once you've created a connection, you should login with the
+`XMPPConnection.login()` method. Once you've logged in, you can being
+chatting with other users by creating new `Chat` or `GroupChat`
+objects.
+
+Working with the Roster
+----------------------
+
+The roster lets you keep track of the availability (presence) of other users.
+Users can be organized into groups such as "Friends" and "Co-workers", and
+then you discover whether each user is online or offline.
+
+Retrieve the roster using the `Roster.getInstanceFor(XMPPConnection)` method. The roster
+class allows you to find all the roster entries, the groups they belong to,
+and the current presence status of each entry.
+
+Reading and Writing Stanzas
+
+Each message to the XMPP server from a client is called a packet and is sent
+as XML. The `org.jivesoftware.smack.packet` package contains classes that
+encapsulate the three different basic packet types allowed by XMPP (message,
+presence, and IQ). Classes such as `Chat` and `GroupChat` provide higher-level
+constructs that manage creating and sending packets automatically, but you can
+also create and send packets directly. Below is a code example for changing
+your presence to let people know you're unavailable and "out fishing":
+
+```
+// Create a new presence. Pass in false to indicate we're unavailable._
+Presence presence = new Presence(Presence.Type.unavailable);
+presence.setStatus("Gone fishing");
+// Send the packet (assume we have an XMPPConnection instance called "con").
+con.sendStanza(presence);
+```
+
+Smack provides two ways to read incoming packets: `PacketListener`, and
+`PacketCollector`. Both use `StanzaFilter` instances to determine which
+packets should be processed. A packet listener is used for event style
+programming, while a packet collector has a result queue of packets that you
+can do polling and blocking operations on. So, a packet listener is useful
+when you want to take some action whenever a packet happens to come in, while
+a packet collector is useful when you want to wait for a specific packet to
+arrive. Packet collectors and listeners can be created using an Connection
+instance.
+
+Copyright (C) Jive Software 2002-2008

documentation/index.md

@@ -0,0 +1,14 @@
+**Smack Documentation**
+
+**Contents:**
+
+  * [Overview](overview.md)
+  * [Getting Started Guide](gettingstarted.md)
+  * [Managing Connections](connections.md)
+  * [Messaging Basics](messaging.md)
+  * [Roster and Presence](roster.md)
+  * [Processing Incoming Stanzas](processing.md)
+  * [Provider Architecture](providers.md)
+  * [Debugging with Smack](debugging.md)
+
+  * [Smack Extensions Manual](extensions/index.md)

documentation/legacy/index.html

@@ -0,0 +1,15 @@
+<html>
+
+<head>
+<title>Smack Legacy User Manual</title>
+<link rel="stylesheet" type="text/css" href="style.css" />
+</head>
+
+<frameset cols="200,*">
+<frame src="toc.html" name="navFrame" target="mainFrame">
+<frame src="intro.html" name="mainFrame">
+</frameset>
+<noframes>
+<H2>Smack Legacy User Manual</H2>
+
+<a href="toc.html">Smack Extensions User Manual</a></noframes></html>

documentation/legacy/intro.html

@@ -0,0 +1,26 @@
+<html>
+<head>
+<title>Smack Extensions User Manual</title>
+<link rel="stylesheet" type="text/css" href="style.css" />
+</head>
+
+<body>
+  	<div class="header">Smack Legacy Manual</div>
+  	<p>The XMPP protocol includes a base protocol and many optional extensions 
+    typically documented as "XEP's". Smack provides the smack-legacy artifcate, with
+	implementations of now <b>obsolete</b> XEPs. You should no longer use this code!</p>
+  
+    <div class="subheader">Legacy Extensions</div><p>
+  
+    <table border="0" width="85%" cellspacing="0" cellpadding="3" style="border:1px #bbb solid;">
+        <tr bgcolor="#ddeeff">
+            <td><b>Name</b></td><td><b>XEP #</b></td><td><b>Description</b></td>
+        </tr>
+        <tr>
+            <td><a href="messageevents.html">Message Events</a></td>
+            <td><a href="http://www.xmpp.org/extensions/xep-0022.html">XEP-0022</a></td>
+            <td>Requests and responds to message events.</td>
+        </tr>
+    </table>
+</body>
+</html>

documentation/legacy/messageevents.html

@@ -0,0 +1,244 @@
+<html>
+<head>
+    <title>Message Events</title>
+    <link rel="stylesheet" type="text/css" href="style.css" />
+</head>
+
+<body>
+
+<div class="header">Message Events</div><p>
+
+This extension is used to request and respond to events relating to the delivery, 
+display, and composition of messages. There are three stages in this extension:<ol>
+    <li>Request for event notifications,
+    <li>Receive the event notification requests and send event notifications, and
+    <li>Receive the event notifications.</ol> 
+<p>For more information on each stage please follow these links:</p>
+<ul>
+  <li><a href="#reqevnot">Requesting Event Notifications</a></li>
+  <li><a href="#lstevnotreq">Reacting to Event Notification Requests</a></li>
+  <li><a href="#lstevnot">Reacting to Event Notifications</a></li>
+</ul>
+<b>XEP related:</b> <a href="http://www.xmpp.org/extensions/xep-0022.html">XEP-22</a>
+<hr>
+<div class="subheader"><a name="reqevnot">Requesting Event Notifications</a></div><p>
+<b>Description</b><p>
+
+In order to receive event notifications for a given message you first have to specify 
+which events are you interested in. Each message that you send has to request its own event 
+notifications. Therefore, every message that you send as part of a chat should request its own event 
+notifications.</p>
+
+<b>Usage</b><p>
+
+The class <i>MessageEventManager</i> provides an easy way for requesting event notifications. All you have to do is specify
+the message that requires the event notifications and the events that you are interested in.
+<p>Use the static method <i><b>MessageEventManager.addNotificationsRequests(Message message, boolean offline, boolean 
+delivered, boolean displayed, boolean composing)</b></i> for requesting event notifications.
+</p>
+
+<b>Example</b><p>
+Below you can find an example that logs in a user to the server, creates a message, adds the requests
+for notifications and sends the message.
+<blockquote>
+<pre>      <font color="#3f7f5f">// Connect to the server and log in</font>
+      conn1 = new XMPPConnection(host);
+      conn1.login(server_user1, pass1);
+    
+      <font color="#3f7f5f">// Create a chat with user2</font>
+      Chat chat1 = conn1.createChat(user2);
+    
+      <font color="#3f7f5f">// Create a message to send</font>
+      Message msg = chat1.createMessage();
+      msg.setSubject(<font color="#0000FF">"Any subject you want"</font>);
+      msg.setBody(<font color="#0000FF">"An interesting body comes here..."</font>);
+      <font color="#3f7f5f">// Add to the message all the notifications requests (offline, delivered, displayed,</font>
+      <font color="#3f7f5f">// composing)</font>
+      MessageEventManager.addNotificationsRequests(msg, <font COLOR="#7f0055"><b>true</b></font>, <font COLOR="#7f0055"><b>true</b></font>, <font COLOR="#7f0055"><b>true</b></font>, <font COLOR="#7f0055"><b>true</b></font>);
+    
+      <font color="#3f7f5f">// Send the message that contains the notifications request</font>
+      chat1.sendMessage(msg);
+</pre>
+</blockquote>
+
+<hr>
+
+<div class="subheader"><a name="lstevnotreq">Reacting to Event Notification Requests</a></div><p>
+
+<b>Description</b><p>
+
+You can receive notification requests for the following events: delivered, displayed, composing and offline. You 
+<b>must</b> listen for these requests and react accordingly.</p>
+
+<b>Usage</b><p>
+
+The general idea is to create a new <i>DefaultMessageEventRequestListener</i> that will listen to the event notifications 
+requests and react with custom logic.  Then you will have to add the listener to the 
+<i>MessageEventManager</i> that works on 
+the desired <i>XMPPConnection</i>.
+<p>Note that <i>DefaultMessageEventRequestListener</i> is a default implementation of the 
+<i>MessageEventRequestListener</i> interface.
+The class <i>DefaultMessageEventRequestListener</i> automatically sends a delivered notification to the sender of the message 
+if the sender has requested to be notified when the message is delivered. If you decide to create a new class that
+implements the <i>MessageEventRequestListener</i> interface, please remember to send the delivered notification.</p>
+<ul>
+  <li>To create a new <i>MessageEventManager</i> use the <i><b>MessageEventManager(XMPPConnection)</b></i> constructor. 
+  </li>
+  <li>To create an event notification requests listener create a subclass of <i><b>DefaultMessageEventRequestListener</b></i> or
+  create a class that implements the <i><b>MessageEventRequestListener</b></i> interface.
+  </li>
+  <li>To add a listener to the messageEventManager use the MessageEventManager's message 
+<i><b>addMessageEventRequestListener(MessageEventRequestListener)</b></i>.</li>
+</ul></p>
+
+<b>Example</b><p>
+
+Below you can find an example that connects two users to the server. One user will create a message, add the requests
+for notifications and will send the message to the other user. The other user will add a 
+<i>DefaultMessageEventRequestListener</i> 
+to a <i>MessageEventManager</i> that will listen and react to the event notification requested by the other user.
+<blockquote>
+<pre>      <font color="#3f7f5f">// Connect to the server and log in the users</font>
+      conn1 = new XMPPTCPConnection(host);
+      conn1.login(server_user1, pass1);
+      conn2 = new XMPPTCPConnection(host);
+      conn2.login(server_user2, pass2);
+  
+      <font color="#3f7f5f">// User2 creates a MessageEventManager</font>
+      MessageEventManager messageEventManager = new MessageEventManager(conn2);
+      <font color="#3f7f5f">// User2 adds the listener that will react to the event notifications requests</font>
+      messageEventManager.addMessageEventRequestListener(new DefaultMessageEventRequestListener() {
+          public void deliveredNotificationRequested(
+              String from,
+              String packetID,
+              MessageEventManager messageEventManager) {
+              super.deliveredNotificationRequested(from, packetID, messageEventManager);
+              <font color="#3f7f5f">// DefaultMessageEventRequestListener automatically responds that the message was delivered when receives this request</font>
+              System.out.println(<font color="#0000FF">"Delivered Notification Requested (" + from + ", " + packetID + ")"</font>);
+          }
+
+          public void displayedNotificationRequested(
+              String from,
+              String packetID,
+              MessageEventManager messageEventManager) {
+              super.displayedNotificationRequested(from, packetID, messageEventManager);
+              <font color="#3f7f5f">// Send to the message's sender that the message was displayed</font>
+              messageEventManager.sendDisplayedNotification(from, packetID);
+          }
+
+          public void composingNotificationRequested(
+              String from,
+              String packetID,
+              MessageEventManager messageEventManager) {
+              super.composingNotificationRequested(from, packetID, messageEventManager);
+              <font color="#3f7f5f">// Send to the message's sender that the message's receiver is composing a reply</font>
+              messageEventManager.sendComposingNotification(from, packetID);
+          }
+
+          public void offlineNotificationRequested(
+              String from,
+              String packetID,
+              MessageEventManager messageEventManager) {
+              super.offlineNotificationRequested(from, packetID, messageEventManager);
+              <font color="#3f7f5f">// The XMPP server should take care of this request. Do nothing.</font>
+              System.out.println(<font color="#0000FF">"Offline Notification Requested (" + from + ", " + packetID + ")"</font>);
+          }
+      });
+
+      <font color="#3f7f5f">// User1 creates a chat with user2</font>
+      Chat chat1 = conn1.createChat(user2);
+    
+      <font color="#3f7f5f">// User1 creates a message to send to user2</font>
+      Message msg = chat1.createMessage();
+      msg.setSubject(<font color="#0000FF">"Any subject you want"</font>);
+      msg.setBody(<font color="#0000FF">"An interesting body comes here..."</font>);
+      <font color="#3f7f5f">// User1 adds to the message all the notifications requests (offline, delivered, displayed,</font>
+      <font color="#3f7f5f">// composing)</font>
+      MessageEventManager.addNotificationsRequests(msg, <font COLOR="#7f0055"><b>true</b></font>, <font COLOR="#7f0055"><b>true</b></font>, <font COLOR="#7f0055"><b>true</b></font>, <font COLOR="#7f0055"><b>true</b></font>);
+    
+      <font color="#3f7f5f">// User1 sends the message that contains the notifications request</font>
+      chat1.sendMessage(msg);
+      Thread.sleep(500);
+      <font color="#3f7f5f">// User2 sends to the message's sender that the message's receiver cancelled composing a reply</font>
+      messageEventManager.sendCancelledNotification(user1, msg.getPacketID());
+</pre>
+</blockquote>
+
+<hr>
+
+<div class="subheader"><a name="lstevnot">Reacting to Event Notifications</a></div><p>
+
+<b>Description</b><p>
+
+Once you have requested for event notifications you will start to receive notifications of events. You can 
+receive notifications of the following events: delivered, displayed, composing, offline and cancelled. You 
+will probably want to react to some or all of these events.</p>
+
+<b>Usage</b><p>
+
+The general idea is to create a new <i>MessageEventNotificationListener</i> that will listen to the event notifications 
+and react with custom logic.  Then you will have to add the listener to the <i>MessageEventManager</i> that works on 
+the desired <i>XMPPConnection</i>.
+<ul>
+  <li>To create a new <i>MessageEventManager</i> use the <i><b>MessageEventManager(XMPPConnection)</b></i> constructor. 
+  </li>
+  <li>To create an event notifications listener create a class that implements the <i><b>MessageEventNotificationListener</b></i> 
+  interface.
+  </li>
+  <li>To add a listener to the messageEventManager use the MessageEventManager's message 
+<i><b>addMessageEventNotificationListener(MessageEventNotificationListener)</b></i>.</li>
+</ul></p>
+
+<b>Example</b><p>
+Below you can find an example that logs in a user to the server, adds a <i>MessageEventNotificationListener</i>
+to a <i>MessageEventManager</i> that will listen and react to the event notifications, creates a message, adds 
+the requests for notifications and sends the message.
+<blockquote>
+<pre>      <font color="#3f7f5f">// Connect to the server and log in</font>
+      conn1 = new XMPPTCPConnection(host);
+      conn1.login(server_user1, pass1);
+  
+      <font color="#3f7f5f">// Create a MessageEventManager</font>
+      MessageEventManager messageEventManager = new MessageEventManager(conn1);
+      <font color="#3f7f5f">// Add the listener that will react to the event notifications</font>
+      messageEventManager.addMessageEventNotificationListener(new MessageEventNotificationListener() {
+          public void deliveredNotification(String from, String packetID) {
+              System.out.println(<font color="#0000FF">"The message has been delivered (" + from + ", " + packetID + ")"</font>);
+          }
+    
+          public void displayedNotification(String from, String packetID) {
+              System.out.println(<font color="#0000FF">"The message has been displayed (" + from + ", " + packetID + ")"</font>);
+          }
+    
+          public void composingNotification(String from, String packetID) {
+              System.out.println(<font color="#0000FF">"The message's receiver is composing a reply (" + from + ", " + packetID + ")"</font>);
+          }
+    
+          public void offlineNotification(String from, String packetID) {
+              System.out.println(<font color="#0000FF">"The message's receiver is offline (" + from + ", " + packetID + ")"</font>);
+          }
+    
+          public void cancelledNotification(String from, String packetID) {
+              System.out.println(<font color="#0000FF">"The message's receiver cancelled composing a reply (" + from + ", " + packetID + ")"</font>);
+          }
+      });
+
+      <font color="#3f7f5f">// Create a chat with user2</font>
+      Chat chat1 = conn1.createChat(user2);
+    
+      <font color="#3f7f5f">// Create a message to send</font>
+      Message msg = chat1.createMessage();
+      msg.setSubject(<font color="#0000FF">"Any subject you want"</font>);
+      msg.setBody(<font color="#0000FF">"An interesting body comes here..."</font>);
+      <font color="#3f7f5f">// Add to the message all the notifications requests (offline, delivered, displayed,</font>
+      <font color="#3f7f5f">// composing)</font>
+      MessageEventManager.addNotificationsRequests(msg, <font COLOR="#7f0055"><b>true</b></font>, <font COLOR="#7f0055"><b>true</b></font>, <font COLOR="#7f0055"><b>true</b></font>, <font COLOR="#7f0055"><b>true</b></font>);
+    
+      <font color="#3f7f5f">// Send the message that contains the notifications request</font>
+      chat1.sendMessage(msg);
+</pre>
+</blockquote>
+
+</body>
+
+</html>

documentation/legacy/toc.html

@@ -0,0 +1,19 @@
+<html>
+<head>
+<title>Smack Legacy User Manual</title>
+<link rel="stylesheet" type="text/css" href="style.css" />
+<base target="mainFrame">
+</head>
+
+<body>
+
+<a href="intro.html">Introduction</a><p>
+
+<div class="subheader">Smack Legacy Extensions</div><p>
+
+<p>
+<a href="messageevents.html">Message Events</a><br>
+</p>
+
+</body>
+</html>

documentation/messaging.md

@@ -0,0 +1,95 @@
+Messaging using Chats
+=====================
+
+[Back](index.md)
+
+Sending messages back and forth is at the core of instant messaging. Although
+individual messages can be sent and received as packets, it's generally easier
+to treat the string of messages as a chat using the
+`org.jivesoftware.smack.Chat` class.
+
+Chat
+----
+
+A chat creates a new thread of messages (using a thread ID) between two users.
+The following code snippet demonstrates how to create a new Chat with a user
+and then send them a text message:
+
+```
+// Assume we've created an XMPPConnection name "connection"._
+ChatManager chatmanager = ChatManager.getInstanceFor(connection);
+Chat newChat = chatmanager.createChat("jsmith@jivesoftware.com", new MessageListener() {
+	public void processMessage(Chat chat, Message message) {
+		System.out.println("Received message: " + message);
+	}
+});
+
+try {
+	newChat.sendMessage("Howdy!");
+}
+catch (XMPPException e) {
+	System.out.println("Error Delivering block");
+}
+```
+
+The `Chat.sendMessage(String)` method is a convenience method that creates a
+Message object, sets the body using the String parameter, then sends the
+message. In the case that you wish to set additional values on a Message
+before sending it, use the `Chat.createMessage()` and
+`Chat.sendMessage(Message)` methods, as in the following code snippet:
+
+```
+Message newMessage = new Message();
+newMessage.setBody("Howdy!");
+message.setProperty("favoriteColor", "red");
+newChat.sendMessage(newMessage);
+```
+
+You'll also notice in the example above that we specified a MessageListener
+when creating a chat. The listener is notified any time a new message arrives
+from the other user in the chat. The following code snippet uses the listener
+as a parrot-bot -- it echoes back everything the other user types.
+
+```
+// Assume a MessageListener we've setup with a chat._
+
+public void processMessage(Chat chat, Message message) {
+		// Send back the same text the other user sent us._
+		chat.sendMessage(message.getBody());
+}
+```
+
+Incoming Chat
+-------------
+
+When chats are prompted by another user, the setup is slightly different since
+you are receiving a chat message first. Instead of explicitly creating a chat
+to send messages, you need to register to handle newly created Chat instances
+when the ChatManager creates them.  The ChatManager will already find a
+matching chat (by thread id) and if none exists, then it will create a new one
+that does match. To get this new chat, you have to register to be notified
+when it happens. You can register a message listener to receive all future
+messages as part of this handler.
+
+```
+// Assume we've created an XMPPConnection name "connection"._
+ChatManager chatManager = ChatManager.getInstanceFor(connection);
+chatManager.addChatListener(
+	new ChatManagerListener() {
+		@Override
+		public void chatCreated(Chat chat, boolean createdLocally)
+		{
+			if (!createdLocally)
+				chat.addMessageListener(new MyNewMessageListener());;
+		}
+	});
+```
+
+In addition to thread based chat messages, there are some clients that do not
+send a thread id as part of the chat. To handle this scenario, Smack will
+attempt match the incoming messages to the best fit existing chat, based on
+the JID. It will attempt to find a chat with the same full JID, failing that,
+it will try the base JID. If no existing chat to the user can found, then a
+new one is created.
+
+Copyright (C) Jive Software 2002-2008

documentation/overview.md

@@ -0,0 +1,48 @@
+Smack Overview
+==============
+
+[Back](index.md)
+
+Smack is a library for communicating with XMPP servers to perform real-time
+communications, including instant messaging and group chat.
+
+Smack Key Advantages
+--------------------
+
+  * Extremely simple to use, yet powerful API. Sending a text message to a user can be accomplished in only a few lines of code: 
+
+    ```java
+    AbstractXMPPConnection connection = new XMPPTCPConnection("mtucker", "password", "jabber.org");
+    connection.connect().login();
+
+    Chat chat = ChatManager.getInstanceFor(connection)
+        .createChat("jsmith@jivesoftware.com", new MessageListener() {
+
+        public void processMessage(Chat chat, Message message) {
+            System.out.println("Received message: " + message);
+        }
+    });
+    chat.sendMessage("Howdy!");
+    ```
+
+* Doesn't force you to code at the packet level, as other libraries do. Smack provides intelligent higher level constructs such as the `Chat` and `Roster` classes, which let you program more efficiently. 
+  * Does not require that you're familiar with the XMPP XML format, or even that you're familiar with XML. 
+  * Provides easy machine to machine communication. Smack lets you set any number of properties on each message, including properties that are Java objects. 
+  * Open Source under the Apache License, which means you can incorporate Smack into your commercial or non-commercial applications. 
+
+About XMPP
+----------
+
+XMPP (eXtensible Messaging and Presence Protocol) is an open protocol
+standardized by the IETF and supported and extended by the XMPP Standards
+Foundation (([http://www.xmpp.org](http://www.xmpp.org)).
+
+How To Use This Documentation
+-----------------------------
+
+This documentation assumes that you're already familiar with the main features
+of XMPP instant messaging. It's also highly recommended that you open the
+Javadoc API guide and use that as a reference while reading through this
+documentation.
+
+Copyright (C) Jive Software 2002-2008

documentation/processing.md

@@ -0,0 +1,58 @@
+Processing Incoming Stanzas
+===========================
+
+[Back](index.md)
+
+Smack provides a flexible framework for processing incoming packets using two
+constructs:
+
+  * `org.jivesoftware.smack.PacketCollector` -- a class that lets you synchronously wait for new packets.
+  * `org.jivesoftware.smack.PacketListener` -- an interface for asynchronously notifying you of incoming packets.  A packet listener is used for event style programming, while a packet collector has a result queue of packets that you can do polling and blocking operations on. So, a packet listener is useful when you want to take some action whenever a packet happens to come in, while a packet collector is useful when you want to wait for a specific packet to arrive. Packet collectors and listeners can be created using an `XMPPConnection` instance.
+
+The `org.jivesoftware.smack.filter.StanzaFilter` interface determines which
+specific packets will be delivered to a `PacketCollector` or `PacketListener`.
+Many pre-defined filters can be found in the `org.jivesoftware.smack.filter`
+package.
+
+The following code snippet demonstrates registering both a packet collector
+and a packet listener:
+
+```
+// Create a packet filter to listen for new messages from a particular
+// user. We use an AndFilter to combine two other filters._
+StanzaFilter filter = new AndFilter(new StanzaTypeFilter(Message.class),
+		new FromContainsFilter("mary@jivesoftware.com"));
+// Assume we've created an XMPPConnection name "connection".
+
+// First, register a packet collector using the filter we created.
+PacketCollector myCollector = connection.createPacketCollector(filter);
+// Normally, you'd do something with the collector, like wait for new packets.
+
+// Next, create a packet listener. We use an anonymous inner class for brevity.
+PacketListener myListener = new PacketListener() {
+		**public** **void** processPacket(Packet packet) {
+			// Do something with the incoming packet here._
+		}
+	};
+// Register the listener._
+connection.addPacketListener(myListener, filter);
+```
+
+Standard Stanza Filters
+-----------------------
+
+A rich set of packet filters are included with Smack, or you can create your
+own filters by coding to the `StanzaFilter` interface. The default set of
+filters includes:
+
+  * `StanzaTypeFilter` -- filters for packets that are a particular Class type.
+  * `StanzaIdFilter` -- filters for packets with a particular packet ID.
+  * `ThreadFilter` -- filters for message packets with a particular thread ID.
+  * `ToContainsFilter` -- filters for packets that are sent to a particular address.
+  * `FromContainsFilter` -- filters for packets that are sent to a particular address.
+  * `StanzaExtensionFilter` -- filters for packets that have a particular packet extension.
+  * `AndFilter` -- implements the logical AND operation over two filters.
+  * `OrFilter` -- implements the logical OR operation over two filters.
+  * `NotFilter` -- implements the logical NOT operation on a filter.
+
+Copyright (C) Jive Software 2002-2008

documentation/providers.md

@@ -0,0 +1,345 @@
+Provider Architecture: Stanza Extensions and Custom IQ's
+========================================================
+
+[Back](index.md)
+
+Introduction
+------------
+
+The Smack provider architecture is a system for plugging in custom XML parsing
+of packet extensions and IQ packets. The standard [Smack
+Extensions](extensions/index.md) are built using the provider architecture.
+There are two types of providers:
+
+  * `IQProvider` -- parses IQ requests into Java objects.
+  * `Extension Provider` -- parses XML sub-documents attached to packets into PacketExtension instances. By default, Smack only knows how to process a few standard packets and sub-packets that are in a few namespaces such as:
+  * jabber:iq:auth
+  * jabber:iq:roster
+  * jabber:iq:register There are many more IQ types and extensions that are part of XMPP standards, and of course an endless number that can be added as custom extensions. To support this, an extensible parsing mechanism is provided via Smack and user build providers.
+
+Whenever a packet extension is found in a packet, parsing will be
+passed to the correct provider. Each provider must implement the
+PacketExtensionProvider interface. Each extension provider is
+responsible for parsing the raw XML stream, via the
+[XML Pull Parser](http://www.xmlpull.org/), to contruct an object.
+
+You can also create an introspection provider
+(`provider.IntrospectionProvider.PacketExtensionIntrospectionProvider`). Here,
+bean introspection is used to try to automatically set the properties
+of the class using the values in the packet extension sub-element.
+
+When no extension provider is registered for an element name and namespace
+combination, Smack will store all top-level elements of the sub-packet in the
+DefaultPacketExtension object and then attach it to the packet.
+
+Management of these providers is accomplished via the [ProviderManager]()
+class. There are multiple ways to add providers to the manager.
+
+  * Call addXXProvider methods - You can call the appropriate add methods directly.
+
+```
+ProviderManager.addIQProvider("element", "namespace", new MyIQProvider());
+ProviderManager.addExtensionProvider("element", "namespace", new MyExtProvider());
+```
+
+  * Add a loader - You can add a ProviderLoader which will inject a means of loading multiple providers (both types) into the manager. This is the mechanism used by Smack to load from the Smack specific file format (via ProviderFileLoader). Implementers can provide the means to load providers from any source they wish, or simply reuse the ProviderFileLoader to load from their own provider files.
+
+
+	ProviderManager.addLoader(new ProviderFileLoader(FileUtils.getStreamForUrl("classpath:com/myco/provider/myco_custom.providers", null)));
+
+
+  * VM Argument - You can add a provider file via the VM argument _smack.provider.file_. This will load the file at the specified URL during startup when Smack initializes. This also assumes the default configuration, since it requires that the **VmArgInitializer** was part of the startup configuration.
+
+
+`-Dsmack.provider.file=classpath:com/myco/provider/myco_custom.provider`s
+
+or
+
+`-Dsmack.provider.file=file:///c:/myco/provider/myco_custom.providers`
+
+
+IQ Providers
+------------
+
+The IQ provider class must implement the IQProvider interface. Each
+IQProvider is responsible for parsing the raw XML stream to create an
+IQ instance.
+
+You can also create an introspection provider
+(`provider.IntrospectionProvider.IQIntrospectionProvider`). Which
+uses, bean introspection to try to automatically set properties of the
+IQ instance using the values found in the IQ packet XML. For example,
+an XMPP time packet resembles the following:
+
+### Introspection
+
+_Time Stanza_
+
+
+	<iq type='result' to='joe@example.com' from='mary@example.com' id='time_1'>
+		<query xmlns='jabber:iq:time'>
+			<utc>20020910T17:58:35</utc>
+			<tz>MDT</tz>
+			<display>Tue Sep 10 12:58:35 2002</display>
+		</query>
+	</iq>
+
+
+_Time IQ Class_
+
+
+	class Time extends IQ {
+		private Date utc;
+		private TimeZone timeZone;
+		private String display;
+
+		@Override
+		public String getChildElementXML() {
+			return null;
+		}
+
+		public void setUtc(String utcString) {
+			try {
+				utc = StringUtils.parseDate(utcString);
+			} catch (ParseException e) {
+			}
+		}
+
+		public void setTimeZone(String zone) {
+			timeZone = TimeZone.getTimeZone(zone);
+		}
+
+		public void setDisplay(String timeDisplay) {
+			display = timeDisplay;
+		}
+	}
+
+_Time Provider_
+
+```java
+public class TimeProvider extends IQIntrospectionProvider<Time> {
+
+    public TimeProvider() {
+        super(Time.class);
+    }
+
+}
+```
+
+The introspection service will automatically try to convert the String value
+from the XML into a boolean, int, long, float, double, or Class depending on
+the type the IQ instance expects.
+
+### Custom IQProvider example
+
+Let's assume you want to write a provider for a new, unsupported IQ in Smack.
+
+_Custom IQ_
+
+```
+<iq type='set' from='juliet@capulet.example/balcony' to='romeo@montage.example'>
+  <myiq xmlns='example:iq:foo' token='secret'>
+    <user age='42'>John Doe</user>
+	<location>New York</location>
+  </myiq>
+</iq>
+```
+
+_Custom IQ Provider_
+
+```java
+public class MyIQProvider extends IQProvider<MyIQ> {
+
+  @Override
+  public MyIQ parse(XmlPullParser parser, int initialDepth) throws XmlPullParserException, IOException {
+    // Define the data we are trying to collect with sane defaults
+    int age = -1;
+	String user = null;
+	String location = null;
+
+    // Start parsing loop
+	outerloop: while(true) {
+	  int eventType = parser.next();
+	  switch(eventType) {
+	  case XmlPullParser.START_TAG:
+		String elementName = parser.getName();
+		switch (elementName) {
+		case "user":
+		  age = ParserUtils.getIntegerAttribute(parser, "age");
+		  user = parser.nextText();
+		  break;
+		case "location"
+		  location = parser.nextText();
+		  break;
+	    }
+		break;
+	  case XmlPullParser.END_TAG:
+		// Abort condition: if the are on a end tag (closing element) of the same depth
+		if (parser.getDepth() == initialDepth) {
+		  break outerloop;
+		}
+		break;
+	  }
+	}
+
+    // Construct the IQ instance at the end of parsing, when all data has been collected
+	return new MyIQ(user, age, location);
+  }
+}
+```
+
+### DiscoItemsProvider
+
+_Disco Items Stanza_
+
+
+
+	<iq type='result' from='shakespeare.lit' to='romeo@montague.net/orchard' id='items1'>
+	   <query xmlns='http://jabber.org/protocol/disco#items'>
+		   <item jid='people.shakespeare.lit' name='Directory of Characters'/>
+		   <item jid='plays.shakespeare.lit' name='Play-Specific Chatrooms'/>
+		   <item jid='mim.shakespeare.lit' name='Gateway to Marlowe IM'/>
+		   <item jid='words.shakespeare.lit' name='Shakespearean Lexicon'/>
+		   <item jid='globe.shakespeare.lit' name='Calendar of Performances'/>
+		   <item jid='headlines.shakespeare.lit' name='Latest Shakespearean News'/>
+		   <item jid='catalog.shakespeare.lit' name='Buy Shakespeare Stuff!'/>
+		   <item jid='en2fr.shakespeare.lit' name='French Translation Service'/>
+	   </query>
+	</iq>
+
+
+_Disco Items IQProvider_
+
+
+
+	public class DiscoverItemsProvider implements IQProvider<DiscoverItems> {
+
+		public DiscoverItems parseIQ(XmlPullParser parser, int initialDepth) throw XmlPullParserException, IOException {
+			DiscoverItems discoverItems = new DiscoverItems();
+			DiscoverItems.Item item;
+			String jid = "";
+			String name = "";
+			String action = "";
+			String node = "";
+			discoverItems.setNode(parser.getAttributeValue("", "node"));
+			outerloop: while (true) {
+				int eventType = parser.next();
+				switch (eventType) {
+				case XmlPullParser.START_TAG:
+					String elementName = parser.getName();
+					switch (elementName) {
+					case "item":
+						// Initialize the variables from the parsed XML
+						jid = parser.getAttributeValue("", "jid");
+						name = parser.getAttributeValue("", "name");
+						node = parser.getAttributeValue("", "node");
+						action = parser.getAttributeValue("", "action");
+						break;
+					}
+					break;
+				case XmlPullParser.END_TAG:
+					String elementName = parser.getName();
+					switch (elementName) {
+					case "item":
+						// Create a new Item and add it to DiscoverItems.
+						item = new DiscoverItems.Item(jid);
+						item.setName(name);
+						item.setNode(node);
+						item.setAction(action);
+						discoverItems.addItem(item);
+						break;
+					case "query":
+					    if (parser.getDepth() == initialDepth) {
+							break outerloop;
+						}
+						break;
+					}
+				}
+			}
+			return discoverItems;
+		}
+	}
+
+
+Extension Providers
+-------------------
+
+Stanza extension providers are responsible for parsing packet extensions,
+which are child elements in a custom namespace of IQ, message and presence
+packets.
+
+_Pubsub Subscription Stanza_
+
+
+	<iq type='result' from='pubsub.shakespeare.lit' to='francisco@denmark.lit/barracks' id='sub1'>
+	   <pubsub xmlns='http://jabber.org/protocol/pubsub'>
+		   <subscription node='princely_musings' jid='francisco@denmark.lit' subscription='unconfigured'>
+			   <subscribe-options>
+				   <required/>
+			   </subscribe-options>
+		   </subscription>
+	   </pubsub>
+	</iq>
+
+
+_Subscription PacketExtensionProvider Implementation_
+
+
+	public class SubscriptionProvider implements PacketExtensionProvider {
+		public PacketExtension parseExtension(XmlPullParser parser) throws Exception {
+			String jid = parser.getAttributeValue(null, "jid");
+			String nodeId = parser.getAttributeValue(null, "node");
+			String subId = parser.getAttributeValue(null, "subid");
+			String state = parser.getAttributeValue(null, "subscription");
+			boolean isRequired = false;
+
+			int tag = parser.next();
+
+			if ((tag == XmlPullParser.START_TAG) && parser.getName().equals("subscribe-options")) {
+				tag = parser.next();
+
+				if ((tag == XmlPullParser.START_TAG) && parser.getName().equals("required"))
+					isRequired = true;
+
+				while (parser.next() != XmlPullParser.END_TAG && parser.getName() != "subscribe-options");
+			}
+			while (parser.getEventType() != XmlPullParser.END_TAG) parser.next();
+			return new Subscription(jid, nodeId, subId, (state == null ? null : Subscription.State.valueOf(state), isRequired);
+		}
+	}
+
+
+Provider file format
+--------------------
+
+This is the format for a provider file which can be parsed by the
+**ProviderFileLoader**.
+
+
+	<?xml version="1.0"?>
+	<smackProviders>
+	<iqProvider>
+		<elementName>query</elementName>
+		<namespace>jabber:iq:time</namespace>
+		<className>org.jivesoftware.smack.packet.Time</className>
+	</iqProvider>
+
+	<iqProvider>
+		<elementName>query</elementName>
+		<namespace>http://jabber.org/protocol/disco#items</namespace>
+		<className>org.jivesoftware.smackx.provider.DiscoverItemsProvider</className>
+	</iqProvider>
+
+	<extensionProvider>
+		<elementName>subscription</elementName>
+		<namespace>http://jabber.org/protocol/pubsub</namespace>
+		<className>org.jivesoftware.smackx.pubsub.provider.SubscriptionProvider</className>
+	</extensionProvider>
+	</smackProviders>
+
+Each provider is associated with an element name and a namespace. If multiple
+provider entries attempt to register to handle the same namespace, the last
+entry added to the **ProviderManager** will overwrite any other that was
+loaded before it.
+
+Copyright (C) Jive Software 2002-2008

documentation/roster.md

@@ -0,0 +1,94 @@
+Roster and Presence
+===================
+
+[Back](index.md)
+
+The roster lets you keep track of the availability ("presence") of other
+users. A roster also allows you to organize users into groups such as
+"Friends" and "Co-workers". Other IM systems refer to the roster as the buddy
+list, contact list, etc.
+
+A `Roster` instance is obtained using the `Roster.getInstanceFor(XMPPConnection)` method.
+
+Roster Entries
+--------------
+
+Every user in a roster is represented by a RosterEntry, which consists of:
+
+  * An XMPP address (e.g. jsmith@example.com).
+  * A name you've assigned to the user (e.g. "Joe").
+  * The list of groups in the roster that the entry belongs to. If the roster entry belongs to no groups, it's called an "unfiled entry".  The following code snippet prints all entries in the roster: 
+
+```
+Roster roster = Roster.getInstanceFor(connection);
+Collection<RosterEntry> entries = roster.getEntries();
+for (RosterEntry entry : entries) {
+	System.out.println(entry);
+}
+```
+
+Methods also exist to get individual entries, the list of unfiled entries, or
+to get one or all roster groups.
+
+Presence
+
+![Roster](images/roster.png)
+
+Every entry in the roster has presence associated with it. The
+`Roster.getPresence(String user)` method will return a Presence object with
+the user's presence or `null` if the user is not online or you are not
+subscribed to the user's presence. _Note:_ typically, presence subscription is
+always tied to the user being on the roster, but this is not true in all
+cases.
+
+A user either has a presence of online or offline. When a user is online,
+their presence may contain extended information such as what they are
+currently doing, whether they wish to be disturbed, etc. See the Presence
+class for further details.
+
+Listening for Roster and Presence Changes
+-----------------------------------------
+
+The typical use of the roster class is to display a tree view of groups and
+entries along with the current presence value of each entry. As an example,
+see the image showing a Roster in the Exodus XMPP client to the right.
+
+The presence information will likely change often, and it's also possible for
+the roster entries to change or be deleted. To listen for changing roster and
+presence data, a RosterListener should be used. To be informed about all
+changes to the roster the RosterListener should be registered before logging
+into the XMPP server. The following code snippet registers a RosterListener
+with the Roster that prints any presence changes in the roster to standard
+out. A normal client would use similar code to update the roster UI with the
+changing information.
+
+```
+Roster roster = Roster.getInstanceFor(con);
+roster.addRosterListener(new RosterListener() {
+	// Ignored events public void entriesAdded(Collection<String> addresses) {}
+	public void entriesDeleted(Collection<String> addresses) {}
+	public void entriesUpdated(Collection<String> addresses) {}
+	public void presenceChanged(Presence presence) {
+		System.out.println("Presence changed: " + presence.getFrom() + " " + presence);
+	}
+});
+```
+
+Adding Entries to the Roster
+----------------------------
+
+Rosters and presence use a permissions-based model where users must give
+permission before they are added to someone else's roster. This protects a
+user's privacy by making sure that only approved users are able to view their
+presence information. Therefore, when you add a new roster entry it will be in
+a pending state until the other user accepts your request.
+
+If another user requests a presence subscription so they can add you to their
+roster, you must accept or reject that request. Smack handles presence
+subscription requests in one of three ways:
+
+  * Automatically accept all presence subscription requests.
+  * Automatically reject all presence subscription requests.
+  * Process presence subscription requests manually.  The mode can be set using the `Roster.setSubscriptionMode(Roster.SubscriptionMode)` method. Simple clients normally use one of the automated subscription modes, while full-featured clients should manually process subscription requests and let the end-user accept or reject each request. If using the manual mode, a PacketListener should be registered that listens for Presence packets that have a type of `Presence.Type.subscribe`.   
+
+Copyright (C) Jive Software 2002-2008

gradle.properties

@@ -1,5 +0,0 @@
-# Workaround for https://github.com/CycloneDX/cyclonedx-gradle-plugin/issues/349
-# suggested at https://docs.gradle.org/current/userguide/upgrading_version_8.html#xml_parsing_now_requires_recent_parsers
-systemProp.javax.xml.parsers.SAXParserFactory=com.sun.org.apache.xerces.internal.jaxp.SAXParserFactoryImpl
-systemProp.javax.xml.transform.TransformerFactory=com.sun.org.apache.xalan.internal.xsltc.trax.TransformerFactoryImpl
-systemProp.javax.xml.parsers.DocumentBuilderFactory=com.sun.org.apache.xerces.internal.jaxp.DocumentBuilderFactoryImpl

gradle/wrapper/gradle-wrapper.properties

@@ -1,7 +0,0 @@
-distributionBase=GRADLE_USER_HOME
-distributionPath=wrapper/dists
-distributionUrl=https\://services.gradle.org/distributions/gradle-8.10.2-bin.zip
-networkTimeout=10000
-validateDistributionUrl=true
-zipStoreBase=GRADLE_USER_HOME
-zipStorePath=wrapper/dists

gradlew

@@ -1,252 +0,0 @@
-#!/bin/sh
-
-#
-# Copyright © 2015-2021 the original authors.
-#
-# Licensed 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
-#
-#      https://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.
-#
-# SPDX-License-Identifier: Apache-2.0
-#
-
-##############################################################################
-#
-#   Gradle start up script for POSIX generated by Gradle.
-#
-#   Important for running:
-#
-#   (1) You need a POSIX-compliant shell to run this script. If your /bin/sh is
-#       noncompliant, but you have some other compliant shell such as ksh or
-#       bash, then to run this script, type that shell name before the whole
-#       command line, like:
-#
-#           ksh Gradle
-#
-#       Busybox and similar reduced shells will NOT work, because this script
-#       requires all of these POSIX shell features:
-#         * functions;
-#         * expansions «$var», «${var}», «${var:-default}», «${var+SET}»,
-#           «${var#prefix}», «${var%suffix}», and «$( cmd )»;
-#         * compound commands having a testable exit status, especially «case»;
-#         * various built-in commands including «command», «set», and «ulimit».
-#
-#   Important for patching:
-#
-#   (2) This script targets any POSIX shell, so it avoids extensions provided
-#       by Bash, Ksh, etc; in particular arrays are avoided.
-#
-#       The "traditional" practice of packing multiple parameters into a
-#       space-separated string is a well documented source of bugs and security
-#       problems, so this is (mostly) avoided, by progressively accumulating
-#       options in "$@", and eventually passing that to Java.
-#
-#       Where the inherited environment variables (DEFAULT_JVM_OPTS, JAVA_OPTS,
-#       and GRADLE_OPTS) rely on word-splitting, this is performed explicitly;
-#       see the in-line comments for details.
-#
-#       There are tweaks for specific operating systems such as AIX, CygWin,
-#       Darwin, MinGW, and NonStop.
-#
-#   (3) This script is generated from the Groovy template
-#       https://github.com/gradle/gradle/blob/HEAD/platforms/jvm/plugins-application/src/main/resources/org/gradle/api/internal/plugins/unixStartScript.txt
-#       within the Gradle project.
-#
-#       You can find Gradle at https://github.com/gradle/gradle/.
-#
-##############################################################################
-
-# Attempt to set APP_HOME
-
-# Resolve links: $0 may be a link
-app_path=$0
-
-# Need this for daisy-chained symlinks.
-while
-    APP_HOME=${app_path%"${app_path##*/}"}  # leaves a trailing /; empty if no leading path
-    [ -h "$app_path" ]
-do
-    ls=$( ls -ld "$app_path" )
-    link=${ls#*' -> '}
-    case $link in             #(
-      /*)   app_path=$link ;; #(
-      *)    app_path=$APP_HOME$link ;;
-    esac
-done
-
-# This is normally unused
-# shellcheck disable=SC2034
-APP_BASE_NAME=${0##*/}
-# Discard cd standard output in case $CDPATH is set (https://github.com/gradle/gradle/issues/25036)
-APP_HOME=$( cd -P "${APP_HOME:-./}" > /dev/null && printf '%s
-' "$PWD" ) || exit
-
-# Use the maximum available, or set MAX_FD != -1 to use that value.
-MAX_FD=maximum
-
-warn () {
-    echo "$*"
-} >&2
-
-die () {
-    echo
-    echo "$*"
-    echo
-    exit 1
-} >&2
-
-# OS specific support (must be 'true' or 'false').
-cygwin=false
-msys=false
-darwin=false
-nonstop=false
-case "$( uname )" in                #(
-  CYGWIN* )         cygwin=true  ;; #(
-  Darwin* )         darwin=true  ;; #(
-  MSYS* | MINGW* )  msys=true    ;; #(
-  NONSTOP* )        nonstop=true ;;
-esac
-
-CLASSPATH=$APP_HOME/gradle/wrapper/gradle-wrapper.jar
-
-
-# Determine the Java command to use to start the JVM.
-if [ -n "$JAVA_HOME" ] ; then
-    if [ -x "$JAVA_HOME/jre/sh/java" ] ; then
-        # IBM's JDK on AIX uses strange locations for the executables
-        JAVACMD=$JAVA_HOME/jre/sh/java
-    else
-        JAVACMD=$JAVA_HOME/bin/java
-    fi
-    if [ ! -x "$JAVACMD" ] ; then
-        die "ERROR: JAVA_HOME is set to an invalid directory: $JAVA_HOME
-
-Please set the JAVA_HOME variable in your environment to match the
-location of your Java installation."
-    fi
-else
-    JAVACMD=java
-    if ! command -v java >/dev/null 2>&1
-    then
-        die "ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH.
-
-Please set the JAVA_HOME variable in your environment to match the
-location of your Java installation."
-    fi
-fi
-
-# Increase the maximum file descriptors if we can.
-if ! "$cygwin" && ! "$darwin" && ! "$nonstop" ; then
-    case $MAX_FD in #(
-      max*)
-        # In POSIX sh, ulimit -H is undefined. That's why the result is checked to see if it worked.
-        # shellcheck disable=SC2039,SC3045
-        MAX_FD=$( ulimit -H -n ) ||
-            warn "Could not query maximum file descriptor limit"
-    esac
-    case $MAX_FD in  #(
-      '' | soft) :;; #(
-      *)
-        # In POSIX sh, ulimit -n is undefined. That's why the result is checked to see if it worked.
-        # shellcheck disable=SC2039,SC3045
-        ulimit -n "$MAX_FD" ||
-            warn "Could not set maximum file descriptor limit to $MAX_FD"
-    esac
-fi
-
-# Collect all arguments for the java command, stacking in reverse order:
-#   * args from the command line
-#   * the main class name
-#   * -classpath
-#   * -D...appname settings
-#   * --module-path (only if needed)
-#   * DEFAULT_JVM_OPTS, JAVA_OPTS, and GRADLE_OPTS environment variables.
-
-# For Cygwin or MSYS, switch paths to Windows format before running java
-if "$cygwin" || "$msys" ; then
-    APP_HOME=$( cygpath --path --mixed "$APP_HOME" )
-    CLASSPATH=$( cygpath --path --mixed "$CLASSPATH" )
-
-    JAVACMD=$( cygpath --unix "$JAVACMD" )
-
-    # Now convert the arguments - kludge to limit ourselves to /bin/sh
-    for arg do
-        if
-            case $arg in                                #(
-              -*)   false ;;                            # don't mess with options #(
-              /?*)  t=${arg#/} t=/${t%%/*}              # looks like a POSIX filepath
-                    [ -e "$t" ] ;;                      #(
-              *)    false ;;
-            esac
-        then
-            arg=$( cygpath --path --ignore --mixed "$arg" )
-        fi
-        # Roll the args list around exactly as many times as the number of
-        # args, so each arg winds up back in the position where it started, but
-        # possibly modified.
-        #
-        # NB: a `for` loop captures its iteration list before it begins, so
-        # changing the positional parameters here affects neither the number of
-        # iterations, nor the values presented in `arg`.
-        shift                   # remove old arg
-        set -- "$@" "$arg"      # push replacement arg
-    done
-fi
-
-
-# Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script.
-DEFAULT_JVM_OPTS='"-Xmx64m" "-Xms64m"'
-
-# Collect all arguments for the java command:
-#   * DEFAULT_JVM_OPTS, JAVA_OPTS, JAVA_OPTS, and optsEnvironmentVar are not allowed to contain shell fragments,
-#     and any embedded shellness will be escaped.
-#   * For example: A user cannot expect ${Hostname} to be expanded, as it is an environment variable and will be
-#     treated as '${Hostname}' itself on the command line.
-
-set -- \
-        "-Dorg.gradle.appname=$APP_BASE_NAME" \
-        -classpath "$CLASSPATH" \
-        org.gradle.wrapper.GradleWrapperMain \
-        "$@"
-
-# Stop when "xargs" is not available.
-if ! command -v xargs >/dev/null 2>&1
-then
-    die "xargs is not available"
-fi
-
-# Use "xargs" to parse quoted args.
-#
-# With -n1 it outputs one arg per line, with the quotes and backslashes removed.
-#
-# In Bash we could simply go:
-#
-#   readarray ARGS < <( xargs -n1 <<<"$var" ) &&
-#   set -- "${ARGS[@]}" "$@"
-#
-# but POSIX shell has neither arrays nor command substitution, so instead we
-# post-process each arg (as a line of input to sed) to backslash-escape any
-# character that might be a shell metacharacter, then use eval to reverse
-# that process (while maintaining the separation between arguments), and wrap
-# the whole thing up as a single "set" statement.
-#
-# This will of course break if any of these variables contains a newline or
-# an unmatched quote.
-#
-
-eval "set -- $(
-        printf '%s\n' "$DEFAULT_JVM_OPTS $JAVA_OPTS $GRADLE_OPTS" |
-        xargs -n1 |
-        sed ' s~[^-[:alnum:]+,./:=@_]~\\&~g; ' |
-        tr '\n' ' '
-    )" '"$@"'
-
-exec "$JAVACMD" "$@"

gradlew.bat

@@ -1,94 +0,0 @@
-@rem
-@rem Copyright 2015 the original author or authors.
-@rem
-@rem Licensed under the Apache License, Version 2.0 (the "License");
-@rem you may not use this file except in compliance with the License.
-@rem You may obtain a copy of the License at
-@rem
-@rem      https://www.apache.org/licenses/LICENSE-2.0
-@rem
-@rem Unless required by applicable law or agreed to in writing, software
-@rem distributed under the License is distributed on an "AS IS" BASIS,
-@rem WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-@rem See the License for the specific language governing permissions and
-@rem limitations under the License.
-@rem
-@rem SPDX-License-Identifier: Apache-2.0
-@rem
-
-@if "%DEBUG%"=="" @echo off
-@rem ##########################################################################
-@rem
-@rem  Gradle startup script for Windows
-@rem
-@rem ##########################################################################
-
-@rem Set local scope for the variables with windows NT shell
-if "%OS%"=="Windows_NT" setlocal
-
-set DIRNAME=%~dp0
-if "%DIRNAME%"=="" set DIRNAME=.
-@rem This is normally unused
-set APP_BASE_NAME=%~n0
-set APP_HOME=%DIRNAME%
-
-@rem Resolve any "." and ".." in APP_HOME to make it shorter.
-for %%i in ("%APP_HOME%") do set APP_HOME=%%~fi
-
-@rem Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script.
-set DEFAULT_JVM_OPTS="-Xmx64m" "-Xms64m"
-
-@rem Find java.exe
-if defined JAVA_HOME goto findJavaFromJavaHome
-
-set JAVA_EXE=java.exe
-%JAVA_EXE% -version >NUL 2>&1
-if %ERRORLEVEL% equ 0 goto execute
-
-echo. 1>&2
-echo ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH. 1>&2
-echo. 1>&2
-echo Please set the JAVA_HOME variable in your environment to match the 1>&2
-echo location of your Java installation. 1>&2
-
-goto fail
-
-:findJavaFromJavaHome
-set JAVA_HOME=%JAVA_HOME:"=%
-set JAVA_EXE=%JAVA_HOME%/bin/java.exe
-
-if exist "%JAVA_EXE%" goto execute
-
-echo. 1>&2
-echo ERROR: JAVA_HOME is set to an invalid directory: %JAVA_HOME% 1>&2
-echo. 1>&2
-echo Please set the JAVA_HOME variable in your environment to match the 1>&2
-echo location of your Java installation. 1>&2
-
-goto fail
-
-:execute
-@rem Setup the command line
-
-set CLASSPATH=%APP_HOME%\gradle\wrapper\gradle-wrapper.jar
-
-
-@rem Execute Gradle
-"%JAVA_EXE%" %DEFAULT_JVM_OPTS% %JAVA_OPTS% %GRADLE_OPTS% "-Dorg.gradle.appname=%APP_BASE_NAME%" -classpath "%CLASSPATH%" org.gradle.wrapper.GradleWrapperMain %*
-
-:end
-@rem End local scope for the variables with windows NT shell
-if %ERRORLEVEL% equ 0 goto mainEnd
-
-:fail
-rem Set variable GRADLE_EXIT_CONSOLE if you need the _script_ return code instead of
-rem the _cmd.exe /c_ return code!
-set EXIT_CODE=%ERRORLEVEL%
-if %EXIT_CODE% equ 0 set EXIT_CODE=1
-if not ""=="%GRADLE_EXIT_CONSOLE%" exit %EXIT_CODE%
-exit /b %EXIT_CODE%
-
-:mainEnd
-if "%OS%"=="Windows_NT" endlocal
-
-:omega

repl

@@ -1,47 +0,0 @@
-#!/usr/bin/env bash
-set -euo pipefail
-
-JDWP=false
-JDWP_PORT=8000
-
-while getopts djp: OPTION "$@"; do
-    case $OPTION in
-	d)
-	    set -x
-	    ;;
-	j)
-		JDWP=true
-		;;
-	p)
-		JDWP_PORT=$OPTARG
-		;;
-    esac
-done
-
-EXTRA_JAVA_ARGS=()
-if $JDWP; then
-	EXTRA_JAVA_ARGS+=("-Xdebug")
-	EXTRA_JAVA_ARGS+=("-Xrunjdwp:server=y,transport=dt_socket,address=${JDWP_PORT},suspend=n")
-fi
-
-PROJECT_ROOT=$(dirname "${BASH_SOURCE[0]}")
-cd "${PROJECT_ROOT}"
-
-echo "Compiling and computing classpath (May take a while)"
-# Sadly even with the --quiet option Gradle (or some component of)
-# will print the number of warnings/errors to stdout if there are
-# any. So the result could look like
-# 52 warnings\n1 warning\n12 warnings\n
-# /smack/smack-repl/build/classes/main:/smack/smack-repl/build/
-# resources/main:/smack/smack-tcp/build/libs/smack-tcp-4.2.0-alpha4-SNAPSHOT.jar
-# So perform a "tail -n1" on the output of gradle
-GRADLE_CLASSPATH="$(${GRADLE_BIN:-./gradlew} :smack-repl:printClasspath --quiet |\
-	tail -n1)"
-echo "Finished, starting REPL"
-
-exec java \
-	"${EXTRA_JAVA_ARGS[@]}" \
-	-Dscala.usejavacp=true \
-	-classpath "${GRADLE_CLASSPATH}" \
-	ammonite.Main \
-	--predef smack-repl/scala.repl

resources/eclipse/smack.importorder

@@ -1,8 +0,0 @@
-#Organize Import Order
-#Wed Jun 14 16:42:40 CEST 2017
-5=
-4=org.jivesoftware.smackx
-3=org.jivesoftware.smack
-2=javax
-1=java
-0=\#

resources/eclipse/smack_formatter.xml

@@ -1,315 +1,295 @@
 <?xml version="1.0" encoding="UTF-8" standalone="no"?>
-<profiles version="13">
-<profile kind="CodeFormatterProfile" name="Smack" version="13">
-<setting id="org.eclipse.jdt.core.formatter.insert_space_after_ellipsis" value="insert"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_after_comma_in_enum_declarations" value="insert"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_new_line_in_empty_annotation_declaration" value="insert"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_before_comma_in_allocation_expression" value="do not insert"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_before_at_in_annotation_type_declaration" value="insert"/>
-<setting id="org.eclipse.jdt.core.formatter.parentheses_positions_in_for_statment" value="common_lines"/>
-<setting id="org.eclipse.jdt.core.formatter.comment.new_lines_at_block_boundaries" value="true"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_after_comma_in_constructor_declaration_parameters" value="insert"/>
-<setting id="org.eclipse.jdt.core.formatter.comment.insert_new_line_for_parameter" value="do not insert"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_new_line_after_annotation_on_package" value="insert"/>
-<setting id="org.eclipse.jdt.core.formatter.parentheses_positions_in_method_invocation" value="common_lines"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_between_empty_parens_in_enum_constant" value="do not insert"/>
-<setting id="org.eclipse.jdt.core.formatter.blank_lines_after_imports" value="1"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_before_closing_paren_in_while" value="do not insert"/>
+<profiles version="12">
+<profile kind="CodeFormatterProfile" name="Smack" version="12">
 <setting id="org.eclipse.jdt.core.formatter.comment.insert_new_line_before_root_tags" value="insert"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_between_empty_parens_in_annotation_type_member_declaration" value="do not insert"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_before_comma_in_method_declaration_throws" value="do not insert"/>
-<setting id="org.eclipse.jdt.core.formatter.parentheses_positions_in_switch_statement" value="common_lines"/>
-<setting id="org.eclipse.jdt.core.formatter.comment.format_javadoc_comments" value="true"/>
-<setting id="org.eclipse.jdt.core.formatter.indentation.size" value="4"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_after_postfix_operator" value="do not insert"/>
-<setting id="org.eclipse.jdt.core.formatter.parentheses_positions_in_enum_constant_declaration" value="common_lines"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_after_comma_in_for_increments" value="insert"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_after_comma_in_type_arguments" value="insert"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_before_comma_in_for_inits" value="do not insert"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_new_line_in_empty_anonymous_type_declaration" value="insert"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_after_semicolon_in_for" value="insert"/>
 <setting id="org.eclipse.jdt.core.formatter.disabling_tag" value="@formatter:off"/>
-<setting id="org.eclipse.jdt.core.formatter.continuation_indentation" value="4"/>
-<setting id="org.eclipse.jdt.core.formatter.alignment_for_enum_constants" value="49"/>
-<setting id="org.eclipse.jdt.core.formatter.blank_lines_before_imports" value="1"/>
-<setting id="org.eclipse.jdt.core.formatter.blank_lines_after_package" value="1"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_after_binary_operator" value="insert"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_after_comma_in_multiple_local_declarations" value="insert"/>
-<setting id="org.eclipse.jdt.core.formatter.parentheses_positions_in_if_while_statement" value="common_lines"/>
-<setting id="org.eclipse.jdt.core.formatter.alignment_for_arguments_in_enum_constant" value="48"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_after_opening_angle_bracket_in_parameterized_type_reference" value="do not insert"/>
-<setting id="org.eclipse.jdt.core.formatter.comment.indent_root_tags" value="true"/>
-<setting id="org.eclipse.jdt.core.formatter.wrap_before_or_operator_multicatch" value="true"/>
-<setting id="org.eclipse.jdt.core.formatter.enabling_tag" value="@formatter:on"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_after_closing_brace_in_block" value="insert"/>
-<setting id="org.eclipse.jdt.core.formatter.comment.count_line_length_from_starting_position" value="false"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_before_parenthesized_expression_in_return" value="insert"/>
-<setting id="org.eclipse.jdt.core.formatter.alignment_for_throws_clause_in_method_declaration" value="16"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_new_line_after_annotation_on_parameter" value="do not insert"/>
-<setting id="org.eclipse.jdt.core.formatter.keep_then_statement_on_same_line" value="false"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_new_line_after_annotation_on_field" value="insert"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_after_comma_in_explicitconstructorcall_arguments" value="insert"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_new_line_in_empty_block" value="insert"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_after_prefix_operator" value="do not insert"/>
-<setting id="org.eclipse.jdt.core.formatter.blank_lines_between_type_declarations" value="1"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_before_closing_brace_in_array_initializer" value="insert"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_before_closing_paren_in_for" value="do not insert"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_after_opening_paren_in_catch" value="do not insert"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_after_opening_angle_bracket_in_type_arguments" value="do not insert"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_new_line_after_annotation_on_method" value="insert"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_after_opening_paren_in_switch" value="do not insert"/>
-<setting id="org.eclipse.jdt.core.formatter.alignment_for_parameterized_type_references" value="0"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_before_opening_brace_in_anonymous_type_declaration" value="insert"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_before_closing_paren_in_parenthesized_expression" value="do not insert"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_new_line_after_annotation_on_enum_constant" value="insert"/>
-<setting id="org.eclipse.jdt.core.formatter.never_indent_line_comments_on_first_column" value="false"/>
-<setting id="org.eclipse.jdt.core.compiler.problem.enumIdentifier" value="error"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_after_and_in_type_parameter" value="insert"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_after_comma_in_for_inits" value="insert"/>
-<setting id="org.eclipse.jdt.core.formatter.indent_statements_compare_to_block" value="true"/>
-<setting id="org.eclipse.jdt.core.formatter.brace_position_for_anonymous_type_declaration" value="end_of_line"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_before_question_in_wildcard" value="do not insert"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_before_opening_paren_in_annotation" value="do not insert"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_before_comma_in_method_invocation_arguments" value="do not insert"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_before_opening_brace_in_switch" value="insert"/>
-<setting id="org.eclipse.jdt.core.formatter.comment.line_length" value="120"/>
-<setting id="org.eclipse.jdt.core.formatter.use_on_off_tags" value="true"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_between_empty_brackets_in_array_allocation_expression" value="do not insert"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_before_opening_brace_in_enum_constant" value="insert"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_between_empty_parens_in_method_invocation" value="do not insert"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_after_assignment_operator" value="insert"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_before_opening_brace_in_type_declaration" value="insert"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_after_opening_paren_in_for" value="do not insert"/>
-<setting id="org.eclipse.jdt.core.formatter.comment.preserve_white_space_between_code_and_line_comments" value="false"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_new_line_after_annotation_on_local_variable" value="insert"/>
-<setting id="org.eclipse.jdt.core.formatter.brace_position_for_method_declaration" value="end_of_line"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_before_closing_paren_in_method_invocation" value="do not insert"/>
-<setting id="org.eclipse.jdt.core.formatter.alignment_for_union_type_in_multicatch" value="16"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_after_colon_in_for" value="insert"/>
-<setting id="org.eclipse.jdt.core.formatter.number_of_blank_lines_at_beginning_of_method_body" value="0"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_after_closing_angle_bracket_in_type_arguments" value="insert"/>
-<setting id="org.eclipse.jdt.core.formatter.keep_else_statement_on_same_line" value="false"/>
-<setting id="org.eclipse.jdt.core.formatter.alignment_for_binary_expression" value="16"/>
-<setting id="org.eclipse.jdt.core.formatter.parentheses_positions_in_catch_clause" value="common_lines"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_after_comma_in_parameterized_type_reference" value="insert"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_before_comma_in_array_initializer" value="do not insert"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_after_comma_in_multiple_field_declarations" value="insert"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_before_comma_in_annotation" value="do not insert"/>
-<setting id="org.eclipse.jdt.core.formatter.alignment_for_arguments_in_explicit_constructor_call" value="16"/>
-<setting id="org.eclipse.jdt.core.formatter.indent_body_declarations_compare_to_annotation_declaration_header" value="true"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_after_comma_in_superinterfaces" value="insert"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_before_colon_in_default" value="do not insert"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_after_question_in_conditional" value="insert"/>
-<setting id="org.eclipse.jdt.core.formatter.brace_position_for_block" value="end_of_line"/>
-<setting id="org.eclipse.jdt.core.formatter.brace_position_for_constructor_declaration" value="end_of_line"/>
-<setting id="org.eclipse.jdt.core.formatter.brace_position_for_lambda_body" value="end_of_line"/>
-<setting id="org.eclipse.jdt.core.formatter.compact_else_if" value="true"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_after_comma_in_annotation" value="insert"/>
 <setting id="org.eclipse.jdt.core.formatter.insert_space_before_comma_in_type_parameters" value="do not insert"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_before_opening_paren_in_catch" value="insert"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_before_opening_paren_in_method_invocation" value="do not insert"/>
-<setting id="org.eclipse.jdt.core.formatter.put_empty_statement_on_new_line" value="true"/>
-<setting id="org.eclipse.jdt.core.formatter.alignment_for_parameters_in_constructor_declaration" value="16"/>
-<setting id="org.eclipse.jdt.core.formatter.alignment_for_type_parameters" value="0"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_after_comma_in_method_invocation_arguments" value="insert"/>
-<setting id="org.eclipse.jdt.core.formatter.alignment_for_arguments_in_method_invocation" value="16"/>
-<setting id="org.eclipse.jdt.core.formatter.alignment_for_throws_clause_in_constructor_declaration" value="16"/>
-<setting id="org.eclipse.jdt.core.compiler.problem.assertIdentifier" value="error"/>
-<setting id="org.eclipse.jdt.core.formatter.comment.clear_blank_lines_in_block_comment" value="true"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_new_line_before_catch_in_try_statement" value="do not insert"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_before_opening_paren_in_try" value="insert"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_new_line_at_end_of_file_if_missing" value="insert"/>
-<setting id="org.eclipse.jdt.core.formatter.comment.clear_blank_lines_in_javadoc_comment" value="true"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_after_comma_in_array_initializer" value="insert"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_before_binary_operator" value="insert"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_before_unary_operator" value="do not insert"/>
-<setting id="org.eclipse.jdt.core.formatter.alignment_for_expressions_in_array_initializer" value="16"/>
-<setting id="org.eclipse.jdt.core.formatter.format_line_comment_starting_on_first_column" value="true"/>
-<setting id="org.eclipse.jdt.core.formatter.number_of_empty_lines_to_preserve" value="1"/>
-<setting id="org.eclipse.jdt.core.formatter.parentheses_positions_in_annotation" value="common_lines"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_after_colon_in_case" value="insert"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_before_ellipsis" value="do not insert"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_before_semicolon_in_try_resources" value="do not insert"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_after_colon_in_assert" value="insert"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_before_closing_paren_in_if" value="do not insert"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_before_comma_in_type_arguments" value="do not insert"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_before_and_in_type_parameter" value="insert"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_new_line_in_empty_type_declaration" value="insert"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_after_opening_paren_in_parenthesized_expression" value="do not insert"/>
-<setting id="org.eclipse.jdt.core.formatter.comment.format_line_comments" value="true"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_after_colon_in_labeled_statement" value="insert"/>
-<setting id="org.eclipse.jdt.core.formatter.align_type_members_on_columns" value="false"/>
-<setting id="org.eclipse.jdt.core.formatter.alignment_for_assignment" value="0"/>
-<setting id="org.eclipse.jdt.core.formatter.alignment_for_module_statements" value="16"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_new_line_in_empty_method_body" value="insert"/>
-<setting id="org.eclipse.jdt.core.formatter.indent_body_declarations_compare_to_type_header" value="true"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_between_empty_parens_in_method_declaration" value="do not insert"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_after_opening_paren_in_enum_constant" value="do not insert"/>
-<setting id="org.eclipse.jdt.core.formatter.alignment_for_superinterfaces_in_type_declaration" value="16"/>
-<setting id="org.eclipse.jdt.core.formatter.blank_lines_before_first_class_body_declaration" value="0"/>
-<setting id="org.eclipse.jdt.core.formatter.alignment_for_conditional_expression" value="80"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_before_opening_brace_in_type_declaration" value="insert"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_after_comma_in_type_arguments" value="insert"/>
+<setting id="org.eclipse.jdt.core.formatter.brace_position_for_anonymous_type_declaration" value="end_of_line"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_before_colon_in_case" value="do not insert"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_after_opening_brace_in_array_initializer" value="insert"/>
+<setting id="org.eclipse.jdt.core.formatter.comment.new_lines_at_block_boundaries" value="true"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_new_line_in_empty_annotation_declaration" value="insert"/>
 <setting id="org.eclipse.jdt.core.formatter.insert_new_line_before_closing_brace_in_array_initializer" value="do not insert"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_before_comma_in_constructor_declaration_parameters" value="do not insert"/>
-<setting id="org.eclipse.jdt.core.formatter.format_guardian_clause_on_one_line" value="false"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_before_opening_paren_in_if" value="insert"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_new_line_after_annotation_on_type" value="insert"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_before_opening_brace_in_block" value="insert"/>
-<setting id="org.eclipse.jdt.core.formatter.brace_position_for_enum_declaration" value="end_of_line"/>
-<setting id="org.eclipse.jdt.core.formatter.brace_position_for_block_in_case" value="end_of_line"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_before_closing_paren_in_constructor_declaration" value="do not insert"/>
-<setting id="org.eclipse.jdt.core.formatter.comment.format_header" value="false"/>
-<setting id="org.eclipse.jdt.core.formatter.alignment_for_arguments_in_allocation_expression" value="16"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_after_opening_paren_in_method_invocation" value="do not insert"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_after_opening_paren_in_annotation" value="do not insert"/>
+<setting id="org.eclipse.jdt.core.formatter.blank_lines_before_field" value="0"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_after_opening_paren_in_while" value="do not insert"/>
+<setting id="org.eclipse.jdt.core.formatter.use_on_off_tags" value="true"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_between_empty_parens_in_annotation_type_member_declaration" value="do not insert"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_new_line_before_else_in_if_statement" value="insert"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_after_prefix_operator" value="do not insert"/>
+<setting id="org.eclipse.jdt.core.formatter.keep_else_statement_on_same_line" value="false"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_after_ellipsis" value="insert"/>
+<setting id="org.eclipse.jdt.core.formatter.comment.insert_new_line_for_parameter" value="do not insert"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_before_opening_brace_in_annotation_type_declaration" value="insert"/>
+<setting id="org.eclipse.jdt.core.formatter.indent_breaks_compare_to_cases" value="true"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_after_at_in_annotation" value="do not insert"/>
+<setting id="org.eclipse.jdt.core.formatter.alignment_for_multiple_fields" value="16"/>
+<setting id="org.eclipse.jdt.core.formatter.alignment_for_expressions_in_array_initializer" value="16"/>
+<setting id="org.eclipse.jdt.core.formatter.alignment_for_conditional_expression" value="80"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_before_opening_paren_in_for" value="insert"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_after_binary_operator" value="insert"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_before_question_in_wildcard" value="do not insert"/>
+<setting id="org.eclipse.jdt.core.formatter.brace_position_for_array_initializer" value="end_of_line"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_between_empty_parens_in_enum_constant" value="do not insert"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_new_line_before_finally_in_try_statement" value="insert"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_new_line_after_annotation_on_local_variable" value="insert"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_new_line_before_catch_in_try_statement" value="insert"/>
 <setting id="org.eclipse.jdt.core.formatter.insert_space_before_opening_paren_in_while" value="insert"/>
-<setting id="org.eclipse.jdt.core.compiler.codegen.inlineJsrBytecode" value="enabled"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_before_closing_paren_in_switch" value="do not insert"/>
-<setting id="org.eclipse.jdt.core.formatter.alignment_for_method_declaration" value="0"/>
+<setting id="org.eclipse.jdt.core.formatter.blank_lines_after_package" value="1"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_after_comma_in_type_parameters" value="insert"/>
+<setting id="org.eclipse.jdt.core.formatter.continuation_indentation" value="4"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_after_postfix_operator" value="do not insert"/>
+<setting id="org.eclipse.jdt.core.formatter.alignment_for_arguments_in_method_invocation" value="16"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_before_closing_angle_bracket_in_type_arguments" value="do not insert"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_before_comma_in_superinterfaces" value="do not insert"/>
+<setting id="org.eclipse.jdt.core.formatter.blank_lines_before_new_chunk" value="1"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_before_binary_operator" value="insert"/>
+<setting id="org.eclipse.jdt.core.formatter.blank_lines_before_package" value="0"/>
+<setting id="org.eclipse.jdt.core.compiler.source" value="1.8"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_after_comma_in_enum_constant_arguments" value="insert"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_after_opening_paren_in_constructor_declaration" value="do not insert"/>
+<setting id="org.eclipse.jdt.core.formatter.comment.format_line_comments" value="true"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_after_closing_angle_bracket_in_type_arguments" value="insert"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_after_comma_in_enum_declarations" value="insert"/>
 <setting id="org.eclipse.jdt.core.formatter.join_wrapped_lines" value="true"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_between_empty_parens_in_constructor_declaration" value="do not insert"/>
-<setting id="org.eclipse.jdt.core.formatter.wrap_before_conditional_operator" value="true"/>
-<setting id="org.eclipse.jdt.core.formatter.indent_switchstatements_compare_to_cases" value="true"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_before_closing_bracket_in_array_allocation_expression" value="do not insert"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_before_closing_paren_in_synchronized" value="do not insert"/>
-<setting id="org.eclipse.jdt.core.formatter.align_fields_grouping_blank_lines" value="2147483647"/>
-<setting id="org.eclipse.jdt.core.formatter.comment.new_lines_at_javadoc_boundaries" value="true"/>
-<setting id="org.eclipse.jdt.core.formatter.brace_position_for_annotation_type_declaration" value="end_of_line"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_before_opening_brace_in_block" value="insert"/>
+<setting id="org.eclipse.jdt.core.formatter.alignment_for_arguments_in_explicit_constructor_call" value="16"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_before_comma_in_method_invocation_arguments" value="do not insert"/>
+<setting id="org.eclipse.jdt.core.formatter.blank_lines_before_member_type" value="1"/>
+<setting id="org.eclipse.jdt.core.formatter.align_type_members_on_columns" value="false"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_after_opening_paren_in_enum_constant" value="do not insert"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_after_opening_paren_in_for" value="do not insert"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_before_opening_brace_in_method_declaration" value="insert"/>
+<setting id="org.eclipse.jdt.core.formatter.alignment_for_selector_in_method_invocation" value="0"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_after_opening_paren_in_switch" value="do not insert"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_after_unary_operator" value="do not insert"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_after_colon_in_case" value="insert"/>
+<setting id="org.eclipse.jdt.core.formatter.comment.indent_parameter_description" value="false"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_after_lambda_arrow" value="insert"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_before_closing_paren_in_method_declaration" value="do not insert"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_before_closing_paren_in_switch" value="do not insert"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_before_opening_brace_in_enum_declaration" value="insert"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_before_opening_angle_bracket_in_type_parameters" value="do not insert"/>
+<setting id="org.eclipse.jdt.core.formatter.comment.clear_blank_lines_in_block_comment" value="true"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_new_line_in_empty_type_declaration" value="insert"/>
+<setting id="org.eclipse.jdt.core.formatter.lineSplit" value="120"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_before_opening_paren_in_if" value="insert"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_between_brackets_in_array_type_reference" value="do not insert"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_after_opening_paren_in_parenthesized_expression" value="do not insert"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_before_comma_in_explicitconstructorcall_arguments" value="do not insert"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_before_opening_brace_in_constructor_declaration" value="insert"/>
+<setting id="org.eclipse.jdt.core.formatter.blank_lines_before_first_class_body_declaration" value="0"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_new_line_after_annotation_on_method" value="insert"/>
+<setting id="org.eclipse.jdt.core.formatter.indentation.size" value="4"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_between_empty_parens_in_method_declaration" value="do not insert"/>
+<setting id="org.eclipse.jdt.core.formatter.enabling_tag" value="@formatter:on"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_before_opening_paren_in_enum_constant" value="do not insert"/>
+<setting id="org.eclipse.jdt.core.formatter.alignment_for_superclass_in_type_declaration" value="16"/>
+<setting id="org.eclipse.jdt.core.formatter.alignment_for_assignment" value="0"/>
+<setting id="org.eclipse.jdt.core.compiler.problem.assertIdentifier" value="error"/>
+<setting id="org.eclipse.jdt.core.formatter.tabulation.char" value="space"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_after_comma_in_constructor_declaration_parameters" value="insert"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_after_semicolon_in_try_resources" value="insert"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_before_prefix_operator" value="do not insert"/>
+<setting id="org.eclipse.jdt.core.formatter.indent_statements_compare_to_body" value="true"/>
+<setting id="org.eclipse.jdt.core.formatter.blank_lines_before_method" value="1"/>
+<setting id="org.eclipse.jdt.core.formatter.wrap_outer_expressions_when_nested" value="true"/>
+<setting id="org.eclipse.jdt.core.formatter.format_guardian_clause_on_one_line" value="false"/>
 <setting id="org.eclipse.jdt.core.formatter.insert_space_before_colon_in_for" value="insert"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_before_closing_paren_in_cast" value="do not insert"/>
+<setting id="org.eclipse.jdt.core.formatter.alignment_for_parameters_in_constructor_declaration" value="16"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_after_colon_in_labeled_statement" value="insert"/>
+<setting id="org.eclipse.jdt.core.formatter.brace_position_for_annotation_type_declaration" value="end_of_line"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_new_line_in_empty_method_body" value="insert"/>
+<setting id="org.eclipse.jdt.core.formatter.alignment_for_method_declaration" value="0"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_before_closing_paren_in_method_invocation" value="do not insert"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_before_closing_paren_in_try" value="do not insert"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_after_opening_bracket_in_array_allocation_expression" value="do not insert"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_before_opening_brace_in_enum_constant" value="insert"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_before_comma_in_annotation" value="do not insert"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_after_at_in_annotation_type_declaration" value="do not insert"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_before_comma_in_method_declaration_throws" value="do not insert"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_before_closing_paren_in_if" value="do not insert"/>
+<setting id="org.eclipse.jdt.core.formatter.brace_position_for_switch" value="end_of_line"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_after_comma_in_method_declaration_throws" value="insert"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_before_parenthesized_expression_in_return" value="insert"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_before_opening_paren_in_annotation" value="do not insert"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_after_question_in_conditional" value="insert"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_after_question_in_wildcard" value="do not insert"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_after_opening_paren_in_try" value="do not insert"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_before_closing_bracket_in_array_allocation_expression" value="do not insert"/>
+<setting id="org.eclipse.jdt.core.formatter.comment.preserve_white_space_between_code_and_line_comments" value="false"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_before_parenthesized_expression_in_throw" value="insert"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_before_comma_in_type_arguments" value="do not insert"/>
+<setting id="org.eclipse.jdt.core.compiler.problem.enumIdentifier" value="error"/>
+<setting id="org.eclipse.jdt.core.formatter.indent_switchstatements_compare_to_switch" value="false"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_before_ellipsis" value="do not insert"/>
+<setting id="org.eclipse.jdt.core.formatter.brace_position_for_block" value="end_of_line"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_before_comma_in_for_inits" value="do not insert"/>
+<setting id="org.eclipse.jdt.core.formatter.brace_position_for_method_declaration" value="end_of_line"/>
+<setting id="org.eclipse.jdt.core.formatter.compact_else_if" value="true"/>
+<setting id="org.eclipse.jdt.core.formatter.wrap_before_or_operator_multicatch" value="true"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_before_comma_in_array_initializer" value="do not insert"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_after_comma_in_for_increments" value="insert"/>
+<setting id="org.eclipse.jdt.core.formatter.format_line_comment_starting_on_first_column" value="true"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_before_closing_bracket_in_array_reference" value="do not insert"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_new_line_after_annotation_on_field" value="insert"/>
+<setting id="org.eclipse.jdt.core.formatter.comment.indent_root_tags" value="true"/>
+<setting id="org.eclipse.jdt.core.formatter.brace_position_for_enum_constant" value="end_of_line"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_before_comma_in_enum_declarations" value="do not insert"/>
+<setting id="org.eclipse.jdt.core.formatter.alignment_for_union_type_in_multicatch" value="16"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_after_comma_in_explicitconstructorcall_arguments" value="insert"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_before_opening_brace_in_switch" value="insert"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_before_comma_in_method_declaration_parameters" value="do not insert"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_after_comma_in_superinterfaces" value="insert"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_before_comma_in_allocation_expression" value="do not insert"/>
+<setting id="org.eclipse.jdt.core.formatter.tabulation.size" value="4"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_before_opening_bracket_in_array_type_reference" value="do not insert"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_new_line_after_opening_brace_in_array_initializer" value="do not insert"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_after_closing_brace_in_block" value="insert"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_before_opening_bracket_in_array_reference" value="do not insert"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_new_line_in_empty_enum_constant" value="insert"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_after_opening_angle_bracket_in_type_arguments" value="do not insert"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_before_opening_paren_in_constructor_declaration" value="do not insert"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_before_comma_in_constructor_declaration_throws" value="do not insert"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_after_opening_paren_in_if" value="do not insert"/>
+<setting id="org.eclipse.jdt.core.formatter.comment.clear_blank_lines_in_javadoc_comment" value="true"/>
+<setting id="org.eclipse.jdt.core.formatter.alignment_for_throws_clause_in_constructor_declaration" value="16"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_after_assignment_operator" value="insert"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_before_assignment_operator" value="insert"/>
+<setting id="org.eclipse.jdt.core.formatter.indent_empty_lines" value="false"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_after_opening_paren_in_synchronized" value="do not insert"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_after_closing_paren_in_cast" value="insert"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_after_comma_in_method_declaration_parameters" value="insert"/>
+<setting id="org.eclipse.jdt.core.formatter.brace_position_for_block_in_case" value="end_of_line"/>
+<setting id="org.eclipse.jdt.core.formatter.number_of_empty_lines_to_preserve" value="1"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_before_opening_paren_in_method_declaration" value="do not insert"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_after_opening_paren_in_catch" value="do not insert"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_before_closing_paren_in_constructor_declaration" value="do not insert"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_before_opening_paren_in_method_invocation" value="do not insert"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_after_opening_bracket_in_array_reference" value="do not insert"/>
+<setting id="org.eclipse.jdt.core.formatter.alignment_for_arguments_in_qualified_allocation_expression" value="16"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_after_and_in_type_parameter" value="insert"/>
+<setting id="org.eclipse.jdt.core.compiler.compliance" value="1.8"/>
+<setting id="org.eclipse.jdt.core.formatter.continuation_indentation_for_array_initializer" value="4"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_between_empty_brackets_in_array_allocation_expression" value="do not insert"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_before_at_in_annotation_type_declaration" value="insert"/>
+<setting id="org.eclipse.jdt.core.formatter.alignment_for_arguments_in_allocation_expression" value="16"/>
+<setting id="org.eclipse.jdt.core.formatter.brace_position_for_lambda_body" value="end_of_line"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_after_opening_paren_in_cast" value="do not insert"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_before_unary_operator" value="do not insert"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_before_closing_angle_bracket_in_parameterized_type_reference" value="do not insert"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_before_opening_brace_in_anonymous_type_declaration" value="insert"/>
+<setting id="org.eclipse.jdt.core.formatter.keep_empty_array_initializer_on_one_line" value="false"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_new_line_in_empty_enum_declaration" value="insert"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_new_line_after_type_annotation" value="do not insert"/>
+<setting id="org.eclipse.jdt.core.formatter.keep_imple_if_on_one_line" value="false"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_before_comma_in_constructor_declaration_parameters" value="do not insert"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_after_closing_angle_bracket_in_type_parameters" value="insert"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_before_colon_in_labeled_statement" value="do not insert"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_new_line_at_end_of_file_if_missing" value="insert"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_after_colon_in_for" value="insert"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_before_comma_in_parameterized_type_reference" value="do not insert"/>
+<setting id="org.eclipse.jdt.core.formatter.alignment_for_superinterfaces_in_type_declaration" value="16"/>
+<setting id="org.eclipse.jdt.core.formatter.alignment_for_binary_expression" value="16"/>
+<setting id="org.eclipse.jdt.core.formatter.brace_position_for_enum_declaration" value="end_of_line"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_new_line_after_annotation_on_type" value="insert"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_before_closing_paren_in_while" value="do not insert"/>
+<setting id="org.eclipse.jdt.core.compiler.codegen.inlineJsrBytecode" value="enabled"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_before_opening_paren_in_try" value="insert"/>
+<setting id="org.eclipse.jdt.core.formatter.put_empty_statement_on_new_line" value="true"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_new_line_after_label" value="do not insert"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_new_line_after_annotation_on_parameter" value="do not insert"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_after_opening_angle_bracket_in_type_parameters" value="do not insert"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_between_empty_parens_in_method_invocation" value="do not insert"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_new_line_before_while_in_do_statement" value="insert"/>
+<setting id="org.eclipse.jdt.core.formatter.alignment_for_arguments_in_enum_constant" value="48"/>
+<setting id="org.eclipse.jdt.core.formatter.comment.format_javadoc_comments" value="true"/>
+<setting id="org.eclipse.jdt.core.formatter.comment.line_length" value="120"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_new_line_after_annotation_on_package" value="insert"/>
+<setting id="org.eclipse.jdt.core.formatter.blank_lines_between_import_groups" value="1"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_before_comma_in_enum_constant_arguments" value="do not insert"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_before_semicolon" value="do not insert"/>
+<setting id="org.eclipse.jdt.core.formatter.brace_position_for_constructor_declaration" value="end_of_line"/>
+<setting id="org.eclipse.jdt.core.formatter.number_of_blank_lines_at_beginning_of_method_body" value="0"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_before_colon_in_conditional" value="insert"/>
+<setting id="org.eclipse.jdt.core.formatter.indent_body_declarations_compare_to_type_header" value="true"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_before_opening_paren_in_annotation_type_member_declaration" value="do not insert"/>
+<setting id="org.eclipse.jdt.core.formatter.wrap_before_binary_operator" value="true"/>
+<setting id="org.eclipse.jdt.core.formatter.indent_body_declarations_compare_to_enum_declaration_header" value="true"/>
+<setting id="org.eclipse.jdt.core.formatter.blank_lines_between_type_declarations" value="1"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_before_closing_paren_in_synchronized" value="do not insert"/>
+<setting id="org.eclipse.jdt.core.formatter.indent_statements_compare_to_block" value="true"/>
+<setting id="org.eclipse.jdt.core.formatter.alignment_for_superinterfaces_in_enum_declaration" value="16"/>
+<setting id="org.eclipse.jdt.core.formatter.join_lines_in_comments" value="true"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_before_question_in_conditional" value="insert"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_before_comma_in_multiple_field_declarations" value="do not insert"/>
+<setting id="org.eclipse.jdt.core.formatter.alignment_for_compact_if" value="16"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_after_comma_in_for_inits" value="insert"/>
+<setting id="org.eclipse.jdt.core.formatter.indent_switchstatements_compare_to_cases" value="true"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_after_comma_in_array_initializer" value="insert"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_before_colon_in_default" value="do not insert"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_before_and_in_type_parameter" value="insert"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_between_empty_parens_in_constructor_declaration" value="do not insert"/>
+<setting id="org.eclipse.jdt.core.formatter.blank_lines_before_imports" value="1"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_after_colon_in_assert" value="insert"/>
+<setting id="org.eclipse.jdt.core.formatter.comment.format_html" value="true"/>
+<setting id="org.eclipse.jdt.core.formatter.alignment_for_throws_clause_in_method_declaration" value="16"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_before_closing_angle_bracket_in_type_parameters" value="do not insert"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_before_opening_bracket_in_array_allocation_expression" value="do not insert"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_new_line_in_empty_anonymous_type_declaration" value="insert"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_after_colon_in_conditional" value="insert"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_after_opening_angle_bracket_in_parameterized_type_reference" value="do not insert"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_before_closing_paren_in_for" value="do not insert"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_before_postfix_operator" value="do not insert"/>
+<setting id="org.eclipse.jdt.core.formatter.comment.format_source_code" value="true"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_before_opening_paren_in_synchronized" value="insert"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_after_comma_in_allocation_expression" value="insert"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_after_comma_in_constructor_declaration_throws" value="insert"/>
+<setting id="org.eclipse.jdt.core.formatter.alignment_for_parameters_in_method_declaration" value="16"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_before_closing_brace_in_array_initializer" value="insert"/>
+<setting id="org.eclipse.jdt.core.compiler.codegen.targetPlatform" value="1.8"/>
 <setting id="org.eclipse.jdt.core.formatter.alignment_for_resources_in_try" value="80"/>
 <setting id="org.eclipse.jdt.core.formatter.use_tabs_only_for_leading_indentations" value="false"/>
-<setting id="org.eclipse.jdt.core.formatter.parentheses_positions_in_try_clause" value="common_lines"/>
-<setting id="org.eclipse.jdt.core.formatter.alignment_for_selector_in_method_invocation" value="0"/>
-<setting id="org.eclipse.jdt.core.formatter.never_indent_block_comments_on_first_column" value="false"/>
-<setting id="org.eclipse.jdt.core.compiler.source" value="9"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_after_opening_paren_in_synchronized" value="do not insert"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_after_comma_in_constructor_declaration_throws" value="insert"/>
-<setting id="org.eclipse.jdt.core.formatter.tabulation.size" value="4"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_new_line_in_empty_enum_constant" value="insert"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_after_comma_in_allocation_expression" value="insert"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_after_opening_bracket_in_array_reference" value="do not insert"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_after_colon_in_conditional" value="insert"/>
-<setting id="org.eclipse.jdt.core.formatter.comment.format_source_code" value="true"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_before_opening_brace_in_array_initializer" value="insert"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_before_closing_paren_in_try" value="do not insert"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_after_semicolon_in_try_resources" value="insert"/>
-<setting id="org.eclipse.jdt.core.formatter.blank_lines_before_field" value="0"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_after_at_in_annotation" value="do not insert"/>
-<setting id="org.eclipse.jdt.core.formatter.continuation_indentation_for_array_initializer" value="4"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_after_question_in_wildcard" value="do not insert"/>
-<setting id="org.eclipse.jdt.core.formatter.blank_lines_before_method" value="1"/>
-<setting id="org.eclipse.jdt.core.formatter.alignment_for_superclass_in_type_declaration" value="16"/>
-<setting id="org.eclipse.jdt.core.formatter.alignment_for_superinterfaces_in_enum_declaration" value="16"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_before_parenthesized_expression_in_throw" value="insert"/>
-<setting id="org.eclipse.jdt.core.formatter.wrap_before_assignment_operator" value="false"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_before_colon_in_labeled_statement" value="do not insert"/>
-<setting id="org.eclipse.jdt.core.compiler.codegen.targetPlatform" value="9"/>
-<setting id="org.eclipse.jdt.core.formatter.brace_position_for_switch" value="end_of_line"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_before_comma_in_superinterfaces" value="do not insert"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_after_comma_in_method_declaration_parameters" value="insert"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_new_line_after_type_annotation" value="do not insert"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_after_opening_brace_in_array_initializer" value="insert"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_before_opening_paren_in_parenthesized_expression" value="do not insert"/>
-<setting id="org.eclipse.jdt.core.formatter.comment.format_html" value="true"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_after_at_in_annotation_type_declaration" value="do not insert"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_after_closing_angle_bracket_in_type_parameters" value="insert"/>
-<setting id="org.eclipse.jdt.core.formatter.parentheses_positions_in_method_delcaration" value="common_lines"/>
-<setting id="org.eclipse.jdt.core.formatter.alignment_for_compact_if" value="16"/>
-<setting id="org.eclipse.jdt.core.formatter.indent_empty_lines" value="false"/>
-<setting id="org.eclipse.jdt.core.formatter.alignment_for_type_arguments" value="0"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_before_comma_in_parameterized_type_reference" value="do not insert"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_after_unary_operator" value="do not insert"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_before_opening_paren_in_enum_constant" value="do not insert"/>
 <setting id="org.eclipse.jdt.core.formatter.alignment_for_arguments_in_annotation" value="0"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_before_comma_in_enum_declarations" value="do not insert"/>
-<setting id="org.eclipse.jdt.core.formatter.keep_empty_array_initializer_on_one_line" value="false"/>
-<setting id="org.eclipse.jdt.core.formatter.indent_switchstatements_compare_to_switch" value="false"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_new_line_before_else_in_if_statement" value="do not insert"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_before_assignment_operator" value="insert"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_before_opening_paren_in_constructor_declaration" value="do not insert"/>
-<setting id="org.eclipse.jdt.core.formatter.blank_lines_before_new_chunk" value="1"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_new_line_after_label" value="do not insert"/>
-<setting id="org.eclipse.jdt.core.formatter.indent_body_declarations_compare_to_enum_declaration_header" value="true"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_after_opening_bracket_in_array_allocation_expression" value="do not insert"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_after_opening_paren_in_constructor_declaration" value="do not insert"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_before_colon_in_conditional" value="insert"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_before_opening_angle_bracket_in_parameterized_type_reference" value="do not insert"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_before_comma_in_method_declaration_parameters" value="do not insert"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_before_closing_angle_bracket_in_type_arguments" value="do not insert"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_before_closing_paren_in_cast" value="do not insert"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_before_colon_in_assert" value="insert"/>
-<setting id="org.eclipse.jdt.core.formatter.blank_lines_before_member_type" value="1"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_new_line_before_while_in_do_statement" value="do not insert"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_before_opening_bracket_in_array_type_reference" value="do not insert"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_before_closing_angle_bracket_in_parameterized_type_reference" value="do not insert"/>
-<setting id="org.eclipse.jdt.core.formatter.alignment_for_arguments_in_qualified_allocation_expression" value="16"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_new_line_after_opening_brace_in_array_initializer" value="do not insert"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_new_line_in_empty_enum_declaration" value="insert"/>
-<setting id="org.eclipse.jdt.core.formatter.indent_breaks_compare_to_cases" value="true"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_before_closing_paren_in_method_declaration" value="do not insert"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_after_opening_paren_in_if" value="do not insert"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_before_semicolon" value="do not insert"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_before_postfix_operator" value="do not insert"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_after_opening_paren_in_try" value="do not insert"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_before_opening_angle_bracket_in_type_arguments" value="do not insert"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_after_opening_paren_in_cast" value="do not insert"/>
+<setting id="org.eclipse.jdt.core.formatter.comment.format_header" value="false"/>
 <setting id="org.eclipse.jdt.core.formatter.comment.format_block_comments" value="true"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_before_lambda_arrow" value="insert"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_after_opening_paren_in_method_declaration" value="do not insert"/>
-<setting id="org.eclipse.jdt.core.formatter.keep_imple_if_on_one_line" value="false"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_before_opening_brace_in_enum_declaration" value="insert"/>
-<setting id="org.eclipse.jdt.core.formatter.alignment_for_parameters_in_method_declaration" value="16"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_between_brackets_in_array_type_reference" value="do not insert"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_before_opening_angle_bracket_in_type_parameters" value="do not insert"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_before_semicolon_in_for" value="do not insert"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_after_comma_in_method_declaration_throws" value="insert"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_before_opening_bracket_in_array_allocation_expression" value="do not insert"/>
-<setting id="org.eclipse.jdt.core.formatter.indent_statements_compare_to_body" value="true"/>
-<setting id="org.eclipse.jdt.core.formatter.alignment_for_multiple_fields" value="16"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_after_comma_in_enum_constant_arguments" value="insert"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_before_prefix_operator" value="do not insert"/>
-<setting id="org.eclipse.jdt.core.formatter.brace_position_for_array_initializer" value="end_of_line"/>
-<setting id="org.eclipse.jdt.core.formatter.wrap_before_binary_operator" value="true"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_before_opening_brace_in_method_declaration" value="insert"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_after_comma_in_type_parameters" value="insert"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_before_closing_paren_in_catch" value="do not insert"/>
-<setting id="org.eclipse.jdt.core.compiler.compliance" value="9"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_before_closing_bracket_in_array_reference" value="do not insert"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_after_comma_in_annotation" value="insert"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_before_comma_in_enum_constant_arguments" value="do not insert"/>
-<setting id="org.eclipse.jdt.core.formatter.parentheses_positions_in_lambda_declaration" value="common_lines"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_between_empty_braces_in_array_initializer" value="do not insert"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_before_colon_in_case" value="do not insert"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_before_comma_in_multiple_local_declarations" value="do not insert"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_before_opening_brace_in_annotation_type_declaration" value="insert"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_before_opening_bracket_in_array_reference" value="do not insert"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_before_opening_paren_in_method_declaration" value="do not insert"/>
-<setting id="org.eclipse.jdt.core.formatter.wrap_outer_expressions_when_nested" value="true"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_after_closing_paren_in_cast" value="insert"/>
-<setting id="org.eclipse.jdt.core.formatter.brace_position_for_enum_constant" value="end_of_line"/>
-<setting id="org.eclipse.jdt.core.formatter.brace_position_for_type_declaration" value="end_of_line"/>
-<setting id="org.eclipse.jdt.core.formatter.blank_lines_before_package" value="0"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_before_opening_paren_in_for" value="insert"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_before_opening_paren_in_synchronized" value="insert"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_before_comma_in_for_increments" value="do not insert"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_before_opening_paren_in_annotation_type_member_declaration" value="do not insert"/>
-<setting id="org.eclipse.jdt.core.formatter.alignment_for_expressions_in_for_loop_header" value="0"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_after_opening_paren_in_while" value="do not insert"/>
 <setting id="org.eclipse.jdt.core.formatter.insert_space_before_closing_paren_in_enum_constant" value="do not insert"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_before_comma_in_explicitconstructorcall_arguments" value="do not insert"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_before_closing_paren_in_annotation" value="do not insert"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_after_opening_angle_bracket_in_type_parameters" value="do not insert"/>
-<setting id="org.eclipse.jdt.core.formatter.indent_body_declarations_compare_to_enum_constant_header" value="true"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_after_lambda_arrow" value="insert"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_before_opening_brace_in_constructor_declaration" value="insert"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_before_comma_in_constructor_declaration_throws" value="do not insert"/>
-<setting id="org.eclipse.jdt.core.formatter.join_lines_in_comments" value="true"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_before_closing_angle_bracket_in_type_parameters" value="do not insert"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_before_question_in_conditional" value="insert"/>
-<setting id="org.eclipse.jdt.core.formatter.comment.indent_parameter_description" value="false"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_new_line_before_finally_in_try_statement" value="do not insert"/>
-<setting id="org.eclipse.jdt.core.formatter.tabulation.char" value="space"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_before_comma_in_multiple_field_declarations" value="do not insert"/>
-<setting id="org.eclipse.jdt.core.formatter.blank_lines_between_import_groups" value="1"/>
-<setting id="org.eclipse.jdt.core.formatter.lineSplit" value="120"/>
-<setting id="org.eclipse.jdt.core.formatter.insert_space_after_opening_paren_in_annotation" value="do not insert"/>
+<setting id="org.eclipse.jdt.core.formatter.alignment_for_enum_constants" value="49"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_before_lambda_arrow" value="insert"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_new_line_in_empty_block" value="insert"/>
+<setting id="org.eclipse.jdt.core.formatter.indent_body_declarations_compare_to_annotation_declaration_header" value="true"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_before_closing_paren_in_parenthesized_expression" value="do not insert"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_before_opening_paren_in_parenthesized_expression" value="do not insert"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_before_closing_paren_in_catch" value="do not insert"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_before_comma_in_multiple_local_declarations" value="do not insert"/>
 <setting id="org.eclipse.jdt.core.formatter.insert_space_before_opening_paren_in_switch" value="insert"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_before_comma_in_for_increments" value="do not insert"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_after_opening_paren_in_method_invocation" value="do not insert"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_before_colon_in_assert" value="insert"/>
+<setting id="org.eclipse.jdt.core.formatter.brace_position_for_type_declaration" value="end_of_line"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_before_opening_brace_in_array_initializer" value="insert"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_between_empty_braces_in_array_initializer" value="do not insert"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_after_opening_paren_in_method_declaration" value="do not insert"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_before_semicolon_in_for" value="do not insert"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_before_opening_paren_in_catch" value="insert"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_before_opening_angle_bracket_in_parameterized_type_reference" value="do not insert"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_after_comma_in_multiple_field_declarations" value="insert"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_before_closing_paren_in_annotation" value="do not insert"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_after_comma_in_parameterized_type_reference" value="insert"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_after_comma_in_method_invocation_arguments" value="insert"/>
+<setting id="org.eclipse.jdt.core.formatter.comment.new_lines_at_javadoc_boundaries" value="true"/>
+<setting id="org.eclipse.jdt.core.formatter.blank_lines_after_imports" value="1"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_after_comma_in_multiple_local_declarations" value="insert"/>
+<setting id="org.eclipse.jdt.core.formatter.indent_body_declarations_compare_to_enum_constant_header" value="true"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_after_semicolon_in_for" value="insert"/>
+<setting id="org.eclipse.jdt.core.formatter.never_indent_line_comments_on_first_column" value="false"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_before_semicolon_in_try_resources" value="do not insert"/>
+<setting id="org.eclipse.jdt.core.formatter.insert_space_before_opening_angle_bracket_in_type_arguments" value="do not insert"/>
+<setting id="org.eclipse.jdt.core.formatter.never_indent_block_comments_on_first_column" value="false"/>
+<setting id="org.eclipse.jdt.core.formatter.keep_then_statement_on_same_line" value="false"/>
 </profile>
 </profiles>

resources/fix-a-javadoc.sh

@@ -1,150 +0,0 @@
-#!/usr/bin/env bash
-
-set -e
-
-# Pretty fancy method to get reliable the absolute path of a shell
-# script, *even if it is sourced*. Credits go to GreenFox on
-# stackoverflow: http://stackoverflow.com/a/12197518/194894
-pushd . > /dev/null
-SCRIPTDIR="${BASH_SOURCE[0]}";
-while([ -h "${SCRIPTDIR}" ]); do
-    cd "`dirname "${SCRIPTDIR}"`"
-    SCRIPTDIR="$(readlink "`basename "${SCRIPTDIR}"`")";
-done
-cd "`dirname "${SCRIPTDIR}"`" > /dev/null
-SCRIPTDIR="`pwd`";
-popd  > /dev/null
-
-SMACK_DIR=$(realpath "${SCRIPTDIR}"/..)
-
-declare -A SMACK_EXCEPTIONS
-SMACK_EXCEPTIONS[NotConnectedException]="if the XMPP connection is not connected."
-SMACK_EXCEPTIONS[InterruptedException]="if the calling thread was interrupted."
-SMACK_EXCEPTIONS[XMPPErrorException]="if there was an XMPP error returned."
-SMACK_EXCEPTIONS[NoResponseException]="if there was no response from the remote entity."
-SMACK_EXCEPTIONS[NotLoggedInException]="if the XMPP connection is not authenticated."
-SMACK_EXCEPTIONS[BOSHException]="if an BOSH related error occurred."
-SMACK_EXCEPTIONS[IOException]="if an I/O error occurred."
-SMACK_EXCEPTIONS[SmackException]="if Smack detected an exceptional situation."
-SMACK_EXCEPTIONS[XMPPException]="if an XMPP protocol error was received."
-SMACK_EXCEPTIONS[SmackSaslException]="if a SASL specific error occurred."
-SMACK_EXCEPTIONS[SASLErrorException]="if a SASL protocol error was returned."
-SMACK_EXCEPTIONS[NotAMucServiceException]="if the entity is not a MUC service."
-SMACK_EXCEPTIONS[NoSuchAlgorithmException]="if no such algorithm is available."
-SMACK_EXCEPTIONS[KeyManagementException]="if there was a key mangement error."
-SMACK_EXCEPTIONS[XmppStringprepException]="if the provided string is invalid."
-SMACK_EXCEPTIONS[XmlPullParserException]="if an error in the XML parser occurred."
-SMACK_EXCEPTIONS[SmackParsingException]="if the Smack parser (provider) encountered invalid input."
-SMACK_EXCEPTIONS[MucNotJoinedException]="if not joined to the Multi-User Chat."
-SMACK_EXCEPTIONS[MucAlreadyJoinedException]="if already joined the Multi-User Chat."7y
-SMACK_EXCEPTIONS[NotALeafNodeException]="if a PubSub leaf node operation was attempted on a non-leaf node."
-SMACK_EXCEPTIONS[FeatureNotSupportedException]="if a requested feature is not supported by the remote entity."
-SMACK_EXCEPTIONS[MucConfigurationNotSupportedException]="if the requested MUC configuration is not supported by the MUC service."
-SMACK_EXCEPTIONS[CouldNotConnectToAnyProvidedSocks5Host]="if no connection to any provided stream host could be established"
-SMACK_EXCEPTIONS[NoSocks5StreamHostsProvided]="if no stream host was provided."
-SMACK_EXCEPTIONS[SmackMessageException]="if there was an error."
-SMACK_EXCEPTIONS[SecurityException]="if there was a security violation."
-SMACK_EXCEPTIONS[InvocationTargetException]="if a reflection-based method or constructor invocation threw."
-SMACK_EXCEPTIONS[IllegalArgumentException]="if an illegal argument was given."
-SMACK_EXCEPTIONS[NotAPubSubNodeException]="if a involved node is not a PubSub node."
-SMACK_EXCEPTIONS[NoAcceptableTransferMechanisms]="if no acceptable transfer mechanisms are available"
-SMACK_EXCEPTIONS[NoSuchMethodException]="if no such method is declared"
-SMACK_EXCEPTIONS[Exception]="if an exception occurred."
-SMACK_EXCEPTIONS[TestNotPossibleException]="if the test is not possible."
-SMACK_EXCEPTIONS[TimeoutException]="if there was a timeout."
-SMACK_EXCEPTIONS[IllegalStateException]="if an illegal state was encountered"
-SMACK_EXCEPTIONS[NoSuchPaddingException]="if the requested padding mechanism is not available."
-SMACK_EXCEPTIONS[BadPaddingException]="if the input data is not padded properly."
-SMACK_EXCEPTIONS[InvalidKeyException]="if the key is invalid."
-SMACK_EXCEPTIONS[IllegalBlockSizeException]="if the input data length is incorrect."
-SMACK_EXCEPTIONS[InvalidAlgorithmParameterException]="if the provided arguments are invalid."
-SMACK_EXCEPTIONS[CorruptedOmemoKeyException]="if the OMEMO key is corrupted."
-SMACK_EXCEPTIONS[CryptoFailedException]="if the OMEMO cryptography failed."
-SMACK_EXCEPTIONS[CannotEstablishOmemoSessionException]="if no OMEMO session could be established."
-SMACK_EXCEPTIONS[UntrustedOmemoIdentityException]="if the OMEMO identity is not trusted."
-SMACK_EXCEPTIONS[FailedNonzaException]="if an XMPP protocol failure was received."
-
-MODE=""
-
-SMACK_DIR=$(realpath "${SCRIPTDIR}"/..)
-while getopts dm:p: OPTION "$@"; do
-	case $OPTION in
-	d)
-		set -x
-		;;
-	m)
-		MODE=${OPTARG}
-		;;
-	p)
-		SMACK_DIR=${OPTARG}
-		;;
-	*)
-		echo "Unknown option ${OPTION}"
-		exit 1
-		;;
-	esac
-done
-
-JAVA_SOURCES_LIST=$(mktemp)
-onExit() {
-	rm "${JAVA_SOURCES_LIST}"
-}
-trap onExit EXIT
-
-find ${SMACK_DIR} \
-	 -type f \
-	 -name "*.java" \
-	 -print > "${JAVA_SOURCES_LIST}"
-
-NPROC=$(nproc)
-
-sed_sources() {
-	sedScript=${1}
-
-	xargs \
-		--max-procs="${NPROC}" \
-		--max-args=8  \
-		-- \
-		sed \
-		  --in-place \
-		  --follow-symlinks \
-		  --regexp-extended \
-		  "${sedScript}" < "${JAVA_SOURCES_LIST}"
-}
-
-show_affected() {
-	echo ${!SMACK_EXCEPTIONS{@}}
-	for exception in ${!SMACK_EXCEPTIONS[@]}; do
-		xargs grep " \* @throws $exception$" < "${JAVA_SOURCES_LIST}"
-	done
-	for exception in ${!SMACK_EXCEPTIONS[@]}; do
-		local count
-		count=$(<"${JAVA_SOURCES_LIST}" xargs grep " \* @throws $exception$" |\
-						  wc -l)
-		echo "$exception $count"q
-	done
-
-}
-
-fix_affected() {
-	for exception in "${!SMACK_EXCEPTIONS[@]}"; do
-		exceptionJavadoc=${SMACK_EXCEPTIONS[${exception}]}
-		sed_sources "s;@throws ((\w*\.)?${exception}) ?\$;@throws \1 ${exceptionJavadoc};"
-	done
-}
-
-add_todo_to_param_and_return() {
-	sed_sources "s;@(param|return) (\w*)\$;@\1 \2 TODO javadoc me please;"
-}
-
-case $MODE in
-	show)
-		show_affected
-		;;
-	fix)
-		fix_affected
-		;;
-	*)
-		echo "Unknown mode ${mode}"
-		exit 1
-esac

resources/generate-notice-file

@@ -1,38 +0,0 @@
-#!/usr/bin/env bash
-set -euo pipefail
-
-SCRIPT_DIR="$( cd -- "$( dirname -- "${BASH_SOURCE[0]}" )" &> /dev/null && pwd )"
-SMACK_DIR=$(realpath "${SCRIPT_DIR}/..")
-
-cd "${SMACK_DIR}"
-
-TEMPFILE=$(mktemp)
-
-cleanup() {
-	rm "${TEMPFILE}"
-}
-trap cleanup EXIT
-
-git shortlog -s |\
-	cut -f2- |\
-	grep -v '(no author)' |\
-	grep '\w \w.*' |\
-	sort \
-	> "${TEMPFILE}"
-
-readonly NOTICE_FILE="${SMACK_DIR}/NOTICE"
-
-cat <<EOF > "${NOTICE_FILE}"
-                 Smack
-
-       An open-source XMPP library
-      maintained by Florian Schmaus
-
- https://igniterealtime.org/projects/smack
-
-
-Authors:
-
-EOF
-
-cat "${TEMPFILE}" >> "${NOTICE_FILE}"

resources/getCopyright.sh

@@ -15,7 +15,7 @@ for p in $SUBPROJECTS; do
 		sort | \
 		# Remove duplicates
 		uniq | \
-		# Split multi Copyright statements, e.g. "2001-2013 FooBar, 2014 Baz"
+		# Split multi Copyright statemtents, e.g. "2001-2013 FooBar, 2014 Baz"
 	    tr ',' '\n' | \
 		# Remove whitespaces resulting from the previous split
 		sed "s/^[ \t]*//" | \

resources/intellij/smack_formatter.xml

@@ -1,51 +0,0 @@
-<code_scheme name="Project" version="173">
-  <option name="FORMATTER_TAGS_ENABLED" value="true" />
-  <JavaCodeStyleSettings>
-    <option name="CLASS_COUNT_TO_USE_IMPORT_ON_DEMAND" value="99" />
-    <option name="NAMES_COUNT_TO_USE_IMPORT_ON_DEMAND" value="99" />
-    <option name="IMPORT_LAYOUT_TABLE">
-      <value>
-        <package name="" withSubpackages="true" static="true" />
-        <emptyLine />
-        <package name="java" withSubpackages="true" static="false" />
-        <package name="javax" withSubpackages="true" static="false" />
-        <emptyLine />
-        <package name="org.jivesoftware.smack" withSubpackages="true" static="false" />
-        <package name="org.jivesoftware.smackx" withSubpackages="true" static="false" />
-        <emptyLine />
-        <package name="" withSubpackages="true" static="false" />
-      </value>
-    </option>
-    <option name="JD_KEEP_EMPTY_LINES" value="false" />
-  </JavaCodeStyleSettings>
-  <codeStyleSettings language="JAVA">
-    <option name="KEEP_LINE_BREAKS" value="false" />
-    <option name="KEEP_FIRST_COLUMN_COMMENT" value="false" />
-    <option name="KEEP_CONTROL_STATEMENT_IN_ONE_LINE" value="false" />
-    <option name="KEEP_BLANK_LINES_IN_DECLARATIONS" value="1" />
-    <option name="KEEP_BLANK_LINES_IN_CODE" value="1" />
-    <option name="KEEP_BLANK_LINES_BEFORE_RBRACE" value="1" />
-    <option name="INDENT_CASE_FROM_SWITCH" value="false" />
-    <option name="ALIGN_MULTILINE_PARAMETERS" value="false" />
-    <option name="ALIGN_MULTILINE_RESOURCES" value="false" />
-    <option name="SPACE_WITHIN_ARRAY_INITIALIZER_BRACES" value="true" />
-    <option name="SPACE_BEFORE_ARRAY_INITIALIZER_LBRACE" value="true" />
-    <option name="CALL_PARAMETERS_WRAP" value="1" />
-    <option name="METHOD_PARAMETERS_WRAP" value="1" />
-    <option name="RESOURCE_LIST_WRAP" value="5" />
-    <option name="EXTENDS_LIST_WRAP" value="1" />
-    <option name="THROWS_LIST_WRAP" value="1" />
-    <option name="EXTENDS_KEYWORD_WRAP" value="1" />
-    <option name="THROWS_KEYWORD_WRAP" value="1" />
-    <option name="BINARY_OPERATION_WRAP" value="1" />
-    <option name="BINARY_OPERATION_SIGN_ON_NEXT_LINE" value="true" />
-    <option name="TERNARY_OPERATION_WRAP" value="5" />
-    <option name="ARRAY_INITIALIZER_WRAP" value="1" />
-    <option name="METHOD_ANNOTATION_WRAP" value="0" />
-    <option name="CLASS_ANNOTATION_WRAP" value="0" />
-    <option name="FIELD_ANNOTATION_WRAP" value="0" />
-    <indentOptions>
-      <option name="CONTINUATION_INDENT_SIZE" value="16" />
-    </indentOptions>
-  </codeStyleSettings>
-</code_scheme>

resources/javadoc-overview.html

@@ -1,121 +0,0 @@
-<body>
-
-  <h1>Overview</h1>
-
-  <p>Smack is a library for client-to-server XMPP connections to perform real-time communications and data exchange. This includes, but is not limited to, instant messaging and group chat. More generically speaking, it allows you to easily exchange data in various ways: For example fire-and-forget, publish-subscribe, between human and non-human endpoints. The use cases include M2M, IoT, and many more.</p>
-
-  <p>Smack is a pure Java library, open-source and highly modular. It runs on Android and Java SE. The API strives to be easy to use but yet powerful.</p>
-
-  <h2>Key Advantages</h2>
-
-  Smack is extremely simple to use, yet provides a powerful API. Sending a text message to a user can be accomplished in only a few lines of code.
-
-  <pre>{@code
-AbstractXMPPConnection connection = new XMPPTCPConnection("mtucker", "password", "jabber.org");
-connection.connect().login();
-
-Message message = connection.getStanzaFactory()
-   .buildMessageStanza()
-   .to("jsmith@igniterealtime.org")
-   .setBody("Howdy! How are you?")
-   .build();
-
-connection.sendStanza(message);
-
-connection.disconnect();
-}</pre>
-
-  <p>Smack doesn't force you to code at the protcol level of XMPP. The library provides intelligent higher level constructs, often called {@link org.jivesoftware.smack.Manager}, which let you program more efficiently. Other examples of those constructs are the Chat and Roster classes.</p>
-
-  <p>Smack comes with APIs for easy machine-to-machine communication. You can set any number of properties on each message, including properties that are Java objects.</p>
-
-  <h2>License</h2>
-
-  <p>Smack is open-source and most parts are under the Apache License
-  2.0, which means you can incorporate Smack into your commercial or
-  non-commercial applications. Some parts of Smack may be under a
-  different open-source license. Please refer to the individual
-  subprojects for their license statement.</p>
-
-  <p>Note that the Apache License 2.0 requires that the contents of a
-  NOICE text file are shown "…within a display generated by the
-  Derivative Works, if and wherever such third-party notices normally
-  appear.". Smack comes with such a NOTICE file. The content of
-  Smack's NOTICE file can conveniently be retrieved using
-  {@link org.jivesoftware.smack.Smack#getNoticeStream}.</p>
-
-  <h2>About XMPP</h2>
-
-  <p>XMPP (eXtensible Messaging and Presence Protocol) is an open protocol standardized by the <a href="https://ietf.org/">Internet Engineering Task Force (IETF)</a> and supported and extended by the <a href="https://www.xmpp.org/">XMPP Standards Foundation (XSF)</a>.</p>
-
-  <h2>Smack Modules</h2>
-
-  <p>Smack is meant to be easily embedded into any existing Java
-	application. The library ships as several modules to provide more
-	flexibility over which features applications require.</p>
-
-  <ul>
-  <li>smack-core -- provides core XMPP functionality. All XMPP features that are part of the XMPP RFCs are included.</li>
-  <li>smack-im -- provides functionality defined in RFC 6121 (XMPP-IM), like the Roster.</li>
-  <li>{@link org.jivesoftware.smack.tcp smack-tcp} -- support for XMPP over TCP. Includes XMPPTCPConnection class, which you usually want to use</li>
-  <li>smack-extensions -- support for many of the extensions (XEPs) defined by the XMPP Standards Foundation, including multi-user chat, file transfer, user search, etc. The extensions are documented in the [extensions manual](extensions/index.md).</li>
-  <li>smack-experimental -- support for experimental extensions (XEPs) defined by the XMPP Standards Foundation. The API and functionality of those extensions should be considered as unstable.</li>
-  <li>smack-legacy -- support for legacy extensions (XEPs) defined by the XMPP Standards Foundation.
-  <li>smack-bosh -- support for BOSH (XEP-0124). This code should be considered as beta.</li>
-  <li>smack-resolver-minidns -- support for resolving DNS SRV records with the help of <a href="https://minidns.org">MiniDNS</a>. Ideal for platforms that do not support the javax.naming API. Also supports [DNSSEC](dnssec.md) TODO: Fix link.</li>
-  <li>smack-resolver-dnsjava -- support for resolving DNS SRV records with the help of dnsjava.</li>
-  <li>smack-resolver-javax -- support for resolving DNS SRV records with the javax namespace API.</li>
-  <li>smack-debug -- an enhanced GUI debugger for protocol traffic. It will automatically be used when found in the classpath and when [debugging](debugging.md) is enabled.</li>
-  </ul>
-
-  <h2>Main API Entry Points</h2>
-
-  <ul>
-    <li>{@link org.jivesoftware.smack.XMPPConnection}</li>
-    <li>{@link org.jivesoftware.smack.tcp.XMPPTCPConnection}</li>
-    <li>{@link org.jivesoftware.smack.roster.Roster}</li>
-    <!-- <li>{@link org.jivesoftware.smack.chat2.Chat}</li> -->
-    <!-- More form index.md -->
-  </ul>
-
-  <h2>Smack Extensions</h2>
-
-  <p>
-	Since the X in XMPP stands for eXstensible, Smack comes with many
-	built-in extensions for XMPP. Click
-  </p>
-  <blockquote><b>{@link org.jivesoftware.smackx}</b></blockquote>
-  <p>
-	for an overview of all supporteted XMPP extensions of Smack.
-  </p>
-
-  Some selected extensions are
-  <ul>
-    <li>{@link org.jivesoftware.smackx.muc.MultiUserChat Multi-User Chat (XEP-0045)}</li>
-    <li>{@link org.jivesoftware.smackx.carbons.CarbonManager Message Carbons (XEP-0289)}</li>
-    <li>{@link org.jivesoftware.smackx.omemo OMEMO (XEP-0384)}</li>
-    <!-- <li>{@link org.jivesoftware.smack.chat2.Chat}</li> -->
-    <!-- More form index.md -->
-  </ul>
-
-  <h2>Configuration</h2>
-
-  <p>Smack has an initialization process that involves 2 phases.</p>
-
-  <ul>
-	<li>Initializing system properties - Initializing all the system properties accessible through the class **SmackConfiguration**. These properties are retrieved by the _getXXX_ methods on that class.</li>
-	<li>Initializing startup classes - Initializing any classes meant to be active at startup by instantiating the class, and then calling the _initialize_ method on that class if it extends **SmackInitializer**. If it does not extend this interface, then initialization will have to take place in a static block of code which is automatically executed when the class is loaded.</li>
-  </ul>
-
-  <p>
-	Initialization is accomplished via a configuration file.
-	By default, Smack
-will load the one embedded in the Smack jar at _org.jivesoftware.smack/smack-
-	config.xml_.
-	This particular configuration contains a list of initializer
-	classes to load.
-	All manager type classes that need to be initialized are
-	contained in this list of initializers.
-  </p>
-
-</body>

resources/logo/.gitignore

@@ -1,2 +0,0 @@
-/*.png
-/smack-logo-plain-minimized.svg

resources/logo/Makefile

@@ -1,22 +0,0 @@
-.PHONY: all clean
-
-all: smack-logo-plain.png smack-logo-plain-icon-16x16.png smack-logo-plain-icon-32x32.png smack-logo-plain-icon-128x128.png smack-logo-plain-minimized.svg
-
-smack-logo-plain.png: smack-logo-plain.svg
-	convert $< $@
-
-smack-logo-plain-icon-16x16.png: smack-logo-plain.svg
-	convert -resize 16x16 $< $@
-
-smack-logo-plain-icon-32x32.png: smack-logo-plain.svg
-	convert -resize 32x32 $< $@
-
-smack-logo-plain-icon-128x128.png: smack-logo-plain.svg
-	convert -resize 128x128 $< $@
-
-smack-logo-plain-minimized.svg: smack-logo-plain.svg
-	scour -i $< -o $@ --enable-viewboxing --enable-id-stripping --enable-comment-stripping --shorten-ids --indent=none
-
-clean:
-	rm -f *.png
-	rm -f smack-logo-plain-minimized.svg

resources/logo/smack-logo-plain.svg

@@ -1,89 +0,0 @@
-<?xml version="1.0" encoding="UTF-8" standalone="no"?>
-<svg
-   xmlns:dc="http://purl.org/dc/elements/1.1/"
-   xmlns:cc="http://creativecommons.org/ns#"
-   xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
-   xmlns:svg="http://www.w3.org/2000/svg"
-   xmlns="http://www.w3.org/2000/svg"
-   xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd"
-   xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape"
-   viewBox="0 0 399.2693 389.25732"
-   height="389.25732"
-   width="399.26932"
-   xml:space="preserve"
-   id="svg2"
-   version="1.1"
-   inkscape:version="0.91 r13725"
-   sodipodi:docname="smack-logo-plain.svg"><sodipodi:namedview
-     pagecolor="#ffffff"
-     bordercolor="#666666"
-     borderopacity="1"
-     objecttolerance="10"
-     gridtolerance="10"
-     guidetolerance="10"
-     inkscape:pageopacity="0"
-     inkscape:pageshadow="2"
-     inkscape:window-width="834"
-     inkscape:window-height="1044"
-     id="namedview3432"
-     showgrid="false"
-     fit-margin-top="0"
-     fit-margin-left="0"
-     fit-margin-right="0"
-     fit-margin-bottom="0"
-     inkscape:zoom="0.65684805"
-     inkscape:cx="238.37045"
-     inkscape:cy="159.12321"
-     inkscape:window-x="2520"
-     inkscape:window-y="0"
-     inkscape:window-maximized="0"
-     inkscape:current-layer="svg2" /><metadata
-     id="metadata8"><rdf:RDF><cc:Work
-         rdf:about=""><dc:format>image/svg+xml</dc:format><dc:type
-           rdf:resource="http://purl.org/dc/dcmitype/StillImage" /><dc:title></dc:title></cc:Work></rdf:RDF></metadata><defs
-     id="defs6"><clipPath
-       id="clipPath18"
-       clipPathUnits="userSpaceOnUse"><path
-         id="path16"
-         d="M 0,600 800,600 800,0 0,0 Z"
-         inkscape:connector-curvature="0" /></clipPath><clipPath
-       id="clipPath30"
-       clipPathUnits="userSpaceOnUse"><path
-         id="path28"
-         d="m 351.001,359.31 c -17.234,-7.3 -51.945,15.909 -51.945,15.909 l 0,0 c 0,0 31.115,-33.702 27.068,-47.102 l 0,0 c -4.048,-13.401 -44.827,-30.694 -44.827,-30.694 l 0,0 c 0,0 51.173,5.823 53.705,-8.205 l 0,0 c 2.528,-14.031 -3.951,-54.186 -3.951,-54.186 l 0,0 c 0,0 25.887,37.471 39.897,36.872 l 0,0 c 14.012,-0.597 39.902,-36.872 39.902,-36.872 l 0,0 c 0,0 -14.178,43.955 -3.952,54.186 l 0,0 c 10.225,10.229 53.706,8.205 53.706,8.205 l 0,0 c 0,0 -43.02,12.932 -44.827,30.694 l 0,0 c -1.81,17.759 27.07,47.102 27.07,47.102 l 0,0 c 0,0 -35.718,-23.04 -51.948,-15.909 l 0,0 c -16.232,7.13 -19.951,50.533 -19.951,50.533 l 0,0 c 0,0 -2.718,-43.232 -19.947,-50.533"
-         inkscape:connector-curvature="0" /></clipPath><radialGradient
-       id="radialGradient40"
-       spreadMethod="pad"
-       gradientTransform="matrix(89.254456,0,0,-89.254456,370.9502,322.4375)"
-       gradientUnits="userSpaceOnUse"
-       r="1"
-       cy="0"
-       cx="0"
-       fy="0"
-       fx="0"><stop
-         id="stop36"
-         offset="0"
-         style="stop-opacity:1;stop-color:#fdbe10" /><stop
-         id="stop38"
-         offset="1"
-         style="stop-opacity:1;stop-color:#f16422" /></radialGradient></defs><g
-     transform="matrix(1.3333333,0,0,-1.3333333,-294.96293,630.13412)"
-     id="g10"><g
-       id="g12"><g
-         clip-path="url(#clipPath18)"
-         id="g14"><g
-           transform="translate(370.9482,472.6006)"
-           id="g20"><path
-             id="path22"
-             style="fill:#fdbe10;fill-opacity:1;fill-rule:nonzero;stroke:none"
-             d="m 0,0 c 0,0 6.213,-72.485 33.318,-84.392 27.104,-11.905 86.753,26.569 86.753,26.569 0,0 -48.228,-49.006 -45.209,-78.665 3.022,-29.661 74.864,-51.262 74.864,-51.262 0,0 -72.61,3.382 -89.688,-13.703 -17.078,-17.084 6.597,-90.49 6.597,-90.49 0,0 -43.237,60.579 -66.635,61.578 -23.4,1.003 -66.633,-61.578 -66.633,-61.578 0,0 10.826,67.062 6.601,90.49 -4.229,23.431 -89.694,13.703 -89.694,13.703 0,0 68.108,28.882 74.865,51.262 6.757,22.378 -45.21,78.665 -45.21,78.665 0,0 57.978,-38.76 86.757,-26.569 C -4.54,-72.2 0,0 0,0"
-             inkscape:connector-curvature="0" /></g></g></g><g
-       id="g24"><g
-         clip-path="url(#clipPath30)"
-         id="g26"><g
-           id="g32"><g
-             id="g34"><path
-               id="path42"
-               style="fill:url(#radialGradient40);stroke:none"
-               d="m 351.001,359.31 c -17.234,-7.3 -51.945,15.909 -51.945,15.909 l 0,0 c 0,0 31.115,-33.702 27.068,-47.102 l 0,0 c -4.048,-13.401 -44.827,-30.694 -44.827,-30.694 l 0,0 c 0,0 51.173,5.823 53.705,-8.205 l 0,0 c 2.528,-14.031 -3.951,-54.186 -3.951,-54.186 l 0,0 c 0,0 25.887,37.471 39.897,36.872 l 0,0 c 14.012,-0.597 39.902,-36.872 39.902,-36.872 l 0,0 c 0,0 -14.178,43.955 -3.952,54.186 l 0,0 c 10.225,10.229 53.706,8.205 53.706,8.205 l 0,0 c 0,0 -43.02,12.932 -44.827,30.694 l 0,0 c -1.81,17.759 27.07,47.102 27.07,47.102 l 0,0 c 0,0 -35.718,-23.04 -51.948,-15.909 l 0,0 c -16.232,7.13 -19.951,50.533 -19.951,50.533 l 0,0 c 0,0 -2.718,-43.232 -19.947,-50.533"
-               inkscape:connector-curvature="0" /></g></g></g></g></g></svg>

resources/logo/smack-logo-with-text.svg

@@ -1,90 +0,0 @@
-<?xml version="1.0" encoding="UTF-8" standalone="no"?>
-<svg
-   xmlns:dc="http://purl.org/dc/elements/1.1/"
-   xmlns:cc="http://creativecommons.org/ns#"
-   xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
-   xmlns:svg="http://www.w3.org/2000/svg"
-   xmlns="http://www.w3.org/2000/svg"
-   viewBox="0 0 1066.6667 800"
-   height="800"
-   width="1066.6667"
-   xml:space="preserve"
-   id="svg2"
-   version="1.1"><metadata
-     id="metadata8"><rdf:RDF><cc:Work
-         rdf:about=""><dc:format>image/svg+xml</dc:format><dc:type
-           rdf:resource="http://purl.org/dc/dcmitype/StillImage" /></cc:Work></rdf:RDF></metadata><defs
-     id="defs6"><clipPath
-       id="clipPath18"
-       clipPathUnits="userSpaceOnUse"><path
-         id="path16"
-         d="M 0,600 H 800 V 0 H 0 Z" /></clipPath><clipPath
-       id="clipPath30"
-       clipPathUnits="userSpaceOnUse"><path
-         id="path28"
-         d="m 200.001,337.31 c -17.233,-7.3 -51.946,15.909 -51.946,15.909 v 0 c 0,0 31.116,-33.703 27.069,-47.103 v 0 c -4.048,-13.4 -44.827,-30.694 -44.827,-30.694 v 0 c 0,0 51.174,5.824 53.704,-8.204 v 0 c 2.528,-14.032 -3.951,-54.186 -3.951,-54.186 v 0 c 0,0 25.889,37.471 39.898,36.872 v 0 c 14.012,-0.598 39.902,-36.872 39.902,-36.872 v 0 c 0,0 -14.178,43.955 -3.951,54.186 v 0 c 10.224,10.229 53.705,8.204 53.705,8.204 v 0 c 0,0 -43.02,12.933 -44.827,30.694 v 0 c -1.811,17.761 27.07,47.103 27.07,47.103 v 0 c 0,0 -35.719,-23.04 -51.948,-15.909 v 0 c -16.232,7.131 -19.951,50.532 -19.951,50.532 v 0 c 0,0 -2.719,-43.23 -19.947,-50.532" /></clipPath><radialGradient
-       id="radialGradient40"
-       spreadMethod="pad"
-       gradientTransform="matrix(89.254456,0,0,-89.254456,219.9502,300.4375)"
-       gradientUnits="userSpaceOnUse"
-       r="1"
-       cy="0"
-       cx="0"
-       fy="0"
-       fx="0"><stop
-         id="stop36"
-         offset="0"
-         style="stop-opacity:1;stop-color:#fdbe10" /><stop
-         id="stop38"
-         offset="1"
-         style="stop-opacity:1;stop-color:#f16422" /></radialGradient><clipPath
-       id="clipPath50"
-       clipPathUnits="userSpaceOnUse"><path
-         id="path48"
-         d="M 0,600 H 800 V 0 H 0 Z" /></clipPath></defs><g
-     transform="matrix(1.3333333,0,0,-1.3333333,0,800)"
-     id="g10"><g
-       id="g12"><g
-         clip-path="url(#clipPath18)"
-         id="g14"><g
-           transform="translate(219.9482,450.6006)"
-           id="g20"><path
-             id="path22"
-             style="fill:#fdbe10;fill-opacity:1;fill-rule:nonzero;stroke:none"
-             d="m 0,0 c 0,0 6.213,-72.485 33.318,-84.392 27.104,-11.905 86.753,26.569 86.753,26.569 0,0 -48.228,-49.006 -45.208,-78.665 3.021,-29.661 74.863,-51.262 74.863,-51.262 0,0 -72.61,3.382 -89.688,-13.703 -17.079,-17.084 6.597,-90.49 6.597,-90.49 0,0 -43.237,60.579 -66.635,61.578 -23.4,1.003 -66.633,-61.578 -66.633,-61.578 0,0 10.826,67.062 6.601,90.49 -4.229,23.431 -89.694,13.703 -89.694,13.703 0,0 68.108,28.882 74.865,51.262 6.757,22.378 -45.21,78.665 -45.21,78.665 0,0 57.978,-38.76 86.757,-26.569 C -4.54,-72.2 0,0 0,0" /></g></g></g><g
-       id="g24"><g
-         clip-path="url(#clipPath30)"
-         id="g26"><g
-           id="g32"><g
-             id="g34"><path
-               id="path42"
-               style="fill:url(#radialGradient40);stroke:none"
-               d="m 200.001,337.31 c -17.233,-7.3 -51.946,15.909 -51.946,15.909 v 0 c 0,0 31.116,-33.703 27.069,-47.103 v 0 c -4.048,-13.4 -44.827,-30.694 -44.827,-30.694 v 0 c 0,0 51.174,5.824 53.704,-8.204 v 0 c 2.528,-14.032 -3.951,-54.186 -3.951,-54.186 v 0 c 0,0 25.889,37.471 39.898,36.872 v 0 c 14.012,-0.598 39.902,-36.872 39.902,-36.872 v 0 c 0,0 -14.178,43.955 -3.951,54.186 v 0 c 10.224,10.229 53.705,8.204 53.705,8.204 v 0 c 0,0 -43.02,12.933 -44.827,30.694 v 0 c -1.811,17.761 27.07,47.103 27.07,47.103 v 0 c 0,0 -35.719,-23.04 -51.948,-15.909 v 0 c -16.232,7.131 -19.951,50.532 -19.951,50.532 v 0 c 0,0 -2.719,-43.23 -19.947,-50.532" /></g></g></g></g><g
-       id="g44"><g
-         clip-path="url(#clipPath50)"
-         id="g46"><g
-           transform="translate(407.4561,274.8086)"
-           id="g52"><path
-             id="path54"
-             style="fill:#000000;fill-opacity:1;fill-rule:nonzero;stroke:none"
-             d="m 0,0 c 3.747,-1.967 9.743,-3.935 15.833,-3.935 6.559,0 10.025,2.719 10.025,6.934 0,3.841 -2.999,6.185 -10.587,8.807 -10.494,3.747 -17.427,9.556 -17.427,18.833 0,10.773 9.089,18.925 23.891,18.925 7.216,0 12.369,-1.406 16.116,-3.186 l -3.186,-11.43 c -2.436,1.218 -7.026,2.997 -13.116,2.997 -6.184,0 -9.183,-2.903 -9.183,-6.09 0,-4.027 3.467,-5.809 11.712,-8.993 11.15,-4.124 16.303,-9.931 16.303,-18.924 0,-10.59 -8.057,-19.584 -25.392,-19.584 -7.213,0 -14.333,1.966 -17.894,3.934 z" /></g><g
-           transform="translate(456.9297,291.3926)"
-           id="g56"><path
-             id="path58"
-             style="fill:#000000;fill-opacity:1;fill-rule:nonzero;stroke:none"
-             d="M 0,0 C 0,5.716 -0.189,10.495 -0.376,14.615 H 11.71 l 0.562,-6.276 h 0.281 c 1.968,2.999 6.09,7.308 13.868,7.308 5.996,0 10.587,-3.092 12.554,-7.871 h 0.186 c 1.78,2.436 3.749,4.311 5.997,5.622 2.53,1.406 5.342,2.249 8.715,2.249 8.807,0 15.459,-6.185 15.459,-19.865 v -26.98 H 55.464 v 24.827 c 0,6.652 -2.154,10.493 -6.744,10.493 -3.373,0 -5.622,-2.248 -6.653,-4.967 -0.282,-1.028 -0.469,-2.434 -0.469,-3.559 V -31.198 H 27.731 v 25.672 c 0,5.713 -2.06,9.648 -6.652,9.648 -3.653,0 -5.808,-2.81 -6.65,-5.059 -0.47,-1.124 -0.564,-2.436 -0.564,-3.655 V -31.198 H 0 Z" /></g><g
-           transform="translate(561.8691,281.835)"
-           id="g60"><path
-             id="path62"
-             style="fill:#000000;fill-opacity:1;fill-rule:nonzero;stroke:none"
-             d="m 0,0 c -7.496,0 -13.304,-1.78 -13.304,-7.214 0,-3.653 2.435,-5.433 5.62,-5.433 3.467,0 6.466,2.341 7.403,5.247 C -0.094,-6.652 0,-5.808 0,-4.966 Z m 13.772,-10.587 c 0,-4.308 0.187,-8.525 0.749,-11.054 H 1.686 l -0.843,4.589 H 0.562 c -2.999,-3.654 -7.682,-5.621 -13.118,-5.621 -9.274,0 -14.802,6.746 -14.802,14.054 0,11.898 10.681,17.522 26.89,17.522 v 0.562 c 0,2.434 -1.312,5.901 -8.339,5.901 -4.685,0 -9.65,-1.593 -12.649,-3.374 l -2.623,9.091 c 3.185,1.779 9.463,4.122 17.802,4.122 15.272,0 20.049,-8.995 20.049,-19.768 z" /></g><g
-           transform="translate(621.3672,261.3164)"
-           id="g64"><path
-             id="path66"
-             style="fill:#000000;fill-opacity:1;fill-rule:nonzero;stroke:none"
-             d="m 0,0 c -2.529,-1.216 -7.309,-2.154 -12.742,-2.154 -14.803,0 -24.266,9.087 -24.266,23.517 0,13.399 9.181,24.361 26.233,24.361 3.749,0 7.87,-0.657 10.869,-1.78 L -2.155,33.355 c -1.687,0.75 -4.217,1.407 -7.964,1.407 -7.495,0 -12.366,-5.34 -12.273,-12.837 0,-8.433 5.621,-12.928 12.554,-12.928 3.373,0 5.996,0.561 8.151,1.499 z" /></g><g
-           transform="translate(643.4795,286.6143)"
-           id="g68"><path
-             id="path70"
-             style="fill:#000000;fill-opacity:1;fill-rule:nonzero;stroke:none"
-             d="m 0,0 h 0.188 c 1.031,1.967 2.155,3.841 3.278,5.526 l 9.276,13.868 H 29.888 L 13.492,0.845 32.23,-26.42 H 14.709 L 3.56,-7.588 0,-12.18 V -26.42 H -14.24 V 40.101 H 0 Z" /></g></g></g></g></svg>

resources/releasedocs/README.html

@@ -0,0 +1,217 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+
+<html>
+<head>
+	<title>Smack Readme</title>
+ <style type="text/css">
+/* global font and body settings */
+body {
+	font-size : 100%;
+	background-color : #d3d6d9;
+	padding: 0;
+	margin: 0 0 30px 0;
+}
+body, td, th {
+	font-family : arial, helvetica, sans-serif;
+	font-size : 10pt;
+}
+pre, tt, code {
+	font-family : courier new, monospace;
+	font-size : 9pt;
+}
+#pageContainer {
+	display: block;
+	position: relative;
+	clear: both;
+	background-color: #fff;
+	border: 1px solid #999;
+	padding: 40px;
+	margin: 30px;
+	-moz-border-radius: 6px;
+}
+#pageHeader {
+	display: block;
+	position: relative;
+	height: 80px;
+	background-color: #e7eaee;
+	border: 1px solid #cccccc;
+	border-bottom: none;
+	-moz-border-radius: 5px 5px 0 0;
+	margin: 10px 0 0 0;
+}
+#pageBody {
+	margin: 0 18px 0 20px;
+}
+/* anchors */
+a:link {
+	color: #11568c;
+}
+a:visited {
+	color: #571c8d;
+}
+a:hover {
+	color: #7a1d42;
+	text-decoration : underline;
+}
+a:active {
+	color: #7a1d42;
+}
+/* page header elements (logo and navigation) */
+.navigation {
+	display: block;
+	position: relative;
+	height: 20px;
+	background-color: #335588;
+	border: 1px solid #cccccc;
+	border-top: none;
+	color: #ffffff;
+	font-size: 11px;
+	line-height: 18px;
+	padding: 0 0 0 0;
+	margin: 0 0 25px 0;
+	overflow: hidden;
+}
+.navigation a {
+	margin: 0 20px 0 20px;
+}
+.navigation a:link { color: #ffffff; }
+.navigation a:visited { color: #ffffff; }
+.navigation a:hover { color: #ffffff; }
+.navigation a:active { color: #ffffff; }
+/* headings */
+h1 {
+	display: block;
+	position: relative;
+	font-size : 1.7em;
+	font-weight : bold;
+	color: #670e15;
+	padding: 0;
+	margin: 30px 0 0 20px;
+}
+h2 {
+	font-size : 1.3em;
+	font-weight : bold;
+	margin: 40px 0 6px 0;
+	padding: 0;
+	color: #335588;
+}
+h3 {
+	font-size : 1.0em;
+	font-weight : bold;
+	margin: 25px 0 3px 0;
+	padding: 0;
+	color: #334466;
+}
+
+/* general elements */
+p {
+	margin: 0 0 15px 0;
+}
+
+ul {
+	margin: 5px 0 15px 15px;
+}
+li {
+	padding-bottom : 4px;
+}
+tt {
+	font-family : courier new, monospace; 
+	font-weight : bold;
+	color : #060;
+}
+hr {
+	display: block;
+	height: 1px;
+	background-color: #999999;
+	border: none;
+	margin: 40px 0 20px 0;
+}
+</style>
+</head>
+<body>
+
+<div id="pageContainer">
+
+	<div id="pageHeader">
+		<h1>Smack Readme</h1>
+	</div>
+	<div class="navigation">
+	<a href="README.html">Readme</a>|<a href="changelog.html"><strong>Changelog</strong></a>
+	</div>
+
+	<div id="pageBody">
+
+<p>
+<table border=0>
+<tr>
+	<td align="right">version:</td>
+	<td><b>@version@</b></td>
+</tr>
+<tr>
+   <td align="right">released:</td>
+   <td><b>@releasedate@</b></td>
+</tr>
+</table>
+
+<p>
+Thank you for downloading Smack! This version of Smack is compatible
+with JVMs @targetCompatibility@ or higher. If you dont' use a
+dependency resolution system, like gradle or maven, then you will need
+to download at least
+the <a href="http://www.extreme.indiana.edu/xgws/xsoap/xpp/mxp1/">Xml
+Pull Parser 3rd Edition (XPP3) library</a> or any other library that
+implements the XmlPullParser interface
+(like <a href="http://kxml.org/">kXML</a>).
+</p>
+
+<p>
+Start off by viewing the <a href="documentation/index.html">documentation</a>
+that can be found in the "documentation" directory included with this distribution.
+</p>
+Further information can be found on the <a href="http://www.igniterealtime.org/projects/smack">
+Smack website</a>. If you need help using or would like to make contributions or
+fixes to the code, please visit the 
+<a href="https://community.igniterealtime.org">online forum</a>.
+</p>
+
+<p><b>About the Distribution</b></p>
+
+The <tt>smack-core.jar</tt> file in the main distribution folder. The optional
+<tt>smack-extensions.jar</tt> contains the <a href="documentation/extensions/index.html">Smack extensions</a> 
+while <tt>smack-debug.jar</tt> contains an enhanced debugger.<p>
+
+<p><b>Changelog and Upgrading</b><p>
+
+View the <a href="changelog.html">changelog</a> for a list of changes since the 
+last release.
+If you are upgrading from Smack 3 to Smack 4, then please consult the <a href="https://community.igniterealtime.org/docs/DOC-2703">Smack 4 Readme and Upgrade Guide</a>
+
+<p><b>License Agreements</b><p>
+<ul>
+<li>Use of the Smack source code is governed by the Apache License:
+<pre>
+ Copyright 2002-2008 Jive Software.
+
+ Licensed 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.
+ </pre></li> 
+ 
+<li>Smack contains icons and images licensed from INCORS GmbH. You are not licensed
+to use these icons outside of Smack.</li>
+
+<li>Third-party source code is licensed as noted in their source files. 
+
+</ul>
+</div>
+</div>
+</body>
+</html>

resources/sample/web/addContact.jsp

@@ -1,4 +1,8 @@
 <%--
+  - $RCSfile$
+  - $Revision$
+  - $Date$
+  -
   - Copyright (C) 2002-2003 Jive Software. 
   - 
   - The Jive Software License (based on Apache Software License, Version 1.1)

resources/sample/web/chat.jsp

@@ -1,4 +1,8 @@
 <%--
+  - $$RCSfile$$
+  - $$Revision$$
+  - $$Date$$
+  -
   - Copyright (C) 2002-2003 Jive Software. 
   - 
   - The Jive Software License (based on Apache Software License, Version 1.1)

resources/sample/web/global.jsp

@@ -1,4 +1,8 @@
 <%--
+  - $$RCSfile$$
+  - $$Revision$$
+  - $$Date$$
+  -
   - Copyright (C) 2002-2003 Jive Software. 
   - 
   - The Jive Software License (based on Apache Software License, Version 1.1)

resources/sample/web/index.jsp

@@ -1,4 +1,8 @@
 <%--
+  - $$RCSfile$$
+  - $$Revision$$
+  - $$Date$$
+  -
   - Copyright (C) 2002-2003 Jive Software. 
   - 
   - The Jive Software License (based on Apache Software License, Version 1.1)

resources/sample/web/login.jsp

@@ -1,4 +1,8 @@
 <%--
+  - $RCSfile$
+  - $Revision$
+  - $Date$
+  -
   - Copyright (C) 2002-2003 Jive Software. 
   - 
   - The Jive Software License (based on Apache Software License, Version 1.1)

resources/sample/web/moveContact.jsp

@@ -1,4 +1,8 @@
 <%--
+  - $RCSfile$
+  - $Revision$
+  - $Date$
+  -
   - Copyright (C) 2002-2003 Jive Software. 
   - 
   - The Jive Software License (based on Apache Software License, Version 1.1)

resources/sample/web/viewRoster.jsp

@@ -1,4 +1,8 @@
 <%--
+  - $$RCSfile$$
+  - $$Revision$$
+  - $$Date$$
+  -
   - Copyright (C) 2002-2003 Jive Software. 
   - 
   - The Jive Software License (based on Apache Software License, Version 1.1)

resources/smacklint.sh

@@ -1,3 +0,0 @@
-#!/usr/bin/env bash
-
-find smack-integration-test -type f -path "*/src/main/java/*/smackx/*/package-info.java"

settings.gradle

@@ -1,7 +1,3 @@
-pluginManagement {
-    includeBuild('build-logic')
-}
-
 // The name of the root project.
 // If we would not set the name, then gradle would use the directory
 // name of the root directory
@@ -10,34 +6,19 @@ rootProject.name = 'Smack'
 include 'smack-core',
 		'smack-im',
 		'smack-tcp',
-		'smack-examples',
 		'smack-extensions',
 		'smack-experimental',
 		'smack-debug',
 		'smack-debug-slf4j',
 		'smack-resolver-dnsjava',
 		'smack-resolver-minidns',
-		'smack-resolver-minidns-dox',
 		'smack-resolver-javax',
 		'smack-sasl-javax',
 		'smack-sasl-provided',
-		'smack-streammanagement',
+		'smack-compression-jzlib',
 		'smack-legacy',
 		'smack-jingle-old',
 		'smack-bosh',
 		'smack-android',
 		'smack-android-extensions',
-		'smack-java11',
-		'smack-java11-full',
-		'smack-integration-test',
-		'smack-omemo',
-		'smack-omemo-signal',
-		'smack-omemo-signal-integration-test',
-		'smack-repl',
-		'smack-openpgp',
-		'smack-websocket',
-		'smack-websocket-okhttp',
-		'smack-websocket-java11',
-		'smack-xmlparser',
-		'smack-xmlparser-stax',
-		'smack-xmlparser-xpp3'
+		'smack-java7'

smack-android-extensions/build.gradle

@@ -1,18 +1,20 @@
-plugins {
-	id 'org.igniterealtime.smack.java-common-conventions'
-	id 'org.igniterealtime.smack.android-conventions'
-	id 'org.igniterealtime.smack.android-boot-classpath-conventions'
-}
-
 description = """\
 Extra Smack extensions for Android."""
 
 // Note that the test dependencies (junit, …) are inferred from the
 // sourceSet.test of the core subproject
 dependencies {
-	api project(':smack-android')
-	api project(':smack-extensions')
-
-	// Add the Android jar to the Eclipse .classpath.
-	implementation files(androidBootClasspath)
+	compile project(':smack-android')
+	compile project(':smack-extensions')
 }
+
+compileJava {
+	options.bootClasspath = androidBootClasspath
+}
+
+// See http://stackoverflow.com/a/2823592/194894
+// TODO this doesn't seem to work right now. But on the other hand it
+// is not really required, just to avoid a javadoc compiler warning
+javadoc {
+	options.linksOffline "http://developer.android.com/reference", androidJavadocOffline
+}

smack-android-extensions/src/main/java/org/jivesoftware/smackx/package-info.java

@@ -1 +0,0 @@
-../../../../../../../smack-java11-full/src/main/java/org/jivesoftware/smackx/package-info.java

smack-android-extensions/src/main/java/org/jivesoftware/smackx/ping/android/ServerPingWithAlarmManager.java

@@ -1,6 +1,6 @@
 /**
  *
- * Copyright © 2014-2024 Florian Schmaus
+ * Copyright © 2014 Florian Schmaus
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -19,6 +19,7 @@ package org.jivesoftware.smackx.ping.android;
 
 import java.util.HashSet;
 import java.util.Map;
+import java.util.Map.Entry;
 import java.util.Set;
 import java.util.WeakHashMap;
 import java.util.logging.Logger;
@@ -36,7 +37,6 @@ import android.content.BroadcastReceiver;
 import android.content.Context;
 import android.content.Intent;
 import android.content.IntentFilter;
-import android.os.Build;
 import android.os.SystemClock;
 
 /**
@@ -50,7 +50,6 @@ import android.os.SystemClock;
  * counted towards the scheduled delay time</li>
  * <li>the scheduled Runnable is not run while the system is in deep sleep.</li>
  * </ul>
- * <p>
  * That is the reason Android comes with an API to schedule those tasks: AlarmManager. Which this
  * class uses to determine every 30 minutes if a server ping is necessary. The interval of 30
  * minutes is the ideal trade-off between reliability and low resource (battery) consumption.
@@ -62,134 +61,120 @@ import android.os.SystemClock;
  * functionality.
  * </p>
  */
-public final class ServerPingWithAlarmManager extends Manager {
+public class ServerPingWithAlarmManager extends Manager {
 
-    private static final Logger LOGGER = Logger.getLogger(ServerPingWithAlarmManager.class
-            .getName());
+	private static final Logger LOGGER = Logger.getLogger(ServerPingWithAlarmManager.class
+			.getName());
 
-    private static final String PING_ALARM_ACTION = "org.igniterealtime.smackx.ping.ACTION";
+	private static final String PING_ALARM_ACTION = "org.igniterealtime.smackx.ping.ACTION";
 
-    private static final Map<XMPPConnection, ServerPingWithAlarmManager> INSTANCES = new WeakHashMap<XMPPConnection, ServerPingWithAlarmManager>();
+	private static final Map<XMPPConnection, ServerPingWithAlarmManager> INSTANCES = new WeakHashMap<XMPPConnection, ServerPingWithAlarmManager>();
 
-    static {
-        XMPPConnectionRegistry.addConnectionCreationListener(new ConnectionCreationListener() {
-            @Override
-            public void connectionCreated(XMPPConnection connection) {
-                getInstanceFor(connection);
-            }
-        });
-    }
+	static {
+		XMPPConnectionRegistry.addConnectionCreationListener(new ConnectionCreationListener() {
+			@Override
+			public void connectionCreated(XMPPConnection connection) {
+				getInstanceFor(connection);
+			}
+		});
+	}
 
-    /**
-     * Get the instance of this manager for the given connection.
-     *
-     * @param connection the connection.
-     * @return the instance of this manager for the given connection.
-     */
-    public static synchronized ServerPingWithAlarmManager getInstanceFor(XMPPConnection connection) {
-        ServerPingWithAlarmManager serverPingWithAlarmManager = INSTANCES.get(connection);
-        if (serverPingWithAlarmManager == null) {
-            serverPingWithAlarmManager = new ServerPingWithAlarmManager(connection);
-            INSTANCES.put(connection, serverPingWithAlarmManager);
-        }
-        return serverPingWithAlarmManager;
-    }
+	public static synchronized ServerPingWithAlarmManager getInstanceFor(XMPPConnection connection) {
+		ServerPingWithAlarmManager serverPingWithAlarmManager = INSTANCES.get(connection);
+		if (serverPingWithAlarmManager == null) {
+			serverPingWithAlarmManager = new ServerPingWithAlarmManager(connection);
+			INSTANCES.put(connection, serverPingWithAlarmManager);
+		}
+		return serverPingWithAlarmManager;
+	}
 
-    private boolean mEnabled = true;
+	private boolean mEnabled = true;
 
-    private ServerPingWithAlarmManager(XMPPConnection connection) {
-        super(connection);
-    }
+	private ServerPingWithAlarmManager(XMPPConnection connection) {
+		super(connection);
+	}
 
-    /**
-     * If enabled, ServerPingWithAlarmManager will call {@link PingManager#pingServerIfNecessary()}
-     * for the connection of this instance every half hour.
-     *
-     * @param enabled whether or not this manager is should be enabled or not.
-     */
-    public void setEnabled(boolean enabled) {
-        mEnabled = enabled;
-    }
+	/**
+	 * If enabled, ServerPingWithAlarmManager will call
+	 * {@link PingManager#pingServerIfNecessary()} for the connection of this
+	 * instance every half hour.
+	 * 
+	 * @param enabled
+	 */
+	public void setEnabled(boolean enabled) {
+		mEnabled = enabled;
+	}
 
-    /**
-     * Check if this manager is enabled.
-     *
-     * @return <code>true</code> if this manager is enabled, <code>false</code> otherwise.
-     */
-    public boolean isEnabled() {
-        return mEnabled;
-    }
+	public boolean isEnabled() {
+		return mEnabled;
+	}
 
-    private static final BroadcastReceiver ALARM_BROADCAST_RECEIVER = new BroadcastReceiver() {
-        @Override
-        @SuppressWarnings("LockOnNonEnclosingClassLiteral")
-        public void onReceive(Context context, Intent intent) {
-            LOGGER.fine("Ping Alarm broadcast received");
-            Set<Map.Entry<XMPPConnection, ServerPingWithAlarmManager>> managers;
-            synchronized (ServerPingWithAlarmManager.class) {
-                // Make a copy to avoid ConcurrentModificationException when
-                // iterating directly over INSTANCES and the Set is modified
-                // concurrently by creating a new ServerPingWithAlarmManager.
-                managers = new HashSet<>(INSTANCES.entrySet());
-            }
-            for (Map.Entry<XMPPConnection, ServerPingWithAlarmManager> entry : managers) {
-                XMPPConnection connection = entry.getKey();
-                if (entry.getValue().isEnabled()) {
-                    LOGGER.fine("Calling pingServerIfNecessary for connection "
-                            + connection);
-                    final PingManager pingManager = PingManager.getInstanceFor(connection);
-                    // Android BroadcastReceivers have a timeout of 60 seconds.
-                    // The connections reply timeout may be higher, which causes
-                    // timeouts of the broadcast receiver and a subsequent ANR
-                    // of the App of the broadcast receiver. We therefore need
-                    // to call pingServerIfNecessary() in a new thread to avoid
-                    // this. It could happen that the device gets back to sleep
-                    // until the Thread runs, but that's a risk we are willing
-                    // to take into account as it's unlikely.
-                    Async.go(new Runnable() {
-                        @Override
-                        public void run() {
-                            pingManager.pingServerIfNecessary();
-                        }
-                    }, "PingServerIfNecessary (" + connection.getConnectionCounter() + ')');
-                } else {
-                    LOGGER.fine("NOT calling pingServerIfNecessary (disabled) on connection "
-                            + connection.getConnectionCounter());
-                }
-            }
-        }
-    };
+	private static final BroadcastReceiver ALARM_BROADCAST_RECEIVER = new BroadcastReceiver() {
+		@Override
+		public void onReceive(Context context, Intent intent) {
+			LOGGER.fine("Ping Alarm broadcast received");
+			Set<Entry<XMPPConnection, ServerPingWithAlarmManager>> managers;
+			synchronized (ServerPingWithAlarmManager.class) {
+				// Make a copy to avoid ConcurrentModificationException when
+				// iterating directly over INSTANCES and the Set is modified
+				// concurrently by creating a new ServerPingWithAlarmManager.
+				managers = new HashSet<>(INSTANCES.entrySet());
+			}
+			for (Entry<XMPPConnection, ServerPingWithAlarmManager> entry : managers) {
+				XMPPConnection connection = entry.getKey();
+				if (entry.getValue().isEnabled()) {
+					LOGGER.fine("Calling pingServerIfNecessary for connection "
+							+ connection.getConnectionCounter());
+					final PingManager pingManager = PingManager.getInstanceFor(connection);
+					// Android BroadcastReceivers have a timeout of 60 seconds.
+					// The connections reply timeout may be higher, which causes
+					// timeouts of the broadcast receiver and a subsequent ANR
+					// of the App of the broadcast receiver. We therefore need
+					// to call pingServerIfNecessary() in a new thread to avoid
+					// this. It could happen that the device gets back to sleep
+					// until the Thread runs, but that's a risk we are willing
+					// to take into account as it's unlikely.
+					Async.go(new Runnable() {
+						@Override
+						public void run() {
+							pingManager.pingServerIfNecessary();
+						}
+					}, "PingServerIfNecessary (" + connection.getConnectionCounter() + ')');
+				} else {
+					LOGGER.fine("NOT calling pingServerIfNecessary (disabled) on connection "
+							+ connection.getConnectionCounter());
+				}
+			}
+		}
+	};
 
-    private static Context sContext;
-    private static PendingIntent sPendingIntent;
-    private static AlarmManager sAlarmManager;
+	private static Context sContext;
+	private static PendingIntent sPendingIntent;
+	private static AlarmManager sAlarmManager;
 
-    /**
-     * Register a pending intent with the AlarmManager to be broadcast every half hour and
-     * register the alarm broadcast receiver to receive this intent. The receiver will check all
-     * known questions if a ping is Necessary when invoked by the alarm intent.
-     *
-     * @param context an Android context.
-     */
-    public static void onCreate(Context context) {
-        sContext = context;
-        context.registerReceiver(ALARM_BROADCAST_RECEIVER, new IntentFilter(PING_ALARM_ACTION));
-        sAlarmManager = (AlarmManager) context.getSystemService(Context.ALARM_SERVICE);
-        int pendingIntentFlags = 0;
-        if (Build.VERSION.SDK_INT >= 23) {
-            pendingIntentFlags |= PendingIntent.FLAG_IMMUTABLE;
-        }
-        sPendingIntent = PendingIntent.getBroadcast(context, 0, new Intent(PING_ALARM_ACTION), pendingIntentFlags);
-        sAlarmManager.setInexactRepeating(AlarmManager.ELAPSED_REALTIME_WAKEUP,
-                SystemClock.elapsedRealtime() + AlarmManager.INTERVAL_HALF_HOUR,
-                AlarmManager.INTERVAL_HALF_HOUR, sPendingIntent);
-    }
+	/**
+	 * Register a pending intent with the AlarmManager to be broadcasted every
+	 * half hour and register the alarm broadcast receiver to receive this
+	 * intent. The receiver will check all known questions if a ping is
+	 * Necessary when invoked by the alarm intent.
+	 * 
+	 * @param context
+	 */
+	public static void onCreate(Context context) {
+		sContext = context;
+		context.registerReceiver(ALARM_BROADCAST_RECEIVER, new IntentFilter(PING_ALARM_ACTION));
+		sAlarmManager = (AlarmManager) context.getSystemService(Context.ALARM_SERVICE);
+		sPendingIntent = PendingIntent.getBroadcast(context, 0, new Intent(PING_ALARM_ACTION), 0);
+		sAlarmManager.setInexactRepeating(AlarmManager.ELAPSED_REALTIME_WAKEUP,
+				SystemClock.elapsedRealtime() + AlarmManager.INTERVAL_HALF_HOUR,
+				AlarmManager.INTERVAL_HALF_HOUR, sPendingIntent);
+	}
 
-    /**
-     * Unregister the alarm broadcast receiver and cancel the alarm.
-     */
-    public static void onDestroy() {
-        sContext.unregisterReceiver(ALARM_BROADCAST_RECEIVER);
-        sAlarmManager.cancel(sPendingIntent);
-    }
+	/**
+	 * Unregister the alarm broadcast receiver and cancel the alarm. 
+	 */
+	public static void onDestroy() {
+		sContext.unregisterReceiver(ALARM_BROADCAST_RECEIVER);
+		sAlarmManager.cancel(sPendingIntent);
+	}
 }