sgml-common-0.6.3

#### Beyond Linux® From Scratch (systemd Edition) - Version r13.0-1357

### Chapter 48. Standard Generalized Markup Language (SGML)

- Prev

  Standard Generalized Markup Language (SGML)

- Next

  docbook-3.1-dtd

- Up
- Home

# sgml-common-0.6.3

## Introduction to SGML Common

The SGML Common package contains install-catalog. This is useful for creating and maintaining centralized SGML catalogs.

### Note

This package is known to build and work properly using an LFS 13.1 platform.

### Package Information

- Download (HTTP): https://sourceware.org/ftp/docbook-tools/new-trials/SOURCES/sgml-common-0.6.3.tgz

- Download MD5 sum: 103c9828f24820df86e55e7862e28974

- Download size: 75 KB

- Estimated disk space required: 1.5 MB

- Estimated build time: less than 0.1 SBU

### Additional Downloads

- Required patch: https://www.linuxfromscratch.org/patches/blfs/svn/sgml-common-0.6.3-manpage-1.patch

## Installation of SGML Common

Instead of the normal convention of including the autotools files in the package, the maintainers included symlinks to the files in `/usr/share/automake`. For previous versions of Automake this convention is valid, but more recent versions of Automake install the internal files in version specific directories. This causes the configure script to abort because it is unable to find these files. To fix this problem, the build system needs to be regenerated. Since the included `Makefile.am` file uses syntax for installing the manual page that is not supported by current versions of Automake, a patch is required to correct the syntax.

    patch -Np1 -i ../sgml-common-0.6.3-manpage-1.patch &&
    autoreconf -f -i

Install SGML Common by running the following commands:

    ./configure --prefix=/usr --sysconfdir=/etc &&
    make

This package does not come with a test suite.

Now, as the `root` user:

    make docdir=/usr/share/doc install &&

    install-catalog --add /etc/sgml/sgml-ent.cat \
        /usr/share/sgml/sgml-iso-entities-8879.1986/catalog &&

    install-catalog --add /etc/sgml/sgml-docbook.cat \
        /etc/sgml/sgml-ent.cat

### Update Hint

Remove the above catalog items prior to upgrading (as the `root` user) with:

    install-catalog --remove /etc/sgml/sgml-ent.cat \
        /usr/share/sgml/sgml-iso-entities-8879.1986/catalog &&

    install-catalog --remove /etc/sgml/sgml-docbook.cat \
        /etc/sgml/sgml-ent.cat

## Configuring SGML Common

### Config Files

`/etc/sgml/sgml.conf`

### Configuration Information

No change in this file is necessary.

## Contents

Installed Programs: install-catalog and sgmlwhich
Installed Libraries: None
Installed Files: SGML and XML DocBook entity files
Installed Directories: /etc/sgml, /usr/share/doc/sgml-common-0.6.3, and /usr/share/sgml

### Short Descriptions

install-catalog | creates a centralized catalog that maintains references to catalogs scattered throughout the `/usr/share/sgml` directory tree
sgmlwhich | prints the name of the main configuration file to standard output
`SGML entities files` | contains the basic character entities defined with SDATA entries
`XML entities files` | contains the basic character entities defined by a hexadecimal representation of the Unicode character number

- Prev

  Standard Generalized Markup Language (SGML)

- Next

  docbook-3.1-dtd

- Up
- Home