Would a timezone man page be useful?

[01micko]

Relevant to the topic I've created a timezone table here

However, maybe that information would be more accessible if it were a manpage in sfwbar?

I have a script that generates one:

findt-tz-rst

#!/bin/bash
#  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 2 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, write to the Free Software
#  Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,
#  MA 02110-1301, USA.
#  

# Copyright 2024 Mick Amadio <[email protected]>
# GPL-2.0

# eg: 
# /usr/share/zoneinfo/Africa/Blantyre
# /usr/share/zoneinfo/America/Indiana/Tell_City

[[ ! -d "/usr/share/zoneinfo" ]] && echo "no zone info!" && exit

# header
echo 'sfwbar-timezones' > sfwbar-timezone.rst
echo '################' >> sfwbar-timezone.rst
echo >> sfwbar-timezone.rst
echo '######################' >> sfwbar-timezone.rst
echo "Sfwbar Timezones Table" >> sfwbar-timezone.rst
echo '######################' >> sfwbar-timezone.rst
echo >> sfwbar-timezone.rst
# man section
echo ":Copyright: GPLv3+" >> sfwbar-timezone.rst
echo ":Manual section: 5" >> sfwbar-timezone.rst
echo >> sfwbar-timezone.rst
echo "SYNOPSIS" >> sfwbar-timezone.rst
echo "========" >> sfwbar-timezone.rst
echo >> sfwbar-timezone.rst
echo 'This table is a convenience table  so that you can copy/paste the
zone into your `widget`' >> sfwbar-timezone.rst
echo 'For example New York would be:``Time("%x", "EST5EDT,M3.2.0,M11.1.0")``' >> sfwbar-timezone.rst
echo >> sfwbar-timezone.rst
echo '=============================== ==============================================' >> sfwbar-timezone.rst
echo 'Place                           Zone' >> sfwbar-timezone.rst
echo '=============================== ==============================================' >> sfwbar-timezone.rst

while read -r line; do
	PLACE=${line/\/usr\/share\/zoneinfo\//}
	lgth=${#line}
	zone=$(tail -n 1 $line)
	printf "%-31s %s\n" "$PLACE" "$zone" >> sfwbar-timezone.rst
done <<<$(find -L /usr/share/zoneinfo/*/ -name "*" -type f)

echo '=============================== ==============================================' >> sfwbar-timezone.rst
echo >> sfwbar-timezone.rst
echo "SEE ALSO" >> sfwbar-timezone.rst
echo "========" >> sfwbar-timezone.rst
echo >> sfwbar-timezone.rst
echo 'sfwbar(1)' >> sfwbar-timezone.rst
# convert to manpage
rst2man sfwbar-timezone.rst  sfwbar-timezone.5
# test with: man 5 ./sfwbar-timezone.5

[01micko]

Screen grab

[LBCrion]

Digging through glib docs - it looks like you can use the : notation for timezones. I.e. ":US/Eastern" or ":Asia/Tokyo". That said, trying this out I discovered that sfwbar doesn't handle invalid timezones gracefully - and that I need to fix.

[01micko]

That said, trying this out I discovered that sfwbar doesn't handle invalid timezones gracefully - and that I need to fix.

I meant to open an issue about that :)

[01micko]

Indeed that ":Place/City" notation works so making my table not so great, but nevertheless informative. 👅

Still, it was nice to create a valid man page from a very simple script.

simple addition to calendar widget

  label 'cal_clock' {
    value = time("%H:%M:%S")
    style = 'cal_clock'
    interval = 1000
    loc(1,1)
  }
  label 'cal_clockjp' {
    value = "󾓥 Tokyo:      " + time("%H:%M:%S",":Asia/Tokyo")
    style = 'cal_clockwl'
    interval = 1000
    loc(1,2)
  }
  label 'cal_clockbeu' {
    value = "󾓦 Beulah:     " + time("%H:%M:%S",":America/North_Dakota/Beulah")
    style = 'cal_clockwl'
    interval = 1000
    loc(1,3)
  }
  label 'cal_clockrm' {
    value = "󾓩 Rome:      " + time("%H:%M:%S",":Europe/Rome")
    style = 'cal_clockwl'
    interval = 1000
    loc(1,4)
  }