This Bugzilla instance is a read-only archive of historic NetBeans bug reports. To report a bug in NetBeans please follow the project's instructions for reporting issues.

Bug 242857 - Javadoc hint regarding exception appears where it should not.
Summary: Javadoc hint regarding exception appears where it should not.
Status: RESOLVED FIXED
Alias: None
Product: java
Classification: Unclassified
Component: Javadoc (show other bugs)
Version: 8.0
Hardware: PC Windows 7
: P3 normal (vote)
Assignee: Ralph Ruijs
URL:
Keywords:
: 153352 251295 (view as bug list)
Depends on:
Blocks:
 
Reported: 2014-03-13 11:48 UTC by wissenstein
Modified: 2015-03-30 11:17 UTC (History)
2 users (show)

See Also:
Issue Type: DEFECT
Exception Reporter:


Attachments
IDE log (186.40 KB, text/plain)
2014-03-13 11:48 UTC, wissenstein
Details

Note You need to log in before you can comment on or make changes to this bug.
Description wissenstein 2014-03-13 11:48:11 UTC
Product Version = NetBeans IDE 8.0 RC1 (Build 201402242200)
Operating System = Windows 7 version 6.1 running on amd64
Java; VM; Vendor = 1.7.0_21
Runtime = Java HotSpot(TM) 64-Bit Server VM 23.21-b01


Create interface CustomFileReader with the following Javadoc comment:

========
package com.wissenstein.javadoc;

import java.io.IOException;

public interface CustomFileReader {

    /**
     * Experimental operation to test Javadoc hints in NetBeans-8.0-RC1
     * @param path file path
     * @throws IOException when file cannot be read
     */
    public void readFile(String path) throws IOException;
}
========

Create class DummyFileReader with the following Javadoc comment:

========
package com.wissenstein.javadoc;

import java.io.IOException;

public class DummyFileReader implements CustomFileReader {

    /**
     * {@inheritDoc}
     */
    @Override
    public void readFile(String path) throws IOException {

        System.out.println("Fake reading file [" + path + "]");
    }
}
========

Open tab DummyFileReader.java in NetBeans-8.0-RC1

Actual result: string "IOException" is yellow-underlined; there is yellow warn-mark in line 11; when mouse cursor hovers over that warn-mark, the following tool-tip appears: "Missing @throws tag for java.io.IOException".

Expected result: Nothing is yellow-underlined in DummyFileReader.java and no warn-marks and tool-tips appear.
Comment 1 wissenstein 2014-03-13 11:48:17 UTC
Created attachment 145991 [details]
IDE log
Comment 2 Jiri Prox 2014-04-18 14:55:29 UTC
reproducible
Comment 3 Jiri Prox 2014-07-30 11:58:43 UTC
*** Bug 153352 has been marked as a duplicate of this bug. ***
Comment 4 Zom-B 2014-11-25 15:37:00 UTC
The same holds for the @return tag.


public class StackPanel extends JComponent {
    /**
     * {@inheritdoc}
     * 
     * ...
     */
    public Component add(Component comp) { /* ... */ }\
}

There is a warning on the first Component (missing return tag) but not on the parameter.
Comment 5 Ralph Ruijs 2014-12-15 10:01:32 UTC
changeset   : a21f2970c108
author      : Ralph Benjamin Ruijs <ralphbenjamin@netbeans.org>
date        : Mon Dec 15 10:59:59 CET 2014
summary     : #242857 - handle {@inheritDoc}
Comment 6 Quality Engineering 2014-12-16 04:21:37 UTC
Integrated into 'main-silver', will be available in build *201412160001* on http://bits.netbeans.org/dev/nightly/ (upload may still be in progress)

Changeset: http://hg.netbeans.org/main-silver/rev/a21f2970c108
User: Ralph Benjamin Ruijs <ralphbenjamin@netbeans.org>
Log: #242857 - handle {@inheritDoc}
Comment 7 Ralph Ruijs 2015-03-30 11:17:23 UTC
*** Bug 251295 has been marked as a duplicate of this bug. ***