GBCH-HOLS(1)

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.