This is gcal.info, produced by makeinfo version 4.0 from gcal.texi.

INFO-DIR-SECTION GNU packages
START-INFO-DIR-ENTRY
* Gcal: (gcal).                       GNU calendar program.
* Tcal: (gcal)Invoking tcal.          Run Gcal with tomorrow's date.
* Txt2gcal: (gcal)Invoking txt2gcal.  Calendar text to resource file.
* Gcal2txt: (gcal)Invoking gcal2txt.  Calendar resource to text file.
END-INFO-DIR-ENTRY

  This file documents Gcal, a program for calculating and printing
calendars.

  Copyright (c) 1994, 95, 96, 1997, 2000 Thomas Esken

  This edition is for Gcal version 3.01.

  Permission is granted to make and distribute verbatim copies of this
manual provided the copyright notice and this permission notice are
preserved on all copies.

  Permission is granted to copy and distribute modified versions of this
manual under the conditions for verbatim copying, provided that the
entire resulting derived work is distributed under the terms of a
permission notice identical to this one.

  Permission is granted to copy and distribute translations of this
manual into another language, under the above conditions for modified
versions, except that this permission notice may be stated in a
translation approved by the Free Software Foundation.

  Any suggestions, improvements, extensions, bug reports, donations,
proposals for contract work, and so forth are welcome!  Please send
them directly to my eMail address <esken@gmx.net>.  If you like my
work, I'd appreciate a postcard from you!

