aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorMattias Andrée <m@maandree.se>2026-02-22 15:02:34 +0100
committerMattias Andrée <m@maandree.se>2026-02-22 15:02:34 +0100
commit3371cc97a6f63e105f3745d2c34eb6b4391b2370 (patch)
tree5c83fcf4b9da8121260f249703ca6e6284253e76
parentUpdate e-mail (diff)
downloadblue-3371cc97a6f63e105f3745d2c34eb6b4391b2370.tar.gz
blue-3371cc97a6f63e105f3745d2c34eb6b4391b2370.tar.bz2
blue-3371cc97a6f63e105f3745d2c34eb6b4391b2370.tar.xz
Signed-off-by: Mattias Andrée <m@maandree.se>
-rw-r--r--DEPENDENCIES2
-rw-r--r--README24
-rw-r--r--blue.130
3 files changed, 27 insertions, 29 deletions
diff --git a/DEPENDENCIES b/DEPENDENCIES
index bc11c99..b1a8369 100644
--- a/DEPENDENCIES
+++ b/DEPENDENCIES
@@ -3,12 +3,10 @@ RUNTIME DEPENDENCIES:
python3
solar-python
-
BUILD DEPENDENCIES:
(no build required)
-
INSTALL DEPENDENCIES:
make
diff --git a/README b/README
index 6086862..c626461 100644
--- a/README
+++ b/README
@@ -1,12 +1,12 @@
NAME
- blue - Creates table of when the blue hour etc. occurs
+ blue - Creates a table of when the blue hour etc. occurs
-SYNPOSIS
+SYNOPSIS
blue [-d delev] ... [-D delev] ... [-e elev] ... [-m elev] ... [-hL | -u] \
[-l lat:lon | -l loc] [-s year-month-day | -s -] [-r num[h|m|s]] [-bBgGnN]
DESCRIPTION
- blue prints a list of time point when the select event occurs.
+ blue prints a list of time points when the selected event occurs.
OPTIONS
-b
@@ -38,18 +38,18 @@ OPTIONS
-l LATITUDE:LONGITUDE
Tell blue where you are. The values are measured in degrees
- and in the GPS (you probably do not have too care about that,
+ and in the GPS (you probably do not have to care about that;
the differences between the systems should not be significant
- another), and must be in decimal.
+ in another), and must be in decimal.
Reminder for Americans (particularly US Americans), you are
- an the western hemisphere, not the eastern, thus your longtiude
+ in the western hemisphere, not the eastern, thus your longitude
is negative. If you experience weird time listings, 100 % of
the times it is because you forgot the minus sign. But no need
to feel stupid, it is a really common mistake.
No complicated stuff please, only latitudes within ±90° and
- longitudes within ±180°. No unit thought.
+ longitudes within ±180°. No units though.
-l LOCATION
Use a named location. In particular, the one stored in the
@@ -72,8 +72,8 @@ OPTIONS
List the time of solar midnight.
-r RES
- Print the in RES resultion. RES must be an integer followed
- by on the the suffixes:
+ Print results in RES resolution. RES must be an integer followed
+ by one of the suffixes:
h hours
m minutes (min is not a valid suffix)
@@ -82,7 +82,7 @@ OPTIONS
For example: -r 15m prints the nearest quarters of the times.
-s DATE
- The last date (local time) to include in the last. DATE must
+ The last date (local time) to include in the list. DATE must
be in %Y-%m-%d (year dash month dash day) format. A dash (-)
for an infinite list. Default limit is one month.
@@ -100,7 +100,7 @@ FILES
even if it is empty, is used.
/etc/geolocation
- Fallback file use if ~/.config/geolocation is missing. Other
+ Fallback file used if ~/.config/geolocation is missing. Other
programs are encouraged to use this file too.
~/.config/geolocation.d/
@@ -115,7 +115,7 @@ FILES
programs are encouraged to use this directory too.
RATIONALE
- This is useful if you plan to take nice photographies, for example
+ This is useful if you plan to take nice photographs, for example
during the blue hours, or the golden hour. But mostly, I just made
this because I could.
diff --git a/blue.1 b/blue.1
index daf062d..830d66b 100644
--- a/blue.1
+++ b/blue.1
@@ -1,7 +1,7 @@
.TH BLUE 1 BLUE
.SH NAME
-blue - Creates table of when the blue hour etc. occurs
-.SH SYNPOSIS
+blue \- Creates a table of when the blue hour etc. occurs
+.SH SYNOPSIS
.B blue
.RB [ -d \ \fIdelev\fP]\ ...
.RB [ -D \ \fIdelev\fP]\ ...
@@ -28,7 +28,7 @@ blue - Creates table of when the blue hour etc. occurs
.RB [ -bBgGnN ]
.SH "DESCRIPTION"
.B blue
-prints a list of time point when the select event occurs.
+prints a list of time points when the selected event occurs.
.SH "OPTIONS"
.TP
.B -b
@@ -64,18 +64,18 @@ Print times in human readable format.
.TP
.RI \fB-l\fP\ latitude : longitude
Tell blue where you are. The values are measured in degrees
-and in the GPS (you probably do not have too care about that,
+and in the GPS (you probably do not have to care about that;
the differences between the systems should not be significant
-another), and must be in decimal.
+in another), and must be in decimal.
Reminder for Americans (particularly US Americans), you are
-an the western hemisphere, not the eastern, thus your longtiude
+in the western hemisphere, not the eastern, thus your longitude
is negative. If you experience weird time listings, 100 % of
the times it is because you forgot the minus sign. But no need
to feel stupid, it is a really common mistake.
No complicated stuff please, only latitudes within ±90° and
-longitudes within ±180°. No unit thought.
+longitudes within ±180°. No units though.
.TP
.BI -l\ location
Use a named location. In particular, the one stored in the
@@ -93,7 +93,7 @@ Print times in local time.
.BI -e\ elev
List the time when the Sun's elevation is
.I elev
-and the firs derivative of the Sun's elevation is
+and the first derivative of the Sun's elevation is
non-negative (morning).
.TP
.B -n
@@ -103,11 +103,11 @@ List the time of solar noon.
List the time of solar midnight.
.TP
.BI -r\ res
-Print the in
+Print results in
.I res
-resultion.
+resolution.
.I res
-must be an integer followed by on the the suffixes:
+must be an integer followed by one of the suffixes:
.nf
h hours
@@ -120,7 +120,7 @@ For example:
prints the nearest quarters of the times.
.TP
.BI -s\ date
-The last date (local time) to include in the last.
+The last date (local time) to include in the list.
.I date
must be in
.B %Y-%m-%d
@@ -143,7 +143,7 @@ If the file contains more than one line, only the first line,
even if it is empty, is used.
.TP
.B /etc/geolocation
-Fallback file use if ~/.config/geolocation is missing. Other
+Fallback file used if ~/.config/geolocation is missing. Other
programs are encouraged to use this file too.
.TP
.B ~/.config/geolocation.d/
@@ -157,11 +157,11 @@ location is not listed in ~/.config/geolocation.d/. The files
are formatted in the same way as ~/.config/geolocation. Other
programs are encouraged to use this directory too.
.SH "RATIONALE"
-This is useful if you plan to take nice photographies, for example
+This is useful if you plan to take nice photographs, for example
during the blue hours, or the golden hour. But mostly, I just made
this because I could.
.SH "NOTES"
-US Americans, remember, you are on the Western Hemisphere.
+US Americans, remember, you are on the western hemisphere.
Therefore, you should specify a negative longitude.
.SH "SEE ALSO"
.BR locateme (1)