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 "Daniel John Debrunner (JIRA)" <de...@db.apache.org> on 2006/08/23 18:45:14 UTC

[jira] Created: (DERBY-1752) Fix javadoc to account for changes required by new licence header policy.

Fix javadoc to account for changes required by new licence header policy.
-------------------------------------------------------------------------

                 Key: DERBY-1752
                 URL: http://issues.apache.org/jira/browse/DERBY-1752
             Project: Derby
          Issue Type: Sub-task
            Reporter: Daniel John Debrunner
             Fix For: 10.2.2.0, 10.3.0.0


The published javadoc creates a copyright with the old copyright statement, should be replaced with the collected works copyright,.



-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators: http://issues.apache.org/jira/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira

        

[jira] Updated: (DERBY-1752) Fix javadoc to account for changes required by new licence header policy.

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

Andrew McIntyre updated DERBY-1752:
-----------------------------------

    Attachment: derby-1752-v2.diff

Attaching another patch for this. Corrects copyright dates and removes 'or its licensors' text, and updates the front page text to match what has been proposed for the docs in DERBY-2237.

> Fix javadoc to account for changes required by new licence header policy.
> -------------------------------------------------------------------------
>
>                 Key: DERBY-1752
>                 URL: https://issues.apache.org/jira/browse/DERBY-1752
>             Project: Derby
>          Issue Type: Sub-task
>            Reporter: Daniel John Debrunner
>         Assigned To: Andrew McIntyre
>             Fix For: 10.2.3.0, 10.3.0.0
>
>         Attachments: derby-1752-v1.diff, derby-1752-v2.diff
>
>
> The published javadoc creates a copyright with the old copyright statement, should be replaced with the collected works copyright,.

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


[jira] Updated: (DERBY-1752) Fix javadoc to account for changes required by new licence header policy.

