You are viewing a plain text version of this content. The canonical link for it is here.
Posted to legal-discuss@apache.org by "David Jencks (Jira)" <ji...@apache.org> on 2020/08/12 17:17:00 UTC
[jira] [Created] (LEGAL-529) Can modern javadoc be distributable in
Apache artifacts or served from Apache project sites?
David Jencks created LEGAL-529:
----------------------------------
Summary: Can modern javadoc be distributable in Apache artifacts or served from Apache project sites?
Key: LEGAL-529
URL: https://issues.apache.org/jira/browse/LEGAL-529
Project: Legal Discuss
Issue Type: Question
Reporter: David Jencks
Since java 9 a modern style of javadoc has been available that uses a search functionality instead of frames. I believe in recent java releases this is the only choice; it's certainly the default. The search works through the inclusion of a javascript file, search.js, with the following header:
```
/*
* Copyright (c) 2015, 2018, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
* under the terms of the GNU General Public License version 2 only, as
* published by the Free Software Foundation. Oracle designates this
* particular file as subject to the "Classpath" exception as provided
* by Oracle in the LICENSE file that accompanied this code.
*
* This code is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
* FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
* version 2 for more details (a copy is included in the LICENSE file that
* accompanied this code).
*
* You should have received a copy of the GNU General Public License version
* 2 along with this work; if not, write to the Free Software Foundation,
* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
*
* Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
* or visit www.oracle.com if you need additional information or have any
* questions.
*/
```
I'll note that as far as I can tell, no LICENSE file is included in the generated javadoc.
Some other javascript from jQuery is also used, but that is MIT licensed.
For a normal java or javascript project (there might be some way to construct a project where the following is not the case, but I can't imagine what it is) this search.js file is not part of the source, the build, or any convenience binaries related to running the project's code; it's only part of generated documentation. It will only be executed in a user's browser while viewing javadoc.
Can javadoc including this file be made available as a release artifact? (For instance as part of a maven-built javadoc jar)
Can javadoc including this file be included in a project website served from Apache with an apache url?
If the answers to the above are "no" are there any conceptual problems with writing and using a MIT or AL2 licensed replacement, possibly hosted outside Apache?
--
This message was sent by Atlassian Jira
(v8.3.4#803005)
---------------------------------------------------------------------
To unsubscribe, e-mail: legal-discuss-unsubscribe@apache.org
For additional commands, e-mail: legal-discuss-help@apache.org