LSB Addendum: SGML & XML Rationale

Table of Contents
Introduction
Definitions
R001--SGML Directory layout
R002--DocBook Directory layout
R003--Open Catalog usage for SGML
R004--Open Catalog usage for DocBook
R005--Configuration files
R006--Iso-entities
R007--Packages

This document explains the rationale for the recommendations to LSB about DocBook. The actual recommendations are presented in a separate document.

Introduction

There are hundreds of man-hours behind those recommendations. They really costed blood, sweat and tears. Each line was discussed many times and the global architecture changed quite often. We really tried to hear what everyone add to say. So we would like to encourage LSB in being very careful if they want to modify them.

The general philosophy was to keep the "historical" choices everywhere it had no consequences, and the "best" technical choice wherever it was interesting. We have attempted to design a very simple but also powerful architecture, in full respect of the FHS (File system Hierarchy Standard).

Another general principal of design was to think about the practical concerns of the user instead of the theory. There were many models that would have been much more intellectually satisfying--but they were all too complex for everyday's use.