From owner-freebsd-doc@freebsd.org Sun Nov 29 09:41:43 2015 Return-Path: Delivered-To: freebsd-doc@mailman.ysv.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by mailman.ysv.freebsd.org (Postfix) with ESMTP id 6F67FA3B214 for ; Sun, 29 Nov 2015 09:41:43 +0000 (UTC) (envelope-from bugzilla-noreply@freebsd.org) Received: from kenobi.freebsd.org (kenobi.freebsd.org [IPv6:2001:1900:2254:206a::16:76]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client did not present a certificate) by mx1.freebsd.org (Postfix) with ESMTPS id 4258C13C0 for ; Sun, 29 Nov 2015 09:41:43 +0000 (UTC) (envelope-from bugzilla-noreply@freebsd.org) Received: from bugs.freebsd.org ([127.0.1.118]) by kenobi.freebsd.org (8.15.2/8.15.2) with ESMTP id tAT9fhFZ085735 for ; Sun, 29 Nov 2015 09:41:43 GMT (envelope-from bugzilla-noreply@freebsd.org) From: bugzilla-noreply@freebsd.org To: freebsd-doc@FreeBSD.org Subject: [Bug 204893] [patch] FDP, section 7.6.2: Wrong example for defining parameter entities Date: Sun, 29 Nov 2015 09:41:43 +0000 X-Bugzilla-Reason: AssignedTo X-Bugzilla-Type: new X-Bugzilla-Watch-Reason: None X-Bugzilla-Product: Documentation X-Bugzilla-Component: Documentation X-Bugzilla-Version: Latest X-Bugzilla-Keywords: patch X-Bugzilla-Severity: Affects Many People X-Bugzilla-Who: andipersti@gmail.com X-Bugzilla-Status: New X-Bugzilla-Priority: --- X-Bugzilla-Assigned-To: freebsd-doc@FreeBSD.org X-Bugzilla-Target-Milestone: --- X-Bugzilla-Flags: X-Bugzilla-Changed-Fields: bug_id short_desc product version rep_platform op_sys bug_status keywords bug_severity priority component assigned_to reporter Message-ID: Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: 7bit X-Bugzilla-URL: https://bugs.freebsd.org/bugzilla/ Auto-Submitted: auto-generated MIME-Version: 1.0 X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.20 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 29 Nov 2015 09:41:43 -0000 https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=204893 Bug ID: 204893 Summary: [patch] FDP, section 7.6.2: Wrong example for defining parameter entities Product: Documentation Version: Latest Hardware: Any OS: Any Status: New Keywords: patch Severity: Affects Many People Priority: --- Component: Documentation Assignee: freebsd-doc@FreeBSD.org Reporter: andipersti@gmail.com Keywords: patch In section 7.6.2 ("Parameter Entities") of the FDP (https://www.freebsd.org/doc/en_US.ISO8859-1/books/fdp-primer/xml-primer-entities.html#xml-primer-parameter-entities) the example given is wrong. The XML standard doesn't allow references to parameter entities within markup declarations in an internal subset of the DTD (see http://www.w3.org/TR/2006/REC-xml11-20060816/#wfc-PEinInternalSubset). Thus, the line 5 in the example () is not well-formed XML. (The delimiting semicolons are also missing in both references.) I suggest to replace that example with a more realistic one like "> %entity; ]> (The attached patch also fixes a typo and adds a sentence about the usefulness of parameter entities.) -- You are receiving this mail because: You are the assignee for the bug.