You are viewing a plain text version of this content. The canonical link for it is here.
Posted to derby-dev@db.apache.org by "Dag H. Wanvik (JIRA)" <ji...@apache.org> on 2010/11/10 00:16:23 UTC

[jira] Created: (DERBY-4897) Get rid of warning for customized tags in javadoc build

Get rid of warning for customized tags in javadoc build
-------------------------------------------------------

                 Key: DERBY-4897
                 URL: https://issues.apache.org/jira/browse/DERBY-4897
             Project: Derby
          Issue Type: Improvement
          Components: Javadoc
            Reporter: Dag H. Wanvik
            Priority: Trivial


Today we see this warning (well, note) in the javadoc build:

Note: Custom tags that could override future standard tags:  @upgrade, @end_format, @disk_layout, @purpose, @format_id. To avoid potential overrides, use at least one period character (.) in custom tag names.

It would be nice to silence this by doing what's suggested.



-- 
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.


[jira] Updated: (DERBY-4897) Get rid of warning for customized tags in javadoc build

Posted by "Dag H. Wanvik (JIRA)" <ji...@apache.org>.
     [ https://issues.apache.org/jira/browse/DERBY-4897?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Dag H. Wanvik updated DERBY-4897:
---------------------------------

    Issue & fix info: [Patch Available]

> Get rid of warning for customized tags in javadoc build
> -------------------------------------------------------
>
>                 Key: DERBY-4897
>                 URL: https://issues.apache.org/jira/browse/DERBY-4897
>             Project: Derby
>          Issue Type: Improvement
>          Components: Javadoc
>            Reporter: Dag H. Wanvik
>            Assignee: Dag H. Wanvik
>            Priority: Trivial
>         Attachments: derby-4897-1.diff, derby-4897-1.stat
>
>
> Today we see this warning (well, note) in the javadoc build:
> Note: Custom tags that could override future standard tags:  @upgrade, @end_format, @disk_layout, @purpose, @format_id. To avoid potential overrides, use at least one period character (.) in custom tag names.
> It would be nice to silence this by doing what's suggested.

-- 
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.


[jira] Commented: (DERBY-4897) Get rid of warning for customized tags in javadoc build

Posted by "Knut Anders Hatlen (JIRA)" <ji...@apache.org>.
    [ https://issues.apache.org/jira/browse/DERBY-4897?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=12931348#action_12931348 ] 

Knut Anders Hatlen commented on DERBY-4897:
-------------------------------------------

Would it make sense to make the prefix "derby." instead of just "."? The tag "@derby.upgrade" looks less like a typo than "@.upgrade" in my eyes... ;) But the patch does exactly what the note tells us to do, so +1 in any case.

> Get rid of warning for customized tags in javadoc build
> -------------------------------------------------------
>
>                 Key: DERBY-4897
>                 URL: https://issues.apache.org/jira/browse/DERBY-4897
>             Project: Derby
>          Issue Type: Improvement
>          Components: Javadoc
>            Reporter: Dag H. Wanvik
>            Assignee: Dag H. Wanvik
>            Priority: Trivial
>         Attachments: derby-4897-1.diff, derby-4897-1.stat
>
>
> Today we see this warning (well, note) in the javadoc build:
> Note: Custom tags that could override future standard tags:  @upgrade, @end_format, @disk_layout, @purpose, @format_id. To avoid potential overrides, use at least one period character (.) in custom tag names.
> It would be nice to silence this by doing what's suggested.

-- 
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.


[jira] Assigned: (DERBY-4897) Get rid of warning for customized tags in javadoc build

Posted by "Dag H. Wanvik (JIRA)" <ji...@apache.org>.
     [ https://issues.apache.org/jira/browse/DERBY-4897?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Dag H. Wanvik reassigned DERBY-4897:
------------------------------------

    Assignee: Dag H. Wanvik

> Get rid of warning for customized tags in javadoc build
> -------------------------------------------------------
>
>                 Key: DERBY-4897
>                 URL: https://issues.apache.org/jira/browse/DERBY-4897
>             Project: Derby
>          Issue Type: Improvement
>          Components: Javadoc
>            Reporter: Dag H. Wanvik
>            Assignee: Dag H. Wanvik
>            Priority: Trivial
>
> Today we see this warning (well, note) in the javadoc build:
> Note: Custom tags that could override future standard tags:  @upgrade, @end_format, @disk_layout, @purpose, @format_id. To avoid potential overrides, use at least one period character (.) in custom tag names.
> It would be nice to silence this by doing what's suggested.

-- 
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.


[jira] Updated: (DERBY-4897) Get rid of warning for customized tags in javadoc build

Posted by "Dag H. Wanvik (JIRA)" <ji...@apache.org>.
     [ https://issues.apache.org/jira/browse/DERBY-4897?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Dag H. Wanvik updated DERBY-4897:
---------------------------------

    Attachment: derby-4897-1.stat
                derby-4897-1.diff

Uplaoding a patch that inserts a "." as the first character of the custom tags. This silences the javadoc build warning.

> Get rid of warning for customized tags in javadoc build
> -------------------------------------------------------
>
>                 Key: DERBY-4897
>                 URL: https://issues.apache.org/jira/browse/DERBY-4897
>             Project: Derby
>          Issue Type: Improvement
>          Components: Javadoc
>            Reporter: Dag H. Wanvik
>            Assignee: Dag H. Wanvik
>            Priority: Trivial
>         Attachments: derby-4897-1.diff, derby-4897-1.stat
>
>
> Today we see this warning (well, note) in the javadoc build:
> Note: Custom tags that could override future standard tags:  @upgrade, @end_format, @disk_layout, @purpose, @format_id. To avoid potential overrides, use at least one period character (.) in custom tag names.
> It would be nice to silence this by doing what's suggested.

-- 
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.


[jira] Closed: (DERBY-4897) Get rid of warning for customized tags in javadoc build

Posted by "Dag H. Wanvik (JIRA)" <ji...@apache.org>.
     [ https://issues.apache.org/jira/browse/DERBY-4897?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Dag H. Wanvik closed DERBY-4897.
--------------------------------

          Resolution: Fixed
       Fix Version/s: 10.8.0.0
    Issue & fix info:   (was: [Patch Available])

Committed version #2 of the patch as svn 1037009.

> Get rid of warning for customized tags in javadoc build
> -------------------------------------------------------
>
>                 Key: DERBY-4897
>                 URL: https://issues.apache.org/jira/browse/DERBY-4897
>             Project: Derby
>          Issue Type: Improvement
>          Components: Javadoc
>            Reporter: Dag H. Wanvik
>            Assignee: Dag H. Wanvik
>            Priority: Trivial
>             Fix For: 10.8.0.0
>
>         Attachments: derby-4897-1.diff, derby-4897-1.stat, derby-4897-2.diff, derby-4897-2.stat
>
>
> Today we see this warning (well, note) in the javadoc build:
> Note: Custom tags that could override future standard tags:  @upgrade, @end_format, @disk_layout, @purpose, @format_id. To avoid potential overrides, use at least one period character (.) in custom tag names.
> It would be nice to silence this by doing what's suggested.

-- 
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.


[jira] Commented: (DERBY-4897) Get rid of warning for customized tags in javadoc build

Posted by "Dag H. Wanvik (JIRA)" <ji...@apache.org>.
    [ https://issues.apache.org/jira/browse/DERBY-4897?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=12931375#action_12931375 ] 

Dag H. Wanvik commented on DERBY-4897:
--------------------------------------

I think that's a good idea. It does look like a typo, doesn't it? I'll make that change. :) Thanks for looking at it, Knut!

> Get rid of warning for customized tags in javadoc build
> -------------------------------------------------------
>
>                 Key: DERBY-4897
>                 URL: https://issues.apache.org/jira/browse/DERBY-4897
>             Project: Derby
>          Issue Type: Improvement
>          Components: Javadoc
>            Reporter: Dag H. Wanvik
>            Assignee: Dag H. Wanvik
>            Priority: Trivial
>         Attachments: derby-4897-1.diff, derby-4897-1.stat
>
>
> Today we see this warning (well, note) in the javadoc build:
> Note: Custom tags that could override future standard tags:  @upgrade, @end_format, @disk_layout, @purpose, @format_id. To avoid potential overrides, use at least one period character (.) in custom tag names.
> It would be nice to silence this by doing what's suggested.

-- 
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.