From af2c9184a69ad2b3e1de9a41d5d00edda3c65f69 Mon Sep 17 00:00:00 2001 From: Julien Eluard Date: Thu, 2 Feb 2012 13:03:02 -0300 Subject: Removed old documentation. --- .../apt/examples/backward-compatibility.apt.vm | 361 --------------------- .../semantic-versioning-conformance.apt.vm | 300 ----------------- enforcer-rule/src/site/apt/index.apt | 32 -- enforcer-rule/src/site/apt/usage.apt.vm | 138 -------- enforcer-rule/src/site/site.xml | 35 -- 5 files changed, 866 deletions(-) delete mode 100755 enforcer-rule/src/site/apt/examples/backward-compatibility.apt.vm delete mode 100755 enforcer-rule/src/site/apt/examples/semantic-versioning-conformance.apt.vm delete mode 100755 enforcer-rule/src/site/apt/index.apt delete mode 100755 enforcer-rule/src/site/apt/usage.apt.vm delete mode 100755 enforcer-rule/src/site/site.xml (limited to 'enforcer-rule/src/site') diff --git a/enforcer-rule/src/site/apt/examples/backward-compatibility.apt.vm b/enforcer-rule/src/site/apt/examples/backward-compatibility.apt.vm deleted file mode 100755 index 41faf0b..0000000 --- a/enforcer-rule/src/site/apt/examples/backward-compatibility.apt.vm +++ /dev/null @@ -1,361 +0,0 @@ -#* - * This software is licensed under the Apache 2 license, quoted below. - * - * Copyright 2010 Julien Eluard - * - * 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. - *# - -Checking a project's compatibility against older releases - -* Basic example - - In order to check your project's compatibility against an older release, you must add the enforcer rule as a dependency to - the maven-enforcer-plugin and then configure your the maven-enforcer-plugin to run the rule. Rule will succeed if specified compatibility type is compatible with specified one (less permissive compatibility types will be accepted). - - By default current artifact will be checked against most recently released version (retrieved from either local or one of configured remote repositories). Setting dumpDetails to true will output differences to standard output. - ---- - - ... - - ... - - ... - - maven-enforcer-plugin - 1.0-beta-1 - ... - - ... - - ${project.groupId} - ${project.artifactId} - ${project.version} - - ... - - ... - - .... - - check-version - verify - - enforce - - - - - BACKWARD_COMPATIBLE_IMPLEMENTER - true - - - - - ... - - ... - - ... - - ... - - ... - ---- - -* Checking against a specific released version - - You can check your project against a specific released version: - ---- - - ... - - ... - - ... - - maven-enforcer-plugin - 1.0-beta-1 - ... - - ... - - ${project.groupId} - ${project.artifactId} - ${project.version} - - ... - - ... - - .... - - check-version - verify - - enforce - - - - - ... - BACKWARD_COMPATIBLE_IMPLEMENTER - 1.0.0 - ... - - - - - ... - - ... - - ... - - ... - - ... - ---- - -* Including classes - - By default all classes will be considered during checking process. You might want to only check a subset of classes/packages. This is achieved by specifying <<>>. - ---- - - ... - - ... - - ... - - maven-enforcer-plugin - 1.0-beta-1 - ... - - ... - - ${project.groupId} - ${project.artifactId} - ${project.version} - - ... - - ... - - .... - - check-version - verify - - enforce - - - - - ... - BACKWARD_COMPATIBLE_IMPLEMENTER - - org.project.MyClass - - ... - - - - - ... - - ... - - ... - - ... - - ... - ---- - - We can specify multiple classes or packages. For example, to include <<>> class and <<>> package you would use a configuration like: - ---- - - ... - - ... - - ... - - maven-enforcer-plugin - 1.0-beta-1 - ... - - ... - - ${project.groupId} - ${project.artifactId} - ${project.version} - - ... - - ... - - .... - - check-version - verify - - enforce - - - - - ... - BACKWARD_COMPATIBLE_IMPLEMENTER - - org.project.MyClass - org.project.internal - - ... - - - - - ... - - ... - - ... - - ... - - ... - ---- - -* Excluding classes - - You may also want to exclude some classes/packages. For instance internal code might evolve independently from published API. This is achieved by specifying <<>>. - ---- - - ... - - ... - - ... - - maven-enforcer-plugin - 1.0-beta-1 - ... - - ... - - ${project.groupId} - ${project.artifactId} - ${project.version} - - ... - - ... - - .... - - check-version - verify - - enforce - - - - - ... - BACKWARD_COMPATIBLE_IMPLEMENTER - - org.project.MyClass - - ... - - - - - ... - - ... - - ... - - ... - - ... - ---- -* Strict checking against a specific released version - - You can stricly check your project (backward compatibility type MUST match specified one) against a specific released version: - ---- - - ... - - ... - - ... - - maven-enforcer-plugin - 1.0-beta-1 - ... - - ... - - ${project.groupId} - ${project.artifactId} - ${project.version} - - ... - - ... - - .... - - check-version - verify - - enforce - - - - - ... - NON_BACKWARD_COMPATIBLE - true - 1.0.0 - ... - - - - - ... - - ... - - ... - - ... - - ... - ---- \ No newline at end of file diff --git a/enforcer-rule/src/site/apt/examples/semantic-versioning-conformance.apt.vm b/enforcer-rule/src/site/apt/examples/semantic-versioning-conformance.apt.vm deleted file mode 100755 index 0f7bf82..0000000 --- a/enforcer-rule/src/site/apt/examples/semantic-versioning-conformance.apt.vm +++ /dev/null @@ -1,300 +0,0 @@ -#* - * This software is licensed under the Apache 2 license, quoted below. - * - * Copyright 2010 Julien Eluard - * - * 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. - *# - -Checking a project's version against older releases - -* Basic example - - In order to check your project's version against an older release, you must add the enforcer rule as a dependency to - the maven-enforcer-plugin and then configure your the maven-enforcer-plugin to run the rule. - - By default current artifact will be checked against most recently released version (retrieved from either local or one of configured remote repositories). Setting dumpDetails to true will output differences to standard output. - ---- - - ... - - ... - - ... - - maven-enforcer-plugin - 1.0-beta-1 - ... - - ... - - ${project.groupId} - ${project.artifactId} - ${project.version} - - ... - - ... - - .... - - check-version - verify - - enforce - - - - - true - - - - - ... - - ... - - ... - - ... - - ... - ---- - -* Checking against a specific released version - - You can check your project against a specific released version: - ---- - - ... - - ... - - ... - - maven-enforcer-plugin - 1.0-beta-1 - ... - - ... - - ${project.groupId} - ${project.artifactId} - ${project.version} - - ... - - ... - - .... - - check-version - verify - - enforce - - - - - ... - 1.0.0 - ... - - - - - ... - - ... - - ... - - ... - - ... - ---- - -* Including classes - - By default all classes will be considered during checking process. You might want to only check a subset of classes/packages. This is achieved by specifying <<>>. - ---- - - ... - - ... - - ... - - maven-enforcer-plugin - 1.0-beta-1 - ... - - ... - - ${project.groupId} - ${project.artifactId} - ${project.version} - - ... - - ... - - .... - - check-version - verify - - enforce - - - - - ... - - org.project.MyClass - - ... - - - - - ... - - ... - - ... - - ... - - ... - ---- - - We can specify multiple classes or packages. For example, to include <<>> class and <<>> package you would use a configuration like: - ---- - - ... - - ... - - ... - - maven-enforcer-plugin - 1.0-beta-1 - ... - - ... - - ${project.groupId} - ${project.artifactId} - ${project.version} - - ... - - ... - - .... - - check-version - verify - - enforce - - - - - ... - - org.project.MyClass - org.project.internal - - ... - - - - - ... - - ... - - ... - - ... - - ... - ---- - -* Excluding classes - - You may also want to exclude some classes/packages. For instance internal code might evolve independently from published API. This is achieved by specifying <<>>. - ---- - - ... - - ... - - ... - - maven-enforcer-plugin - 1.0-beta-1 - ... - - ... - - ${project.groupId} - ${project.artifactId} - ${project.version} - - ... - - ... - - .... - - check-version - verify - - enforce - - - - - ... - - org.project.MyClass - - ... - - - - - ... - - ... - - ... - - ... - - ... - ---- diff --git a/enforcer-rule/src/site/apt/index.apt b/enforcer-rule/src/site/apt/index.apt deleted file mode 100755 index 2887116..0000000 --- a/enforcer-rule/src/site/apt/index.apt +++ /dev/null @@ -1,32 +0,0 @@ -~~ -~~ This software is licensed under the Apache 2 license, quoted below. -~~ -~~ Copyright 2010 Julien Eluard -~~ -~~ 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. -~~ - -Semantic Versioning Enforcer Rule - - The Semantic Versioning Enforcer Rule is used to check your classes against previously released classes. - Depending on changes your version number will be valid or not according to {{{http://semver.org}semantic versioning}} rules. - -* Rules Overview - - The Semantic Versioning Enforcer Rule has the following rules. - - * {{{./examples/semantic-versioning-conformance.html}requireSemanticVersioningConformance}} checks a project version number against an older release. - - * {{{./examples/backward-compatibility.html}requireBackwardCompatibility}} checks a project artifact against an older release. - - [] diff --git a/enforcer-rule/src/site/apt/usage.apt.vm b/enforcer-rule/src/site/apt/usage.apt.vm deleted file mode 100755 index fc9c196..0000000 --- a/enforcer-rule/src/site/apt/usage.apt.vm +++ /dev/null @@ -1,138 +0,0 @@ -#* - * This software is licensed under the Apache 2 license, quoted below. - * - * Copyright 2010 Julien Eluard - * - * 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. - *# - -Usage - - The enforcer rule offers a rule for checking project's version against a previously released artifact. - -* Basic Usage - -** Checking a project's compatibility - - In order to check your project's compatibility, you must add the enforcer rule as a dependency to - the maven-enforcer-plugin and then configure the maven-enforcer-plugin to run the rule: - ---- - - ... - - ... - - ... - - maven-enforcer-plugin - 1.0-beta-1 - ... - - ... - - ${project.groupId} - ${project.artifactId} - ${project.version} - - ... - - ... - - .... - - check - verify - - enforce - - - - - BACKWARD_COMPATIBLE_IMPLEMENTER - - - - - ... - - ... - - ... - - ... - - ... - ---- - - Once you have configured your project, maven-enforcer will be able to throw a build error if current version is not backward compatible with last released one. - - Some more detailed {{{./examples/backward-compatibility.html}examples}} of the <<>> rule. - - -** Checking a project's version - - In order to check your project's version, you must add the enforcer rule as a dependency to - the maven-enforcer-plugin and then configure the maven-enforcer-plugin to run the rule: - ---- - - ... - - ... - - ... - - maven-enforcer-plugin - 1.0-beta-1 - ... - - ... - - ${project.groupId} - ${project.artifactId} - ${project.version} - - ... - - ... - - .... - - check - verify - - enforce - - - - - - - - ... - - ... - - ... - - ... - - ... - ---- - - Once you have configured your project, maven-enforcer will be able to throw a build error if current version follows semantic versioning principles. - - Some more detailed {{{./examples/semantic-versioning-conformance.html}examples}} of the <<>> rule. diff --git a/enforcer-rule/src/site/site.xml b/enforcer-rule/src/site/site.xml deleted file mode 100755 index d8d264e..0000000 --- a/enforcer-rule/src/site/site.xml +++ /dev/null @@ -1,35 +0,0 @@ - - - - - - - - - - - - - - - - - -- cgit v1.2.3