From unknown Mon Jun 23 16:48:45 2025 X-Loop: help-debbugs@gnu.org Subject: bug#20203: add example to date man page Resent-From: =?UTF-8?Q?=E7=A9=8D=E4=B8=B9=E5=B0=BC?= Dan Jacobson Original-Sender: "Debbugs-submit" Resent-CC: bug-coreutils@gnu.org Resent-Date: Thu, 26 Mar 2015 00:00:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 20203 X-GNU-PR-Package: coreutils X-GNU-PR-Keywords: To: 20203@debbugs.gnu.org X-Debbugs-Original-To: bug-coreutils@gnu.org Received: via spool by submit@debbugs.gnu.org id=B.142732794121445 (code B ref -1); Thu, 26 Mar 2015 00:00:02 +0000 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?Q?=E7=A9=8D=E4=B8=B9=E5=B0=BC?= Dan Jacobson 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-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 unknown Mon Jun 23 16:48:45 2025 MIME-Version: 1.0 X-Mailer: MIME-tools 5.503 (Entity 5.503) X-Loop: help-debbugs@gnu.org From: help-debbugs@gnu.org (GNU bug Tracking System) To: =?UTF-8?Q?=E7=A9=8D=E4=B8=B9=E5=B0=BC?= Dan Jacobson Subject: bug#20203: closed (Re: bug#20203: add example to date man page) Message-ID: References: <551359D0.80909@draigBrady.com> <877fu4wrwu.fsf@jidanni.org> X-Gnu-PR-Message: they-closed 20203 X-Gnu-PR-Package: coreutils Reply-To: 20203@debbugs.gnu.org Date: Thu, 26 Mar 2015 01:00:05 +0000 Content-Type: multipart/mixed; boundary="----------=_1427331605-27238-1" This is a multi-part message in MIME format... ------------=_1427331605-27238-1 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" Your bug report #20203: add example to date man page which was filed against the coreutils package, has been closed. The explanation is attached below, along with your original report. If you require more details, please reply to 20203@debbugs.gnu.org. --=20 20203: http://debbugs.gnu.org/cgi/bugreport.cgi?bug=3D20203 GNU Bug Tracking System Contact help-debbugs@gnu.org with problems ------------=_1427331605-27238-1 Content-Type: message/rfc822 Content-Disposition: inline Content-Transfer-Encoding: 7bit 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-- ------------=_1427331605-27238-1 Content-Type: message/rfc822 Content-Disposition: inline Content-Transfer-Encoding: 7bit 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. ------------=_1427331605-27238-1--