Codebase list libhdate / 45d711a
Update manpages hyphen patch. Tzafrir Cohen 10 years ago
1 changed file(s) with 258 addition(s) and 16 deletion(s). Raw diff Collapse all Expand all
22
33 --- a/docs/man/man1/hcal.1
44 +++ b/docs/man/man1/hcal.1
5 @@ -7,13 +7,13 @@
5 @@ -7,13 +7,13 @@ hcal \- displays a Hebrew / Gregorian ca
66 .B hcal
77 [options] [coordinates [timezone]] [[mm] yyyy]
88 .TP
1919 .PP
2020 .SH "DESCRIPTION"
2121 .B hcal
22 @@ -54,7 +54,7 @@
23 .RE
24 .RS 7
25 .B \ \ \ --no-visual
22 @@ -34,77 +34,77 @@ will interpret the given date as a Hebre
23 .PP
24 .SH "OPTIONS"
25 .TP 18
26 -.B \-1 --one-month
27 +.B \-1 \-\-one-month
28 over-ride config file setting if you had set option --three-month as a default there
29 .TP
30 -.B \-3 --three-month
31 +.B \-3 \-\-three-month
32 output previous/next months, side by side. requires 127 columns
33 .TP
34 -.B \-b --bidi
35 +.B \-b \-\-bidi
36 output Hebrew information in Hebrew , in reverse
37 .RE
38 .RS 7
39 -.B \ \ \ --visual
40 +.B \ \ \ \-\-visual
41 \ sequence
42 .P
43 .RE
44 .RS 7
45 -.B \ \ \ --no-bidi
46 +.B \ \ \ \-\-no-bidi
47 \ over-ride config file setting if you had set
48 .RE
49 .RS 7
50 -.B \ \ \ --no-visual
2651 -\ option -bidi as a default there
52 +.B \ \ \ \-\-no-visual
2753 +\ option --bidi as a default there
2854 .TP 18
29 .B \-c --colorize
55 -.B \-c --colorize
56 +.B \-c \-\-colorize
3057 output in calming, muted tones
31 @@ -81,7 +81,7 @@
58 .RE
59 .RS 7
60 -.B \ \ \ --no-color
61 +.B \ \ \ \-\-no-color
62 \ over-ride config file setting
63 .TP 18
64 -.B \-d --diaspora
65 +.B \-d \-\-diaspora
66 use diaspora reading and holidays. Only relevant if hcal is using location information indicating an Israeli timezone
67 .TP
68 -.B \-f --footnote
69 +.B \-f \-\-footnote
70 output descriptive notes of holidays
71 .RE
72 .RS 7
73 -.B \ \ \ --no-footnote
74 +.B \ \ \ \-\-no-footnote
75 \ over-ride config file setting
76 .TP 18
77 -.B \-h --html
78 +.B \-h \-\-html
79 output in html format to stdout
80 .RE
81 .RS 7
82 -.B \ \ \ --no-html
83 +.B \ \ \ \-\-no-html
3284 \ over-ride config file setting
3385 .TP 18
3486 .B \-H --hebrew
3587 -output Hebrew information in Hebrew, in 'logical' sequence. If this displays in reverse for you, use option -b
3688 +output Hebrew information in Hebrew, in 'logical' sequence. If this displays in reverse for you, use option \-b
3789 .TP
38 .B \-I --israel
90 -.B \-I --israel
91 +.B \-I \-\-israel
3992 override a diaspora default. Only relevant if hcal is using location information indicating other than an Israeli timezone
40 @@ -153,7 +153,7 @@
93 .TP
94 .B \-i
95 use external css file "./hcal.css" for html output
96 .TP
97 -.B \ \ \ \--no-reverse
98 +.B \ \ \ \-\-no\-reverse
99 do not highlight today's date
100 .TP
101 -.B \-p --parasha
102 +.B \-p \-\-parasha
103 output week's parasha on each calendar row
104 .TP
105 -.B \-s --shabbat
106 +.B \-s \-\-shabbat
107 output Shabbat times and parshiot
108 .TP
109 -.B \-l --latitude
110 +.B \-l \-\-latitude
111 [NS]yy[.yyy] decimal degrees, or [NS]yy[:mm[:ss]] degrees, minutes, seconds. Negative values are South
112 .TP
113 -.B \-L --longitude
114 +.B \-L \-\-longitude
115 [EW]xx[.xxx] decimal degrees, or [EW]xx[:mm[:ss]] degrees, minutes, seconds. Negative values are West
116 .TP
117 -.B \-z --timezone
118 +.B \-z \-\-timezone
119 \+/-UTC. Notation may be in decimal hours ( hh[.hh] ) or hours, minutes ( hh[:mm] )
120 .SH NOTES
121 .SS "HOLIDAYS"
122 @@ -153,7 +153,7 @@ Gregorian and Hebrew dates, as follows:
41123 \ Other Israeli National days
42124 .RE
43125 .P
44126 -Use the -f (--footnote) option to have hcal describe what any particular day is marking.
45 +Use the \-f (--footnote) option to have hcal describe what any particular day is marking.
127 +Use the \-f (\-\-footnote) option to have hcal describe what any particular day is marking.
46128 .SS LOCATIONS
47129 If you want
48130 .B hcal
49 @@ -174,7 +174,7 @@
131 @@ -164,9 +164,9 @@ requires location and time zone informat
132 uses your computer's local time zone information as an indicator, and either picks a city in that time zone, or defaults to the equator at the center of that time zone. If
133 .B hcal
134 can't even retrieve time zone information from your computer, it defaults to Tel-Aviv. For other locations, use the
135 -.B -l -L
136 +.B \-l \-L
137 option pair. For other timezones, use the
138 -.B -z
139 +.B \-z
140 option. Co-ordinates and standard time zones for some common locations are listed below.
141 .PP
142 The current defaults include:
143 @@ -174,7 +174,7 @@ The current defaults include:
50144 Timezone Default city Lattitude Longitude
51145 .RE
52146 .RS 12
55149 .RE
56150 .RS 12
57151 0 London 51 0
58 @@ -191,19 +191,19 @@
152 @@ -191,19 +191,19 @@ Timezone Default city Lattitude Lo
59153 .PP
60154 Useful locations and time zones
61155 .RS 6
79173 .RS 6
80174 .RE
81175 Tiberias 32, 35, 2
176 @@ -239,12 +239,12 @@ The software does not yet account for th
177 .TP 3
178 1. Display a 2012ce year's calendar, three-months wide, in color.
179 .RS 6
180 -.B hcal -3c 2012
181 +.B hcal \-3c 2012
182 .RE
183 .HP 3
184 2. Display the current month's calendar, with Shabbat times, parshiot, footnoted holiday identification, with Hebrew information in Hebrew, and all in "calming", "muted" color-tones.
185 .RS 6
186 -.B hcal -csfH
187 +.B hcal \-csfH
188 .SH "SEE ALSO"
189 mlterm(1), hdate(1), hebcal(1), date(1), ncal(1), cal(1), remind(1)
190 .SH "AUTHORS"
82191 --- a/docs/man/man3/hdate.h.3
83192 +++ b/docs/man/man3/hdate.h.3
84 @@ -999,7 +999,7 @@
193 @@ -999,7 +999,7 @@ a static string with name of translator,
85194 .PP
86195 helper function to find hebrew locale \fBReturns:\fP
87196 .RS 4
92201
93202 --- a/docs/man/man1/hdate.1
94203 +++ b/docs/man/man1/hdate.1
95 @@ -9,13 +9,13 @@
204 @@ -9,13 +9,13 @@ hdate \- displays Hebrew date informatio
96205 .B hdate
97206 [options] [coordinates [timezone]] [ julian_day ]
98207 .TP
109218 .PP
110219 .SH "DESCRIPTION"
111220 .B hdate
112 @@ -140,7 +140,7 @@
221 @@ -45,79 +45,79 @@ will interpret it as the "Julian day num
222 .PP
223 .SH "OPTIONS"
224 .TP 18
225 -.B \-b --bidi
226 +.B \-b \-\-bidi
227 output Hebrew information in Hebrew, but in reverse
228 .RE
229 .RS 7
230 -.B \ \ \ --visual
231 +.B \ \ \ \-\-visual
232 \ sequence.
233 .TP 18
234 .B \-c
235 print Shabbat start/end times. Shabbat starts 20 min before sunset,
236 and ends when three stars are out.
237 .TP
238 -.B \-d --diaspora
239 +.B \-d \-\-diaspora
240 use diaspora reading and holidays.
241 .TP
242 -.B \-h --holidays
243 +.B \-h \-\-holidays
244 print holidays.
245 .TP
246 .B \-H
247 Print only if it is a holiday.
248 .TP
249 -.B \-i --ical
250 +.B \-i \-\-ical
251 use iCal formatted output.
252 .TP
253 -.B \-j --julian
254 +.B \-j \-\-julian
255 print Julian day number.
256 .TP
257 -.B \-o --omer
258 +.B \-o \-\-omer
259 print Sefirat Ha Omer
260 .TP
261 -.B \-q --quiet-alerts
262 +.B \-q \-\-quiet-alerts
263 quiet. suppress warning messages
264 .TP
265 -.B \-r --parasha
266 +.B \-r \-\-parasha
267 print weekly reading for Shabbat.
268 .TP
269 .B \-R
270 print only if the weekly reading is read on that Shabbat
271 .TP
272 -.B \-s --sun
273 +.B \-s \-\-sun
274 print sunrise/sunset times.
275 .TP
276 -.B \-S --short-format
277 +.B \-S \-\-short\-format
278 print using short format.
279 .TP
280 .B \-t
281 print day times: first light, talit, sunrise, mid day, sunset, first stars, three stars
282 .TP
283 -.B \-T --table
284 +.B \-T \-\-table
285 print tabular output. All data for each requested day will be output on a single comma-delimited line.
286 Most suitable for piping, or export to spreadsheets\n\n\
287 .TP
288 -.B \-l --latitude
289 +.B \-l \-\-latitude
290 [NS]yy[.yyy] decimal degrees, or [NS]yy[:mm[:ss]] degrees, minutes, seconds. Negative values are South
291 .TP
292 -.B \-L --longitude
293 +.B \-L \-\-longitude
294 [EW]xx[.xxx] decimal degrees, or [EW]xx[:mm[:ss]] degrees, minutes, seconds. Negative values are West
295 .TP
296 -.B \-z --timezone
297 +.B \-z \-\-timezone
298 \+/-UTC. Notation may be in decimal hours ( hh[.hh] ) or hours, minutes ( hh[:mm] )
299 .TP
300 -.B \ \ --hebrew
301 +.B \ \ \-\-hebrew
302 forces Hebrew to print in Hebrew characters
303 .TP
304 -.B \ \ --yom
305 +.B \ \ \-\-yom
306 force Hebrew prefix to Hebrew day of week
307 .TP
308 -.B \ \ --leshabbat
309 +.B \ \ \-\-leshabbat
310 insert parasha between day of week and day
311 .TP
312 -.B \ \ --leseder
313 +.B \ \ \-\-leseder
314 insert parasha between day of week and day
315 .TP
316 -.B \ \ --not-sunset-aware
317 +.B \ \ \-\-not\-sunset\-aware
318 don't display next day if after sunset
319 .SH NOTES
320 .SS LOCATIONS
321 @@ -130,9 +130,9 @@ requires location and time zone informat
322 uses your computer's local time zone information as an indicator, and either picks a city in that time zone, or defaults to the equator at the center of that time zone. If
323 .B hdate
324 can't even retrieve time zone information from your computer, it defaults to Tel-Aviv. For other locations, use the
325 -.B -l -L
326 +.B \-l \-L
327 option pair. For other timezones, use the
328 -.B -z
329 +.B \-z
330 option. Co-ordinates and standard time zones for some common locations are listed below.
331 .PP
332 The current defaults include:
333 @@ -140,7 +140,7 @@ The current defaults include:
113334 Timezone Default city Lattitude Longitude
114335 .RE
115336 .RS 12
118339 .RE
119340 .RS 12
120341 0 London 51 0
121 @@ -157,19 +157,19 @@
342 @@ -157,19 +157,19 @@ Timezone Default city Lattitude Lo
122343 .PP
123344 Useful locations and time zones
124345 .RS 6
142363 .RS 6
143364 .RE
144365 Tiberias 32, 35, 2
366 @@ -199,17 +199,17 @@ The timezone support is currenlty primit
367 .TP 10
368 .B Historical
369 The software does not yet account for the phenomenon and complications of the "Gregorian transition" from the prior, Julian calendar, which effectively caused an instantaneous 'loss' of two weeks for all gentiles affected. Countries (eg. Poland, Spain and Italy) began adopting the Gregorian calendar on 8 Tishrei 5343 (4 October 1582CE), although many did not transition until the 56th century (1752 CE, eg. UK colonies, Sweden). Russia did not adopt the Gregorian calendar until 5678 (1918 CE) and Turkey did not until 5687 (December, 1926 CE). Many other countries made the transition on other dates. Keep in mind that Russia invaded part of Poland, undoing, for the interim, the Gregorian transition for (only) that part of Poland; Also important to remember in this regard is that Eretz Ysroel was part of the Turkish Ottoman empire until the British mandate (5677 (1917CE)). Until all this is accounted for adequately by this application, refer to '
370 -.B ncal -p
371 +.B ncal \-p
372 \' for a basic table of country transitions. However, keep in mind that European borders underwent many changes during the 426 years in question, so the accuracy of your data will depend on accurate knowledge of whether any particular date at any specific location was Julian or Gregorian.
373 .SH "EXAMPLES"
374 1. Create an iCal calendar of the holidays of year 2025.
375 .RS 6
376 -.B hdate -Hi 2025
377 +.B hdate \-Hi 2025
378 .RE
379 .HP 3
380 2. Print out the weekly readings and sunset/sunrise times for Eilat, on April 2031.
381 .RS 6
382 -.B hdate -sR 4 2031 -l29 -L34 -z2
383 +.B hdate \-sR 4 2031 \-l29 \-L34 \-z2
384 .RE
385 .SH "SEE ALSO"
386 mlterm(1), hcal(1), hebcal(1), date(1), ncal(1), cal(1), remind(1)