gbch-hols - maintain holidays file
gbch-hols [ -options ] year [ file ]
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.
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
.
causes a summary of the other options to be displayed without taking further action.
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
Set the holidays specified on standard input or the specified file if given. Month names may be given in abbreviated or full format.
Clear the existing holidays before setting.
Do not clear the existing holidays before setting.
Save all the current options in a .gnubatch file in the current directory. If this option is specified, there is no further action.
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.
~/.gnubatch configuration file (home directory)
.gnubatch configuration file (current directory)
btrest.help message file
space-separated options to override defaults for gbch-start
btsyntax(5)
,
gnubatch.conf(5),
gnubatch.hosts(5),
btsched(8)
,
xbnetserv(8)
.
Various diagnostics are read and printed as required from the message file btrest.help.
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.
John M Collins, Xi Software Ltd.