."\ Master source for date_ver manual : /usr/src/local/man/src/date_ver.rof
.TH DATE_VER P "Manual V1.2 for Program V1.7" "Julian Stacey" "Julian Stacey, Vector Systems Ltd"
.\" A4 the cludgy way.
.pl 29.6c
.UC 4
.SH NAME
date_ver \- Produce a C language char string with revision date.
.SH SYNTAX
.B date_ver
[-0] [-n] [-t] [-vVariableName] [-dDays]
.in +5
[-oOutput_file] [-iIncludeLocalFile] [-IincludeSystemFile]
.br
[-bBeginText] [-eEndText]
.in -5
.SH DESCRIPTION
.I Date_ver
is not a standard Unix command, it is unique to VSL systems with the Ournix overlay.
.sp
.I Date_ver
is a tool to help C Program Production.
.I Date_ver
produces to stdout a C character string with a revision date in either a text string or
long numeric format. The date is the date the instant this command is invoked.
It is used by diverting the output to a file, with your C program including the file. The author uses make(1) to call
.I date_ver,
and do the diversion.
.SH OPTIONS
The order used to specify options does not affect the order in which they will
be executed.
.br
The following options are available :
.TP
.B \-0
Initial time stamp is set to zero rather than current time.
.TP
.B \-n
Produce a time stamp as a long numeric value.
.TP
.B \-t
Produce a time stamp as a quoted text string.
.TP
.B \-vVariableName
Specify variable name.
The default name is "time_stamp".
.TP
.B \-dNumber
Produce a time stamp corresponding to a time a number of days from now.
If used in conjunction with -0, sets time n days after beginning of time,
as opposed to the default n days after current time.
.TP
.B \-IincludeSystemFile
Produce a #include <includeSystemFile> line before the time stamp.
This option exists because UCB Make(1) would not pass # character to this program.
Typically used as -Isys/types.h to include a time_t definition.
.TP
.B \-iIncludeLocalFile
Produce a #include "IncludeLocalFile" line before the time stamp.
This option exists because UCB Make(1) would not pass # character to this program.
.TP
.B \-bString
Produce a String of text as a \\n terminated line before doing anything else.
.TP
.B \-eString
Produce a String of text as a \\n terminated line after doing everything else.
.TP
.B \-oOutput_file
Produce output to file instead of stdout.
Filename must immediately follow the -o with no space between -o and file name.
.SH EXAMPLES
Example 1
.ti +5
date_ver -t -d31 -vexpiry -Isys/types.h
.br
Produces :
.in +5
.nf
#include <sys/types.h>
time_t expiry = (time_t) 620850204L ; /* from date_ver */
.fi
.in -5
.sp
Example 2
.ti +5
date_ver -t -d31 -vexpiry -Isys/types.h
.br
Produces :
.in +5
.nf
#include <sys/types.h>
char expiry[] = "Sun Sep  3 11:23:49 1989" ; /* from date_ver */
.fi
.in -5
.sp
.SH LIMITATION
Successive calls of
.I date_ver,
with alternate -t and -n flags will probably not produce identical time stamps,
as successive invocations will probably occur in different second intervals on
your host computer, to get time stamps identical, (both text and numeric),
call
.I date_ver
-n
and then use Ctime(3) when your program runs, to convert the time_t/long
produced by date_ver -n.
.SH EXIT CODE
1 if a syntax invocation error is detected (in which case
.I date_ver
will abort), else 0.
.SH HOST OP SYSTEM
This utility runs on both Msdos 3.2 & Unix UCB BSD 4.2.
.SH ENHANCEMENTS LATER
.TP
.B \-oFile
Will specify output file name. -b- or -b not specified will cause a default
to stdout.
.SH AUTHOR
Program Copyright Julian H. Stacey, Munich, 1988.
.br
Document Copyright Julian H. Stacey 21st May 1996.
.\" earlier actually, but when ?
.so author.jhs
.SH SEE ALSO
make(1), time(3), ctime(3).
.SH FILES
None.
.\ End of file