Is there something wrong with this (docbook) that has gone long unchanged, like the iptables instructions?

I've never been able to get docbook working correctly. Inevitably, there is a point at which I run a makefile and the screen explodes with hundreds of lines of "no ID for constraint" or "I/O error attempting to load network entity", etc.

Basically, I'm just asking if the LFS docbook setup has ever worked correctly. I've just been disabling manpage generation when things go wrong and happily hammer the offending package's website with traffic when I need help. (Since they can't be bothered to include civilized documentation.)

As an aside: the iptables instructions are borked on the module names and it's far simpler to declare the rules you want and tell iptables to load whatever modules it needs when importing them. Also, most of the "settings" they have in the directions have been default in iptables for a decade or more. If anyone is interested, I can post the scripts. I have them for both SysV and SysD.

It has. But the configuration often confuses people.

By default, only 4.5 docbook is enabled, followed by an "example" on how to enable several docbooks (which people run, and it shouldn't be ran as-is), and all of that followed by a required block to support all previous docbook versions (4.1.1, 4.2, 4.3, 4.4) which most packages use.

Well... I've tried everything. But, I don't think this is LFS' fault. I've seen it fail to varying degrees over dozens of packages tonight. Needless to day, I really despise this whole docbook system. I just want some friggin man pages without the overhead of an unwieldy document build system.