From owner-freebsd-doc@FreeBSD.ORG  Mon Apr  7 19:49:56 2003
Return-Path: <owner-freebsd-doc@FreeBSD.ORG>
Delivered-To: freebsd-doc@hub.freebsd.org
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP
	id AA62137B401; Mon,  7 Apr 2003 19:49:56 -0700 (PDT)
Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21])
	by mx1.FreeBSD.org (Postfix) with ESMTP
	id 5B43C43F85; Mon,  7 Apr 2003 19:49:56 -0700 (PDT)
	(envelope-from murray@FreeBSD.org)
Received: from freefall.freebsd.org (murray@localhost [127.0.0.1])
	by freefall.freebsd.org (8.12.9/8.12.9) with ESMTP id h382nuUp091607;
	Mon, 7 Apr 2003 19:49:56 -0700 (PDT)
	(envelope-from murray@freefall.freebsd.org)
Received: (from murray@localhost)
	by freefall.freebsd.org (8.12.9/8.12.9/Submit) id h382ntN0091603;
	Mon, 7 Apr 2003 19:49:55 -0700 (PDT)
Date: Mon, 7 Apr 2003 19:49:55 -0700 (PDT)
From: Murray Stokely <murray@FreeBSD.org>
Message-Id: <200304080249.h382ntN0091603@freefall.freebsd.org>
To: osa@FreeBSD.org.ru, murray@FreeBSD.org, freebsd-doc@FreeBSD.org
Subject: Re: docs/50677: [PATCH] update
	doc/en_US.ISO8859-1/books/faq/book.sgml
X-BeenThere: freebsd-doc@freebsd.org
X-Mailman-Version: 2.1.1
Precedence: list
List-Id: Documentation project <freebsd-doc.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/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: Tue, 08 Apr 2003 02:49:57 -0000

Synopsis: [PATCH] update doc/en_US.ISO8859-1/books/faq/book.sgml

State-Changed-From-To: open->feedback
State-Changed-By: murray
State-Changed-When: Mon Apr 7 19:46:21 PDT 2003
State-Changed-Why: 
Arghh.. I just lost my extensive comments about this patch.  The short
of it is that this doesn't even validate (missing tags, etc..) and the
English is ambiguous.  I think every sentence needs revision.  Here is
the last bit of my previous comment that I was able to salvage from my
editor on freefall :

"The NEWCARD implementation for PC-card does not work for me." ..

Also, The cbb0 line might be better if enclosed in <errorname>.

I won't go on, but each entry needs extensive grammatical improvement
as well as some markup changes.

Maybe someone else can work with you to improve the English?

It would be nice to add these technical issues to the FAQ.

Thanks for your time spent writing this up.  Your contributions are
appreciated.


http://www.freebsd.org/cgi/query-pr.cgi?pr=50677