Posted by "Andrew McIntyre (JIRA)" <ji...@apache.org>.
     [ http://issues.apache.org/jira/browse/DERBY-1752?page=all ]

Andrew McIntyre updated DERBY-1752:
-----------------------------------

    Fix Version/s: 10.2.3.0
                       (was: 10.2.2.0)

I am in agreement with Dan that the copyright notice as would appear in the NOTICE file is sufficient for the front page of the generated documentation. While my original query for clarification did not receive a reply, this question came up in a later thread:

http://mail-archives.apache.org/mod_mbox/www-legal-discuss/200611.mbox/%3c5CC03585-6EF3-44F5-BEE0-A7D0C159F482@gbiv.com%3e

Because the source in this case are the file in the java tree, I believe that the source header is not required in the javadoc, nor in the generated documentation. It would be nice if http://www.apache.org/legal/src-headers.html clarified this, but despite lack of clarification, I do think we are ok for 10.2.2 based on the above email thread.

I will leave this open and produce a patch to fix the incorrect copyright statement and replace it with the NOTICE-style copyright in trunk and 10.2.3.x

> Fix javadoc to account for changes required by new licence header policy.
> -------------------------------------------------------------------------
>
>                 Key: DERBY-1752
>                 URL: http://issues.apache.org/jira/browse/DERBY-1752
>             Project: Derby
>          Issue Type: Sub-task
>            Reporter: Daniel John Debrunner
>         Assigned To: Andrew McIntyre
>             Fix For: 10.3.0.0, 10.2.3.0
>
>         Attachments: derby-1752-v1.diff
>
>
> The published javadoc creates a copyright with the old copyright statement, should be replaced with the collected works copyright,.

-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators: http://issues.apache.org/jira/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira

        

[jira] Commented: (DERBY-1752) Fix javadoc to account for changes required by new licence header policy.

Posted by "Andrew McIntyre (JIRA)" <ji...@apache.org>.
    [ http://issues.apache.org/jira/browse/DERBY-1752?page=comments#action_12446459 ] 
            
Andrew McIntyre commented on DERBY-1752:
----------------------------------------

I've been meaning to follow up on this for awhile, but I noticed that ij.runScript() allows null for the outputEncoding, but requires an encoding be set for the input encoding. Should runScript() also allow for a null inputEncoding, wihich then defaults to the current value for file.encoding?


> Fix javadoc to account for changes required by new licence header policy.
> -------------------------------------------------------------------------
>
>                 Key: DERBY-1752
>                 URL: http://issues.apache.org/jira/browse/DERBY-1752
>             Project: Derby
>          Issue Type: Sub-task
>            Reporter: Daniel John Debrunner
>         Assigned To: Andrew McIntyre
>             Fix For: 10.3.0.0, 10.2.2.0
>
>         Attachments: derby-1752-v1.diff
>
>
> The published javadoc creates a copyright with the old copyright statement, should be replaced with the collected works copyright,.

-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators: http://issues.apache.org/jira/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira

        

[jira] Commented: (DERBY-1752) Fix javadoc to account for changes required by new licence header policy.

Posted by "Daniel John Debrunner (JIRA)" <de...@db.apache.org>.
    [ http://issues.apache.org/jira/browse/DERBY-1752?page=comments#action_12431713 ] 
            
Daniel John Debrunner commented on DERBY-1752:
----------------------------------------------

The header text in http://www.apache.org/legal/src-headers.html#header-text  is clearly designed for source header files, look at the title of the page and sub-sections and the wording of the header.

I don't think that page is meant to cover introductions to Apache software that state it is being released under the ALv2.

The copyright notice covering the collected works is just a copy of the copyright notice from the NOTICE file which is covered here

http://www.apache.org/legal/src-headers.html#notice

Note there is no requirement to have these lines in the oveview file since the licence itself is defined in the LICENCE file, I just thought they were helpful and clarifying when I created this overview:

"Apache Derby is an open source subproject of the Apache DB project, licensed under the Apache License, Version 2.0."

Note also the meaning of the lines above "the whole project is released under ALv2", the lines you replace them with (from the source header) mean "this file is released under ALv2".

Note I have the same concern about the new copyright pages in the documentation, the same source header is used, when a simple statement of it's released under the ALv2  seems to be more appropriate.


> Fix javadoc to account for changes required by new licence header policy.
> -------------------------------------------------------------------------
>
>                 Key: DERBY-1752
>                 URL: http://issues.apache.org/jira/browse/DERBY-1752
>             Project: Derby
>          Issue Type: Sub-task
>            Reporter: Daniel John Debrunner
>         Assigned To: Andrew McIntyre
>             Fix For: 10.3.0.0, 10.2.2.0
>
>         Attachments: derby-1752-v1.diff
>
>
> The published javadoc creates a copyright with the old copyright statement, should be replaced with the collected works copyright,.

-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators: http://issues.apache.org/jira/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira

        

[jira] Updated: (DERBY-1752) Fix javadoc to account for changes required by new licence header policy.

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

Kathey Marsden updated DERBY-1752:
----------------------------------

    Component/s: Javadoc

> Fix javadoc to account for changes required by new licence header policy.
> -------------------------------------------------------------------------
>
>                 Key: DERBY-1752
>                 URL: https://issues.apache.org/jira/browse/DERBY-1752
>             Project: Derby
>          Issue Type: Sub-task
>          Components: Javadoc
>            Reporter: Daniel John Debrunner
>            Assignee: Andrew McIntyre
>             Fix For: 10.2.2.1, 10.3.1.4
>
>         Attachments: derby-1752-v1.diff, derby-1752-v2.diff
>
>
> The published javadoc creates a copyright with the old copyright statement, should be replaced with the collected works copyright,.

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


[jira] Assigned: (DERBY-1752) Fix javadoc to account for changes required by new licence header policy.

Posted by "Andrew McIntyre (JIRA)" <de...@db.apache.org>.
     [ http://issues.apache.org/jira/browse/DERBY-1752?page=all ]

Andrew McIntyre reassigned DERBY-1752:
--------------------------------------

    Assignee: Andrew McIntyre

> Fix javadoc to account for changes required by new licence header policy.
> -------------------------------------------------------------------------
>
>                 Key: DERBY-1752
>                 URL: http://issues.apache.org/jira/browse/DERBY-1752
>             Project: Derby
>          Issue Type: Sub-task
>            Reporter: Daniel John Debrunner
>         Assigned To: Andrew McIntyre
>             Fix For: 10.3.0.0, 10.2.2.0
>
>         Attachments: derby-1752-v1.diff
>
>
> The published javadoc creates a copyright with the old copyright statement, should be replaced with the collected works copyright,.

-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators: http://issues.apache.org/jira/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira

        

[jira] Resolved: (DERBY-1752) Fix javadoc to account for changes required by new licence header policy.

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

Andrew McIntyre resolved DERBY-1752.
------------------------------------

       Resolution: Fixed
    Fix Version/s:     (was: 10.2.3.0)
                   10.2.2.1

Committed derby-1752-2 patch to trunk with revision 505644 and 10.2 with 505645.

> Fix javadoc to account for changes required by new licence header policy.
> -------------------------------------------------------------------------
>
>                 Key: DERBY-1752
>                 URL: https://issues.apache.org/jira/browse/DERBY-1752
>             Project: Derby
>          Issue Type: Sub-task
>            Reporter: Daniel John Debrunner
>         Assigned To: Andrew McIntyre
>             Fix For: 10.2.2.1, 10.3.0.0
>
>         Attachments: derby-1752-v1.diff, derby-1752-v2.diff
>
>
> The published javadoc creates a copyright with the old copyright statement, should be replaced with the collected works copyright,.

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


[jira] Commented: (DERBY-1752) Fix javadoc to account for changes required by new licence header policy.

Posted by "Andrew McIntyre (JIRA)" <de...@db.apache.org>.
    [ http://issues.apache.org/jira/browse/DERBY-1752?page=comments#action_12431695 ] 
            
Andrew McIntyre commented on DERBY-1752:
----------------------------------------

HI Dan, I missed the 'or its licensees,' sorry about that.

As for the text Iadded, I was just following the policy at http://www.apache.org/legal/src-headers.html which states:

"With few exceptions, all human-readable Apache-developed files that are included within a distribution must include the header text. Documentation, including web site documentation distributed with the release, may include the header text within some form of metadata (such as HTML comments) or as a header or footer appearing in the visible documentation."

where "header text" equals http://www.apache.org/legal/src-headers.html#header-text

Can you point me to the policy for collected works?


> Fix javadoc to account for changes required by new licence header policy.
> -------------------------------------------------------------------------
>
>                 Key: DERBY-1752
>                 URL: http://issues.apache.org/jira/browse/DERBY-1752
>             Project: Derby
>          Issue Type: Sub-task
>            Reporter: Daniel John Debrunner
>         Assigned To: Andrew McIntyre
>             Fix For: 10.3.0.0, 10.2.2.0
>
>         Attachments: derby-1752-v1.diff
>
>
> The published javadoc creates a copyright with the old copyright statement, should be replaced with the collected works copyright,.

-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators: http://issues.apache.org/jira/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira

        

[jira] Closed: (DERBY-1752) Fix javadoc to account for changes required by new licence header policy.

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

Daniel John Debrunner closed DERBY-1752.
----------------------------------------


Javadoc has correct copyright notice.

> Fix javadoc to account for changes required by new licence header policy.
> -------------------------------------------------------------------------
>
>                 Key: DERBY-1752
>                 URL: https://issues.apache.org/jira/browse/DERBY-1752
>             Project: Derby
>          Issue Type: Sub-task
>            Reporter: Daniel John Debrunner
>         Assigned To: Andrew McIntyre
>             Fix For: 10.2.2.1, 10.3.0.0
>
>         Attachments: derby-1752-v1.diff, derby-1752-v2.diff
>
>
> The published javadoc creates a copyright with the old copyright statement, should be replaced with the collected works copyright,.

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


[jira] Commented: (DERBY-1752) Fix javadoc to account for changes required by new licence header policy.

Posted by "Andrew McIntyre (JIRA)" <ji...@apache.org>.
    [ http://issues.apache.org/jira/browse/DERBY-1752?page=comments#action_12446465 ] 
            
Andrew McIntyre commented on DERBY-1752:
----------------------------------------

whoops, wrong issue, should have been DERBY-1609 ...

> Fix javadoc to account for changes required by new licence header policy.
> -------------------------------------------------------------------------
>
>                 Key: DERBY-1752
>                 URL: http://issues.apache.org/jira/browse/DERBY-1752
>             Project: Derby
>          Issue Type: Sub-task
>            Reporter: Daniel John Debrunner
>         Assigned To: Andrew McIntyre
>             Fix For: 10.3.0.0, 10.2.2.0
>
>         Attachments: derby-1752-v1.diff
>
>
> The published javadoc creates a copyright with the old copyright statement, should be replaced with the collected works copyright,.

-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators: http://issues.apache.org/jira/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira

        

[jira] Updated: (DERBY-1752) Fix javadoc to account for changes required by new licence header policy.

Posted by "Andrew McIntyre (JIRA)" <de...@db.apache.org>.
     [ http://issues.apache.org/jira/browse/DERBY-1752?page=all ]

Andrew McIntyre updated DERBY-1752:
-----------------------------------

    Attachment: derby-1752-v1.diff

Attaching a patch for this issue.

> Fix javadoc to account for changes required by new licence header policy.
> -------------------------------------------------------------------------
>
>                 Key: DERBY-1752
>                 URL: http://issues.apache.org/jira/browse/DERBY-1752
>             Project: Derby
>          Issue Type: Sub-task
>            Reporter: Daniel John Debrunner
>             Fix For: 10.3.0.0, 10.2.2.0
>
>         Attachments: derby-1752-v1.diff
>
>
> The published javadoc creates a copyright with the old copyright statement, should be replaced with the collected works copyright,.

-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators: http://issues.apache.org/jira/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira

        

[jira] Commented: (DERBY-1752) Fix javadoc to account for changes required by new licence header policy.

Posted by "Daniel John Debrunner (JIRA)" <de...@db.apache.org>.
    [ http://issues.apache.org/jira/browse/DERBY-1752?page=comments#action_12430275 ] 
            
Daniel John Debrunner commented on DERBY-1752:
----------------------------------------------

The collected works copyright just needs to be the ASF not "or its licencees".

The patch changes the licence text in the overview html file, I think this is wrong.
The previous text seems to be fine. It's indicating the collected works is under the ALv2.

The wording you've added is for a source file, not for the complete works. The wording now
is really akward, e.g. "this file" what does that mean in the context?

> Fix javadoc to account for changes required by new licence header policy.
> -------------------------------------------------------------------------
>
>                 Key: DERBY-1752
>                 URL: http://issues.apache.org/jira/browse/DERBY-1752
>             Project: Derby
>          Issue Type: Sub-task
>            Reporter: Daniel John Debrunner
>         Assigned To: Andrew McIntyre
>             Fix For: 10.3.0.0, 10.2.2.0
>
>         Attachments: derby-1752-v1.diff
>
>
> The published javadoc creates a copyright with the old copyright statement, should be replaced with the collected works copyright,.

-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators: http://issues.apache.org/jira/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira

        

[jira] Updated: (DERBY-1752) Fix javadoc to account for changes required by new licence header policy.

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

Andrew McIntyre updated DERBY-1752:
-----------------------------------

    Derby Info: [Patch Available]

> Fix javadoc to account for changes required by new licence header policy.
> -------------------------------------------------------------------------
>
>                 Key: DERBY-1752
>                 URL: https://issues.apache.org/jira/browse/DERBY-1752
>             Project: Derby
>          Issue Type: Sub-task
>            Reporter: Daniel John Debrunner
>         Assigned To: Andrew McIntyre
>             Fix For: 10.2.3.0, 10.3.0.0
>
>         Attachments: derby-1752-v1.diff, derby-1752-v2.diff
>
>
> The published javadoc creates a copyright with the old copyright statement, should be replaced with the collected works copyright,.

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