From debbugs-submit-bounces@debbugs.gnu.org Wed Mar 25 19:59:01 2015 Received: (at submit) by debbugs.gnu.org; 25 Mar 2015 23:59:01 +0000 Received: from localhost ([127.0.0.1]:36724 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1YavCP-0005Zi-19 for submit@debbugs.gnu.org; Wed, 25 Mar 2015 19:59:01 -0400 Received: from eggs.gnu.org ([208.118.235.92]:59249) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1YavCN-0005ZQ-BC for submit@debbugs.gnu.org; Wed, 25 Mar 2015 19:58:59 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1YavCH-0004De-7v for submit@debbugs.gnu.org; Wed, 25 Mar 2015 19:58:53 -0400 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=-1.9 required=5.0 tests=BAYES_00,T_DKIM_INVALID autolearn=disabled version=3.3.2 Received: from lists.gnu.org ([2001:4830:134:3::11]:39197) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1YavCH-0004Da-5Q for submit@debbugs.gnu.org; Wed, 25 Mar 2015 19:58:53 -0400 Received: from eggs.gnu.org ([2001:4830:134:3::10]:60966) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1YavCG-00013L-CX for bug-coreutils@gnu.org; Wed, 25 Mar 2015 19:58:53 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1YavCA-0004Cm-NC for bug-coreutils@gnu.org; Wed, 25 Mar 2015 19:58:52 -0400 Received: from homie.mail.dreamhost.com ([208.97.132.208]:38601 helo=homiemail-a5.g.dreamhost.com) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1YavCA-0004Cb-Gv for bug-coreutils@gnu.org; Wed, 25 Mar 2015 19:58:46 -0400 Received: from homiemail-a5.g.dreamhost.com (localhost [127.0.0.1]) by homiemail-a5.g.dreamhost.com (Postfix) with ESMTP id A97E770406A for ; Wed, 25 Mar 2015 16:58:44 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha1; c=relaxed; d=jidanni.org; h=from:to :subject:date:message-id:mime-version:content-type; s= jidanni.org; bh=85x9nswzqUHb2Qzj4lxigX/ChBI=; b=fVY/q0WR/zFqkCOn HhQZiS+imr6MDE72yz5gFCQuh0+cXhNXqstfZJGuPFNEB37x4M0ZiyESV+UTnhMb tuAuH2JhPnPo4nb/LxkDwBPKr14vZe+eqG9V1vUJH/aN75Em668AkdQrjdzJYrul V6swHftZ/N2VHCteo8zovBNpdaA= Received: from jidanni.org (114-41-39-174.dynamic.hinet.net [114.41.39.174]) (using TLSv1 with cipher AES128-SHA (128/128 bits)) (No client certificate requested) (Authenticated sender: jidanni@jidanni.org) by homiemail-a5.g.dreamhost.com (Postfix) with ESMTPSA id 728AE704063 for ; Wed, 25 Mar 2015 16:58:44 -0700 (PDT) From: =?utf-8?B?56mN5Li55bC8?= Dan Jacobson To: bug-coreutils@gnu.org Subject: add example to date man page Date: Thu, 26 Mar 2015 07:58:41 +0800 Message-ID: <877fu4wrwu.fsf@jidanni.org> MIME-Version: 1.0 Content-Type: text/plain X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x X-detected-operating-system: by eggs.gnu.org: Error: Malformed IPv6 address (bad octet value). X-Received-From: 2001:4830:134:3::11 X-Spam-Score: -5.0 (-----) X-Debbugs-Envelope-To: submit X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -5.0 (-----) Please change -I[TIMESPEC], --iso-8601[=TIMESPEC] output date/time in ISO 8601 format. TIMESPEC='date' for date only (the default), 'hours', 'minutes', 'seconds', or 'ns' for date and time to the indicated precision. to -I[TIMESPEC], --iso-8601[=TIMESPEC] output date/time in ISO 8601 format. TIMESPEC='date' for date only (2015-03-26, the default), 'hours', 'minutes', 'seconds', or 'ns' for date and time to the indicated precision. From debbugs-submit-bounces@debbugs.gnu.org Wed Mar 25 20:59:06 2015 Received: (at 20203-done) by debbugs.gnu.org; 26 Mar 2015 00:59:06 +0000 Received: from localhost ([127.0.0.1]:36741 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1Yaw8Y-00073t-Ax for submit@debbugs.gnu.org; Wed, 25 Mar 2015 20:59:06 -0400 Received: from mail1.vodafone.ie ([213.233.128.43]:5996) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1Yaw8W-00073L-3D for 20203-done@debbugs.gnu.org; Wed, 25 Mar 2015 20:59:05 -0400 X-IronPort-Anti-Spam-Filtered: true X-IronPort-Anti-Spam-Result: ApQLAGtZE1VtT91e/2dsb2JhbABcgwZSVQWCRE64JYlhhXkCgV5MAQEBAQEBfUEBg1IBAQEEI2YJAg0EAwECAQkhAgIPAj4IBgEMBgIBAYgvAQOTE5x2hWmUNgEBAQEBBQEBAQEBAQEbiyGEZRiCaIFFBYYYjCGBMlSHGzqCdoJOhnGGIiKDbj4xgkMBAQE Received: from unknown (HELO localhost.localdomain) ([109.79.221.94]) by mail1.vodafone.ie with ESMTP; 26 Mar 2015 00:58:57 +0000 Message-ID: <551359D0.80909@draigBrady.com> Date: Thu, 26 Mar 2015 00:58:56 +0000 From: =?UTF-8?B?UMOhZHJhaWcgQnJhZHk=?= User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:31.0) Gecko/20100101 Thunderbird/31.4.0 MIME-Version: 1.0 To: =?UTF-8?B?56mN5Li55bC8IERhbiBKYWNvYnNvbg==?= , 20203-done@debbugs.gnu.org Subject: Re: bug#20203: add example to date man page References: <877fu4wrwu.fsf@jidanni.org> In-Reply-To: <877fu4wrwu.fsf@jidanni.org> Content-Type: multipart/mixed; boundary="------------050102040805030506070808" X-Spam-Score: 0.0 (/) X-Debbugs-Envelope-To: 20203-done X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: 0.0 (/) This is a multi-part message in MIME format. --------------050102040805030506070808 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit On 25/03/15 23:58, 積丹尼 Dan Jacobson wrote: > Please change > > -I[TIMESPEC], --iso-8601[=TIMESPEC] > output date/time in ISO 8601 format. TIMESPEC='date' for date > only (the default), 'hours', 'minutes', 'seconds', or 'ns' for > date and time to the indicated precision. > > to > -I[TIMESPEC], --iso-8601[=TIMESPEC] > output date/time in ISO 8601 format. TIMESPEC='date' for date > only (2015-03-26, the default), 'hours', 'minutes', 'seconds', or 'ns' for > date and time to the indicated precision. Probably not worth doing on its own, but I noticed other improvements that could be made to these option descriptions, which the attached should fix up. cheers, Pádraig. --------------050102040805030506070808 Content-Type: text/x-patch; name="date-I-example.patch" Content-Transfer-Encoding: 7bit Content-Disposition: attachment; filename="date-I-example.patch" >From a5dc4b8d697e7a50bec123113950ab3f5700705a Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?P=C3=A1draig=20Brady?= Date: Thu, 26 Mar 2015 00:47:28 +0000 Subject: [PATCH] doc: clarify the date standard output formats * src/date.c (usage): Use FMT rather than TIMESPEC as the parameter, since it's simpler to understand and can be better aligned. Give an example for the --iso-8601 output format. Adjust the example used for the 3 standard formats to be unambiguous to day/mon ordering and use of leading zeros in the time. Reorder the options descriptions slightly, so that the 3 standards options are together. Fixes http://bugs.gnu.org/20203 --- src/date.c | 38 ++++++++++++++++++++++---------------- 1 file changed, 22 insertions(+), 16 deletions(-) diff --git a/src/date.c b/src/date.c index 65fd0fc..3df7522 100644 --- a/src/date.c +++ b/src/date.c @@ -132,26 +132,32 @@ Display the current time in the given FORMAT, or set the system date.\n\ emit_mandatory_arg_note (); fputs (_("\ - -d, --date=STRING display time described by STRING, not 'now'\n\ - -f, --file=DATEFILE like --date once for each line of DATEFILE\n\ - -I[TIMESPEC], --iso-8601[=TIMESPEC] output date/time in ISO 8601 format.\n\ - TIMESPEC='date' for date only (the default),\n\ - 'hours', 'minutes', 'seconds', or 'ns' for date\n\ - and time to the indicated precision.\n\ + -d, --date=STRING display time described by STRING, not 'now'\n\ + -f, --file=DATEFILE like --date; once for each line of DATEFILE\n\ "), stdout); fputs (_("\ - -r, --reference=FILE display the last modification time of FILE\n\ - -R, --rfc-2822 output date and time in RFC 2822 format.\n\ - Example: Mon, 07 Aug 2006 12:34:56 -0600\n\ + -I[FMT], --iso-8601[=FMT] output date/time in ISO 8601 format.\n\ + FMT='date' for date only (the default),\n\ + 'hours', 'minutes', 'seconds', or 'ns' for date\n\ + and time to the indicated precision.\n\ + Example: 2006-08-14T02:34:56-0600\n\ "), stdout); fputs (_("\ - --rfc-3339=TIMESPEC output date and time in RFC 3339 format.\n\ - TIMESPEC='date', 'seconds', or 'ns' for\n\ - date and time to the indicated precision.\n\ - Date and time components are separated by\n\ - a single space: 2006-08-07 12:34:56-06:00\n\ - -s, --set=STRING set time described by STRING\n\ - -u, --utc, --universal print or set Coordinated Universal Time (UTC)\n\ + -R, --rfc-2822 output date and time in RFC 2822 format.\n\ + Example: Mon, 14 Aug 2006 02:34:56 -0600\n\ +"), stdout); + fputs (_("\ + --rfc-3339=FMT output date/time in RFC 3339 format.\n\ + FMT='date', 'seconds', or 'ns' for\n\ + date and time to the indicated precision.\n\ + Example: 2006-08-14 02:34:56-06:00\n\ +"), stdout); + fputs (_("\ + -r, --reference=FILE display the last modification time of FILE\n\ +"), stdout); + fputs (_("\ + -s, --set=STRING set time described by STRING\n\ + -u, --utc, --universal print or set Coordinated Universal Time (UTC)\n\ "), stdout); fputs (HELP_OPTION_DESCRIPTION, stdout); fputs (VERSION_OPTION_DESCRIPTION, stdout); -- 2.1.0 --------------050102040805030506070808-- From unknown Mon Jun 23 16:49:26 2025 Received: (at fakecontrol) by fakecontrolmessage; To: internal_control@debbugs.gnu.org From: Debbugs Internal Request Subject: Internal Control Message-Id: bug archived. Date: Thu, 23 Apr 2015 11:24:03 +0000 User-Agent: Fakemail v42.6.9 # This is a fake control message. # # The action: # bug archived. thanks # This fakemail brought to you by your local debbugs # administrator