1. 1
2. 2
3. 3
4. 4
5. 5
6. 6
7. 7
8. 8
9. 9
10. 10
11. 11
12. 12
13. 13
14. 14
15. 15
16. 16
17. 17
18. 18
19. 19
20. 20
21. 21
22. 22
23. 23
24. 24
25. 25
26. 26
27. 27
28. 28
29. 29
30. 30
31. 31
32. 32
33. 33
34. 34
35. 35
36. 36
37. 37
38. 38
39. 39
40. 40
41. 41
42. 42
43. 43
44. 44
45. 45
46. 46
47. 47
48. 48
49. 49
50. 50
51. 51
52. 52
53. 53
54. 54
55. 55
56. 56
57. 57
58. 58
59. 59
60. 60
61. 61
62. 62
63. 63
64. 64
65. 65
66. 66
67. 67
68. 68
69. 69
70. 70
71. 71
72. 72

// Copyright (C) 2025 Shota FUJI
//
// This program is free software: you can redistribute it and/or modify
// it under the terms of the GNU General Public License as published by
// the Free Software Foundation, either version 3 of the License, or
// (at your option) any later version.
//
// This program is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
// GNU General Public License for more details.
//
// You should have received a copy of the GNU General Public License
// along with this program.  If not, see <https://www.gnu.org/licenses/>.
//
// SPDX-License-Identifier: GPL-3.0-only

= sunwait-wait(1)
:docdate: 2025-07-20
:doctype: manpage
:mansource: sunwait

== Name

sunwait-wait - Waits for sunrise and/or sunset

== Synposis

*sunwait* *wait* ++[++[-e | --event _<event>_]...]

== Description

This command sleeps until the next _event_ happens.

== Options

*-e* _<event>_, *--event* _<event>_::
Targets sunrise or sunset when set.
If this option is not set, *sunwait* targets both, which is equivalent of,

+
[,shell]
----
sunwait wait -e sunrise -e sunset
----

+
which means "waits for next sunset or sunrise".
Valid values are:

* *sunrise*   Waits for sunrise, when the Sun rose and the twilight starts.
* *sunset*    Waits for sunset, when the Sun set past the twilight.

== Examples

Waits for 10 minutes before sunset at Giza Necropolis.

[,shell]
----
sunwait wait -e sunset -o 10 --lat 29.977435N --lon 31.132484E
----

Waits until 1 hour 15 minutes before the Sun rises in Greenwich, London.

[,shell]
----
sunwait wait -e sunrise -o -1:15 --lat 51.477932N --lon 0.000000E
----

== See also

*sunwait*(1)