1. Proper formating of the man page.

2. Corrected the documentation about the possibility to omit the timestamp.
This commit is contained in:
heinzel
2008-02-19 16:48:06 +00:00
parent c1aa247e85
commit 277ef6c1cf
2 changed files with 32 additions and 13 deletions

View File

@@ -1,25 +1,43 @@
.\" unixtime.1 .\" unixtime.1
.TH UNIXTIME 1 "Feb. 2008" "heinzel" .TH UNIXTIME 1 2008-02 "heinzelwerk"
.SH NAME .SH NAME
unixtime \- converts a unix timestamp into a human readable date unixtime \- converts a unix timestamp into a human readable date
.SH SYNOPSIS .SH SYNOPSIS
.B unixtime [-h, --help] [-V, --version] <TIMESTAMP> .B unixtime
.RI [ timestamp ]
.LP
.B unixtime
.BR -h | --help
|
.BR -V | --version
.SH DESCRIPTION .SH DESCRIPTION
\fBunixtime\fP is similar to the standard c library function \fBctime()\fP .B unixtime
print out the date, that is given as
.IR timestamp .
.PP
.I timestamp
should be an integer value, that represent seconds since the Epoch.
.PP
If
.I timestamp
is ommited, it will default to 0, which has the effect, that the
begin of the Epoch will be shown.
.PP
The format of the date string depends on
.BR ctime (3).
.PP
Normal output goes to stdout, errors and warnings to stderr.
.SH OPTIONS .SH BUGS
An integer <TIMESTAMP>, which is a number of seconds since the Epoch. Since I have no true understanding of C, I am sure, there are.
.SH "BUGS" .SH AUTHOR
Since I have no real understanding of C, I am sure, there are.
.SH "AUTHOR"
heinzel <heinzel@heinzelwelt.de> heinzel <heinzel@heinzelwelt.de>
.SH "SEE ALSO" .SH "SEE ALSO"
.BR time (2), .BR ctime (3),
.BR ctime (3) .BR time (2)

View File

@@ -120,9 +120,10 @@ int print_help( void ) {
printf("%s converts a unix timestamp into a human readable date.\n", printf("%s converts a unix timestamp into a human readable date.\n",
progname); progname);
printf("\n"); printf("\n");
printf("Usage: unixtime [-h, --help] [-V, --version] <TIMESTAMP>\n"); printf("Usage: unixtime [<timestamp>]\n"
" [-h, --help] [-V, --version]\n");
printf("\n"); printf("\n");
printf("Where <TIMESTAMP> is the number of seconds since the Epoch\n"); printf("Where <timestamp> is the number of seconds since the Epoch\n");
if((p = strdup(ctime(& t))) != NULL) { if((p = strdup(ctime(& t))) != NULL) {
/* ctime() return the date as string with an appended new line. /* ctime() return the date as string with an appended new line.
* Since we do not want the new line to be printed, we terminate * Since we do not want the new line to be printed, we terminate