From obrien@NUXI.com  Thu May 18 17:10:57 2000
Return-Path: <obrien@NUXI.com>
Received: from relay.nuxi.com (nuxi.cs.ucdavis.edu [169.237.7.38])
	by hub.freebsd.org (Postfix) with ESMTP id 3CADD37B5EC
	for <FreeBSD-gnats-submit@freebsd.org>; Thu, 18 May 2000 17:10:55 -0700 (PDT)
	(envelope-from obrien@NUXI.com)
Received: from dragon.nuxi.com (root@c01-120.006.popsite.net [216.126.134.120])
	by relay.nuxi.com (8.9.3/8.9.3) with ESMTP id RAA66349
	for <FreeBSD-gnats-submit@freebsd.org>; Thu, 18 May 2000 17:10:53 -0700 (PDT)
	(envelope-from obrien@dragon.nuxi.com)
Received: (from obrien@localhost)
	by dragon.nuxi.com (8.9.3/8.9.1) id RAA18911;
	Thu, 18 May 2000 17:10:52 -0700 (PDT)
	(envelope-from obrien)
Message-Id: <200005190010.RAA18911@dragon.nuxi.com>
Date: Thu, 18 May 2000 17:10:52 -0700 (PDT)
From: "David O'Brien" <obrien@NUXI.com>
Reply-To: obrien@NUXI.com
To: FreeBSD-gnats-submit@freebsd.org
Subject: mktemp(1) binary, or manpage / usage() is incorrect
X-Send-Pr-Version: 3.2

>Number:         18667
>Category:       bin
>Synopsis:       mktemp(1) binary, or manpage / usage() is incorrect
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    alex
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          sw-bug
>Submitter-Id:   current-users
>Arrival-Date:   Thu May 18 17:20:00 PDT 2000
>Closed-Date:    Sun Oct 15 04:36:54 PDT 2000
>Last-Modified:  Sun Oct 15 04:37:24 PDT 2000
>Originator:     David O'Brien
>Release:        FreeBSD 5.0-CURRENT i386
>Organization:
The FreeBSD Project
>Environment:

	

>Description:

	The mktemp(1) man page states:
	SYNOPSIS
		mktemp [-d] [-q] [-t prefix] [-u] [template ...]

	The mktemp usage() is:
	usage: mktemp [-d] [-q] [-t prefix] [-u] [template ...]

	Both of these say all arguments to mktemp are optional.  However
	mktemp(1) will not do anything useful w/o being run w/arguments.

>How-To-Repeat:

	/usr/bin/mktemp

>Fix:

	1st must decided what is the correct operation.


>Release-Note:
>Audit-Trail:

From: Johan Karlsson <k@numeri.campus.luth.se>
To: freebsd-gnats-submit@FreeBSD.org
Cc: obrien@NUXI.com
Subject: Re: bin/18667: mktemp(1) binary, or manpage / usage() is incorrect
Date: Fri, 04 Aug 2000 22:31:02 +0200

 Hi David
 
 What do you think about the following patch mktemp usage?
 
 Am I correct in the assumption that you are obrien@freebsd.org ?
 
 If so and the patch seems ok, maybe you can comitt it.
 
 Index: mktemp.1
 ===================================================================
 RCS file: /home/ncvs/src/usr.bin/mktemp/mktemp.1,v
 retrieving revision 1.9
 diff -u -r1.9 mktemp.1
 --- mktemp.1	2000/06/04 09:11:22	1.9
 +++ mktemp.1	2000/08/04 20:22:15
 @@ -42,9 +42,14 @@
  .Nm mktemp
  .Op Fl d
  .Op Fl q
 -.Op Fl t Ar prefix
  .Op Fl u
 +.Ar template
  .Op Ar template ...
 +.Nm mktemp
 +.Op Fl d
 +.Op Fl q
 +.Op Fl u
 +.Fl t Ar prefix
  .Sh DESCRIPTION
  The
  .Nm
 Index: mktemp.c
 ===================================================================
 RCS file: /home/ncvs/src/usr.bin/mktemp/mktemp.c,v
 retrieving revision 1.2
 diff -u -r1.2 mktemp.c
 --- mktemp.c	1998/05/05 06:13:47	1.2
 +++ mktemp.c	2000/08/04 20:20:03
 @@ -145,6 +145,8 @@
  usage()
  {
  	fprintf(stderr,
 -		"usage: mktemp [-d] [-q] [-t prefix] [-u] [template ...]\n");
 +		"usage: mktemp [-d] [-q] [-u] template [template ...]\n");
 +	fprintf(stderr,
 +		"       mktemp [-d] [-q] [-u] -t prefix \n");
  	exit (1);
  }
 
 
 

From: Sheldon Hearn <sheldonh@uunet.co.za>
To: Johan Karlsson <k@numeri.campus.luth.se>
Cc: freebsd-gnats-submit@FreeBSD.org
Subject: Re: bin/18667: mktemp(1) binary, or manpage / usage() is incorrect 
Date: Mon, 07 Aug 2000 10:54:30 +0200

 On Fri, 04 Aug 2000 13:40:03 MST, Johan Karlsson wrote:
 
 >  +.Ar template
 >   .Op Ar template ...
 
 Better expressed as
 
 .Ar template ...
 
 >  +		"usage: mktemp [-d] [-q] [-u] template [template ...]\n");
 >  +	fprintf(stderr,
 >  +		"       mktemp [-d] [-q] [-u] -t prefix \n");
 
 Again, more consistently expressed at 
 
 	usage: mktemp [-d] [-q] [-u] template ...
 
 The optional nature of arguments implied by ellipsis is implicit. ;-)
 
 Ciao,
 Sheldon.
 

