From owner-cvs-doc@FreeBSD.ORG  Sun Nov 12 11:22:56 2006
Return-Path: <owner-cvs-doc@FreeBSD.ORG>
X-Original-To: cvs-doc@freebsd.org
Delivered-To: cvs-doc@freebsd.org
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id C4F7016A416;
	Sun, 12 Nov 2006 11:22:56 +0000 (UTC)
	(envelope-from lothrandil@n00b.apagnu.se)
Received: from pne-smtpout2-sn2.hy.skanova.net
	(pne-smtpout2-sn2.hy.skanova.net [81.228.8.164])
	by mx1.FreeBSD.org (Postfix) with ESMTP id 861C043D8C;
	Sun, 12 Nov 2006 11:22:53 +0000 (GMT)
	(envelope-from lothrandil@n00b.apagnu.se)
Received: from [90.224.57.146] (90.224.57.146) by
	pne-smtpout2-sn2.hy.skanova.net (7.2.075)
	id 452BAB4100664E7B; Sun, 12 Nov 2006 12:22:52 +0100
Message-ID: <4557040D.2090608@n00b.apagnu.se>
Date: Sun, 12 Nov 2006 12:22:53 +0100
From: Niclas Zeising <lothrandil@n00b.apagnu.se>
User-Agent: Thunderbird 1.5.0.8 (Windows/20061025)
MIME-Version: 1.0
To: Marc Fonvieille <blackend@freebsd.org>
References: <200611120013.kAC0D5GM097268@repoman.freebsd.org>	<200611121144.28895.jkois@freebsd.org>	<4556FE2A.1080501@n00b.apagnu.se>
	<20061112111431.GA84563@abigail.blackend.org>
In-Reply-To: <20061112111431.GA84563@abigail.blackend.org>
Content-Type: text/plain; charset=ISO-8859-1; format=flowed
Content-Transfer-Encoding: 7bit
Cc: Johann Kois <jkois@freebsd.org>, doc-committers@freebsd.org,
	Giorgos Keramidas <keramida@freebsd.org>, cvs-all@freebsd.org,
	cvs-doc@freebsd.org
Subject: Re: cvs
	commit:	doc/en_US.ISO8859-1/books/handbook/security	chapter.sgml
X-BeenThere: cvs-doc@freebsd.org
X-Mailman-Version: 2.1.5
Precedence: list
List-Id: CVS commit messages for the doc and www trees <cvs-doc.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/cvs-doc>,
	<mailto:cvs-doc-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/cvs-doc>
List-Post: <mailto:cvs-doc@freebsd.org>
List-Help: <mailto:cvs-doc-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/cvs-doc>,
	<mailto:cvs-doc-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Sun, 12 Nov 2006 11:22:56 -0000

Marc Fonvieille wrote:
> On Sun, Nov 12, 2006 at 11:57:46AM +0100, Niclas Zeising wrote:
>> The difference between ssh and <application>ssh</application> is that 
>> ssh can be both an application and a protocol, and we have to 
>> differentiate that. Apart from that, I find staring a sentence with a 
>> non-capitalized letter looks weird. Maybe we should use the 
>> all-capitalized version, at least when talking about the protocol.
> 
> SSH is the protocol, and ssh is the application/program (so
> <application></application> or <command></command> according to the
> situation).  We also have to start a sentence with a capitalized letter,
> so we used to do the same thing as in the manual page, i.e, writing "The
> blahblah utility/tool/program/whatever".
> 
Okay. I'll do an overhaul of the security chapter and see if I can make 
some sort of progress regarding consistency between, SSH, ssh and so on, 
using SSH for the protocol, and <application>ssh</application> or 
<command>ssh</command> depending on the situation.
Thanks for the clarification!
Regards!
//Niclas