Skip to main content

Notice: this Wiki will be going read only early in 2024 and edits will no longer be possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.

Jump to: navigation, search

Difference between revisions of "Higgins/Template - File Headers"

m (Gunnar.wagenknecht.org moved page Template - File Headers to Higgins/Template - File Headers: clarify project specific page)
 
(17 intermediate revisions by 5 users not shown)
Line 1: Line 1:
==File Headers, Copyright ==
+
{{#eclipseproject:technology.higgins|eclipse_custom_style.css}}
 +
__NOTOC__
 +
 
 
===Java files===
 
===Java files===
We follow the [[Eclipse conventions]]. Each Java file should have a header like this with "2005-2006" replaced with the correct year(s), "Parity Communications, Inc." replace with the copyright holder, and "Paul Trevithick" replaced with original author of the file:  
+
We follow the [http://www.eclipse.org/legal/copyrightandlicensenotice.php Eclipse conventions]. Each Java file should have a header like this with "2005-2009" replaced with the correct year(s), "Azigo, Inc." replace with the copyright holder, and "Paul Trevithick" replaced with original author of the file:  
 
+
/*******************************************************************************
<blockquote>
+
* Copyright (c) 2005-2010 Azigo, Inc.
<code>/*******************************************************************************</code><br/>
+
* All rights reserved. This program and the accompanying materials
<code>* Copyright (c) 2005-2006 Parity Communications, Inc.</code><br/>
+
* are made available under the terms of the Eclipse Public License v1.0
<code>* All rights reserved. This program and the accompanying materials</code><br/>
+
* which accompanies this distribution, and is available at
<code>* are made available under the terms of the Eclipse Public License v1.0</code><br/>
+
* http://www.eclipse.org/legal/epl-v10.html
<code>* which accompanies this distribution, and is available at</code><br/>
+
*
<code>* http://www.eclipse.org/legal/epl-v10.html</code><br/>
+
* Contributors:
<code>*</code><br/>
+
* Paul Trevithick - initial API and implementation
<code>* Contributors:</code><br/>
+
*******************************************************************************/
<code>* Paul Trevithick - initial API and implementation</code><br/>
+
<code>*******************************************************************************/</code>
+
</blockquote>
+
 
+
 
+
==EMF-generated classes==
+
In Higgins we order the methods in an EMF-generated class as follows:
+
  
# All @generated methods that have not been modified at all are listed first,
+
===OWL Files===
# followed by "////////////" (twelve forward slashes),
+
Should carry a header like this
# followed by any non-generated methods, OR any "@generated NOT" methods.
+
&lt;!--
 +
*******************************************************************************
 +
* Copyright (c) 2008-2010 <copyright holder>
 +
* All rights reserved. This document and 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:
 +
* <someone's name> - initial vocabulary
 +
*******************************************************************************
 +
--&gt;
  
This convention has evolved from bitter experience. There are times (now fairly rare) when EMF gets sufficiently confused with a series of complex changes to the model and to the code, that it is quicker to delete the entire generated class file and have it regenerated. Before deleting, we copy everything below the //////////// into a scratch file, and use it to patch up the freshly regenerated file later.
+
[[Category:Higgins Developer Info]]

Latest revision as of 18:07, 12 April 2015

{{#eclipseproject:technology.higgins|eclipse_custom_style.css}}


Java files

We follow the Eclipse conventions. Each Java file should have a header like this with "2005-2009" replaced with the correct year(s), "Azigo, Inc." replace with the copyright holder, and "Paul Trevithick" replaced with original author of the file:

/*******************************************************************************
* Copyright (c) 2005-2010 Azigo, Inc.
* 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:
* Paul Trevithick - initial API and implementation
*******************************************************************************/

OWL Files

Should carry a header like this

<!--
*******************************************************************************
* Copyright (c) 2008-2010 <copyright holder>
* All rights reserved. This document and 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:
* <someone's name> - initial vocabulary
*******************************************************************************
-->

Back to the top