From owner-freebsd-hackers  Mon Aug 11 19:58:58 1997
Return-Path: <owner-freebsd-hackers>
Received: (from root@localhost)
          by hub.freebsd.org (8.8.5/8.8.5) id TAA21016
          for hackers-outgoing; Mon, 11 Aug 1997 19:58:58 -0700 (PDT)
Received: from suntan.tandem.com (suntan.tandem.com [192.216.221.8])
          by hub.freebsd.org (8.8.5/8.8.5) with SMTP id TAA21005
          for <hackers@freebsd.org>; Mon, 11 Aug 1997 19:58:54 -0700 (PDT)
From: grog@lemis.com
Received: from papillon.lemis.com by suntan.tandem.com (8.6.12/suntan5.970212) 
	id TAA07638; Mon, 11 Aug 1997 19:58:48 -0700
Received: (grog@localhost) by papillon.lemis.com (8.8.4/8.6.12) 
       id LAA00484; Tue, 12 Aug 1997 11:29:57 +0900 (JST)
Message-Id: <199708120229.LAA00484@papillon.lemis.com>
Subject: Re: date(1)
In-Reply-To: <199708102053.VAA22190@awfulhak.org> from Brian Somers at "Aug 10, 97 09:53:41 pm"
To: brian@awfulhak.org (Brian Somers)
Date: Tue, 12 Aug 1997 11:29:55 +0900 (JST)
Cc: hackers@freebsd.org (FreeBSD Hackers)
Organisation:   LEMIS, PO Box 460, Echunga SA 5153, Australia
Phone:          +61-8-8388-8250
Fax:            +61-8-8388-8250
Mobile:         +61-41-739-7062
WWW-Home-Page:  http://www.lemis.com/~grog
X-Mailer: ELM [version 2.4ME+ PL32 (25)]
MIME-Version: 1.0
Content-Type: text/plain; charset=US-ASCII
Content-Transfer-Encoding: 7bit
Sender: owner-freebsd-hackers@freebsd.org
X-Loop: FreeBSD.org
Precedence: bulk

Brian Somers writes:
>> The documentation's inadequate.  Sure, it points to environ(7), but
>> since TZ is almost never used in BSD, there's a tendency to think
>> it'll be like a System V TZ, which is completely different.  How about
>> adding:
>>
>> --- /usr/share/man/man1/date.1.orig     Fri Aug  1 04:13:12 1997
>> +++ /usr/share/man/man1/date.1  Fri Aug  1 14:54:38 1997
>> @@ -171,6 +171,11 @@
>>  .Bl -tag -width Ds
>>  .It Ev TZ
>>  The timezone to use when displaying dates.
>> +The normal format is a pathname relative to
>> +.Dq Pa /usr/share/zoneinfo .
>> +For example, the command
>> +.Dq env TZ=America/Los_Angeles date
>> +displays the current time in California.
>>  See
>>  .Xr environ 7
>>  for more information.
>
> But this is already mentioned in environ(7).

Sure, that's what I said at the top.  But it's not obvious what the
reference to environ(7) is for, and the usage of TZ is different
enough from that of other UNIX systems that many people, myself
included, don't expect it and thus don't look at environ(7).

Greg