GNU bug report logs - #7618
doc: mktemp: improve '[deprecated]' notices

Message received at submit <at> debbugs.gnu.org:

Received: (at submit) by debbugs.gnu.org; 12 Dec 2010 01:03:31 +0000
From debbugs-submit-bounces <at> debbugs.gnu.org Sat Dec 11 20:03:31 2010
Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org)
	by debbugs.gnu.org with esmtp (Exim 4.69)
	(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
	id 1PRaLa-0007kw-Jg
	for submit <at> debbugs.gnu.org; Sat, 11 Dec 2010 20:03:30 -0500
Received: from eggs.gnu.org ([140.186.70.92])
	by debbugs.gnu.org with esmtp (Exim 4.69)
	(envelope-from <jidanni@HIDDEN>) id 1PRaLY-0007kj-Tm
	for submit <at> debbugs.gnu.org; Sat, 11 Dec 2010 20:03:29 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <jidanni@HIDDEN>) id 1PRaRS-0007K4-LT
	for submit <at> debbugs.gnu.org; Sat, 11 Dec 2010 20:09:35 -0500
X-Spam-Checker-Version: SpamAssassin 3.3.1 (2010-03-16) on eggs.gnu.org
X-Spam-Level: 
X-Spam-Status: No, score=-1.9 required=5.0 tests=BAYES_00, RCVD_IN_DNSWL_NONE, 
	T_DKIM_INVALID autolearn=unavailable version=3.3.1
Received: from lists.gnu.org ([199.232.76.165]:43705)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <jidanni@HIDDEN>) id 1PRaRS-0007K0-HX
	for submit <at> debbugs.gnu.org; Sat, 11 Dec 2010 20:09:34 -0500
Received: from [140.186.70.92] (port=45539 helo=eggs.gnu.org)
	by lists.gnu.org with esmtp (Exim 4.43) id 1PRaRR-0004Vw-FV
	for bug-coreutils@HIDDEN; Sat, 11 Dec 2010 20:09:34 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <jidanni@HIDDEN>) id 1PRaRQ-0007J1-BX
	for bug-coreutils@HIDDEN; Sat, 11 Dec 2010 20:09:33 -0500
Received: from caiajhbdccac.dreamhost.com ([208.97.132.202]:46882
	helo=homiemail-a61.g.dreamhost.com)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <jidanni@HIDDEN>) id 1PRaRQ-0007Ij-3a
	for bug-coreutils@HIDDEN; Sat, 11 Dec 2010 20:09:32 -0500
Received: from homiemail-a61.g.dreamhost.com (localhost [127.0.0.1])
	by homiemail-a61.g.dreamhost.com (Postfix) with ESMTP id CFA0357806C
	for <bug-coreutils@HIDDEN>; Sat, 11 Dec 2010 17:09:30 -0800 (PST)
DomainKey-Signature: a=rsa-sha1; c=nofws; d=jidanni.org; h=from:to:subject
	:date:message-id:mime-version:content-type; q=dns; s=jidanni.org
	; b=cJmKmtIMonEyWxM5zPirUZViGCPVpLpKDwSmJKKziTuTtuC++1gReCnUH/g+
	1r14aEAZrI77gDFC7/WDNSa/wC2HX3IhCtYYB1NcGCn/QgfVJJGdl+RFotBnvZcn
	Om99a4QOnftJCcZDqKF1XCC30HdKEBdwd7u4p7CpncviTd4=
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=yXppLu9IgBJhoM2eN5AWZBeItRg=; b=my3Lrx5tGW9lCp+n
	yinYWQYtpmrs6PjjRqx952qDss8478OQdspxqeOW8oYVoz6915x94gHwdxd265Sp
	H9/+oYHHu9LDVviDs6x9lVg+BCF7oFAe8oXMIN3+ReYII8UNWMkVTaE/T/nTyXTE
	o1/a8R5O8uIikgr8eIR8e40f1HQ=
Received: from jidanni.org (218-163-4-63.dynamic.hinet.net [218.163.4.63])
	(using TLSv1 with cipher AES256-SHA (256/256 bits))
	(No client certificate requested)
	(Authenticated sender: jidanni@HIDDEN)
	by homiemail-a61.g.dreamhost.com (Postfix) with ESMTPSA id 73ED9578069
	for <bug-coreutils@HIDDEN>; Sat, 11 Dec 2010 17:09:30 -0800 (PST)
From: jidanni@HIDDEN
To: bug-coreutils@HIDDEN
Subject: man mktemp/[deprecated] clarification
Date: Sun, 12 Dec 2010 08:05:51 +0800
Message-ID: <87ipyzua74.fsf@HIDDEN>
MIME-Version: 1.0
Content-Type: text/plain
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3)
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 2)
X-Spam-Score: -5.4 (-----)
X-Debbugs-Envelope-To: submit
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.11
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <http://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>,
	<mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <http://debbugs.gnu.org/pipermail/debbugs-submit>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <http://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>,
	<mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Sender: debbugs-submit-bounces <at> debbugs.gnu.org
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
X-Spam-Score: -5.4 (-----)

man mktemp
       -p DIR use DIR as a prefix; implies -t [deprecated]

       -t     interpret TEMPLATE as a single file name component, relative to a directory: $TMPDIR, if  set;
              else the directory specified via -p; else /tmp [deprecated]

It is not clear what is deprecated, -p, or both. Move [deprecated]
closer to the front of the sentence.

Or add a DEPRECATED OPTIONS section.

Also I know the info page says why, but at

       -u, --dry-run
              do not create anything; merely print a name (unsafe)

the reader thinks 'why, will it grind up my filesystem?'
If --dry-run is unsafe, then I'd hate to try --wet-run.

Say (unsafe to use for ....).