[PATCH 5/8] winsup/doc: Convert utils.xml to using refentry

[Jon TURNEY]

On 16/06/2015 13:49, Corinna Vinschen wrote:
> On Jun 16 12:09, Jon TURNEY wrote:
>> On 16/06/2015 10:45, Corinna Vinschen wrote:
>>> On Jun 16 10:28, Jon TURNEY wrote:
>>>> On 15/06/2015 18:11, Corinna Vinschen wrote:
>>>>> On Jun 15 13:36, Jon TURNEY wrote:
>>>>>> Convert utils.xml from using a sect2 to using a refentry for each utility
>>>>>> program.
>>>>>>
>>>>>> Unfortunately, using refentry seems to tickle a bug in dblatex when generating
>>>>>> pdf, which appears to not escape \ properly in the latex for refentry, so use
>>>>>> fop instead.
>>>>>
>>>>> Uhm... wasn't Yaakov's patch from 2014-11-28 explicitely meant to drop
>>>>> the requirement to use fop andd thus java?
>>>>>
>>>>> Is there really no other way to handle that, rather than reverting to
>>>>> fop?
>>>>
>>>> Now I try again --with-dblatex, it works fine, so that part of the patch can
>>>> be removed.
>>>>
>>>> I can only guess I must have had some other markup error causing me
>>>> problems, which has since been fixed.
>>>
>>> I'm relieved :}
>>
>> Approved with that change?
>
> Yep, thanks.

Done.

Note that the next time you build documentation for the website, you 
might need to take some special steps to add new .html files.

and next time you build a package you might need to take some special 
steps to exclude /usr/share/man/

Please let me know if there are any problems with these changes.