I am curious to know what people think is the most poorly written man page?
My nomination is for 'date(1)'.
I spent quite some time Googling how to convert Unix epoch time
(seconds) to "readable" format. The solution was this:
$ date --date=@1363483846
Sat Mar 16 21:30:46 EDT 2013
Give the very sparse, cryptic description for the -d option, how does
one make the leap to use @seconds for STRING?
-d, --date=STRING
display time described by STRING, not ‘now’
Not only is this this description cryptic, but it obscures one of the
most useful features for using the date command: date calculations.
For example, the warranty on one of our systems expires in 378 days.
What date is that?
today=$(date +%s)
days=$(( 378*24*60*60 ))
future=$(( $today + $days ))
date --date=@${future}
--
--
Central West End Linux Users Group (via Google Groups)
Main page: http://www.cwelug.org
To post: [email protected]
To subscribe: [email protected]
To unsubscribe: [email protected]
More options: http://groups.google.com/group/cwelug
---
You received this message because you are subscribed to the Google Groups
"Central West End Linux Users Group" group.
To unsubscribe from this group and stop receiving emails from it, send an email
to [email protected].
For more options, visit https://groups.google.com/groups/opt_out.
