#### Beyond Linux® From Scratch (systemd Edition) - Version 11.1

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

- Prev

  docbook-dsssl-1.79

- Next

  Extensible Markup Language (XML)

- Up
- Home

# DocBook-utils-0.6.14

## Introduction to DocBook-utils

The DocBook-utils package is a collection of utility scripts used to convert and analyze SGML documents in general, and DocBook files in particular. The scripts are used to convert from DocBook or other SGML formats into “classical” file formats like HTML, man, info, RTF and many more. There's also a utility to compare two SGML files and only display the differences in markup. This is useful for comparing documents prepared for different languages.

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

### Package Information

- Download (HTTP): https://sourceware.org/ftp/docbook-tools/new-trials/SOURCES/docbook-utils-0.6.14.tar.gz

- Download (FTP): ftp://sourceware.org/pub/docbook-tools/new-trials/SOURCES/docbook-utils-0.6.14.tar.gz

- Download MD5 sum: 6b41b18c365c01f225bc417cf632d81c

- Download size: 124 KB

- Estimated disk space required: 1.44 MB

- Estimated build time: less than 0.1 SBU

### Additional Downloads

- Required patch: https://www.linuxfromscratch.org/patches/blfs/11.1/docbook-utils-0.6.14-grep_fix-1.patch

### DocBook-utils Dependencies

#### Required

OpenJade-1.3.2, docbook-dsssl-1.79, and docbook-3.1-dtd

#### Optional (Runtime Dependencies Only)

SGMLSpm-1.1 (for conversion to man and texinfo), and Lynx-2.8.9rel.1 or Links-2.25 or W3m (for conversion to ASCII text)

User Notes: https://wiki.linuxfromscratch.org/blfs/wiki/docbook-utils

## Installation of DocBook-utils

Install DocBook-utils by running the following commands:

    patch -Np1 -i ../docbook-utils-0.6.14-grep_fix-1.patch &&
    sed -i 's:/html::' doc/HTML/Makefile.in                &&

    ./configure --prefix=/usr --mandir=/usr/share/man      &&
    make

This package does not come with a test suite.

Now, as the `root` user:

    make docdir=/usr/share/doc install

Many packages use an alternate name for the DocBook-utils scripts. If you wish to create these alternate names, use the following command as the `root` user:

    for doctype in html ps dvi man pdf rtf tex texi txt
    do
        ln -svf docbook2$doctype /usr/bin/db2$doctype
    done

### Note

The jw script uses the which command to locate required utilities. You must install Which-2.21 before attempting to use any of the DocBook-utils programs.

## Command Explanations

patch -Np1 -i ../docbook-utils-0.6.14-grep_fix-1.patch: This patch corrects the syntax in the jw (Jade Wrapper) script which is at the heart of much db2* processing, so that the current version of grep will not reject it.

sed -i 's:/html::' doc/HTML/Makefile.in: This command changes the installation directory of the HTML documents.

`docdir=/usr/share/doc`: This option is placed on the make install line because is is not recognized by configure.

## Contents

Installed Programs: docbook2dvi, docbook2html, docbook2man, docbook2pdf, docbook2ps, docbook2rtf, docbook2tex, docbook2texi, docbook2txt, jw, and sgmldiff
Installed Libraries: None
Installed Directories: /usr/share/doc/docbook-utils-0.6.14 and /usr/share/sgml/docbook/utils-0.6.14
Installed Symlinks: db2dvi, db2html, db2man, db2pdf, db2ps, db2rtf, db2tex, db2texi, and db2txt

### Short Descriptions

docbook2* | are simple one-line wrapper scripts to jw. They are provided as easy-to-remember names used to convert DocBook or other SGML files to the respective format
db2* | are symlinks pointing at the respectively named docbook2* commands, created to satisfy some program's use of these names
jw | is a script used to convert DocBook or other SGML files to various output formats. It hides most of OpenJade's complexity and adds comfortable features
sgmldiff | is used to compare two SGML files and only return the differences in the markup. This is especially useful to compare files that should be identical except for language differences in the content

Last updated on

- Prev

  docbook-dsssl-1.79

- Next

  Extensible Markup Language (XML)

- Up
- Home