From: Johan Karlsson <k@numeri.campus.luth.se>
To: Sheldon Hearn <sheldonh@uunet.co.za>
Cc: freebsd-gnats-submit@FreeBSD.org
Subject: Re: bin/18667: mktemp(1) binary, or manpage / usage() is incorrect 
Date: Mon, 07 Aug 2000 11:02:30 +0200

 At Mon, 07 Aug 2000 10:54:30 +0200, Sheldon Hearn wrote:
 > The optional nature of arguments implied by ellipsis is implicit. ;-)
 
 
 Ok, a new try :-)
 
 /Johan K
 
 Index: mktemp.1
 ===================================================================
 RCS file: /home/ncvs/src/usr.bin/mktemp/mktemp.1,v
 retrieving revision 1.9
 diff -u -r1.9 mktemp.1
 --- mktemp.1	2000/06/04 09:11:22	1.9
 +++ mktemp.1	2000/08/07 08:59:28
 @@ -42,9 +42,13 @@
  .Nm mktemp
  .Op Fl d
  .Op Fl q
 -.Op Fl t Ar prefix
  .Op Fl u
 -.Op Ar template ...
 +.Ar template ...
 +.Nm mktemp
 +.Op Fl d
 +.Op Fl q
 +.Op Fl u
 +.Fl t Ar prefix
  .Sh DESCRIPTION
  The
  .Nm
 Index: mktemp.c
 ===================================================================
 RCS file: /home/ncvs/src/usr.bin/mktemp/mktemp.c,v
 retrieving revision 1.2
 diff -u -r1.2 mktemp.c
 --- mktemp.c	1998/05/05 06:13:47	1.2
 +++ mktemp.c	2000/08/07 08:59:55
 @@ -145,6 +145,8 @@
  usage()
  {
  	fprintf(stderr,
 -		"usage: mktemp [-d] [-q] [-t prefix] [-u] [template ...]\n");
 +		"usage: mktemp [-d] [-q] [-u] template ...\n");
 +	fprintf(stderr,
 +		"       mktemp [-d] [-q] [-u] -t prefix \n");
  	exit (1);
  }
 
 
 

From: Sheldon Hearn <sheldonh@uunet.co.za>
To: Johan Karlsson <k@numeri.campus.luth.se>
Cc: freebsd-gnats-submit@FreeBSD.org
Subject: Re: bin/18667: mktemp(1) binary, or manpage / usage() is incorrect 
Date: Mon, 07 Aug 2000 11:25:35 +0200

 On Mon, 07 Aug 2000 11:02:30 +0200, Johan Karlsson wrote:
 
 > Ok, a new try :-)
 
 I like what you have now.
 
 Ciao,
 Sheldon.
 

From: Johan Karlsson <k@numeri.campus.luth.se>
To: freebsd-gnats-submit@FreeBSD.org
Cc:  
Subject: Re: bin/18667: mktemp(1) binary, or manpage / usage() is incorrect
Date: Fri, 13 Oct 2000 11:20:12 +0200

 Reading the manpage and src I've come up with the atteched patch 
 which describes the usage of mktemp(1) more accuratly than my prev 
 patch.
 
 
 Index: usr.bin/mktemp/mktemp.1
 ===================================================================
 RCS file: /home/ncvs/src/usr.bin/mktemp/mktemp.1,v
 retrieving revision 1.9
 diff -u -r1.9 mktemp.1
 --- usr.bin/mktemp/mktemp.1	2000/06/04 09:11:22	1.9
 +++ usr.bin/mktemp/mktemp.1	2000/10/13 09:17:07
 @@ -44,7 +44,12 @@
  .Op Fl q
  .Op Fl t Ar prefix
  .Op Fl u
 -.Op Ar template ...
 +.Ar template ...
 +.Nm mktemp
 +.Op Fl d
 +.Op Fl q
 +.Op Fl u
 +.Fl t Ar prefix
  .Sh DESCRIPTION
  The
  .Nm
 Index: usr.bin/mktemp/mktemp.c
 ===================================================================
 RCS file: /home/ncvs/src/usr.bin/mktemp/mktemp.c,v
 retrieving revision 1.2
 diff -u -r1.2 mktemp.c
 --- usr.bin/mktemp/mktemp.c	1998/05/05 06:13:47	1.2
 +++ usr.bin/mktemp/mktemp.c	2000/10/13 09:16:38
 @@ -145,6 +145,8 @@
  usage()
  {
  	fprintf(stderr,
 -		"usage: mktemp [-d] [-q] [-t prefix] [-u] [template ...]\n");
 +		"usage: mktemp [-d] [-q] [-t prefix] [-u] template ...\n");
 +	fprintf(stderr,
 +		"       mktemp [-d] [-q] [-u] -t prefix \n");
  	exit (1);
  }
 
 
Responsible-Changed-From-To: freebsd-bugs->alex 
Responsible-Changed-By: johan 
Responsible-Changed-When: Fri Oct 13 02:23:30 PDT 2000 
Responsible-Changed-Why:  
Another commit-candidate. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=18667 
State-Changed-From-To: open->closed 
State-Changed-By: alex 
State-Changed-When: Sun Oct 15 04:36:54 PDT 2000 
State-Changed-Why:  
Changed in HEAD and RELENG_4. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=18667 
>Unformatted:
