[debbugs-tracker] bug#14686: closed (Bug#713022: truncate man and info pages must mention -s / -r mandatory)

[GNU bug Tracking System]

Your message dated Fri, 21 Jun 2013 23:37:20 +0100
with message-id <address@hidden>
and subject line Re: bug#14686: Bug#713022: truncate man and info pages must 
mention -s / -r mandatory
has caused the debbugs.gnu.org bug report #14686,
regarding Bug#713022: truncate man and info pages must mention -s / -r mandatory
to be marked as done.

(If you believe you have received this mail in error, please contact
address@hidden)


-- 
14686: http://debbugs.gnu.org/cgi/bugreport.cgi?bug=14686
GNU Bug Tracking System
Contact address@hidden with problems
> --- Begin Message ---
>
>
>
> Subject: 
>
> Bug#713022: truncate man and info pages must mention -s / -r mandatory
>
>
>
>
> Date: 
>
> Sat, 22 Jun 2013 04:05:29 +0800
>
>
>
>
> Package: coreutils
> Version: 8.13-3.3
> File: /usr/share/man/man1/truncate.1.gz
> X-debbugs-CC: address@hidden
>
> $ 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...> <number> [OPTION...] FILE...
>
> Also mention size is in bytes. Don't just hope the reader will examine
> every options' wording to ferret that out.
>
>
>
> --- End Message ---
> --- Begin Message ---
>
>
>
> Subject: 
>
> Re: bug#14686: Bug#713022: truncate man and info pages must mention -s / -r mandatory
>
>
>
>
> Date: 
>
> Fri, 21 Jun 2013 23:37:20 +0100
>
>
>
>
> User-agent: 
>
> Mozilla/5.0 (X11; Linux x86_64; rv:17.0) Gecko/20130110 Thunderbird/17.0.2
>
>
>
>
> On 06/21/2013 09:05 PM, address@hidden wrote:
> > Package: coreutils
> > Version: 8.13-3.3
> > File: /usr/share/man/man1/truncate.1.gz
> > X-debbugs-CC: address@hidden
> > 
> > $ 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...> <number> [OPTION...] FILE...
>
> Or more accurately:
>
>  truncate <--size|--reference> <SIZE|FILE> [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.
>
>
>
> --- End Message ---