Para utilizar a regra de Copyright, o usuário precisa lidar com três
campos
1. Incluir Pacotes:
Para este campo, o usuário precisa utilizar especificações do pacote
separadas por vírgulas para determinar classes onde esse copyright se
aplica.
(por exemplo, com.ibm.package1,com.ibm.package2). Esse campo também
suporta curingas (por exemplo,
com.ibm.package1.*,com.ibm.package2.*).
Mas "com.ibm.package1" e "com.ibm.package1.*" terão significados
diferentes. Se o usuário quiser utilizar seu comentário sobre
copyright em apenas uma
classe, ele utilizará "com.ibm.package1". Mas se quiser utilizá-lo
para todas as classes que começam com "com.ibm.package1", ele
utilizará "com.ibm.package1.*"
Não é obrigatório fornecer um valor para esse campo. Se nenhum valor
for especificado, a regra será executada para todos os pacotes
2. Excluir Pacotes:
As propriedades deste campo são as mesmas que as do campo "Incluir
Pacotes". Mas o usuário utilizará esse campo para especificar
os pacotes onde não quer que essa regra seja executada.
Não é obrigatório fornecer um valor para esse campo. Se nenhum valor
for especificado, a regra será executada para todos os pacotes
3. Comentário sobre Copyright:
O usuário deve digitar um bloco de comentário Java válido contendo o
aviso de copyright desejado.
O usuário pode utilizar [date], onde ele espera que a data do
copyright apareça. Por exemplo-
/**********************************************************************
* Copyright (c) [date] IBM
Corporation e outros.
* Todos os direitos reservados. Este programa e os materiais
que o acompanham
* são disponibilizados sob os termos do Eclipse Public License
v1.0
* que acompanha esta distribuição e que está disponível em
* http://www.eclipse.org/legal/epl-v10.html
* $Id: Copyright_Help.html,v 1.1 29/02/2008 15:07:43 linda_hillis Exp $
*
* Contribuidores:
* IBM - API inicial e implementação
**********************************************************************/
Se não havia nenhum comentário sobre Copyright no arquivo e o ano
atual for 2007, após a correção rápida, o comentário sobre Copyright
terá a seguinte aparência-
/**********************************************************************
* Copyright (c) 2007 IBM
Corporation e outros.
* Todos os direitos reservados. Este programa e os materiais
que o acompanham
* são disponibilizados sob os termos do Eclipse Public License
v1.0
* que acompanha esta distribuição e que está disponível em
* http://www.eclipse.org/legal/epl-v10.html
* $Id: Copyright_Help.html,v 1.1 29/02/2008 15:07:43 linda_hillis Exp $
*
* Contribuidores:
* IBM - API inicial e implementação
**********************************************************************/
Se o arquivo tinha um comentário sobre Copyright como o seguinte
/**********************************************************************
* Copyright (c) 2005 IBM
Corporation e outros.
* Todos os direitos reservados. Este programa e os materiais
que o acompanham
* são disponibilizados sob os termos do Eclipse Public License
v1.0
* que acompanha esta distribuição e que está disponível em
* http://www.eclipse.org/legal/epl-v10.html
* $Id: Copyright_Help.html,v 1.1 29/02/2008 15:07:43 linda_hillis Exp $
*
* Contribuidores:
* IBM - API inicial e implementação
**********************************************************************/
Mas a data da última modificação desse arquivo foi 2006 e o ano atual
é 2006. Após a correção rápida, o comentário terá a seguinte
aparência
/**********************************************************************
* Copyright (c) 2005,2006 IBM
Corporation e outros.
* Todos os direitos reservados. Este programa e os materiais
que o acompanham
* são disponibilizados sob os termos do Eclipse Public License
v1.0
* que acompanha esta distribuição e que está disponível em
* http://www.eclipse.org/legal/epl-v10.html
* $Id: Copyright_Help.html,v 1.1 29/02/2008 15:07:43 linda_hillis Exp $
*
* Contribuidores:
* IBM - API inicial e implementação
**********************************************************************/
Mas se o ano atual for 2007 e o ano da última modificação foi 2006,
após a correção rápida, o arquivo terá a seguinte aparência -
/**********************************************************************
* Copyright (c) 2005,2007 IBM
Corporation e outros.
* Todos os direitos reservados. Este programa e os materiais
que o acompanham
* são disponibilizados sob os termos do Eclipse Public License
v1.0
* que acompanha esta distribuição e que está disponível em
* http://www.eclipse.org/legal/epl-v10.html
* $Id: Copyright_Help.html,v 1.1 29/02/2008 15:07:43 linda_hillis Exp $
*
* Contribuidores:
* IBM - API inicial e implementação
**********************************************************************/
Se o usuário quiser ignorar a comparação de alguma linha, ele terá
que utilizar [ignore] nessa linha. Mas a tag [ignore] deve ser a
única coisa inserida nessa linha
(nem mesmo espaços são permitidos antes ou depois da tag
[ignore]). Por exemplo-
/**********************************************************************
* Copyright (c) [date] IBM
Corporation e outros.
* Todos os direitos reservados. Este programa e os materiais
que o acompanham
* são disponibilizados sob os termos do Eclipse Public License
v1.0
* que acompanha esta distribuição e que está disponível em
* http://www.eclipse.org/legal/epl-v10.html
[ignore]
*
* Contribuidores:
* IBM - API inicial e implementação
**********************************************************************/
Mas a correção rápida obterá essa linha do comentário sobre copyright
no arquivo e substituirá [ignore] por ela.
Se não houver um comentário sobre copyright no arquivo, a correção
rápida excluirá a linha que contém [ignore]
Sem as tags [date] e [ignore], a regra vai comparar tudo que for
transmitido como parâmetro.
Mas nesse caso, o ano do copyright deverá ser digitado. Por
exemplo-
/**********************************************************************
* Copyright (c) 2007 IBM Corporation e outros.
* Todos os direitos reservados. Este programa e os materiais
que o acompanham
* são disponibilizados sob os termos do Eclipse Public License
v1.0
* que acompanha esta distribuição e que está disponível em
* http://www.eclipse.org/legal/epl-v10.html
* $Id: Copyright_Help.html,v 1.1 29/02/2008 15:07:43 linda_hillis Exp $
*
* Contribuidores:
* IBM - API inicial e implementação
**********************************************************************/