From owner-freebsd-doc@FreeBSD.ORG  Sun Oct 14 21:34:36 2012
Return-Path: <owner-freebsd-doc@FreeBSD.ORG>
Delivered-To: doc@freebsd.org
Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52])
 by hub.freebsd.org (Postfix) with ESMTP id D223B790;
 Sun, 14 Oct 2012 21:34:36 +0000 (UTC)
 (envelope-from wblock@wonkity.com)
Received: from wonkity.com (wonkity.com [67.158.26.137])
 by mx1.freebsd.org (Postfix) with ESMTP id 88DEA8FC0C;
 Sun, 14 Oct 2012 21:34:36 +0000 (UTC)
Received: from wonkity.com (localhost [127.0.0.1])
 by wonkity.com (8.14.5/8.14.5) with ESMTP id q9ELYUJG006862;
 Sun, 14 Oct 2012 15:34:30 -0600 (MDT)
 (envelope-from wblock@wonkity.com)
Received: from localhost (wblock@localhost)
 by wonkity.com (8.14.5/8.14.5/Submit) with ESMTP id q9ELYTIJ006859;
 Sun, 14 Oct 2012 15:34:29 -0600 (MDT)
 (envelope-from wblock@wonkity.com)
Date: Sun, 14 Oct 2012 15:34:29 -0600 (MDT)
From: Warren Block <wblock@wonkity.com>
To: Sergey Kandaurov <pluknet@gmail.com>
Subject: Re: Rendering problem with <question>
In-Reply-To: <CAE-mSOJDb4O7Tuy3-QAhFJCJq3GYQ4OCyuaDe7VWLVHvgWWenA@mail.gmail.com>
Message-ID: <alpine.BSF.2.00.1210141533130.6596@wonkity.com>
References: <alpine.BSF.2.00.1210140841530.4409@wonkity.com>
 <CAE-mSOJDb4O7Tuy3-QAhFJCJq3GYQ4OCyuaDe7VWLVHvgWWenA@mail.gmail.com>
User-Agent: Alpine 2.00 (BSF 1167 2008-08-23)
MIME-Version: 1.0
Content-Type: TEXT/PLAIN; charset=US-ASCII; format=flowed
X-Greylist: Sender IP whitelisted, not delayed by milter-greylist-4.2.7
 (wonkity.com [127.0.0.1]); Sun, 14 Oct 2012 15:34:30 -0600 (MDT)
Cc: doc@freebsd.org, Gabor Kovesdan <gabor@freebsd.org>
X-BeenThere: freebsd-doc@freebsd.org
X-Mailman-Version: 2.1.14
Precedence: list
List-Id: Documentation project <freebsd-doc.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/options/freebsd-doc>,
 <mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc>
List-Post: <mailto:freebsd-doc@freebsd.org>
List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
 <mailto:freebsd-doc-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Sun, 14 Oct 2012 21:34:36 -0000

On Sun, 14 Oct 2012, Sergey Kandaurov wrote:

> On 14 October 2012 18:56, Warren Block <wblock@wonkity.com> wrote:
>> There is a question and answer section at the end of the Rebuilding "world"
>> section of the Handbook:
>>
>> http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/makeworld.html#Q25.7.14.1.
>>
>> Note how the first question is shown.  Now look at the next question: the
>> question text is not shown, just the number.  The DocBook source for that
>> question:
>>
>>   <question>
>>     <indexterm><primary>signal 11</primary></indexterm>
>>
>>     <para>My compile failed with lots of signal 11 (or other signal
>>       number) errors.  What has happened?</para>
>>   </question>
>>
>> It appears the renderer is being confused by the <indexterm>, which it
>> should ignore.
>
> Hi.
> This is probably the result of sgml2xml mismerge in r39534.
> I guess the <indexterm> tag should be inside <answer>, not <question>.

That does work.  Still, seems like it should be valid before the 
question also.  Or between the two.