Date: Wed, 24 May 2017 07:53:59 -0400 From: Ernie Luzar <luzar722@gmail.com> To: Trevor Roydhouse <trev@sentry.org> Cc: freebsd-doc <freebsd-doc@FreeBSD.org> Subject: Re: having trouble making changes to the handbook Message-ID: <59257457.1090204@gmail.com> In-Reply-To: <b44f9fd8-21a8-c847-bdbb-01ea01c4ecf2@sentry.org> References: <592041FB.9030408@gmail.com> <20170522050544.GS39245@kduck.kaduk.org> <59231887.7090100@gmail.com> <20170523024852.GV39245@kduck.kaduk.org> <592474C7.3070900@gmail.com> <b44f9fd8-21a8-c847-bdbb-01ea01c4ecf2@sentry.org>
next in thread | previous in thread | raw e-mail | index | archive | help
Trevor Roydhouse wrote: > Ernie Luzar wrote on 24/05/2017 03:43: >> One last thing. When I go to edit the chapter.xml content I see the >> text wraped in notation. Is there a special term that this "notation" >> is normally referred by? > > Are you referring to the tags which comprise the XML markup? > Yes the "chapter.xml" files with content enclosed with < > like <indexterm> </indexterm> Is this markup notation referred to as "tags" or is "markup notations" the correct way to reference them as a group? 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. 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 <para>Here is what the xml markup notation code looks like;<title>As seem in the raw code.</title></para> which when seen from a browser would show as Here is what the xml markup notation code looks like; <title>As seem in the raw code.</title>
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?59257457.1090204>