2019-06-07 23:28:03 +00:00
|
|
|
<?xml version="1.0" encoding="UTF-8"?>
|
2023-03-15 21:52:13 +00:00
|
|
|
|
|
|
|
<!--
|
|
|
|
SPDX-FileCopyrightText: 2019 The CC: Tweaked Developers
|
|
|
|
|
|
|
|
SPDX-License-Identifier: MPL-2.0
|
|
|
|
-->
|
|
|
|
|
2019-06-07 23:28:03 +00:00
|
|
|
<!DOCTYPE suppressions PUBLIC
|
|
|
|
"-//Checkstyle//DTD SuppressionFilter Configuration 1.2//EN"
|
|
|
|
"https://checkstyle.org/dtds/suppressions_1_2.dtd">
|
|
|
|
<suppressions>
|
|
|
|
<!-- All the config options and method fields. -->
|
|
|
|
<suppress checks="StaticVariableName" files=".*[\\/]ComputerCraft.java" />
|
|
|
|
<suppress checks="StaticVariableName" files=".*[\\/]ComputerCraftAPI.java" />
|
2019-10-27 15:16:47 +00:00
|
|
|
|
Generate documentation stubs from Javadocs
illuaminate does not handle Java files, for obvious reasons. In order to
get around that, we have a series of stub files within /doc/stub which
mirrored the Java ones. While this works, it has a few problems:
- The link to source code does not work - it just links to the stub
file.
- There's no guarantee that documentation remains consistent with the
Java code. This change found several methods which were incorrectly
documented beforehand.
We now replace this with a custom Java doclet[1], which extracts doc
comments from @LuaFunction annotated methods and generates stub-files
from them. These also contain a @source annotation, which allows us to
correctly link them back to the original Java code.
There's some issues with this which have yet to be fixed. However, I
don't think any of them are major blockers right now:
- The custom doclet relies on Java 9 - I think it's /technically/
possible to do this on Java 8, but the API is significantly uglier.
This means that we need to run javadoc on a separate JVM.
This is possible, and it works locally and on CI, but is definitely
not a nice approach.
- illuaminate now requires the doc stubs to be generated in order for
the linter to pass, which does make running the linter locally much
harder (especially given the above bullet point).
We could notionally include the generated stubs (or at least a cut
down version of them) in the repo, but I'm not 100% sure about that.
[1]: https://docs.oracle.com/javase/9/docs/api/jdk/javadoc/doclet/package-summary.html
2020-07-03 12:31:26 +00:00
|
|
|
<!-- The commands API is documented in Lua. -->
|
|
|
|
<suppress checks="SummaryJavadocCheck" files=".*[\\/]CommandAPI.java" />
|
2023-10-03 08:19:19 +00:00
|
|
|
|
|
|
|
<!-- Allow putting files in other packages if they look like our TeaVM stubs. -->
|
|
|
|
<suppress checks="PackageName" files=".*[\\/]T[A-Za-z]+.java" />
|
|
|
|
|
|
|
|
<!-- Allow underscores in our test classes. -->
|
Rewrite computer selectors
This adds support for computer selectors, in the style of entity
selectors. The long-term goal here is to replace our existing ad-hoc
selectors. However, to aid migration, we currently support both - the
previous one will most likely be removed in MC 1.21.
Computer selectors take the form @c[<key>=<value>,...]. Currently we
support filtering by id, instance id, label, family (as before) and
distance from the player (new!). The code also supports computers within
a bounding box, but there's no parsing support for that yet.
This commit also (finally) documents the /computercraft command. Well,
sort of - it's definitely not my best word, but I couldn't find better
words.
2024-03-12 20:12:13 +00:00
|
|
|
<suppress checks="MethodName" files=".*(Contract|Test).java" />
|
2019-06-07 23:28:03 +00:00
|
|
|
</suppressions>
|