Gradle: stand-alone build, independent from css4j-dist.

Author: carlosame

.gitignore

@@ -18,5 +18,8 @@
 *.iws
 
 # Gradle
-/.gradle
+**/.gradle
 /build/
+/buildSrc/build/
+
+/CHANGES.txt

README.md

@@ -1,5 +1,51 @@
 # css4j - dom4j module
 
-Subclasses several [dom4j](https://dom4j.github.io/) classes and provides CSS functionality to it. Licence is BSD 3-clause.
+Subclasses several [dom4j](https://dom4j.github.io/) classes and provides CSS functionality to it.
+Licence is BSD 3-clause.
 
-Please refer to the `css4j-dist` repository for build instructions.
+## Build from source
+To build css4j-dom4j from the code that is currently at the Git repository, you need a current JDK (the build is tested with
+version 16). You can run a variety of Gradle tasks with the Gradle wrapper (on Unix-like systems you may need to type `./gradlew`):
+
+- `gradlew build` (normal build)
+- `gradlew build publishToMavenLocal` (to install in local Maven repository)
+- `gradlew copyJars` (to copy jar files into a top-level _jar_ directory)
+- `gradlew lineEndingConversion` (to convert line endings of top-level text files to CRLF)
+- `gradlew publish` (to deploy to a Maven repository, as described in the `publishing.repositories.maven` block of
+[build.gradle](https://github.com/css4j/css4j/blob/master/build.gradle))
+
+<br/>
+
+## Usage from a Gradle project
+If your Gradle project depends on css4j-dom4j, you can use this project's own Maven repository in a `repositories` section of
+your build file:
+```groovy
+repositories {
+    maven {
+        url "https://css4j.github.io/maven/"
+        mavenContent {
+            releasesOnly()
+        }
+        content {
+            includeGroup 'io.sf.carte'
+            includeGroup 'io.sf.jclf'
+            includeGroup 'xmlpull'
+            includeGroup 'xpp3'
+        }
+    }
+}
+```
+please use this repository **only** for the artifact groups listed in the `includeGroup` statements.
+
+Then, in your `build.gradle` file:
+```groovy
+dependencies {
+    api "io.sf.carte:css4j-dom4j:${css4jDom4jVersion}"
+}
+```
+where `css4jDom4jVersion` would be defined in a `gradle.properties` file.
+
+<br/>
+
+## Website
+For more information please visit https://css4j.github.io/

RELEASE_NOTES.txt

@@ -0,0 +1,73 @@
+
+                       CSS4J-DOM4J MODULE RELEASE NOTES
+                       ================================
+
+Release 3.6.0 - July 30, 2021
+-----------------------------
+
+Release Highlights
+------------------
+
+* Build improvements.
+
+  The Gradle build is now independent from css4j-dist.
+
+
+Description
+-----------
+ This software contains Java(tm) classes that leverage the DOM4J library to use
+CSS4J. Unless otherwise noted, this software is provided under a BSD-style
+licence (see the LICENSE.txt file).
+
+ This css4j-dom4j module uses documents and elements that extend those of dom4j
+(it is intended for those who are comfortable with dom4j).
+
+
+Java(tm) Runtime Environment requirements
+-----------------------------------------
+ All the classes in the binary package have been compiled with a Java compiler
+set to 1.8 compiler compliance level, except the module-info file.
+
+ Building the library requires JDK 15 or higher, although the resulting jar
+files can be run with a 1.8 JRE.
+
+
+Software dependencies
+=====================
+
+ To build this library you need:
+
+- The css4j artifact (and its transitive dependencies); version 3.6.0 or higher
+  is recommended (compatibility with 4.0 or higher is not guaranteed):
+  https://github.com/css4j/css4j/releases
+
+- The css4j-agent artifact; version 3.6.0 or higher is recommended
+  (compatibility with 4.0 or higher is not guaranteed):
+  https://github.com/css4j/css4j-agent/releases
+  It is optional at runtime.
+
+- The dom4j JAR package (tested with 2.1.1). Requires at least version 2.0 to
+  compile and 2.1.1 to run the tests, but you should be able to run the
+  resulting jar file with dom4j 1.6 if you are stuck with it.
+  URL: https://github.com/dom4j
+
+- The XPP3 Pull Parser (which is supported by this library but beware that it
+  does not support entities). See:
+  https://github.com/xmlpull-xpp3/xmlpull-xpp3
+
+
+ Optional packages (required for tests):
+
+- A recent version of JUnit 4.
+
+- Jaxen (https://github.com/jaxen-xpath/jaxen), this software was tested with
+  version 1.2.0.
+
+- The SLF4J package, which is a logging package. See http://www.slf4j.org/ 
+  for more information.
+
+
+Project Sites
+=============
+Project home: https://css4j.github.io/
+Development site: https://github.com/css4j/css4j-dom4j