NAME

gbch-hols - maintain holidays file


SYNOPSIS

gbch-hols [ -options ] year [ file ]


DESCRIPTION

gbch-hols sets or displays the contents of the holidays file for the given year, as used by the "holiday" option of the "days to avoid" selection of repeats of GNUbatch jobs.


OPTIONS

Note that the order of treatment, letters and keywords described below may be modified by editing the file btrest.help - see btsyntax(5).

The environment variable on which options are supplied is GBCH_HOLS and the environment variable to specify the help file is BTRESTCONF.

-? or +explain

causes a summary of the other options to be displayed without taking further action.

-d or +display

Display the holiday file contents for the given year. This option is selected by default.

If a file name is given, it is created and output is to that file, otherwise output is to standard output.

The format is as follows:

 January:1
 December:25
-s or +set

Set the holidays specified on standard input or the specified file if given. Month names may be given in abbreviated or full format.

-C or +clear

Clear the existing holidays before setting.

-r or +no-clear

Do not clear the existing holidays before setting.

+freeze-current

Save all the current options in a .gnubatch file in the current directory. If this option is specified, there is no further action.

+freeze-home

Save all the current options in a .gnubatch file in the user's home directory. If this option is specified, there is no further action.


FILES

~/.gnubatch configuration file (home directory)

.gnubatch configuration file (current directory)

btrest.help message file


ENVIRONMENT

GBCH_HOLS

space-separated options to override defaults for gbch-start


SEE ALSO

btsyntax(5), gnubatch.conf(5), gnubatch.hosts(5), btsched(8), xbnetserv(8).


DIAGNOSTICS

Various diagnostics are read and printed as required from the message file btrest.help.


COPYRIGHT

Copyright (c) 2009 Free Software Foundation, Inc. This is free software. You may redistribute copies of it under the terms of the GNU General Public License <http://www.gnu.org/licenses/gpl.html>. There is NO WARRANTY, to the extent permitted by law.


AUTHOR

John M Collins, Xi Software Ltd.