Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Fix javadoc errors and warnings #475

Closed
Siedlerchr opened this issue Dec 6, 2020 · 6 comments · Fixed by JabRef/jabref#9701 or JabRef/jabref#9986
Closed

Fix javadoc errors and warnings #475

Siedlerchr opened this issue Dec 6, 2020 · 6 comments · Fixed by JabRef/jabref#9701 or JabRef/jabref#9986
Labels
code quality good first issue needs-refinement Issue description is not complete; needs to be refined

Comments

@Siedlerchr
Copy link
Collaborator

Excerpt from the javadoc generation:

/Users/christophs/workspace/jabref/src/main/java/org/jabref/migrations/MergeReviewIntoCommentMigration.java:15: warning: no comment
public class MergeReviewIntoCommentMigration {
       ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/migrations/PreferencesMigrations.java:29: warning: no comment
public class PreferencesMigrations {
       ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/migrations/PostOpenMigration.java:5: warning: no comment
public interface PostOpenMigration {
       ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/preferences/ExportComparator.java:6: warning: no comment
public class ExportComparator implements Comparator<List<String>> {
       ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/preferences/SearchPreferences.java:5: warning: no comment
public class SearchPreferences {
       ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/preferences/AppearancePreferences.java:5: warning: no comment
public class AppearancePreferences {
       ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/preferences/ExternalApplicationsPreferences.java:3: warning: no comment
public class ExternalApplicationsPreferences {
       ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/preferences/JabRefPreferences.java:111: warning: no comment
public class JabRefPreferences implements PreferencesService {
       ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/preferences/FilePreferences.java:8: warning: no comment
public class FilePreferences {
       ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/preferences/LastFocusedTabPreferences.java:6: warning: no comment
public class LastFocusedTabPreferences {
       ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/preferences/JabRefPreferencesFilter.java:10: warning: no comment
public class JabRefPreferencesFilter {
       ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/preferences/JabRefPreferencesFilter.java:38: warning: no comment
    public static class PreferenceOption implements Comparable<PreferenceOption> {
                  ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/preferences/JabRefPreferencesFilter.java:34: warning: no comment
    public enum PreferenceType {
           ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/preferences/ImportExportPreferences.java:3: warning: no comment
public class ImportExportPreferences {
       ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/preferences/GeneralPreferences.java:7: warning: no comment
public class GeneralPreferences {
       ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/preferences/PreferencesService.java:48: warning: no comment
public interface PreferencesService {
       ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/preferences/PreviewPreferences.java:10: warning: no comment
public class PreviewPreferences {
       ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/preferences/PreviewPreferences.java:68: warning: no comment
    public static class Builder {
                  ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/preferences/VersionPreferences.java:5: warning: no comment
public class VersionPreferences {
       ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/logic/database/DatabaseMerger.java:23: warning: no comment
public class DatabaseMerger {
       ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/logic/preferences/TimestampPreferences.java:8: warning: no comment
public class TimestampPreferences {
       ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/logic/preferences/OwnerPreferences.java:3: warning: no comment
public class OwnerPreferences {
       ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/logic/l10n/LocalizationKeyParams.java:7: warning: no comment
public class LocalizationKeyParams {
       ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/logic/l10n/LocalizationKey.java:5: warning: no comment
public class LocalizationKey {
       ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/logic/l10n/Encodings.java:7: warning: no comment
public class Encodings {
       ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/logic/l10n/Localization.java:22: error: reference not found
 * serves as key inside the {@link l10n} properties files that hold the translation for many languages. When a message
                                   ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/logic/l10n/LocalizationLocator.java:7: warning: no comment
public class LocalizationLocator implements ResourceLocator {
       ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/logic/net/ProxyRegisterer.java:3: warning: no comment
public class ProxyRegisterer {
       ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/logic/net/ProxyAuthenticator.java:7: warning: no comment
public class ProxyAuthenticator extends Authenticator {
       ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/logic/net/ProxyPreferences.java:5: warning: no comment
public class ProxyPreferences {
       ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/logic/importer/OutputPrinter.java:3: warning: no comment
public interface OutputPrinter {
       ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/logic/importer/ImportFormatPreferences.java:11: warning: no comment
public class ImportFormatPreferences {
       ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/logic/importer/util/IdentifierParser.java:15: warning: no comment
public class IdentifierParser {
       ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/logic/importer/util/FileFieldParser.java:11: warning: no comment
public class FileFieldParser {
       ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/logic/importer/util/ShortDOIServiceException.java:5: warning: no comment
public class ShortDOIServiceException extends JabRefException {
       ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/logic/JabRefException.java:6: warning: no comment
public class JabRefException extends Exception {
       ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/logic/importer/util/MetaDataParser.java:30: warning: no comment
public class MetaDataParser {
       ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/logic/importer/util/GrobidService.java:22: warning: no comment
    public enum ConsolidateCitations {
           ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/logic/importer/AuthorListParser.java:16: warning: no comment
public class AuthorListParser {
       ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/logic/importer/PagedSearchBasedFetcher.java:12: warning: no comment
public interface PagedSearchBasedFetcher extends SearchBasedFetcher {
       ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/logic/importer/ImportException.java:5: warning: no comment
public class ImportException extends JabRefException {
       ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/logic/importer/fileformat/PdfContentImporter.java:41: warning: empty <p> tag
 * <p>
   ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/logic/importer/fileformat/GvkParser.java:29: warning: no comment
public class GvkParser implements Parser {
       ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/logic/importer/fileformat/RepecNepImporter.java:26: warning: empty <p> tag
 * <p>
   ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/logic/importer/fileformat/RepecNepImporter.java:32: error: unexpected end tag: </p>
 * At the time of writing RePEc holds over 300.000 items.</p>
                                                         ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/logic/importer/fileformat/RepecNepImporter.java:33: warning: empty <p> tag
 * <p>
   ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/logic/importer/fileformat/RepecNepImporter.java:38: warning: empty <p> tag
 * <p>
   ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/logic/importer/fileformat/RepecNepImporter.java:40: warning: empty <p> tag
 * <p>
   ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/logic/importer/fileformat/RepecNepImporter.java:139: error: unexpected end tag: </p>
 * </p>
   ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/logic/importer/fileformat/IsiImporter.java:32: warning: empty <p> tag
 * <p>
   ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/logic/importer/fileformat/IsiImporter.java:36: warning: empty <p> tag
 * <p>
   ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/logic/importer/fileformat/EndnoteImporter.java:30: error: semicolon missing
 * http://libguides.csuchico.edu/c.php?g=414245&p=2822898
                                               ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/logic/importer/fileformat/CoinsParser.java:22: error: unknown tag: implNote
 * @implNote implemented by reverse-engineering <a href="https://github.com/SeerLabs/CiteSeerX/blob/4df28a98083be2829ec4c56ebbac09eb7772d379/src/java/edu/psu/citeseerx/domain/BiblioTransformer.java#L155-L249">the implementation by CiteSeerX</a>
   ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/logic/importer/fileformat/RisImporter.java:31: warning: no comment
public class RisImporter extends Importer {
       ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/logic/importer/fetcher/DOAJFetcher.java:35: error: unknown tag: implNote
 * @implNote <a href="https://doaj.org/api/v1/docs">API documentation</a>
   ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/logic/importer/fetcher/DiVA.java:22: warning: no comment
public class DiVA implements IdBasedParserFetcher {
       ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/logic/importer/fetcher/TitleFetcher.java:14: warning: no comment
public class TitleFetcher implements IdBasedFetcher {
       ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/logic/importer/fetcher/GrobidCitationFetcher.java:22: warning: no comment
public class GrobidCitationFetcher implements SearchBasedFetcher {
       ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/logic/importer/fetcher/OpenAccessDoi.java:24: error: unknown tag: implSpec
 * @implSpec API is documented at http://unpaywall.org/api/v2
   ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/logic/importer/fetcher/ACMPortalFetcher.java:19: warning: no comment
public class ACMPortalFetcher implements SearchBasedParserFetcher {
       ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/logic/importer/fetcher/DoiFetcher.java:36: warning: no comment
public class DoiFetcher implements IdBasedFetcher, EntryBasedFetcher {
       ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/logic/importer/fetcher/AbstractIsbnFetcher.java:15: warning: no comment
public abstract class AbstractIsbnFetcher implements IdBasedParserFetcher {
                ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/logic/importer/fetcher/IEEE.java:39: error: bad HTML entity
 * Will first look for URLs of the type https://ieeexplore.ieee.org/stamp/stamp.jsp?[tp=&]arnumber=...
                                                                                        ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/logic/importer/fetcher/IEEE.java:42: error: unknown tag: implNote
 * @implNote <a href="https://developer.ieee.org/docs">API documentation</a>
   ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/logic/importer/fetcher/ComplexSearchQuery.java:14: warning: no comment
public class ComplexSearchQuery {
       ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/logic/importer/fetcher/ComplexSearchQuery.java:149: warning: no comment
    public static class ComplexSearchQueryBuilder {
                  ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/logic/importer/fetcher/GvkFetcher.java:22: warning: no comment
public class GvkFetcher implements SearchBasedParserFetcher {
       ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/logic/importer/fetcher/CiteSeer.java:31: warning: no comment
public class CiteSeer implements SearchBasedParserFetcher {
       ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/logic/importer/fetcher/TrustLevel.java:3: warning: no comment
public enum TrustLevel {
       ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/logic/importer/fetcher/IacrEprintFetcher.java:34: warning: no comment
public class IacrEprintFetcher implements IdBasedFetcher {
       ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/logic/importer/fetcher/RfcFetcher.java:23: warning: no comment
public class RfcFetcher implements IdBasedParserFetcher {
       ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/logic/importer/fetcher/CompositeSearchBasedFetcher.java:19: warning: no comment
public class CompositeSearchBasedFetcher implements SearchBasedFetcher {
       ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/logic/importer/fetcher/CollectionOfComputerScienceBibliographiesFetcher.java:25: warning: no comment
public class CollectionOfComputerScienceBibliographiesFetcher implements SearchBasedParserFetcher {
       ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/logic/importer/fetcher/SpringerFetcher.java:34: error: unknown tag: implNote
 * @implNote see <a href="https://dev.springernature.com/">API documentation</a> for more details
   ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/logic/importer/fetcher/CollectionOfComputerScienceBibliographiesParser.java:20: warning: no comment
public class CollectionOfComputerScienceBibliographiesParser implements Parser {
       ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/logic/importer/fetcher/ArXiv.java:54: error: attribute not supported in HTML5: herf
 * <a herf="https://gitlab.c3sl.ufpr.br/portalmec/dspace-portalmec/blob/aa209d15082a9870f9daac42c78a35490ce77b52/dspace-api/src/main/java/org/dspace/submit/lookup/ArXivService.java">dspace-portalmec</a>
      ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/logic/importer/ParseException.java:3: warning: no comment
public class ParseException extends Exception {
       ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/logic/importer/WebFetchers.java:49: warning: no comment
public class WebFetchers {
       ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/logic/importer/FetcherException.java:5: warning: no comment
public class FetcherException extends JabRefException {
       ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/logic/importer/ImportFormatReader.java:36: warning: no comment
public class ImportFormatReader {
       ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/logic/importer/ImportFormatReader.java:232: warning: no comment
    public interface CheckedFunction<T, R> {
           ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/logic/importer/ImportFormatReader.java:146: warning: no comment
    public static class UnknownFormatImport {
                  ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/logic/importer/ParserResult.java:21: warning: no comment
public class ParserResult {
       ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/logic/importer/PagedSearchBasedParserFetcher.java:14: warning: no comment
public interface PagedSearchBasedParserFetcher extends SearchBasedParserFetcher, PagedSearchBasedFetcher {
       ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/logic/importer/ImportCleanup.java:10: warning: no comment
public class ImportCleanup {
       ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/logic/importer/OpenDatabase.java:21: warning: no comment
public class OpenDatabase {
       ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/logic/importer/FetcherResult.java:7: warning: no comment
public final class FetcherResult {
             ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/logic/util/BuildInfo.java:11: warning: no comment
public final class BuildInfo {
             ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/logic/util/strings/UnicodeLigaturesMap.java:5: warning: no comment
public class UnicodeLigaturesMap extends HashMap<String, String> {
       ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/logic/util/strings/RtfCharMap.java:5: warning: no comment
public class RtfCharMap {
       ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/logic/util/strings/StringLengthComparator.java:5: warning: no comment
public class StringLengthComparator implements Comparator<String> {
       ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/logic/util/strings/StringSimilarity.java:7: warning: no comment
public class StringSimilarity {
       ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/logic/util/strings/HTMLUnicodeConversionMaps.java:6: warning: no comment
public class HTMLUnicodeConversionMaps {
       ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/logic/util/strings/XmlCharsMap.java:5: warning: no comment
public class XmlCharsMap extends HashMap<String, String> {
       ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/logic/util/strings/StringManipulator.java:8: warning: no comment
public class StringManipulator {
       ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/logic/util/ExternalLinkCreator.java:11: warning: no comment
public class ExternalLinkCreator {
       ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/logic/util/io/AutoLinkPreferences.java:3: warning: no comment
public class AutoLinkPreferences {
       ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/logic/util/io/AutoLinkPreferences.java:5: warning: no comment
    public enum CitationKeyDependency {
           ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/logic/util/io/FileUtil.java:33: warning: no comment
public class FileUtil {
       ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/logic/util/io/FileHistory.java:9: warning: no comment
public class FileHistory {
       ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/logic/util/io/FileNameUniqueness.java:7: warning: no comment
public class FileNameUniqueness {
       ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/logic/util/io/FileFinder.java:9: warning: no comment
public interface FileFinder {
       ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/logic/util/io/FileFinders.java:3: warning: no comment
public class FileFinders {
       ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/logic/util/StandardFileType.java:9: error: unknown tag: implNote
 * @implNote Enter the extensions in lowercase without a dot! The dot is added implicitly.
   ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/logic/util/UpdateField.java:15: warning: no comment
public class UpdateField {
       ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/logic/util/TestEntry.java:9: warning: no comment
public class TestEntry {
       ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/logic/util/UnknownFileType.java:9: warning: no comment
public class UnknownFileType implements FileType {
       ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/logic/util/Version.java:255: warning: no comment
    public enum DevelopmentStage {
           ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/logic/util/DelayTaskThrottler.java:18: error: @param name not found
 * @param <T>
           ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/logic/util/DelayTaskThrottler.java:18: warning: no description for @param
 * @param <T>
   ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/logic/util/DelayTaskThrottler.java:20: error: unknown tag: implNote
 * @implNote Once {@link #schedule(Runnable)} is called, the task is delayed for a given time span.
   ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/logic/layout/Layout.java:15: warning: no comment
public class Layout {
       ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/logic/layout/format/EntryTypeFormatter.java:12: warning: no comment
public class EntryTypeFormatter implements LayoutFormatter {
       ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/logic/layout/format/Iso690FormatDate.java:6: warning: no comment
public class Iso690FormatDate implements LayoutFormatter {
       ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/logic/layout/format/AuthorAndsCommaReplacer.java:6: error: bad HTML entity
 * Replaces and's for & (in case of two authors) and , (in case of more than two authors).
                      ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/logic/layout/format/Replace.java:24: error: bad HTML entity
 *  \format[Replace(and,&)]{\author} :
                        ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/logic/layout/format/Replace.java:26: error: bad HTML entity
 *      by "&"
            ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/logic/layout/format/RemoveBrackets.java:8: error: unknown tag: example
 * <example>
   ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/logic/layout/format/RemoveBrackets.java:10: error: unknown tag: example
 * </example>
   ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/logic/layout/format/AuthorAndsReplacer.java:6: error: bad HTML entity
 * Replaces and's for & (in case of two authors) and ; (in case
                      ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/logic/layout/format/WrapFileLinks.java:20: error: self-closing element not allowed
 * <p/>
   ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/logic/layout/format/WrapFileLinks.java:25: error: self-closing element not allowed
 * <p/>
   ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/logic/layout/format/WrapFileLinks.java:31: error: self-closing element not allowed
 * <p/>
   ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/logic/layout/format/WrapFileLinks.java:32: error: self-closing element not allowed
 * <p/>
   ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/logic/layout/format/WrapFileLinks.java:33: error: self-closing element not allowed
 * <p/>
   ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/logic/layout/format/WrapFileLinks.java:35: error: self-closing element not allowed
 * <p/>
   ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/logic/layout/format/WrapFileLinks.java:44: error: self-closing element not allowed
 * <p/>
   ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/logic/layout/format/WrapFileLinks.java:47: error: self-closing element not allowed
 * <p/>
   ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/logic/layout/format/WrapFileLinks.java:49: error: self-closing element not allowed
 * <p/>
   ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/logic/layout/format/WrapFileLinks.java:51: error: self-closing element not allowed
 * <p/>
   ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/logic/layout/format/WrapFileLinks.java:54: error: self-closing element not allowed
 * <p/>
   ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/logic/layout/format/WrapFileLinks.java:59: error: self-closing element not allowed
 * <p/>
   ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/logic/layout/format/WrapFileLinks.java:63: error: self-closing element not allowed
 * <p/>
   ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/logic/layout/format/WrapFileLinks.java:66: error: self-closing element not allowed
 * <p/>
   ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/logic/layout/format/WrapFileLinks.java:71: error: self-closing element not allowed
 * <p/>
   ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/logic/formatter/bibtexfields/LatexCleanupFormatter.java:9: error: no tag name after @
 * Simplifies LaTeX syntax. {@see org.jabref.logic.layout.format.RemoveLatexCommandsFormatter} for a formatter removing LaTeX commands completely.
                            ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/logic/citationstyle/CSLAdapter.java:30: error: unknown tag: apiNote
 * @apiNote The first call to {@link #makeBibliography} is expensive since the
   ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/logic/citationstyle/CSLAdapter.java:34: error: unknown tag: implNote
 * @implNote The main function {@link #makeBibliography} will enforce
   ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/logic/remote/server/RemoteListenerServerLifecycle.java:13: error: self-closing element not allowed
 * <p/>
   ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/logic/remote/server/RemoteListenerServerLifecycle.java:16: error: self-closing element not allowed
 * <p/>
   ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/logic/remote/shared/Protocol.java:14: error: unknown tag: implNote
 * @implNote The first byte of every message identifies its type as a {@link RemoteMessage}.
   ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/gui/fieldeditors/TextInputControlBehavior.java:31: error: reference not found
 * This class contains some code taken from {@link com.sun.javafx.scene.control.behavior.TextInputControlBehavior},
                                                   ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/gui/util/OptionalObjectProperty.java:12: error: reference not found
 * Similar to {@link com.tobiasdiez.easybind.monadic.MonadicObservableValue}
                     ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/gui/util/RecursiveTreeItem.java:19: error: unknown tag: implNote
 * @implNote Taken from https://gist.github.com/lestard/011e9ed4433f9eb791a8
   ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/gui/util/RecursiveTreeItem.java:20: error: unknown tag: implNote
 * @implNote As CheckBoxTreeItem extends TreeItem, this class will work for both.
   ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/gui/util/ViewModelTreeCellFactory.java:21: error: @param name not found
 * @param <S> view model
           ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/gui/autocompleter/AutoCompletionTextInputBinding.java:42: error: reference not found
 * This class is a slightly modified version of {@link impl.org.controlsfx.autocompletion.AutoCompletionTextFieldBinding}
                                                       ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/gui/icon/JabRefMaterialDesignIcon.java:9: error: unknown tag: implNote
 * @implNote The glyphs of the ttf (speak: the icons) were created with Illustrator and a template from the material design icons
   ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/gui/help/ErrorConsoleAction.java:10: error: self-closing element not allowed
 * <p/>
   ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/model/entry/IdGenerator.java:7: error: self-closing element not allowed
 * <p/>
   ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/logic/formatter/bibtexfields/NormalizePagesFormatter.java:46: error: unknown tag: example
     * <example>
       ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/logic/formatter/bibtexfields/NormalizePagesFormatter.java:52: error: unknown tag: example
     * </example>
       ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/logic/formatter/bibtexfields/OrdinalsToSuperscriptFormatter.java:35: error: unknown tag: example
     * <example>
       ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/logic/formatter/bibtexfields/OrdinalsToSuperscriptFormatter.java:37: error: unknown tag: example
     * </example>
       ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/logic/citationstyle/CitationStyleGenerator.java:29: error: unknown tag: implNote
     * @implNote the citation is generated using JavaScript which may take some time, better call it from outside the main Thread
       ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/logic/citationstyle/CitationStyleGenerator.java:38: error: unknown tag: implNote
     * @implNote the citation is generated using JavaScript which may take some time, better call it from outside the main Thread
       ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/logic/citationstyle/CitationStyleGenerator.java:47: error: unknown tag: implNote
     * @implNote the citation is generated using JavaScript which may take some time, better call it from outside the main Thread
       ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/logic/citationstyle/CitationStyleGenerator.java:56: error: unknown tag: implNote
     * @implNote The citations are generated using JavaScript which may take some time, better call it from outside the main thread.
       ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/logic/bibtex/comparator/MetaDataDiff.java:33: error: unknown tag: implNote
     * @implNote Should be kept in sync with {@link MetaData#equals(Object)}
       ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/model/entry/BibEntry.java:316: error: unknown tag: emph
     * Sets this entry's identifier (ID). It is used internally  to distinguish different BibTeX entries. It is <emph>not</emph> the citation key. The BibTexKey is the {@link InternalField#KEY_FIELD}.
                                                                                                                ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/model/entry/BibEntry.java:316: error: unknown tag: emph
     * Sets this entry's identifier (ID). It is used internally  to distinguish different BibTeX entries. It is <emph>not</emph> the citation key. The BibTexKey is the {@link InternalField#KEY_FIELD}.
                                                                                                                         ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/model/entry/BibEntry.java:333: error: unknown tag: emph
     * Sets the citation key. Note: This is <emph>not</emph> the internal Id of this entry.
                                            ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/model/entry/BibEntry.java:333: error: unknown tag: emph
     * Sets the citation key. Note: This is <emph>not</emph> the internal Id of this entry.
                                                     ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/model/entry/BibEntry.java:504: error: malformed HTML
     * The following aliases are considered (old bibtex <-> new biblatex) based
                                                        ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/model/entry/BibEntry.java:506: error: malformed HTML
     * address        <-> location <br>
                      ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/model/entry/BibEntry.java:507: error: malformed HTML
     * annote         <-> annotation <br>
                      ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/model/entry/BibEntry.java:508: error: malformed HTML
     * archiveprefix  <-> eprinttype <br>
                      ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/model/entry/BibEntry.java:509: error: malformed HTML
     * journal        <-> journaltitle <br>
                      ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/model/entry/BibEntry.java:510: error: malformed HTML
     * key            <-> sortkey <br>
                      ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/model/entry/BibEntry.java:511: error: malformed HTML
     * pdf            <-> file <br>
                      ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/model/entry/BibEntry.java:512: error: malformed HTML
     * primaryclass   <-> eprintclass <br>
                      ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/model/entry/BibEntry.java:513: error: malformed HTML
     * school         <-> institution <br>
                      ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/model/entry/BibEntry.java:645: error: bad HTML entity
     * This returns a canonical BibTeX serialization. Special characters such as "{" or "&" are NOT escaped, but written
                                                                                         ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/model/entry/CanonicalBibEntry.java:24: error: bad HTML entity
     *     <li>Special characters such as "{" or "&" are NOT escaped, but written as</li>
                                                  ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/gui/SidePaneComponent.java:133: error: unknown tag: implNote
     * @implNote The {@link SidePaneManager} always creates an instance of every side component (e.g., to get the toggle action)
       ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/logic/importer/fetcher/DOAJFetcher.java:157: error: unknown tag: implNote
     * @implNote slightly altered version based on https://gist.github.com/enginer/230e2dc2f1d213a825d5
       ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/gui/fieldeditors/TextInputControlBehavior.java:96: error: unknown tag: implNote
     * @implNote taken from {@link com.sun.javafx.scene.control.behavior.TextFieldBehavior#contextMenuRequested(javafx.scene.input.ContextMenuEvent)}
       ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/gui/fieldeditors/TextInputControlBehavior.java:96: error: reference not found
     * @implNote taken from {@link com.sun.javafx.scene.control.behavior.TextFieldBehavior#contextMenuRequested(javafx.scene.input.ContextMenuEvent)}
                                   ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/gui/fieldeditors/TextInputControlBehavior.java:152: error: unknown tag: implNote
     * @implNote taken from {@link com.sun.javafx.scene.control.behavior.TextAreaBehavior#contextMenuRequested(javafx.scene.input.ContextMenuEvent)}
       ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/gui/fieldeditors/TextInputControlBehavior.java:152: error: reference not found
     * @implNote taken from {@link com.sun.javafx.scene.control.behavior.TextAreaBehavior#contextMenuRequested(javafx.scene.input.ContextMenuEvent)}
                                   ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/gui/fieldeditors/URLUtil.java:24: error: unknown tag: example
     * <example>
       ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/gui/fieldeditors/URLUtil.java:26: error: semicolon missing
     *  https://www.google.de/url?sa=t&rct=j&q=&esrc=s&source=web&cd=1&cad=rja&uact=8&&url=http%3A%2F%2Fwww.inrg.csie.ntu.edu.tw%2Falgorithm2014%2Fhomework%2FWagner-74.pdf&ei=DifeVYHkDYWqU5W0j6gD&usg=AFQjCNFl638rl5KVta1jIMWLyb4CPSZidg&sig2=0hSSMw9XZXL3HJWwEcJtOg
                                      ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/gui/fieldeditors/URLUtil.java:26: error: semicolon missing
     *  https://www.google.de/url?sa=t&rct=j&q=&esrc=s&source=web&cd=1&cad=rja&uact=8&&url=http%3A%2F%2Fwww.inrg.csie.ntu.edu.tw%2Falgorithm2014%2Fhomework%2FWagner-74.pdf&ei=DifeVYHkDYWqU5W0j6gD&usg=AFQjCNFl638rl5KVta1jIMWLyb4CPSZidg&sig2=0hSSMw9XZXL3HJWwEcJtOg
                                            ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/gui/fieldeditors/URLUtil.java:26: error: semicolon missing
     *  https://www.google.de/url?sa=t&rct=j&q=&esrc=s&source=web&cd=1&cad=rja&uact=8&&url=http%3A%2F%2Fwww.inrg.csie.ntu.edu.tw%2Falgorithm2014%2Fhomework%2FWagner-74.pdf&ei=DifeVYHkDYWqU5W0j6gD&usg=AFQjCNFl638rl5KVta1jIMWLyb4CPSZidg&sig2=0hSSMw9XZXL3HJWwEcJtOg
                                               ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/gui/fieldeditors/URLUtil.java:26: error: semicolon missing
     *  https://www.google.de/url?sa=t&rct=j&q=&esrc=s&source=web&cd=1&cad=rja&uact=8&&url=http%3A%2F%2Fwww.inrg.csie.ntu.edu.tw%2Falgorithm2014%2Fhomework%2FWagner-74.pdf&ei=DifeVYHkDYWqU5W0j6gD&usg=AFQjCNFl638rl5KVta1jIMWLyb4CPSZidg&sig2=0hSSMw9XZXL3HJWwEcJtOg
                                                      ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/gui/fieldeditors/URLUtil.java:26: error: semicolon missing
     *  https://www.google.de/url?sa=t&rct=j&q=&esrc=s&source=web&cd=1&cad=rja&uact=8&&url=http%3A%2F%2Fwww.inrg.csie.ntu.edu.tw%2Falgorithm2014%2Fhomework%2FWagner-74.pdf&ei=DifeVYHkDYWqU5W0j6gD&usg=AFQjCNFl638rl5KVta1jIMWLyb4CPSZidg&sig2=0hSSMw9XZXL3HJWwEcJtOg
                                                                 ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/gui/fieldeditors/URLUtil.java:26: error: semicolon missing
     *  https://www.google.de/url?sa=t&rct=j&q=&esrc=s&source=web&cd=1&cad=rja&uact=8&&url=http%3A%2F%2Fwww.inrg.csie.ntu.edu.tw%2Falgorithm2014%2Fhomework%2FWagner-74.pdf&ei=DifeVYHkDYWqU5W0j6gD&usg=AFQjCNFl638rl5KVta1jIMWLyb4CPSZidg&sig2=0hSSMw9XZXL3HJWwEcJtOg
                                                                      ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/gui/fieldeditors/URLUtil.java:26: error: semicolon missing
     *  https://www.google.de/url?sa=t&rct=j&q=&esrc=s&source=web&cd=1&cad=rja&uact=8&&url=http%3A%2F%2Fwww.inrg.csie.ntu.edu.tw%2Falgorithm2014%2Fhomework%2FWagner-74.pdf&ei=DifeVYHkDYWqU5W0j6gD&usg=AFQjCNFl638rl5KVta1jIMWLyb4CPSZidg&sig2=0hSSMw9XZXL3HJWwEcJtOg
                                                                              ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/gui/fieldeditors/URLUtil.java:26: error: bad HTML entity
     *  https://www.google.de/url?sa=t&rct=j&q=&esrc=s&source=web&cd=1&cad=rja&uact=8&&url=http%3A%2F%2Fwww.inrg.csie.ntu.edu.tw%2Falgorithm2014%2Fhomework%2FWagner-74.pdf&ei=DifeVYHkDYWqU5W0j6gD&usg=AFQjCNFl638rl5KVta1jIMWLyb4CPSZidg&sig2=0hSSMw9XZXL3HJWwEcJtOg
                                                                                     ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/gui/fieldeditors/URLUtil.java:26: error: semicolon missing
     *  https://www.google.de/url?sa=t&rct=j&q=&esrc=s&source=web&cd=1&cad=rja&uact=8&&url=http%3A%2F%2Fwww.inrg.csie.ntu.edu.tw%2Falgorithm2014%2Fhomework%2FWagner-74.pdf&ei=DifeVYHkDYWqU5W0j6gD&usg=AFQjCNFl638rl5KVta1jIMWLyb4CPSZidg&sig2=0hSSMw9XZXL3HJWwEcJtOg
                                                                                      ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/gui/fieldeditors/URLUtil.java:26: error: semicolon missing
     *  https://www.google.de/url?sa=t&rct=j&q=&esrc=s&source=web&cd=1&cad=rja&uact=8&&url=http%3A%2F%2Fwww.inrg.csie.ntu.edu.tw%2Falgorithm2014%2Fhomework%2FWagner-74.pdf&ei=DifeVYHkDYWqU5W0j6gD&usg=AFQjCNFl638rl5KVta1jIMWLyb4CPSZidg&sig2=0hSSMw9XZXL3HJWwEcJtOg
                                                                                                                                                                           ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/gui/fieldeditors/URLUtil.java:26: error: semicolon missing
     *  https://www.google.de/url?sa=t&rct=j&q=&esrc=s&source=web&cd=1&cad=rja&uact=8&&url=http%3A%2F%2Fwww.inrg.csie.ntu.edu.tw%2Falgorithm2014%2Fhomework%2FWagner-74.pdf&ei=DifeVYHkDYWqU5W0j6gD&usg=AFQjCNFl638rl5KVta1jIMWLyb4CPSZidg&sig2=0hSSMw9XZXL3HJWwEcJtOg
                                                                                                                                                                                                   ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/gui/fieldeditors/URLUtil.java:26: error: semicolon missing
     *  https://www.google.de/url?sa=t&rct=j&q=&esrc=s&source=web&cd=1&cad=rja&uact=8&&url=http%3A%2F%2Fwww.inrg.csie.ntu.edu.tw%2Falgorithm2014%2Fhomework%2FWagner-74.pdf&ei=DifeVYHkDYWqU5W0j6gD&usg=AFQjCNFl638rl5KVta1jIMWLyb4CPSZidg&sig2=0hSSMw9XZXL3HJWwEcJtOg
                                                                                                                                                                                                                                          ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/gui/fieldeditors/URLUtil.java:27: error: unknown tag: example
     * </example>
       ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/gui/fieldeditors/URLUtil.java:74: error: unknown tag: c
     * @return true if <c>url</c> contains a valid URL
                       ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/gui/fieldeditors/URLUtil.java:74: error: unknown tag: c
     * @return true if <c>url</c> contains a valid URL
                             ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/logic/importer/fileformat/IsiImporter.java:364: error: semicolon missing
     * Fixed bug from: http://sourceforge.net/tracker/index.php?func=detail&aid=1542552&group_id=92314&atid=600306
                                                                           ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/logic/importer/fileformat/IsiImporter.java:364: error: semicolon missing
     * Fixed bug from: http://sourceforge.net/tracker/index.php?func=detail&aid=1542552&group_id=92314&atid=600306
                                                                                       ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/logic/importer/fileformat/IsiImporter.java:364: error: semicolon missing
     * Fixed bug from: http://sourceforge.net/tracker/index.php?func=detail&aid=1542552&group_id=92314&atid=600306
                                                                                                      ^
/Users/christophs/workspace/jabref/src/main/java/org/jabref/logic/layout/format/DocBookAuthorFormatter.java:17: error: incorrect use of inline tag
     * @param version @link {@link DocBookVersion}
                      ^
Please file a bug against the javadoc tool via the Java bug reporting page
(http://bugreport.java.com) after checking the Bug Database (http://bugs.java.com)
for duplicates. Include error messages and the following diagnostic in your report. Thank you.
java.lang.NullPointerException: Cannot read field "endKind" because "tag" is null
        at jdk.compiler/com.sun.tools.doclint.Checker.isSelfClosingAllowed(Checker.java:423)
        at jdk.compiler/com.sun.tools.doclint.Checker.visitStartElement(Checker.java:380)
        at jdk.compiler/com.sun.tools.doclint.Checker.visitStartElement(Checker.java:106)
        at jdk.compiler/com.sun.tools.javac.tree.DCTree$DCStartElement.accept(DCTree.java:850)
        at jdk.compiler/com.sun.source.util.DocTreePathScanner.scan(DocTreePathScanner.java:71)
        at jdk.compiler/com.sun.source.util.DocTreeScanner.scanAndReduce(DocTreeScanner.java:83)
        at jdk.compiler/com.sun.source.util.DocTreeScanner.scan(DocTreeScanner.java:98)
        at jdk.compiler/com.sun.source.util.DocTreeScanner.scanAndReduce(DocTreeScanner.java:106)
        at jdk.compiler/com.sun.source.util.DocTreeScanner.visitDocComment(DocTreeScanner.java:184)
        at jdk.compiler/com.sun.tools.doclint.Checker.visitDocComment(Checker.java:269)
        at jdk.compiler/com.sun.tools.doclint.Checker.visitDocComment(Checker.java:106)
        at jdk.compiler/com.sun.tools.javac.tree.DCTree$DCDocComment.accept(DCTree.java:138)
        at jdk.compiler/com.sun.source.util.DocTreePathScanner.scan(DocTreePathScanner.java:50)
        at jdk.compiler/com.sun.tools.doclint.Checker.scan(Checker.java:231)
        at jdk.compiler/com.sun.tools.doclint.DocLint.scan(DocLint.java:351)
        at jdk.javadoc/jdk.javadoc.internal.doclets.toolkit.WorkArounds.runDocLint(WorkArounds.java:111)
        at jdk.javadoc/jdk.javadoc.internal.doclets.toolkit.util.Utils.getDocCommentTree0(Utils.java:2725)
        at jdk.javadoc/jdk.javadoc.internal.doclets.toolkit.util.Utils.getDocCommentTree(Utils.java:2768)
        at jdk.javadoc/jdk.javadoc.internal.doclets.toolkit.util.Utils$CommentHelperCache.computeIfAbsent(Utils.java:2914)
        at jdk.javadoc/jdk.javadoc.internal.doclets.toolkit.util.Utils.getCommentHelper(Utils.java:2588)
        at jdk.javadoc/jdk.javadoc.internal.doclets.toolkit.util.Utils.hasBlockTag(Utils.java:2632)
        at jdk.javadoc/jdk.javadoc.internal.doclets.toolkit.util.Utils.hasHiddenTag(Utils.java:1556)
        at jdk.javadoc/jdk.javadoc.internal.doclets.toolkit.util.VisibleMemberTable.mustDocument(VisibleMemberTable.java:410)
        at java.base/java.util.stream.ReferencePipeline$2$1.accept(ReferencePipeline.java:176)
        at java.base/java.util.ArrayList$ArrayListSpliterator.forEachRemaining(ArrayList.java:1625)
        at java.base/java.util.stream.AbstractPipeline.copyInto(AbstractPipeline.java:484)
        at java.base/java.util.stream.AbstractPipeline.wrapAndCopyInto(AbstractPipeline.java:474)
        at java.base/java.util.stream.ReduceOps$ReduceOp.evaluateSequential(ReduceOps.java:913)
        at java.base/java.util.stream.AbstractPipeline.evaluate(AbstractPipeline.java:234)
        at java.base/java.util.stream.ReferencePipeline.collect(ReferencePipeline.java:578)
        at jdk.javadoc/jdk.javadoc.internal.doclets.toolkit.util.VisibleMemberTable.computeVisibleMethods(VisibleMemberTable.java:508)
        at jdk.javadoc/jdk.javadoc.internal.doclets.toolkit.util.VisibleMemberTable.computeVisibleMembers(VisibleMemberTable.java:393)
        at jdk.javadoc/jdk.javadoc.internal.doclets.toolkit.util.VisibleMemberTable.computeVisibleMembers(VisibleMemberTable.java:379)
        at jdk.javadoc/jdk.javadoc.internal.doclets.toolkit.util.VisibleMemberTable.ensureInitialized(VisibleMemberTable.java:146)
        at jdk.javadoc/jdk.javadoc.internal.doclets.toolkit.util.VisibleMemberTable.getVisibleMembers(VisibleMemberTable.java:190)
        at jdk.javadoc/jdk.javadoc.internal.doclets.toolkit.util.VisibleMemberTable.getVisibleMembers(VisibleMemberTable.java:209)
        at jdk.javadoc/jdk.javadoc.internal.doclets.toolkit.builders.MemberSummaryBuilder$PropertyHelper.computeProperties(MemberSummaryBuilder.java:479)
        at jdk.javadoc/jdk.javadoc.internal.doclets.toolkit.builders.MemberSummaryBuilder$PropertyHelper.<init>(MemberSummaryBuilder.java:474)
        at jdk.javadoc/jdk.javadoc.internal.doclets.toolkit.builders.MemberSummaryBuilder.<init>(MemberSummaryBuilder.java:88)
        at jdk.javadoc/jdk.javadoc.internal.doclets.toolkit.builders.MemberSummaryBuilder$1.<init>(MemberSummaryBuilder.java:101)
        at jdk.javadoc/jdk.javadoc.internal.doclets.toolkit.builders.MemberSummaryBuilder.getInstance(MemberSummaryBuilder.java:101)
        at jdk.javadoc/jdk.javadoc.internal.doclets.toolkit.builders.BuilderFactory.getMemberSummaryBuilder(BuilderFactory.java:214)
        at jdk.javadoc/jdk.javadoc.internal.doclets.formats.html.ClassWriterImpl.getHeader(ClassWriterImpl.java:116)
        at jdk.javadoc/jdk.javadoc.internal.doclets.toolkit.builders.ClassBuilder.buildClassDoc(ClassBuilder.java:142)
        at jdk.javadoc/jdk.javadoc.internal.doclets.toolkit.builders.ClassBuilder.build(ClassBuilder.java:113)
        at jdk.javadoc/jdk.javadoc.internal.doclets.formats.html.HtmlDoclet.generateClassFiles(HtmlDoclet.java:254)
        at jdk.javadoc/jdk.javadoc.internal.doclets.toolkit.AbstractDoclet.generateClassFiles(AbstractDoclet.java:285)
        at jdk.javadoc/jdk.javadoc.internal.doclets.toolkit.AbstractDoclet.generateClassFiles(AbstractDoclet.java:267)
        at jdk.javadoc/jdk.javadoc.internal.doclets.toolkit.AbstractDoclet.startGeneration(AbstractDoclet.java:206)
        at jdk.javadoc/jdk.javadoc.internal.doclets.toolkit.AbstractDoclet.run(AbstractDoclet.java:113)
        at jdk.javadoc/jdk.javadoc.doclet.StandardDoclet.run(StandardDoclet.java:103)
        at jdk.javadoc/jdk.javadoc.internal.tool.Start.parseAndExecute(Start.java:555)
        at jdk.javadoc/jdk.javadoc.internal.tool.Start.begin(Start.java:399)
        at jdk.javadoc/jdk.javadoc.internal.tool.Start.begin(Start.java:348)
        at jdk.javadoc/jdk.javadoc.internal.tool.Main.execute(Main.java:63)
        at jdk.javadoc/jdk.javadoc.internal.tool.Main.main(Main.java:52)
100 errors
100 warnings

@ThiloteE
Copy link
Collaborator

@Siedlerchr please provide better explanation of this issue, otherwise this might not be a "good first issue", in particular "how to trigger the error" and "how to use "javadoc"

@ThiloteE ThiloteE added the needs-refinement Issue description is not complete; needs to be refined label Jan 20, 2023
@Siedlerchr
Copy link
Collaborator Author

This is a code quality issue. Not really important.
I will try to refine it

@koppor
Copy link
Owner

koppor commented Mar 15, 2023

As a developer, I open IntelliJ and start the javadoc generation to have "nice" documentation.

  1. Double click on "javadoc" in the Gradle tasks image
  2. IntelliJ runs the gradle task:
    image
  3. There are warnings and errors output
    image
  4. These should be fixed

Fixing empty comments

Especially the empty comment at ThreeWayMergeCell can be easily fixed:

image

Just remove the comment.

Fixing not found links

Each "broken" link should be followed by Ctrl+Left Mouse. For all links I checked, these exists

Information about {@link}: It is used inside texts. @see is an own block. See also https://stackoverflow.com/a/10097249/873282.

Suggestion: In case the link can be followed in IntelliJ, just keep it. We should then follow up https://bugs.openjdk.org/browse/JDK-8224266 and check whether there is still an issue in warnings vs. errors in link reporting in the javadoc module of JDK - or if our gradle installation does something wrong. Starting point: /build.gradle#L409

@koppor
Copy link
Owner

koppor commented Mar 27, 2023

Not all errors are fixed at JabRef#9701. Therefore reopened.

@BugMan-111
Copy link

Hi @koppor, it appears javadoc doesn't generate warnings for empty comments anymore (?), I have searched the code base and I only find one empty comment (See this).

Image

Is this how we suppose to fix it? All of the warnings related to "no comments" listed in the original issue descriptions are no longer there.

@koppor
Copy link
Owner

koppor commented May 17, 2023

I described at #475 (comment) how to reproduce.

Think, we cannot do anything about "reference not found". In IntelliJ, I can follow each link.

Excerpt from current error output:

image

What you need to do is to double cleack an error and think of how to fix it.

image

I fixed half of it at JabRef#9911. Maybe, this helps to fix the other ones?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment