EnglishFrenchSpanish

OnWorks favicon

copyright-update - Online in the Cloud

Run copyright-update in OnWorks free hosting provider over Ubuntu Online, Fedora Online, Windows online emulator or MAC OS online emulator

This is the command copyright-update that can be run in the OnWorks free hosting provider using one of our multiple free online workstations such as Ubuntu Online, Fedora Online, Windows online emulator or MAC OS online emulator

PROGRAM:

NAME


copyright-update - Update Copyright information in files

SYNOPSIS


copyright-update [options] FILE [FILE ...]
copyright-update [options] --recursive PATH [PATH ...]

DESCRIPTION


Update the copyright information in set of files, possibly recursively, matching content
criteria. The updating affects copyright year, GPL address information etc.

The line must have word "Copyright", a space, three characters '(C)' (or a U+00A9 UTF
copyright sign), a space, and the range of years. Varying amount of spaces and tabs are
permitted, but there must be no spaces around the dash-character in YEAR-YEAR. Examples:

A whitespace, or multiple, required
| | No space between years
| | |
Copyright (C) YYYY-YYYY
Copyright: (C) YYYY-YYYY
|
A colon is optional

By default certain files and paths are always ignored; like version control directories,
backups files, object files and binary files according to Perl's "-T" file test. Run
program with option --help-exclude to see exclude path list.

OPTIONS


Run options
-a, --auto
In automatic mode, the author's name is read from environment variable NAME and only
lines matching 'Copyright.*$NAME' are affected. If NAME is not set, read information
from EMAIL.

If neither NAME nor EMAIL exists in evenvironemt, or if their values are not in a
recognizable formats (see section ENVIRONMENT), this options does nothing.

This option effectively tries to preset value for the --line option.

-c, --code
Preset --include to match common code files: .c, .h, .cc, .hh, .cpp, .c++, .hpp, .C,
.pl, .py, .sh and .rb

-d, --debug LEVEL
Turn on debug. Level can be in range 0-10.

-f, --fsf-address
Change License paragraphs that refer to FSF address. The FSF's current recommendation
is to redirect inquiries about licences to their URL.

Effectively replace paragraphs:

You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA

You should have received a copy of the GNU General Public License
along with this package; if not, write to the Free Software
Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301USA

With this:

You should have received a copy of the GNU General Public License
along with this program. If not, see <http://www.gnu.org/licenses/>.

-i, --include REGEXP
Include files matching regexp. The match is done against whole path.

If this option is not supplied, every file is automatically included. The matches can
be further filtered by using option --exclude.

This option can be used multiple times. See also option --code.

-l, --line REGEXP
Change only lines which match REGEXP. The match is case-insensitive.

-r, --recursive
Recursively search all directories given in command line.

-R, --regexp REGEXP
Change only files whose content matches REGEXP. The file is read in as a one big
string so that it's possible to match using Perl regular expressions across the whole
file. An example: '(?smi)This.*multi.*line.*match'. See perlre(1) for more information
about 'smi' and other modifiers.

This option can be used as a preliminary Content criteria, to select files before
--line option finds the correct Copyright lines.

-t, --test, --dry-run
Run in test mode. Show what would happen. No files are changed.

-v, --verbose LEVEL
Print informational messages. Increase numeric LEVEL for more verbosity.

-x, --exclude REGEXP
Ignore files matching regexp. The match is done against whole path. The option can be
used multiple times.

This option is applied after possible --include matches.

-y, --year YEAR
Update files using YEAR. Value must be four digits.

The default operation is to use currect year, so this option is not necessary in
normal use. Use case: you plan to take a long holiday before year's end and want to
update the next year's value beforehand.

-Y, --no-year
Disable updating year.

Miscellaneus options
-h, --help
Display help.

--help-exclude
Display default values used to exclude paths and files.

--help-html
Display help in HTML format.

--help-man
Display help in manual page man(1) format.

-V, --version
Display contact and version information.

EXAMPLES


The primary use is to update files to reflect current year; option --year is implicit:

copyright-update *

To test what would happen:

copyright-update --verbose 1 --test *

Update only C-code file:

copyright-update --verbose 1 --include '\.[ch]$' --recursive .

It is possible to restrict updating files recursively to only those files whose content
match regexp. Here, the lines affected are those that match --line regular expression.

copyright-update \
--regexp '(?i)Author:.*John.*Doe' \
--line '\bFoo\b' \
--ignore '\.(bak|bup|[~#]])$' \
--verbose 1 \
--year 2013 \
--test \
--recursive \
.

TROUBLESHOOTING


See option --debug.

ENVIRONMENT


EMAIL
In the form "firstname.lastname@example.com"; that is, without the angles <>. If set,
the value is used in option --auto only if environment variable NAME is not set.

In order to find first and lastname, the localpart in email address must match case
insensitive regexp '^[a-z-]+\.[a-z-]+@':

address@example.com Not used, not in form First.Last
+------ +----------

mr.first.lastname@example.com Not used, likewise
+---------------- +----------
| |
Localpart Domain part

NAME
In the form "Firstname Lastname". If set, the value is used in option --auto.

Use copyright-update online using onworks.net services


Free Servers & Workstations

Download Windows & Linux apps

  • 1
    PAC Manager
    PAC Manager
    PAC is a Perl/GTK replacement for
    SecureCRT/Putty/etc (linux
    ssh/telnet/... gui)... It provides a GUI
    to configure connections: users,
    passwords, EXPECT regula...
    Download PAC Manager
  • 2
    GeoServer
    GeoServer
    GeoServer is an open-source software
    server written in Java that allows users
    to share and edit geospatial data.
    Designed for interoperability, it
    publishes da...
    Download GeoServer
  • 3
    Firefly III
    Firefly III
    A free and open-source personal finance
    manager. Firefly III features a
    double-entry bookkeeping system. You can
    quickly enter and organize your
    transactions i...
    Download Firefly III
  • 4
    Apache OpenOffice Extensions
    Apache OpenOffice Extensions
    The official catalog of Apache
    OpenOffice extensions. You'll find
    extensions ranging from dictionaries to
    tools to import PDF files and to connect
    with ext...
    Download Apache OpenOffice Extensions
  • 5
    MantisBT
    MantisBT
    Mantis is an easily deployable, web
    based bugtracker to aid product bug
    tracking. It requires PHP, MySQL and a
    web server. Checkout our demo and hosted
    offerin...
    Download MantisBT
  • 6
    LAN Messenger
    LAN Messenger
    LAN Messenger is a p2p chat application
    for intranet communication and does not
    require a server. A variety of handy
    features are supported including
    notificat...
    Download LAN Messenger
  • More »

Linux commands

Ad