.TH darksky 1
.SH NAME
darksky \- print weather report from forecast.io
.SH SYNOPSIS
.B darksky
[
.I -acdhmDHM
]
.SH DESCRIPTION
.I Darksky
prints the weater report for the current location. Options control
which types of data are printed:
.TP
.B -a
Explicitly mention a lack of warnings.
.TP
.B -c
Print the current conditions and temperature.
.TP
.B -d
Print a daily forecast for the next seven days.
.TP
.B -h
Print an hourly forecast for the next 24 hours.
.TP
.B -m
Print a forecast for the next 60 minutes, with a
graph of upcoming precipitation.
.TP
.B -D
Print a one-line summary of the the daily forecast.
.TP
.B -H
Print a one-line summary of the hourly forecast.
.TP
.B -M
Print a one-line summary of the minutely forecast,
without the percipitation graph.
.PP
Options can be combined arbitarially. The summary options will
override the others. Requested data types are always printed in
order of increasing length of time.
If no options are given,
.I darksky
will print the current conditions, the forecast for the upcoming
hour, and a summary of the upcoming day and week (equivalent to
.IR -cmHD ).
If any weather alerts are in
effect, they will be printed. The
.I -a
flag allows
.I darksky
to check only for such alerts.
.PP
.I Darksky
uses
.IR webfs (4)
to connect to the 
.I forecast.io
server; it must be mounted on
.B /mnt/web
beforehand.
.SH EXAMPLES
Check the current conditions and the next hour:
.EX
: ; darksky -cm
Conditions as of Sun Jun 14 17:12:52 EDT 2015
	Mostly Cloudy, 77.21°
Forecast for the next hour:
	Mostly cloudy for the hour.
	                                                             
.EE
Get an overview of the next week:
.EX
: ; darksky -cMHD
Conditions as of Sun Jun 14 17:15:09 EDT 2015
	Mostly Cloudy, 77.2°
	Mostly cloudy for the hour.
	Light rain throughout the day.
	Rain throughout the week, with temperatures bottoming out at 74°F on Tuesday.
.EE
.SH FILES
.TF $home/lib/darksky
.TP
.B $home/lib/darksky
API key from https://developer.forecast.io/register
.TP
.B /lib/sky/here
location as latitude (N), longitude (W), and elevation (meters)
.SH SOURCE
.B /n/sources/contrib/anothy/src/cmd/darksky.c
.SH SEE ALSO
.IR webfs (4),
.IR weather (1),
.IR https://forecast.io ,
.I https://bitbucket.org/bedo/9son
.SH BUGS
We rely on
.I forecast.io
to guess the proper units to use for your location.