From owner-freebsd-doc@FreeBSD.ORG  Thu Feb 20 14:57:55 2014
Return-Path: <owner-freebsd-doc@FreeBSD.ORG>
Delivered-To: freebsd-doc@FreeBSD.org
Received: from mx1.freebsd.org (mx1.freebsd.org
 [IPv6:2001:1900:2254:206a::19:1])
 (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits))
 (No client certificate requested)
 by hub.freebsd.org (Postfix) with ESMTPS id CFA8985D;
 Thu, 20 Feb 2014 14:57:55 +0000 (UTC)
Received: from wonkity.com (wonkity.com [67.158.26.137])
 (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits))
 (No client certificate requested)
 by mx1.freebsd.org (Postfix) with ESMTPS id 7D1761A1B;
 Thu, 20 Feb 2014 14:57:55 +0000 (UTC)
Received: from wonkity.com (localhost [127.0.0.1])
 by wonkity.com (8.14.8/8.14.8) with ESMTP id s1KEvnvw069259
 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=NO);
 Thu, 20 Feb 2014 07:57:50 -0700 (MST)
 (envelope-from wblock@wonkity.com)
Received: from localhost (wblock@localhost)
 by wonkity.com (8.14.8/8.14.8/Submit) with ESMTP id s1KEvlqX069256;
 Thu, 20 Feb 2014 07:57:47 -0700 (MST)
 (envelope-from wblock@wonkity.com)
Date: Thu, 20 Feb 2014 07:57:47 -0700 (MST)
From: Warren Block <wblock@wonkity.com>
To: Hiroki Sato <hrs@FreeBSD.org>
Subject: Re: ZFS handbook project patch
In-Reply-To: <20140220.162055.109321178462259649.hrs@allbsd.org>
Message-ID: <alpine.BSF.2.00.1402200747110.69044@wonkity.com>
References: <5305A9A4.1010603@allanjude.com>
 <20140220.162055.109321178462259649.hrs@allbsd.org>
User-Agent: Alpine 2.00 (BSF 1167 2008-08-23)
MIME-Version: 1.0
Content-Type: TEXT/PLAIN; charset=US-ASCII; format=flowed
X-Greylist: Sender IP whitelisted, not delayed by milter-greylist-4.4.3
 (wonkity.com [127.0.0.1]); Thu, 20 Feb 2014 07:57:50 -0700 (MST)
Cc: freebsd-doc@FreeBSD.org, freebsd@allanjude.com
X-BeenThere: freebsd-doc@freebsd.org
X-Mailman-Version: 2.1.17
Precedence: list
List-Id: Documentation project <freebsd-doc.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/options/freebsd-doc>,
 <mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc/>
List-Post: <mailto:freebsd-doc@freebsd.org>
List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
 <mailto:freebsd-doc-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Thu, 20 Feb 2014 14:57:55 -0000

On Thu, 20 Feb 2014, Hiroki Sato wrote:

> Allan Jude <freebsd@allanjude.com> wrote
>  in <5305A9A4.1010603@allanjude.com>:
>
> fr> It also fixes a paragraph that someone else wrote, that Warren had
> fr> pointed out made no sense.
> fr>
> fr> Also adds some missing <acronym> tags, and replace all of the
> fr> <userinput> tags that are actually commands with <command>
>
> -    <screen>&prompt.root; <userinput>service zfs start</userinput></screen>
> +    <screen>&prompt.root; <command>service zfs start</command></screen>
>
> <userinput> is correct here.  <command> is for the name of an
> executable program or command, not a command line.

Yes.  Although <command> is sometimes used for short inline commands 
that are a bit more than a simple command name:

   <para>Files beginning with the letter "A" can be listed with
     <command>ls A*</command>.  More detailed searches can be done with
     <command>find</command>:</para>

   <screen>&prompt.user; <userinput>find /usr/ports -name Makefile</userinput></screen>

There are some examples in the FDP Primer:
http://www.freebsd.org/doc/en_US.ISO8859-1/books/fdp-primer/book.html#idp66516784

(Although they also show <prompt>, which I don't recall seeing used 
anywhere else in our docs and am pretty sure I've never used myself.)