NetBSD Problem Report #9150

Received: (qmail 27758 invoked from network); 9 Jan 2000 02:47:28 -0000
Message-Id: <200001090230.UAA19215@rkr.kcnet.com>
Date: Sat, 8 Jan 2000 20:30:46 -0600 (CST)
From: Richard Rauch <rkr@rkr.kcnet.com>
Reply-To: rkr@rkr.kcnet.com
To: gnats-bugs@gnats.netbsd.org
Subject: Minor changes to cat(1)'s man-page.
X-Send-Pr-Version: 3.95

>Number:         9150
>Category:       bin
>Synopsis:       Minor changes to cat(1)'s man-page.
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    bin-bug-people
>State:          closed
>Class:          change-request
>Submitter-Id:   net
>Arrival-Date:   Sat Jan 08 18:48:00 +0000 2000
>Closed-Date:    Sun Jan 09 15:54:35 +0000 2000
>Last-Modified:  Sun Jan 09 15:57:03 +0000 2000
>Originator:     Richard Rauch
>Release:        NetBSD 1.4.1
>Organization:
  "I probably don't know what I'm talking about."  --rkr@rkr.kcnet.com
>Environment:

System: NetBSD rkr.kcnet.com 1.4.1 NetBSD 1.4.1 (olibGENERIC) #3: Tue Nov 30 01:09:25 CST 1999 root@rkr.kcnet.com:/usr/src/sys/arch/i386/compile/olibGENERIC i386


>Description:
	There seemed to be a couple of points worth clarifying, and 2 or 3
	cross-references worth adding.

	(Since the man page is in /usr/src/bin, I am filing this as a bin
	PR.  (^& )
>How-To-Repeat:
	``man cat''
	Read.
	Ponder such things as whether ``cat - -'' is legitimate, and whether
	it will read standard input twice, or if it will read standard input
	once and then read a file called ``-''.  The man-page really doesn't
	say.
>Fix:
	The following was produced by checkin/(edit/review)*/rcsdiff on cat.1
	It leaves some debatable points but seems to be an improvement, IMHO.

*** cat.1	2000/01/09 00:40:03	1.1
--- cat.1	2000/01/09 02:09:41
***************
*** 54,60 ****
  The
  .Ar file
  operands are processed in command line order.
! A single dash represents the standard input.
  .Pp
  The options are as follows:
  .Bl -tag -width Ds
--- 54,68 ----
  The
  .Ar file
  operands are processed in command line order.
! A single dash represents the standard input,
! and may appear multiple times in the
! .Ar file
! list.
! .Pp
! The word
! .Dq concatenate
! is just a verbose synonym for
! .Dq catenate .
  .Pp
  The options are as follows:
  .Bl -tag -width Ds
***************
*** 104,114 ****
--- 112,131 ----
  redirection, the command
  .Dq Li cat file1 file2 > file1
  will cause the original data in file1 to be destroyed!
+ Note that this is already done before
+ .Nm
+ even begins running.
+ It is not per se a bug in
+ .Nm
+ but it is something to be aware of.
  .Sh SEE ALSO
  .Xr head 1 ,
+ .Xr hexdump 1 ,
+ .Xr lpr 1 ,
  .Xr more 1 ,
  .Xr pr 1 ,
  .Xr tail 1 ,
+ .Xr view 1 ,
  .Xr vis 1
  .Rs
  .%A Rob Pike
>Release-Note:
>Audit-Trail:
State-Changed-From-To: open->closed 
State-Changed-By: abs 
State-Changed-When: Sun Jan 9 07:54:35 PST 2000 
State-Changed-Why:  
Changes committed 
(with slight modifications) 
>Unformatted:

NetBSD Home
NetBSD PR Database Search

(Contact us) $NetBSD: query-full-pr,v 1.51 2026/08/10 02:28:17 riastradh Exp $
$NetBSD: gnats_config.sh,v 1.10 2026/05/13 22:00:09 riastradh Exp $
Copyright © 1994-2026 The NetBSD Foundation, Inc. ALL RIGHTS RESERVED.