------------------------oOO      \\\_''/      OOo---------------------------
Thomas Esken               O     (/o-o\)     O  eMail: esken@gmx.net
Im Hagenfeld 84                 ((  ^  ))       Phone: +49 251 232585
D-48147 Muenster; Germany    \____) ~ (____/    MotD : 2old2live, 2young2die


File: gcal.info,  Node: Obsolete Special Texts,  Next: Format Instruction,  Prev: Special Texts Summary,  Up: Top

Obsolete Special Texts and Format Elements
******************************************

* Menu:

* Table of Obsolete Special Texts::
* Table of Obsolete Date Format Elements::
* Table of Obsolete Date Formats::

  Because Gcal 3.01 is able to represent most special texts which may
occur in the text part of a resource file line (*note Description of
all `%?'... Special Texts: Special Texts.), and most of the format
elements as they may be used in the date format text of the
`--date-format' *Note Calendar option `--date-format=de|us|gb|TEXT':
x-date-format, by using a format instruction, some of them --mainly
introduced in the Gcal versions 2.20 and 2.40-- are obsolete now.  The
following complete tables of all these obsolete special texts
respectively format elements with their new representation, as used by
Gcal 3.01 now, show the changes made.


File: gcal.info,  Node: Table of Obsolete Special Texts,  Next: Table of Obsolete Date Format Elements,  Prev: Obsolete Special Texts,  Up: Obsolete Special Texts

Table of Obsolete Special Texts
===============================

  This table opposes all obsolete special texts as they may be used in
the text part of a resource file line (*note Description of all `%?'...
Special Texts: Special Texts.), and their new representation, as used
by Gcal 3.01 now:

*Symbolic name*                             *Old-style*       *New-style*

%complete weekday name                      `%o'          ==  `%K'
%3-letter weekday name                      `%O'          ==  `%>3#K'
%2-letter weekday name                      `%K'          ==  `%>2#K'
%weekday number (Mon=1...Sun=7)             `%S'          ==  `%W'
%weekday number (Mon=1...Sun=7) ONS         `%I'          ==  `%>1&*W'
%weekday number (Mon=0...Sun=6) ONS         `%J'          ==  `%>1&*E'
%weekday number (Sun=1...Sat=7)             `%('          ==  `%I'
%weekday number (Sun=1...Sat=7) ONS         `%<'          ==  `%>1&*I'
%weekday number (Sun=0...Sat=6)             `%)'          ==  `%J'
%weekday number (Sun=0...Sat=6) ONS         `%>'          ==  `%>1&*J'
%weekday number (Mon=1...Sun=7) FLX         `%['          ==  `%S'
%weekday number (Mon=1...Sun=7) FLX ONS     `%{'          ==  `%>1&*S'
%weekday number (Mon=0...Sun=6) FLX         `%]'          ==  `%T'
%weekday number (Mon=0...Sun=6) FLX ONS     `%}'          ==  `%>1&*T'
%day-of-year number                         `%+'          ==  `%N'
%day-of-year number +LZ                     `%*'          ==  `%>03*N'
%day-of-year number ONS                     `%&'          ==  `%>1&*N'
%day-of-year number +LZ ONS                 `%#'          ==  `%>03&*N'
%day number +LZ                             `%N'          ==  `%>02*D'
%day number ONS                             `%s'          ==  `%>1&*D'
%day number +LZ ONS                         `%u'          ==  `%>02&*D'
%complete month name                        `%M'          ==  `%U'
%3-letter month name                        `%T'          ==  `%>3#U'
%month number                               `%U'          ==  `%M'
%month number +LZ                           `%W'          ==  `%>02*M'
%month number ONS                           `%z'          ==  `%>1&*M'
%month number +LZ ONS                       `%Z'          ==  `%>02&*M'
%complete year number +LZ                   `%='          ==  `%>04*Y'
%age value (birthday) number                `%b'          ==  `%B'
%age value (birthday) number ONS            `%B'          ==  `%>1&*B'
%moon phase                                 `%-'          ==  `%O'
%moon phase +LZ                             `%_'          ==  `%>03*O'
%moon phase text graphics image             `%:'          ==  `%Z'

Legend:

+LZ  ==   With leading zero(es)
FLX  ==   Flexible starting day of week (*note Calendar option
          `--starting-day=ARGUMENT': x-starting-day.)
ONS  ==   With Ordinal Number suffix


File: gcal.info,  Node: Table of Obsolete Date Format Elements,  Next: Table of Obsolete Date Formats,  Prev: Table of Obsolete Special Texts,  Up: Obsolete Special Texts

Table of Obsolete Date Format Elements
======================================

  This table opposes all obsolete date format elements as they may be
used in the date format text of the `--date-format' option (*note
Calendar option `--date-format=de|us|gb|TEXT': x-date-format.), and
their new representation, as used by Gcal 3.01 now:

*Symbolic name*                      *Old-style*       *New-style*

%day number                          `%d'          ==  `%>02*D'
%day number +LS                      `%D'          ==  `%>2*D'
%day number +LZ ONS                  `%u'          ==  `%02&*D'
%day number +LS ONS                  `%U'          ==  `%>2&*D'
%complete month name                 `%B'          ==  `%U'
%3-letter month name                 `%b'          ==  `%<3#U'
%month number +LZ                    `%m'          ==  `%>02*M'
%month number +LS                    `%M'          ==  `%>2*M'
%complete year number +LZ            `%y'          ==  `%>04*Y'
%complete year number +LZ            `%Y'          ==  `%>4*Y'
%last-2-digits year number +LZ       `%z'          ==  `%>02#Y'
%last-2-digits year number +LS       `%Z'          ==  `%>2#Y'
%complete weekday name               `%A'          ==  `%K'
%3-letter weekday name               `%W'          ==  `%<3#K'
%2-letter weekday name               `%w'          ==  `%<2#K'

Legend:

+LZ  ==   With leading zero(es)
+LS  ==   With leading space(s)
ONS  ==   With Ordinal Number suffix


File: gcal.info,  Node: Table of Obsolete Date Formats,  Prev: Table of Obsolete Date Format Elements,  Up: Obsolete Special Texts

Table of Obsolete Date Formats
==============================

  This table opposes all obsolete date format texts as they may be used
in the fixed defaults of the country specific date formats of the
`--date-format' option for German users, U.S. american users and users
in Great Britain (*note Calendar option `--date-format=de|us|gb|TEXT':
x-date-format.), and their new representation, as used by Gcal
3.01 now:

*CC*    *Old-style*                *New-style*

DE      `%w,  %1%D%2 %b %y'    ==  `%<2#K,  %1%>2*D%2 %<3#U %>04*Y'
US      `%W, %b  %1%U%2 %y'    ==  `%<3#K, %<3#U  %1%>2&*D%2 %>04*Y'
GB      `%W,  %1%U%2 %b %y'    ==  `%<3#K,  %1%>2&*D%2 %<3#U %>04*Y'


File: gcal.info,  Node: Format Instruction,  Next: Coding Scheme,  Prev: Obsolete Special Texts,  Up: Top

Format Instruction
******************

  Gcal 3.01 is able to represent text variables, special texts and date
formats especially in a very comfortable and uniform manner by using a
format instruction.

  Here comes the description of the format instruction components, now
called FORMAT in the further context.  In general, the template of a
format instruction is:

     ALIGNMENT [SIGN] [ZERO] WIDTH [STYLE] [SUFFIX] FORMAT

  If a FORMAT of above mentioned template is used, its components must
be specified in the above mentioned order, at which the definition of
the components embraced by `[ ]' is of course optional.  The single
components of the format instruction are assembled as follows:

*Character* *Description of the components*

            ALIGNMENT group (exactly one member must be defined):
`<'         Field contents is placed at the left margin of the field by
            using the width WIDTH
`:'         Field contents is placed in centered manner in the field by
            using the width WIDTH
`>'         Field contents is placed at the right margin of the field by
            using the width WIDTH

            SIGN (may be defined):
`+'         Numerical value is provided with leading sign

            ZERO (may be defined):
`0'         Numerical value is filled with leading zero(es)

            WIDTH (must be defined):
N           Field has the width N (actual range 1...256).

            STYLE group (exactly one member may be defined):
`u'         Field contents is converted to upper-case letters
`l'         Field contents is converted to lower-case letters
`w'         Field contents is converted to capitalized words

            SUFFIX (may be defined):
`&'         Numerical value is provided with an Ordinal Number suffix

            FORMAT group (exactly one member must be defined):
`*'         Field contents is not cut after position WIDTH
`#'         Field contents is cut after position WIDTH

  If a given WIDTH component is greater 256 but less than 999, a field
width of 256 is assumed.  But if a given WIDTH component is zero, this
interrupts the interpretation phase of Gcal so that the complete FORMAT
is not interpreted anymore and is therefore displayed respectively
assigned as is.  The same happens if a component is misspelled, given
in wrong order, or one of the required components is unspecified.

  Furthermore, a STYLE component may be specified case-independently.
*Note Calendar option `--translate-string=TEXT': x-translate-string,
for further annotations how the STYLE component is used correctly.


File: gcal.info,  Node: Coding Scheme,  Next: Environment Variables,  Prev: Format Instruction,  Up: Top

Coding Scheme
*************

* Menu:

* Coding Scheme Table 1::
* Coding Scheme Table 2::

  The following coding scheme tables explain the relations between the
_date part_ (YYYY...) of a resource file line and the modifiers, the
short-style option `-c|C[]' --which is used for enabling the fixed date
feature-- respectively the `--period-of-fixed-dates=ARGUMENT'
long-style option may have, i.e. they point out all possible
correspondences.  This is necessary because Gcal does not respect all
entries found in a resource file if a _fixed date_ argument is given,
it respects only those entries which have a definite relation to the
_fixed date_ argument to avoid the output of redundant information!
*Note Fixed dates option `--period-of-fixed-dates=ARGUMENT':
x-period-of-fixed-dates, for further details.

In the _date part_ YYYY...:

YYYY
     represents any year number (`0001...9999').

MM
     represents any month number (`01...12' or `99') respectively any
     textual short month name with length of 3 characters (`Jan',
     `Feb'...).

DD
     represents any day number (`01...28', `29', `30', `31' or `99').

WWW
     represents any textual short weekday name with length of 2...3
     characters (`Mon...Sun').

?
     represents any case-insensitive single letter.

N
     represents any positive integer number (one or more digits).


File: gcal.info,  Node: Coding Scheme Table 1,  Next: Coding Scheme Table 2,  Prev: Coding Scheme,  Up: Coding Scheme

Coding Scheme Table 1
=====================

  This table opposes all possible encode variations of a date given in
the _date part_ of resource file with all fitting modifiers of the
short-style option `-c|C[]'.

*Please note:*
The `-c', `-ct', `-cNd', `-c*d|wN[WWW]', `-c@?[[+|-]N[WWW]]', `-cMMDD'
and `-cMMWWWN' options respect *all* encode variations of the _date
part_!

*Date part*               *Short-style option `-c|C[]'*

`00000000'                `-cN+|-'
`000000DD'                `-cNw|+|-', `-cw[+|-]', `-cm[+|-]'
`0000MM00'                `-cN+|-'
`0000MMDD'                `-cNw|+|-', `-cw[+|-]', `-cm[+|-]', `-cy[+|-]',
                          `-clNd|w|+|-', `-cl*d|wN[WWW]',
                          `-cl@?[[+|-]N[WWW]]', `-clMMDD', `-clMMWWWN'
`YYYY0000'                `-cN+|-'
`YYYY00DD'                `-cNw|+|-', `-cw[+|-]', `-cm[+|-]'
`YYYYMM00'                `-cN+|-'
`YYYYMMDD'                `-cNw|+|-', `-cw[+|-]', `-cm[+|-]', `-cy[+|-]',
                          `-clNd|w|+|-', `-cl*d|wN[WWW]',
                          `-cl@?[[+|-]N[WWW]]', `-clMMDD', `-clMMWWWN'
`000000WWWN'              `-cNw|+|-', `-cw[+|-]', `-cm[+|-]'
`0000MMWWWN'              `-cNw|+|-', `-cw[+|-]', `-cm[+|-]', `-cy[+|-]',
                          `-clNd|w|+|-', `-cl*d|wN[WWW]',
                          `-cl@?[[+|-]N[WWW]]', `-clMMDD', `-clMMWWWN'
`YYYY00WWWN'              `-cNw|+|-', `-cw[+|-]', `-cm[+|-]'
`YYYYMMWWWN'              `-cNw|+|-', `-cw[+|-]', `-cm[+|-]', `-cy[+|-]',
                          `-clNd|w|+|-', `-cl*d|wN[WWW]',
                          `-cl@?[[+|-]N[WWW]]', `-clMMDD', `-clMMWWWN'
`0000*dN[WWW]'            `-cNw|+|-', `-cw[+|-]', `-cm[+|-]', `-cy[+|-]',
                          `-clNd|w|+|-', `-cl*d|wN[WWW]',
                          `-cl@?[[+|-]N[WWW]]', `-clMMDD', `-clMMWWWN'
`YYYY*dN[WWW]'            `-cNw|+|-', `-cw[+|-]', `-cm[+|-]', `-cy[+|-]',
                          `-clNd|w|+|-', `-cl*d|wN[WWW]',
                          `-cl@?[[+|-]N[WWW]]', `-clMMDD', `-clMMWWWN'
`0000*wN[WWW]'            `-cNw|+|-', `-cw[+|-]', `-cm[+|-]', `-cy[+|-]',
                          `-clNd|w|+|-', `-cl*d|wN[WWW]',
                          `-cl@?[[+|-]N[WWW]]', `-clMMDD', `-clMMWWWN'
`YYYY*wN[WWW]'            `-cNw|+|-', `-cw[+|-]', `-cm[+|-]', `-cy[+|-]',
                          `-clNd|w|+|-', `-cl*d|wN[WWW]',
                          `-cl@?[[+|-]N[WWW]]', `-clMMDD', `-clMMWWWN'
`0000@?[+|-]N[WWW]'       `-cNw|+|-', `-cw[+|-]', `-cm[+|-]', `-cy[+|-]',
                          `-clNd|w|+|-', `-cl*d|wN[WWW]',
                          `-cl@?[[+|-]N[WWW]]', `-clMMDD', `-clMMWWWN'
`YYYY@?[+|-]N[WWW]'       `-cNw|+|-', `-cw[+|-]', `-cm[+|-]', `-cy[+|-]',
                          `-clNd|w|+|-', `-cl*d|wN[WWW]',
                          `-cl@?[[+|-]N[WWW]]', `-clMMDD', `-clMMWWWN'


File: gcal.info,  Node: Coding Scheme Table 2,  Prev: Coding Scheme Table 1,  Up: Coding Scheme

Coding Scheme Table 2
=====================

  This table opposes all fitting modifiers of the short-style option
`-c|C[]' with all possible encode variations of a date given in the
_date part_ of resource file.

*Short-style option       *Date part*
`-c|C[]'*                 

`-c'                      
`-ct'                     
`-cNd|+|-'                
`-cMMDD'                  
`-cMMWWWN'                
`-c*d|wN[WWW]'            
`-c@?[[+|-]N[WWW]]'       `00000000', `0000MM00', `YYYY0000', `YYYYMM00',
                          `000000DD', `0000MMDD', `YYYY00DD', `YYYYMMDD',
                          `000000WWWN', `0000MMWWWN', `YYYY00WWWN',
                          `YYYYMMWWWN', `0000*dN', `0000*dNWWW',
                          `YYYY*dN', `YYYY*dNWWW', `0000*wN',
                          `0000*wNWWW', `YYYY*wN', `YYYY*wNWWW',
                          `0000@?[+|-]N', `0000@?[+|-]NWWW',
                          `YYYY@?[+|-]N', `YYYY@?[+|-]NWWW'
`-cNw'                    
`-cw[+|-]'                `000000DD', `0000MMDD', `YYYY00DD', `YYYYMMDD',
                          `000000WWWN', `0000MMWWWN', `YYYY00WWWN',
                          `YYYYMMWWWN', `0000*dN', `0000*dNWWW',
                          `YYYY*dN', `YYYY*dNWWW', `0000*wN',
                          `0000*wNWWW', `YYYY*wN', `YYYY*wNWWW',
                          `0000@?[+|-]N', `0000@?[+|-]NWWW',
                          `YYYY@?[+|-]N', `YYYY@?[+|-]NWWW'
`-cm[+|-]'                `000000DD', `0000MMDD', `YYYY00DD', `YYYYMMDD',
                          `000000WWWN', `0000MMWWWN', `YYYY00WWWN',
                          `YYYYMMWWWN', `0000*dN', `0000*dNWWW',
                          `YYYY*dN', `YYYY*dNWWW', `0000*wN',
                          `0000*wNWWW', `YYYY*wN', `YYYY*wNWWW',
                          `0000@?[+|-]N', `0000@?[+|-]NWWW',
                          `YYYY@?[+|-]N', `YYYY@?[+|-]NWWW'
`-cy[+|-]'                
`-clNd|w|+|-'             
`-clMMDD'                 
`-clMMWWWN'               
`-cl*d|wN[WWW]'           
`-cl@?[[+|-]N[WWW]]'      `0000MMDD', `YYYYMMDD', `0000MMWWWN',
                          `YYYYMMWWWN', `0000*dN', `0000*dNWWW',
                          `YYYY*dN', `YYYY*dNWWW', `0000*wN',
                          `0000*wNWWW', `YYYY*wN', `YYYY*wNWWW',
                          `0000@?[+|-]N', `0000@?[+|-]NWWW',
                          `YYYY@?[+|-]N', `YYYY@?[+|-]NWWW'


File: gcal.info,  Node: Environment Variables,  Next: Error Codes,  Prev: Coding Scheme,  Up: Top

Environment Variables
*********************

Here is a table of all environment variables which are used by Gcal:

`GCAL'
`GCAL_OPT'
     Flags which are passed to the Gcal program automatically.

`GCAL_COLUMNS'
`COLUMNS'
     Sets the number of columns on the screen.  Takes precedence over
     the number of columns specified by the `TERM' environment variable
     or the system itself.

`GCAL_DATE_FORMAT'
     Contains the date format text which defines the ordering of a
     displayed date.  Takes precedence over the default date format
     text.

`GCAL_LINES'
`LINES'
     Sets the number of lines on the screen.  Takes precedence over the
     number of lines specified by the `TERM' environment variable or
     the system itself.

`GCAL_SYS_DATADIR'
     Name of a file directory absolute to the _root_/$PREFIX file
     directory, where the system-administrator stores common, _public
     access_ resource files (dates files).

`GCAL_USR_DATADIR'
     Name of a file directory relative to the `HOME' file directory,
     where the user stores personal, respectively _private access_
     resource files (dates files).  Takes precedence over
     `GCAL_SYS_DATADIR'.

`GCALANSI'
     If defined or set, ANSI escape highlighting sequences are used
     respectively substituted by default if no other highlighting
     sequences are defined by command line option or found in the
     Termcap library.

`GCALPATH'
     (`:') colon-separated list of file directories which are searched
     to find the `.gcalrc' file.  Takes precedence over `HOME',
     `GCAL_USR_DATADIR' and `GCAL_SYS_DATADIR'.

`GCALPROG'
     Contains the file name of the executable Gcal program that is used
     by the Tcal program to call the Gcal program.  Takes precedence
     over the file name `gcal' which is burned-in during the
     compilation step of the Tcal program.  The `GCALPROG' environment
     variable must always be set if the Gcal program is installed under
     another name than the standard name `gcal', otherwise Tcal is
     unable to execute the Gcal program automatically!

`HOME'
     Name of the user's home file directory.  This is used to find the
     `.gcalrc' file.  Takes precedence over `GCAL_USR_DATADIR' and
     `GCAL_SYS_DATADIR'.

`LANGUAGE'
     The national language and other cultural-specific conventions used
     by Gcal at run-time.  Takes precedence over `LC_ALL', `LC_MESSAGES'
     and `LANG'.

`LC_ALL'
     The national language and other cultural-specific conventions used
     by Gcal at run-time.  Takes precedence over `LC_MESSAGES' and
     `LANG'.

`LC_MESSAGES'
     The national language and other cultural-specific conventions used
     by Gcal at run-time.  Takes precedence over `LANG'.

`LANG'
     The national language and other cultural-specific conventions used
     by Gcal at run-time.

`LOGNAME'
     The eMail address which is used if the mailing option is wanted.
     *Note Global option `--mail[=ADDRESS]': x-mail, for more details.

`MAILPROG'
     Name of the mailer program which is used if the mailing option is
     wanted.  Takes precedence over the file name `mail' which is
     burned-in during the compilation step of the Gcal program.  *Note
     Global option `--mail[=ADDRESS]': x-mail, for more details.

`MAILTO'
     The eMail address which is used if the mailing option is wanted.
     Takes precedence over `USER' and `LOGNAME'.  *Note Global option
     `--mail[=ADDRESS]': x-mail, for more details.

`PAGER'
     Name of the _external pager_ program which is used if the paging
     option is wanted.  *Note Global option `--pager': x-pager, for
     more details.

`PATH'
     (`:') colon-separated list of file directories which are searched
     to find the _external pager_ program.  *Note Global option
     `--pager': x-pager, for more details.

`TERM'
     The type of terminal on which the Gcal program is being run.

`TXT2GCALPROG'
     Contains the file name of the executable Txt2gcal program that is
     used by the Gcal program to call the Txt2gcal program.  Takes
     precedence over the file name `txt2gcal' which is burned-in during
     the compilation step of the Gcal program.  The `TXT2GCALPROG'
     environment variable must always be set if the Txt2gcal program is
     installed under another name than the standard name `txt2gcal',
     otherwise Gcal is unable to execute the Txt2gcal program
     automatically!  *Note Text variables::, for further details.

`TZ'
     The timezone information which is added to the date text of sent
     eMails, created response files and created shell script files.

`USER'
     The eMail address which is used if the mailing option is wanted.
     Takes precedence over `LOGNAME'.  *Note Global option
     `--mail[=ADDRESS]': x-mail, for more details.


File: gcal.info,  Node: Error Codes,  Next: Glossary,  Prev: Environment Variables,  Up: Top

Error Codes
***********

Gcal produces the following _exit codes_:

`127'
     Request for help screen, software license or program version
     (adjustable).

`126'
     Invalid command line argument / option.

`125'
     Year out of range for computing the Easter Sunday's date.

`124'
     Virtual memory exhausted.

`123'
     Invalid date part in resource file or in include file.

`122'
     Invalid month field entry in resource file or in include file.

`121'
     Invalid day field entry in resource file or in include file.

`120'
     Malformed _#include_ statement in resource file or in include file.

`119'
     Illegal recursive/cyclic _#include_ statement in resource file or
     in include file.

`118'
     Resource file or include file not found.

`117'
     Invalid N'th weekday field (only `1...5' or `9' valid).

`116'
     Missing _whitespace_ separator character between _date part_ and
     _text part_.

`115'
     Response file respectively shell script cannot be written.

`114'
     Invalid date variable operation.

`113'
     Referenced date variable undefined.

`112'
     Invalid date value assigned to date variable.

`111'
     Sending output to eMail address failed.

`110'
     Internal error, C function pipe(), fork(), exec*() or unlink()
     failed.

`109'
     Error reading resource, include respectively response file.

`108'
     Illegal character found in response file.

`107'
     Internal error, invalid value for the size of an internal table
     occurred.

`106'
     Invalid date format text specified.

`105'
     Invalid text variable definition.

`104'
     Invalid regular expression search pattern specified.

`3'
     Program aborted by signal.

`2'
     _Exit code_ not equal zero returned by external command.

`1'
     Activated `-c|C[]', `-f|F NAME[+...]' or `-# LINE' option caused
     no output of resource file entries.

`0'
     Normal program termination.

