From owner-freebsd-doc@FreeBSD.ORG Tue Jul 27 18:20:03 2010 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 2E6A510656B3 for ; Tue, 27 Jul 2010 18:20:03 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id DABD48FC2D for ; Tue, 27 Jul 2010 18:20:02 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.4/8.14.4) with ESMTP id o6RIK2MX053765 for ; Tue, 27 Jul 2010 18:20:02 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.4/8.14.4/Submit) id o6RIK24m053764; Tue, 27 Jul 2010 18:20:02 GMT (envelope-from gnats) Resent-Date: Tue, 27 Jul 2010 18:20:02 GMT Resent-Message-Id: <201007271820.o6RIK24m053764@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-doc@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, Anton Shterenlikht Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 98E5E1065675 for ; Tue, 27 Jul 2010 18:18:26 +0000 (UTC) (envelope-from mexas@bristol.ac.uk) Received: from dirg.bris.ac.uk (dirg.bris.ac.uk [137.222.10.102]) by mx1.freebsd.org (Postfix) with ESMTP id 4D6F28FC2E for ; Tue, 27 Jul 2010 18:18:26 +0000 (UTC) Received: from ncsd.bris.ac.uk ([137.222.10.59] helo=ncs.bris.ac.uk) by dirg.bris.ac.uk with esmtp (Exim 4.69) (envelope-from ) id 1OdojQ-0002sR-UI for FreeBSD-gnats-submit@freebsd.org; Tue, 27 Jul 2010 19:18:25 +0100 Received: from mech-cluster241.men.bris.ac.uk ([137.222.187.241]) by ncs.bris.ac.uk with esmtpsa (TLSv1:AES256-SHA:256) (Exim 4.67) (envelope-from ) id 1OdojQ-0006BD-Pk for FreeBSD-gnats-submit@freebsd.org; Tue, 27 Jul 2010 19:18:24 +0100 Received: from mech-cluster241.men.bris.ac.uk (localhost [127.0.0.1]) by mech-cluster241.men.bris.ac.uk (8.14.4/8.14.4) with ESMTP id o6RIIOV0083481 for ; Tue, 27 Jul 2010 19:18:24 +0100 (BST) (envelope-from mexas@mech-cluster241.men.bris.ac.uk) Received: (from mexas@localhost) by mech-cluster241.men.bris.ac.uk (8.14.4/8.14.4/Submit) id o6RIIOIW083480; Tue, 27 Jul 2010 19:18:24 +0100 (BST) (envelope-from mexas) Message-Id: <201007271818.o6RIIOIW083480@mech-cluster241.men.bris.ac.uk> Date: Tue, 27 Jul 2010 19:18:24 +0100 (BST) From: Anton Shterenlikht To: FreeBSD-gnats-submit@FreeBSD.org X-Send-Pr-Version: 3.113 Cc: Subject: docs/149007: wrong program name on fdp-primer page X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: Anton Shterenlikht List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 27 Jul 2010 18:20:03 -0000 >Number: 149007 >Category: docs >Synopsis: wrong program name on fdp-primer page >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: change-request >Submitter-Id: current-users >Arrival-Date: Tue Jul 27 18:20:02 UTC 2010 >Closed-Date: >Last-Modified: >Originator: Anton Shterenlikht >Release: FreeBSD 9.0-CURRENT ia64 >Organization: University of Bristol >Environment: System: FreeBSD mech-cluster241.men.bris.ac.uk 9.0-CURRENT FreeBSD 9.0-CURRENT #0 r209586: Wed Jun 30 09:59:43 BST 2010 mexas@mech-cluster241.men.bris.ac.uk:/usr/obj/usr/src/sys/TZAV ia64 >Description: On http://www.freebsd.org/doc/en_US.ISO8859-1/books/fdp-primer/sgml-primer-elements.html need to do s/nsgmls/onsgmls/g >How-To-Repeat: >Fix: try this patch --- chapter.sgml.diff begins here --- --- chapter.sgml.old 2010-07-27 19:05:14.000000000 +0100 +++ chapter.sgml 2010-07-27 19:05:32.000000000 +0100 @@ -412,23 +412,23 @@ Try to validate this file using an SGML parser. Part of textproc/docproj is the - nsgmls validating - parser. Normally, nsgmls reads in a document + onsgmls validating + parser. Normally, onsgmls reads in a document marked up according to an SGML DTD and returns a copy of the document's Element Structure Information Set (ESIS, but that is not important right now). - However, when nsgmls is given the - parameter, nsgmls will suppress its normal output, and + However, when onsgmls is given the + parameter, onsgmls will suppress its normal output, and just print error messages. This makes it a useful way to check to see if your document is valid or not. - Use nsgmls to check that your document is + Use onsgmls to check that your document is valid: - &prompt.user; nsgmls -s example.sgml + &prompt.user; onsgmls -s example.sgml - As you will see, nsgmls returns without displaying any + As you will see, onsgmls returns without displaying any output. This means that your document validated successfully. @@ -438,11 +438,11 @@ removing the title and /title tags, and re-run the validation. - &prompt.user; nsgmls -s example.sgml -nsgmls:example.sgml:5:4:E: character data is not allowed here -nsgmls:example.sgml:6:8:E: end tag for "HEAD" which is not finished + &prompt.user; onsgmls -s example.sgml +onsgmls:example.sgml:5:4:E: character data is not allowed here +onsgmls:example.sgml:6:8:E: end tag for "HEAD" which is not finished - The error output from nsgmls is organized into + The error output from onsgmls is organized into colon-separated groups, or columns. @@ -458,7 +458,7 @@ 1 The name of the program generating the error. This - will always be nsgmls. + will always be onsgmls. @@ -483,8 +483,8 @@ message, W is for warnings, and E is for errors It is not always the fifth column either. - nsgmls -sv displays - nsgmls:I: SP version "1.3" + onsgmls -sv displays + onsgmls:I: SP version "1.3" (depending on the installed version). As you can see, this is an informational message. , and X is for @@ -512,7 +512,7 @@ The second error is because head elements must contain a title - element. Because it does not nsgmls considers that the + element. Because it does not onsgmls considers that the element has not been properly finished. However, the closing tag indicates that the element has been closed before it has been finished. @@ -894,13 +894,13 @@ Add some comments to example.sgml, and - check that the file still validates using nsgmls. + check that the file still validates using onsgmls. Add some invalid comments to example.sgml, and see the error messages that - nsgmls gives when it encounters an invalid comment. + onsgmls gives when it encounters an invalid comment. @@ -1049,7 +1049,7 @@ - Validate the document using nsgmls. + Validate the document using onsgmls. --- chapter.sgml.diff ends here --- >Release-Note: >Audit-Trail: >Unformatted: