From owner-freebsd-doc@FreeBSD.ORG Thu Jul 25 19:41:15 2013 Return-Path: Delivered-To: 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 ESMTP id AB5B1A7C for ; Thu, 25 Jul 2013 19:41:15 +0000 (UTC) (envelope-from gabor.kovesdan@gmail.com) Received: from mail-ee0-x22a.google.com (mail-ee0-x22a.google.com [IPv6:2a00:1450:4013:c00::22a]) (using TLSv1 with cipher ECDHE-RSA-RC4-SHA (128/128 bits)) (No client certificate requested) by mx1.freebsd.org (Postfix) with ESMTPS id 3D45A2C23 for ; Thu, 25 Jul 2013 19:41:15 +0000 (UTC) Received: by mail-ee0-f42.google.com with SMTP id c4so1165711eek.1 for ; Thu, 25 Jul 2013 12:41:13 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=message-id:date:from:user-agent:mime-version:to:subject:references :in-reply-to:content-type:content-transfer-encoding; bh=AFQGtKPmPe2BKU7DRx7KqKLUZ6Kei8SQcTPK14cMf2Q=; b=NJo4E08pk1+eRhUE8+CO3SZKtVwqBLQ9UGDLXZ+deGjcJ9bo7zhE2LePFSIa4Cy74t FSfTBAKIUzPsVmgms97plJHvzuCiVWABXvJtKjPxgaxlUmMNMMy/45VZDu/oCKQz7RZc wi+Yxnhldya6XN7dNVBYEo4TJYBAi5k0gMnYb2jxVk162W+se/IgDIX3JZebljMnGhBA y+3NKUEYePBKxCnnN0qN6zBwpcBb6paQv6bd+KjHZDWxGajPsJxI9+elrX7YUkj11jnj 1GbBmb30z2MZJFPCezrSbUgsnJetl6TL+MP9RABmjxm0Lo2+WRtUxidyUI5AW1AJyB66 HEVw== X-Received: by 10.14.173.70 with SMTP id u46mr43560654eel.92.1374781273034; Thu, 25 Jul 2013 12:41:13 -0700 (PDT) Received: from [192.168.1.117] (catv-80-99-23-232.catv.broadband.hu. [80.99.23.232]) by mx.google.com with ESMTPSA id m1sm75818478eex.17.2013.07.25.12.41.10 for (version=TLSv1 cipher=ECDHE-RSA-RC4-SHA bits=128/128); Thu, 25 Jul 2013 12:41:11 -0700 (PDT) Message-ID: <51F17F47.3060101@FreeBSD.org> Date: Thu, 25 Jul 2013 21:40:55 +0200 From: Gabor Kovesdan User-Agent: Mozilla/5.0 (Windows NT 6.1; WOW64; rv:24.0) Gecko/20100101 Thunderbird/24.0a2 MIME-Version: 1.0 To: Warren Block , doc@FreeBSD.org Subject: Re: and other tag usage References: In-Reply-To: Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 25 Jul 2013 19:41:15 -0000 On 2013.07.25. 20:15, Warren Block wrote: > When writing sections, I've generally not used other > markup inside those sections except for . For example: > > rm /tmp/foo > > However, there are some spots in the Handbook where tags > are also used: > > rm /tmp/foo > > This looks different in the XHTML output, with the filename rendered > in green. > > I feel that the first form is correct, we are pointing out what the > user should type, but can see benefits for the second. I have not > counted to see which form is prevalent, but think it is the first. > The FDP Primer actually uses a filename without filename tags in the > example. > > Anyone care strongly either way? I prefer the first approach. The emphasis is on what the user should type and not on the fact that it is a filename. Besides, the green rendering inside the userinput would be too much. Gabor