gbch-hols - maintain holidays file

# 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.