From debbugs-submit-bounces@debbugs.gnu.org Fri Jun 21 17:42:46 2013 Received: (at submit) by debbugs.gnu.org; 21 Jun 2013 21:42:47 +0000 Received: from localhost ([127.0.0.1]:33461 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1Uq96U-0002dr-Ji for submit@debbugs.gnu.org; Fri, 21 Jun 2013 17:42:46 -0400 Received: from eggs.gnu.org ([208.118.235.92]:40717) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1Uq96S-0002dR-C7 for submit@debbugs.gnu.org; Fri, 21 Jun 2013 17:42:44 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Uq96L-0003R1-DD for submit@debbugs.gnu.org; Fri, 21 Jun 2013 17:42:38 -0400 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=-100.0 required=5.0 tests=BAYES_40,T_DKIM_INVALID, USER_IN_WHITELIST autolearn=disabled version=3.3.2 Received: from lists.gnu.org ([2001:4830:134:3::11]:55771) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Uq96L-0003Qx-86 for submit@debbugs.gnu.org; Fri, 21 Jun 2013 17:42:37 -0400 Received: from eggs.gnu.org ([2001:4830:134:3::10]:42425) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Uq96J-0004fJ-OZ for bug-coreutils@gnu.org; Fri, 21 Jun 2013 17:42:37 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Uq96H-0003QQ-Em for bug-coreutils@gnu.org; Fri, 21 Jun 2013 17:42:35 -0400 Received: from buxtehude.debian.org ([140.211.166.26]:54388) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Uq96H-0003Oo-5Z for bug-coreutils@gnu.org; Fri, 21 Jun 2013 17:42:33 -0400 Received: from debbugs by buxtehude.debian.org with local (Exim 4.80) (envelope-from ) id 1Uq965-0004FB-2a; Fri, 21 Jun 2013 21:42:21 +0000 X-Loop: owner@bugs.debian.org Subject: Bug#713022: truncate man and info pages must mention -s / -r mandatory Resent-From: jidanni@jidanni.org Resent-To: debian-bugs-dist@lists.debian.org Resent-CC: bug-coreutils@gnu.org, Michael Stone X-Loop: owner@bugs.debian.org Resent-Date: Fri, 21 Jun 2013 21:42:16 +0000 Resent-Message-ID: X-Debian-PR-Message: report 713022 X-Debian-PR-Package: coreutils X-Debian-PR-Keywords: X-Debian-PR-Source: coreutils Received: via spool by submit@bugs.debian.org id=B.137185089216064 (code B); Fri, 21 Jun 2013 21:42:16 +0000 Received: (at submit) by bugs.debian.org; 21 Jun 2013 21:41:32 +0000 Received: from caiajhbdccah.dreamhost.com ([208.97.132.207] helo=homiemail-a38.g.dreamhost.com) by buxtehude.debian.org with esmtp (Exim 4.80) (envelope-from ) id 1Uq95I-0004Ar-1p for submit@bugs.debian.org; Fri, 21 Jun 2013 21:41:32 +0000 Received: from homiemail-a38.g.dreamhost.com (localhost [127.0.0.1]) by homiemail-a38.g.dreamhost.com (Postfix) with ESMTP id 406AF10AFAE for ; Fri, 21 Jun 2013 14:41:30 -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=7u1O+qjU2ocQrhUVS33gDft9Dvk=; b=WH+SvEBI8C8dGzzR O6lXlheJmZ4PQYzhey/DyCvAcRn2KMhtTE1flWQ3E2dfFF1xYYxHdvRJC5MDlGMU AsN6XdC1wfrH606th1BxDmXHScdblzp8i2AOytZrdhipwmG9/dbkMpnG/XXbwTps q81Jp1ixGKaON6P3LceDUFsP/QQ= Received: from jidanni.org (114-41-1-117.dynamic.hinet.net [114.41.1.117]) (using TLSv1 with cipher DHE-RSA-AES128-SHA (128/128 bits)) (No client certificate requested) (Authenticated sender: jidanni@jidanni.org) by homiemail-a38.g.dreamhost.com (Postfix) with ESMTPSA id F34B710AFAA for ; Fri, 21 Jun 2013 14:41:29 -0700 (PDT) From: jidanni@jidanni.org To: submit@bugs.debian.org Date: Sat, 22 Jun 2013 04:05:29 +0800 Message-ID: <87txkrw7p2.fsf@jidanni.org> MIME-Version: 1.0 Content-Type: text/plain Delivered-To: submit@bugs.debian.org Resent-Sender: Debian BTS X-detected-operating-system: by eggs.gnu.org: GNU/Linux 3.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 Reply-To: jidanni@jidanni.org, 713022@bugs.debian.org 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 (-----) Package: coreutils Version: 8.13-3.3 File: /usr/share/man/man1/truncate.1.gz X-debbugs-CC: bug-coreutils@gnu.org $ truncate /tmp/erere truncate: you must specify either `--size' or `--reference' What a shock. Not mentioned on man or info pages! And truncate OPTION... FILE... should be truncate <--size|--ref...> [OPTION...] FILE... Also mention size is in bytes. Don't just hope the reader will examine every options' wording to ferret that out. From debbugs-submit-bounces@debbugs.gnu.org Fri Jun 21 18:37:30 2013 Received: (at 14686-done) by debbugs.gnu.org; 21 Jun 2013 22:37:30 +0000 Received: from localhost ([127.0.0.1]:33536 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1Uq9xS-0005MY-5e for submit@debbugs.gnu.org; Fri, 21 Jun 2013 18:37:30 -0400 Received: from mail3.vodafone.ie ([213.233.128.45]:63459) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1Uq9xQ-0005MF-Cx for 14686-done@debbugs.gnu.org; Fri, 21 Jun 2013 18:37:29 -0400 X-IronPort-Anti-Spam-Filtered: true X-IronPort-Anti-Spam-Result: AjcDAHXUxFFda5t9/2dsb2JhbAANTsM0AwGBGYMXAQEBAwEyAUYFCwsNCwkWDwkDAgECAUUHDAEFAgEBiASqLZIKjmpfB4NhA54Hg2iIcIE4 Received: from unknown (HELO [192.168.1.79]) ([93.107.155.125]) by mail3.vodafone.ie with ESMTP; 21 Jun 2013 23:37:20 +0100 Message-ID: <51C4D5A0.9020102@draigBrady.com> Date: Fri, 21 Jun 2013 23:37:20 +0100 From: =?ISO-8859-1?Q?P=E1draig_Brady?= User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:17.0) Gecko/20130110 Thunderbird/17.0.2 MIME-Version: 1.0 To: jidanni@jidanni.org, 713022@bugs.debian.org Subject: Re: bug#14686: Bug#713022: truncate man and info pages must mention -s / -r mandatory References: <87txkrw7p2.fsf@jidanni.org> In-Reply-To: <87txkrw7p2.fsf@jidanni.org> X-Enigmail-Version: 1.5.1 Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: 8bit X-Spam-Score: 0.0 (/) X-Debbugs-Envelope-To: 14686-done Cc: 14686-done@debbugs.gnu.org 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 (/) On 06/21/2013 09:05 PM, jidanni@jidanni.org wrote: > Package: coreutils > Version: 8.13-3.3 > File: /usr/share/man/man1/truncate.1.gz > X-debbugs-CC: bug-coreutils@gnu.org > > $ truncate /tmp/erere > truncate: you must specify either `--size' or `--reference' > > What a shock. Not mentioned on man or info pages! Well it was immediately obvious what to do given the above output. Some might consider a pointed message like this, preferable to having to read the manual initially. > > And > truncate OPTION... FILE... > should be > truncate <--size|--ref...> [OPTION...] FILE... Or more accurately: truncate <--size|--reference> [OPTION...] FILE... Now some may find the above more confusing to parse. Also worth noting is the next line in the man page and info manual, i.e. the first line of the description, should make it quite obvious a size is required: "Shrink or extend the size of each FILE to the specified size" Also we follow this pattern for other utils like cut(1). So I'm slightly inclined to leave as is. > Also mention size is in bytes. Don't just hope the reader will examine > every options' wording to ferret that out. Fair enough. I'll adjust to: -s, --size=SIZE set or adjust the file size by SIZE bytes. See also --io-blocks thanks, Pádraig. From debbugs-submit-bounces@debbugs.gnu.org Sat Jun 22 04:42:10 2013 Received: (at 14686-done) by debbugs.gnu.org; 22 Jun 2013 08:42:10 +0000 Received: from localhost ([127.0.0.1]:34210 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1UqJOc-0007Ju-3q for submit@debbugs.gnu.org; Sat, 22 Jun 2013 04:42:10 -0400 Received: from caiajhbdcaib.dreamhost.com ([208.97.132.81]:52092 helo=homiemail-a2.g.dreamhost.com) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1UqJOY-0007JO-GF for 14686-done@debbugs.gnu.org; Sat, 22 Jun 2013 04:42:07 -0400 Received: from homiemail-a2.g.dreamhost.com (localhost [127.0.0.1]) by homiemail-a2.g.dreamhost.com (Postfix) with ESMTP id 72C0F280069; Sat, 22 Jun 2013 01:42:05 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha1; c=relaxed; d=jidanni.org; h=from:to:cc :subject:references:date:message-id:mime-version:content-type; s=jidanni.org; bh=Po7kf5F7jyYFymMQO7fCjnC/qU0=; b=Rjqlf5CKX1VlH i74YxGDXggsRGFrLhZUNAD473eVYrfgSZfl2o/oqmnoyq+plsHfIyko5ITvcRHrq JVJ3rJCjC76CdCfOQkbhAGPrySHvqA3to41zQcKT3jPq5Ex2hYEfaf1HwvlKeMow VTteX6UcBdx/Vjx5Oj+F1XLfgEaKic= Received: from jidanni.org (122-118-150-215.dynamic.hinet.net [122.118.150.215]) (using TLSv1 with cipher DHE-RSA-AES128-SHA (128/128 bits)) (No client certificate requested) (Authenticated sender: jidanni@jidanni.org) by homiemail-a2.g.dreamhost.com (Postfix) with ESMTPSA id 04FCC280062; Sat, 22 Jun 2013 01:42:05 -0700 (PDT) From: jidanni@jidanni.org To: p@draigbrady.com Subject: Re: bug#14686: Bug#713022: truncate man and info pages must mention -s / -r mandatory References: <51C4D5A0.9020102@draigBrady.com> Date: Sat, 22 Jun 2013 16:42:01 +0800 Message-ID: <87sj0ar0yu.fsf@jidanni.org> MIME-Version: 1.0 Content-Type: text/plain X-Spam-Score: 0.0 (/) X-Debbugs-Envelope-To: 14686-done Cc: 713022@bugs.debian.org, 14686-done@debbugs.gnu.org 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 (/) I thought it would do the obvious, like touch does. NAME touch - change file timestamps SYNOPSIS touch [OPTION]... FILE... DESCRIPTION Update the access and modification times of each FILE to the current time. A FILE argument that does not exist is created empty, unless -c or -h is supplied. NAME truncate - shrink or extend the size of a file to the specified size SYNOPSIS truncate OPTION... FILE... DESCRIPTION Shrink or extend the size of each FILE to the specified size A FILE argument that does not exist is created. Who would have guessed that for some reason an argument is required, I don't see why $ truncate FILE cannot just work too. You know, to truncate the file, to zero bytes. But hey I'm not a pro. From debbugs-submit-bounces@debbugs.gnu.org Sat Jun 22 05:58:30 2013 Received: (at 14686-done) by debbugs.gnu.org; 22 Jun 2013 09:58:30 +0000 Received: from localhost ([127.0.0.1]:34297 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1UqKaU-0002xf-4U for submit@debbugs.gnu.org; Sat, 22 Jun 2013 05:58:30 -0400 Received: from mail3.vodafone.ie ([213.233.128.45]:42652) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1UqKaS-0002xI-Ge for 14686-done@debbugs.gnu.org; Sat, 22 Jun 2013 05:58:29 -0400 X-IronPort-Anti-Spam-Filtered: true X-IronPort-Anti-Spam-Result: AjcDAIx0xVFtTSz+/2dsb2JhbAANTsM5AwGBFYMXAQEBBDIBRhALDQsJFg8JAwIBAgFFEwEFAgEBsjCSEI5qXwcWg0sDngeDaIhwgTg Received: from unknown (HELO [192.168.1.79]) ([109.77.44.254]) by mail3.vodafone.ie with ESMTP; 22 Jun 2013 10:58:22 +0100 Message-ID: <51C5753D.6090106@draigBrady.com> Date: Sat, 22 Jun 2013 10:58:21 +0100 From: =?ISO-8859-1?Q?P=E1draig_Brady?= User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:17.0) Gecko/20130110 Thunderbird/17.0.2 MIME-Version: 1.0 To: jidanni@jidanni.org Subject: Re: bug#14686: Bug#713022: truncate man and info pages must mention -s / -r mandatory References: <51C4D5A0.9020102@draigBrady.com> <87sj0ar0yu.fsf@jidanni.org> In-Reply-To: <87sj0ar0yu.fsf@jidanni.org> X-Enigmail-Version: 1.5.1 Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: 8bit X-Spam-Score: 0.0 (/) X-Debbugs-Envelope-To: 14686-done Cc: 713022@bugs.debian.org, 14686-done@debbugs.gnu.org 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 (/) On 06/22/2013 09:42 AM, jidanni@jidanni.org wrote: > I thought it would do the obvious, like touch does. > > > NAME > touch - change file timestamps > > SYNOPSIS > touch [OPTION]... FILE... > > DESCRIPTION > Update the access and modification times of each FILE to the current > time. > > A FILE argument that does not exist is created empty, unless -c or -h > is supplied. > > > > NAME > truncate - shrink or extend the size of a file to the specified size > > SYNOPSIS > truncate OPTION... FILE... > > DESCRIPTION > Shrink or extend the size of each FILE to the specified size > > A FILE argument that does not exist is created. > > > > Who would have guessed that for some reason an argument is required, > I don't see why > $ truncate FILE > cannot just work too. > You know, to truncate the file, to zero bytes. > But hey I'm not a pro. I remember discussing the interface at the time. The thinking was that since data was destroyed here, an explicit -s0 was required to avoid typos like: truncate - s1M file Behaving like you suggest would create '-' and 's1M' and truncate 'file' without warning. cheers, Pádraig. From debbugs-submit-bounces@debbugs.gnu.org Sat Jun 22 06:03:07 2013 Received: (at 14686-done) by debbugs.gnu.org; 22 Jun 2013 10:03:07 +0000 Received: from localhost ([127.0.0.1]:34303 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1UqKew-0003DM-PZ for submit@debbugs.gnu.org; Sat, 22 Jun 2013 06:03:06 -0400 Received: from caiajhbdcbhh.dreamhost.com ([208.97.132.177]:42633 helo=homiemail-a4.g.dreamhost.com) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1UqKeu-0003D4-Mc for 14686-done@debbugs.gnu.org; Sat, 22 Jun 2013 06:03:05 -0400 Received: from homiemail-a4.g.dreamhost.com (localhost [127.0.0.1]) by homiemail-a4.g.dreamhost.com (Postfix) with ESMTP id 552DE51C070; Sat, 22 Jun 2013 03:03:03 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha1; c=relaxed; d=jidanni.org; h=date:from :to:cc:subject:message-id:references:mime-version:content-type: in-reply-to; s=jidanni.org; bh=ahOfUq4XDG/Xv/bF/TiNx/loXX4=; b=h B+QM6khnzc0ywNSbfrEGW1MR3JsD9VuOeCw9SDtHo72BsyUEQg4yZ7wgtnzlDG+i y4SNy+5je88CT4S65iwjMMNncK6WjTP0VgWWFkwdJACLASexiXuWVyWMv9A59H4u qp1iiZmcw5l7iSDb35jqXIkW2qILQfJVyO0Olk3sRg= Received: from jidanni.org (122-118-150-215.dynamic.hinet.net [122.118.150.215]) (using TLSv1 with cipher DHE-RSA-AES128-SHA (128/128 bits)) (No client certificate requested) (Authenticated sender: jidanni@jidanni.org) by homiemail-a4.g.dreamhost.com (Postfix) with ESMTPSA id 1429D51C05F; Sat, 22 Jun 2013 03:03:03 -0700 (PDT) Date: Sat, 22 Jun 2013 18:02:59 +0800 From: jidanni@jidanni.org To: =?iso-8859-1?Q?P=E1draig?= Brady Subject: Re: bug#14686: Bug#713022: truncate man and info pages must mention -s / -r mandatory Message-ID: <20130622100259.GA15826@jidanni.org> References: <51C4D5A0.9020102@draigBrady.com> <87sj0ar0yu.fsf@jidanni.org> <51C5753D.6090106@draigBrady.com> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <51C5753D.6090106@draigBrady.com> User-Agent: Mutt/1.5.21 (2010-09-15) X-Spam-Score: 0.0 (/) X-Debbugs-Envelope-To: 14686-done Cc: 713022@bugs.debian.org, 14686-done@debbugs.gnu.org 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 (/) Well I bet that rm is as evil. From unknown Tue Jun 17 01:34:42 2025 Received: (at fakecontrol) by fakecontrolmessage; To: internal_control@debbugs.gnu.org From: Debbugs Internal Request Subject: Internal Control Message-Id: bug archived. Date: Sat, 20 Jul 2013 11:24:04 +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