Per poter utilizzare la regola Copyright l'utente deve utilizzare tre campi
1. Includere i pacchetti:
Per questo campo, l'utente deve utilizzare le specifiche di pacchetti separate da virgola in modo da determinare le classi in cui si applica questo copyright.
Ad esempio, com.ibm.package1,com.ibm.package2. Questo campo supporta anche caratteri jolly, ad esempio, com.ibm.package1.*,com.ibm.package2.*.
"com.ibm.package1" e "com.ibm.package1.*" avranno significati differenti. Se l'utente desidera utilizzare questo commento del copyright solo su una
classe, allora dovrà utilizzare "com.ibm.package1". Se invece desidera utilizzarlo per tutte le classi che iniziano con "com.ibm.package1", allora
utilizzerà "com.ibm.package1.*"
Non è obbligatorio specificare un valore per questo campo. Se non viene specificato alcun valore, la regola verrà eseguita per tutti i pacchetti.
2. Escludere i pacchetti:
Le proprietà di questo campo sono uguali a quelle del campo "Includere i pacchetti". L'utente utilizzerà questo campo per specificare
i pacchetti su cui desidera non eseguire la regola.
Non è obbligatorio specificare un valore per questo campo. Se non viene specificato alcun valore, la regola verrà eseguita per tutti i pacchetti.
3. Commento copyright:
L'utente deve immettere un blocco di commenti Java valido contenente le informazioni sul copyright desiderato.
L'utente può utilizzare [date] dove prevede che venga visualizzata la data del copyright. Ad esempio
/**********************************************************************
* Copyright (c) [date] IBM Corporation e altri.
* Tutti i diritti riservati. Questo programma e il relativo materiale
* sono disponibili in base ai termini di Eclipse Public License v1.0
* fornita con questa distribuzione e disponibile all'indirizzo
* http://www.eclipse.org/legal/epl-v10.html
* $Id: Copyright_Help.html,v 1.1 2008/02/29 15:07:43 linda_hillis Exp $
*
* Contributor:
* IBM - API e implementazione iniziale
**********************************************************************/
Se nel file non è presente alcun commento di copyright e l'anno corrente è2007, in seguito a una rapida correzione, il commento avrà il seguente aspetto:
/**********************************************************************
* Copyright (c) 2007 IBM Corporation e altri.
* Tutti i diritti riservati. Questo programma e il relativo materiale
* sono disponibili in base ai termini di Eclipse Public License v1.0
* fornita con questa distribuzione e disponibile all'indirizzo
* http://www.eclipse.org/legal/epl-v10.html
* $Id: Copyright_Help.html,v 1.1 2008/02/29 15:07:43 linda_hillis Exp $
*
* Contributor:
* IBM - API e implementazione iniziale
**********************************************************************/
Se il file aveva un commento di copyright come il seguente
/**********************************************************************
* Copyright (c) 2005 IBM Corporation e altri.
* Tutti i diritti riservati. Questo programma e il relativo materiale
* sono disponibili in base ai termini di Eclipse Public License v1.0
* fornita con questa distribuzione e disponibile all'indirizzo
* http://www.eclipse.org/legal/epl-v10.html
* $Id: Copyright_Help.html,v 1.1 2008/02/29 15:07:43 linda_hillis Exp $
*
* Contributor:
* IBM - API e implementazione iniziale
**********************************************************************/
Ma la data dell'ultima modifica del file era nel 2006 e l'anno corrente è il2006. In seguito a una rapida correzione, il commento avrà il seguente aspetto:
/**********************************************************************
* Copyright (c) 2005,2006 IBM Corporation e altri.
* Tutti i diritti riservati. Questo programma e il relativo materiale
* sono disponibili in base ai termini di Eclipse Public License v1.0
* fornita con questa distribuzione e disponibile all'indirizzo
* http://www.eclipse.org/legal/epl-v10.html
* $Id: Copyright_Help.html,v 1.1 2008/02/29 15:07:43 linda_hillis Exp $
*
* Contributor:
* IBM - API e implementazione iniziale
**********************************************************************/
Se invece l'anno corrente è il 2007 e l'anno dell'ultima modifica era 2006, dopo una rapida correzione il file avrà il seguente aspetto:
/**********************************************************************
* Copyright (c) 2005,2007 IBM Corporation e altri.
* Tutti i diritti riservati. Questo programma e il relativo materiale
* sono disponibili in base ai termini di Eclipse Public License v1.0
* fornita con questa distribuzione e disponibile all'indirizzo
* http://www.eclipse.org/legal/epl-v10.html
* $Id: Copyright_Help.html,v 1.1 2008/02/29 15:07:43 linda_hillis Exp $
*
* Contributor:
* IBM - API e implementazione iniziale
**********************************************************************/
Se l'utente desidera ignorare il confronto tra le righe, allora sarà necessario utilizzare[ignore] su tale riga. La tag [ignore] deve essere l'unico elemento immesso sulla riga
(neanche gli spazi sono consentiti prima o dopo la tag [ignore]). Ad esempio:
/**********************************************************************
* Copyright (c) [date] IBM Corporation e altri.
* Tutti i diritti riservati. Questo programma e il relativo materiale
* sono disponibili in base ai termini di Eclipse Public License v1.0
* fornita con questa distribuzione e disponibile all'indirizzo
* http://www.eclipse.org/legal/epl-v10.html
[ignore]
*
* Contributor:
* IBM - API e implementazione iniziale
**********************************************************************/
La correzione rapida utilizzerà quella riga dal commento del copyright nel file e la utilizzerà per sostituire la tag [ignore].
Se nel file non è presente alcun commento di copyright, la correzione rapida eliminerà la riga con [ignore]
Senza le tag [date] e [ignore] la regola confronta tutti gli elementi inoltrati come parametro.
In tal caso, l'anno del copyright deve essere immesso. Ad esempio
/**********************************************************************
* Copyright (c) 2007 IBM Corporation e altri.
* Tutti i diritti riservati. Questo programma e il relativo materiale
* sono disponibili in base ai termini di Eclipse Public License v1.0
* fornita con questa distribuzione e disponibile all'indirizzo
* http://www.eclipse.org/legal/epl-v10.html
* $Id: Copyright_Help.html,v 1.1 2008/02/29 15:07:43 linda_hillis Exp $
*
* Contributor:
* IBM - API e implementazione iniziale
**********************************************************************/