From owner-freebsd-doc@freebsd.org Wed May 24 11:53:49 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 9554BD7B83A for ; Wed, 24 May 2017 11:53:49 +0000 (UTC) (envelope-from luzar722@gmail.com) Received: from mail-it0-x230.google.com (mail-it0-x230.google.com [IPv6:2607:f8b0:4001:c0b::230]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (Client CN "smtp.gmail.com", Issuer "Google Internet Authority G2" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 5160D1598 for ; Wed, 24 May 2017 11:53:49 +0000 (UTC) (envelope-from luzar722@gmail.com) Received: by mail-it0-x230.google.com with SMTP id g126so37261691ith.0 for ; Wed, 24 May 2017 04:53:49 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=message-id:date:from:user-agent:mime-version:to:cc:subject :references:in-reply-to:content-transfer-encoding; bh=6EHeZZ5wsLsScUOl3BUBZLe/hOKYBwCDCKZW3FpjklA=; b=g9wsPLS92r8qKi+3MBR4PyjW+5Vjo76j/2huvWtgoNSfHrBLx6k8QziaO6c9PY+Zo3 tAfiv5xWkxqwW7U6N0NS1lgWxqLDaMAUsvsypEZM4BL+kxjGeihZHJ5AEEnMtd+GQkpO Ho5Kblwxm0v0EUNvVmekSGa7d9wFYLg2gwCw1+pvfmnWsQ9NKMn6ft/X/6T5U/dx1Fka 6S+83oBWk8T9vHb4qftCzyGMVoHPRK7YkH57l5zrRBmd3wUKvLksFEhAckIudRFub4+0 KOdUIoGfyzNP6/DOkJNK9uoDsSj/33FK9Dzk/G2tudNa7zFL3/6YW+aw9MGvi+vM9SSs j6nA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:message-id:date:from:user-agent:mime-version:to :cc:subject:references:in-reply-to:content-transfer-encoding; bh=6EHeZZ5wsLsScUOl3BUBZLe/hOKYBwCDCKZW3FpjklA=; b=IKnHGj/FBHcMwynJyIHwIM8Zc0pE1kvPatWjEwk25XbTRi4k7ha3JryWBVMoZp7EYl vZUExuStUk14M8RLKgT16e3z5Hany9CdugTkkEYNWCtGKocNywiwve0Zw2ReNDIidRW1 SUAmszaoCnQd7ukkfp0ipJICV3vzHLsNJnbARQHLlxURzFndleLrVtibkg7MT6dLdGDk wKAkFcpyg9uWuqf2HYv3waZmJlDzBWbzE4A0XaZD5OppM6pZ301zgVXA8qvBvW9o1s3y tnlT55lltgORoN5eVhpUIIFhUh3Kbx4o5H/zr3ZHp0yjEz6iU1TKPEwKEJOaqnAQlm3f 2qRg== X-Gm-Message-State: AODbwcAKCNCSzL6qQVL1tHgcGZFN+uPhDguhs56spXP+VjIXnx+BSMW4 sfxHYXKjK5qW7xOz X-Received: by 10.36.23.22 with SMTP id 22mr8132707ith.78.1495626828572; Wed, 24 May 2017 04:53:48 -0700 (PDT) Received: from [10.0.10.3] (cpe-74-141-88-57.neo.res.rr.com. [74.141.88.57]) by smtp.googlemail.com with ESMTPSA id m4sm1534029ith.5.2017.05.24.04.53.47 (version=TLS1 cipher=ECDHE-RSA-AES128-SHA bits=128/128); Wed, 24 May 2017 04:53:48 -0700 (PDT) Message-ID: <59257457.1090204@gmail.com> Date: Wed, 24 May 2017 07:53:59 -0400 From: Ernie Luzar User-Agent: Thunderbird 2.0.0.24 (Windows/20100228) MIME-Version: 1.0 To: Trevor Roydhouse CC: freebsd-doc Subject: Re: having trouble making changes to the handbook References: <592041FB.9030408@gmail.com> <20170522050544.GS39245@kduck.kaduk.org> <59231887.7090100@gmail.com> <20170523024852.GV39245@kduck.kaduk.org> <592474C7.3070900@gmail.com> In-Reply-To: Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit 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 11:53:49 -0000 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 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 Here is what the xml markup notation code looks like;As seem in the raw code. which when seen from a browser would show as Here is what the xml markup notation code looks like; As seem in the raw code.