From owner-freebsd-doc@freebsd.org Wed May 24 12:22:33 2017 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 6169FD78F1A for ; Wed, 24 May 2017 12:22:33 +0000 (UTC) (envelope-from freebsd-doc@sentry.org) Received: from shadow.sentry.org (shadow.sentry.org [103.78.157.218]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client CN "shadow.sentry.org", Issuer "COMODO RSA Domain Validation Secure Server CA" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id CBEF01A7C for ; Wed, 24 May 2017 12:22:32 +0000 (UTC) (envelope-from freebsd-doc@sentry.org) Received: from shadow.sentry.org (localhost [127.0.0.1]) by shadow.sentry.org (8.15.2/8.15.2) with ESMTP id v4OCMS9R065655 for ; Wed, 24 May 2017 22:22:28 +1000 (AEST) (envelope-from freebsd-doc@sentry.org) Subject: Re: having trouble making changes to the handbook To: freebsd-doc References: <592041FB.9030408@gmail.com> <20170522050544.GS39245@kduck.kaduk.org> <59231887.7090100@gmail.com> <20170523024852.GV39245@kduck.kaduk.org> <592474C7.3070900@gmail.com> <59257457.1090204@gmail.com> Reply-To: freebsd-doc From: Trev Message-ID: Date: Wed, 24 May 2017 22:22:28 +1000 User-Agent: Mozilla/5.0 (X11; FreeBSD amd64; rv:49.0) Gecko/20100101 Firefox/49.0 SeaMonkey/2.46 MIME-Version: 1.0 In-Reply-To: <59257457.1090204@gmail.com> Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit X-Greylist: Sender IP whitelisted, not delayed by milter-greylist-4.6.2 (shadow.sentry.org [127.0.0.1]); Wed, 24 May 2017 22:22:28 +1000 (AEST) X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 24 May 2017 12:22:33 -0000 Ernie Luzar wrote on 24/05/2017 21:53: >> Are you referring to the tags which comprise the XML markup? > Yes the "chapter.xml" files with content enclosed with < > like > > Is this markup notation referred to as "tags" or is "markup notations" > the correct way to reference them as a group? XML Markup comprises tags which are used to denote XML elements and attributes. > Where are the intended usage meanings of all the different > combinations of markup notations documented at? Looking at the > online handbook and back tracking to the xml markup notation is not a > easy method of identifying the xml markup notation to use to add new > information to the handbook information. You need the DTD (document type definition) that is being used. The FreeBSD documentation uses the DocBook DTD. If you've already installed the textproc/docbook-xml port, the DTD is part of it. > Now here is the really puzzling question. How would I write > documentation about these xml markup notations showing the real xml > markup notation code in the doc without it being interpreted as > something that gets converted? example > Here is what the xml markup notation code looks like;As > seem in the raw code. You would use the less than and greater than XML character entities in place of the less than and greater than signs. For example, <para>