This Bugzilla instance is deprecated, and most Eclipse projects now use GitHub or Eclipse GitLab. Please see the deprecation plan for details.
Bug 277256 - Copyright description in help file
Summary: Copyright description in help file
Status: RESOLVED WONTFIX
Alias: None
Product: Babel
Classification: Technology
Component: translations (show other bugs)
Version: unspecified   Edit
Hardware: All All
: P3 normal (vote)
Target Milestone: ---   Edit
Assignee: Denis Roy CLA
QA Contact:
URL:
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2009-05-20 21:27 EDT by Tsutomu Obata CLA
Modified: 2012-03-01 21:31 EST (History)
3 users (show)

See Also:


Attachments
Example Help Files (4.03 KB, application/x-zip-compressed)
2009-07-22 01:08 EDT, Tsutomu Obata CLA
no flags Details

Note You need to log in before you can comment on or make changes to this bug.
Description Tsutomu Obata CLA 2009-05-20 21:27:58 EDT
Build ID: N/A

Steps To Reproduce:

Now, we (Japan working group) are translating help files including,

   Eclipse Web Tools Platform(WTP) 3.0.2    from Ganymede SR1 (3.4.1)
   Mylyn 3.1.0
   Plattform 3.3.0 - 3.3.2                  from Eclipse 3.3.1
   Java development tools (JDT) 3.3.1       from Eclipse 3.3.1

We think we had better annotate the translation contributor's copyright.
Then, we have a question.

Where, and how should we add the "Copyright" description to header section in help file ?

We plan to add translator's Copyright description to header section in each translated help file (html format).
Which is better, type A or type B or type C ?  (or any another solutions ?)

Original (sample);

<head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<meta name="copyright" content="Copyright (c) 2000, 2008 IBM Corporation and others. All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: IBM Corporation - initial API and implementation" />
<meta name="DC.rights.owner" content="(C) Copyright 2000, 2008" />
<meta content="public" name="security" />

type A ;
Add another meta tag (maybe meta name is "copyright", content includes translator's name, etc.) besides the original contributor's Copyright tag.
That is, there are some copyright tags in help file.

type B ;
Insert translator's Copyright description to the original contributor's Copyright tag.
That is, there is only one copyright tag in help file.

type C ;
Add a simple comment line (includes translator's Copyright description) under the original contributor's Copyright tag.

More information:
Comment 1 Denis Roy CLA 2009-07-20 13:16:56 EDT
I will ask Eclipse legal for advice.
Comment 2 Denis Roy CLA 2009-07-20 13:47:09 EDT
If you use this doc file in CVS as a reference:

http://dev.eclipse.org/viewcvs/index.cgi/org.eclipse.tm.rse/doc/org.eclipse.rse.doc.user/gettingstarted/g_start.html?revision=1.6&root=DSDP_Project&view=markup

The Eclipse Legal team tells me that you should simply add yourself as a contributor to the file in the comment section that contains the EPL notice:

<!--
This program and the accompanying materials are made available under the terms
of the Eclipse Public License v1.0 which accompanies this distribution, and is 
available at http://www.eclipse.org/legal/epl-v10.html

Contributors:
David Dykstal (IBM) - [203337] RSE user guide - TOC differs from Chapter for setting up a dstore server
*** Add here: My name (MyCompany) - Comment  ***
-->
Comment 3 Tsutomu Obata CLA 2009-07-22 01:08:08 EDT
Created attachment 142211 [details]
Example Help Files

Thank you for your reply.

I understood the case that you mentioned. But I would like to make sure a couple of cases. Please tell me if I'm right or not.


Case 1;

Example ; See Attachments
         toverws.html(from org.eclipse.jst.ws.doc.user_1.0.500.v200809092107)

It contains the EPL notice in the meta tag, instead of the comment section. I think I should add the translator's Info like below. Am I right?


<meta name="copyright" content="Copyright (c) 2000, 2008 IBM Corporation and others. All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: IBM Corporation - initial API and implementation
Tsutomu Obata (NEC Soft) - translated to Japanese
" />


Case 2;

Example ; 
http://dev.eclipse.org/viewcvs/index.cgi/org.eclipse.platform.doc.user/tasks/help_accessibility.htm?view=markup


There isn't the EPL notice in the help file.
So I think the translator's Info should be added in the "copyright" section.
Am I right?


<head>
<meta name="copyright" content="Copyright (c) IBM Corporation and others 2000, 2006. This page is made available under license. For full details see the LEGAL in the documentation book that contains this page.
Tsutomu Obata (NEC Soft) - translated to Japanese" />
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
<meta http-equiv="Content-Style-Type" content="text/css" />
<link rel="STYLESHEET" href="../book.css" charset="ISO-8859-1" type="text/css" />
<script language="JavaScript" src="PLUGINS_ROOT/org.eclipse.help/livehelp.js"> </script>
<title>Help accessibility</title>
</head>


Case 3;

Example ; See Attachments
         Team-Support.html(from org.eclipse.mylyn.help.ui_3.1.0.I20090311-1900-e3x.jar)

There's NOT the Contributors Info AT ALL.
I should create a comment section and add the translator's Info. Am I right?


<?xml version='1.0' encoding='utf-8' ?><!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
	<head>
		<meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
		<title>Mylyn Reference - Team Support</title>
		<link type="text/css" rel="stylesheet" href="book.css"/>
	</head>
<!--
Contributors:
Tsutomu Obata (NEC Soft) - translated to Japanese
-->
	<body>
		<table class="navigation" style="width: 100%;" border="0" summary="navigation">
			<tr>
				<th style="width: 100%" align="center" colspan="3">Team Support</th>
			</tr>
			<tr>
				<td style="width: 20%" align="left">
****** snip ***********
Comment 4 Tsutomu Obata CLA 2009-08-03 02:38:12 EDT
We (Japan Working Group) talked about this subject.
Changing description per case (See Comment #3) is too complicated, maybe it's enough to simply add a comment section that includes the translator's Info. 
This is our conclusion.
So, we will add a comment section to each of the translated help files.


Example ; 

<?xml version='1.0' encoding='utf-8' ?><!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
	<head>
		<meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
		<title>Mylyn Reference - Team Support</title>
		<link type="text/css" rel="stylesheet" href="book.css"/>
	</head>
<!--
Contributors:
NEC Soft, Ltd. - translated to Japanese
-->
	<body>
		<table class="navigation" style="width: 100%;" border="0" summary="navigation">
			<tr>
****** snip ***********
Comment 5 Satoru Yoshida CLA 2012-03-01 21:15:15 EST
I have not heard activity of the group in 2 years or more.

(I have translated since last August because no Japanese had translated on Babel at least 2 years)

So, this issue could be closed, I think.
Comment 6 Kit Lo CLA 2012-03-01 21:31:39 EST
no activity, resolved