Hello,

I am struggling with xubuntu documentation libs (aka entities). Please
allow me to demonstrate the problem on an example.

This is a typical header of xubuntu xml documentation file
(add-applications by Jim):

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
        "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
<!ENTITY % globalent SYSTEM "../../../libs/global.ent">
%globalent;
<!ENTITY % cdo-C SYSTEM "../../../libs/cdo-C.ent">
%cdo-C;
<!ENTITY % gnome-menus-C SYSTEM "../../../ubuntu/libs/gnome-menus-C.ent">
%gnome-menus-C;
<!ENTITY % xinclude SYSTEM "../../../libs/xinclude.mod">
%xinclude;
<!ENTITY language "en">
<!ENTITY ubuntu '<phrase>Ubuntu</phrase>'>
]>

As it seems, it points to several 'entity' files, however, none of
which is in /xubuntu/libs dir. Instead, it points to generic libs and,
noticeably, ubuntu libs. Therefore, xubuntu-specific menu entries in
/xubuntu/libs/gnome-menus-C.ent and xubuntu.ent are being ignored.

On the other hand, basic-commands (by Freddy) has a slightly different
header. Precisely, this line is different:
<!ENTITY % gnome-menus-C SYSTEM "../../libs/gnome-menus-C.ent">
Apparently, this links to /xubuntu/libs/gnome-menus-C.ent.
Nevertheless, none of these two links to xubuntu.ent (and these are
currently the only two modified files in xubuntu's trunk).

This raises an obvious question. What is the proper way to include
xubuntu-specific menu entries? One solution would be to just add a
proper entity declaration to each and every file, but is it really
necessary? Some of the definitions in gnome-menus-c.ent and
xubuntu.ent reiterate. Wouldn't it be a better idea to merge these
files?

Sorry for such a lengthy email but I wanted to avoid misunderstanding.

Kind Regards,
Jan