Go to main content

man pages section 8: System Administration Commands

Exit Print View

Updated: Thursday, June 13, 2019
 
 

install-catalog (8)

Name

install-catalog - Manage a SGML or XML centralized catalog

Synopsis

install-catalog [ option ]  action  ... [  [ -d]  [ --delegate] ]  [  [
-a centralized ordinary]  [ --add centralized ordinary]

[ -r centralized ordinary]  [ --remove centralized ordinary]

[ -h]  [ --help]

[ -v]  [ --version] ]

Description

INSTALL-CATALOG(8)                                          INSTALL-CATALOG(8)



NAME
       install-catalog - Manage a SGML or XML centralized catalog

SYNOPSIS
       install-catalog [ option ]  action  ... [  [ -d]  [ --delegate] ]  [  [
       -a centralized ordinary]  [ --add centralized ordinary]

        [ -r centralized ordinary]  [ --remove centralized ordinary]

        [ -h]  [ --help]

        [ -v]  [ --version] ]


DESCRIPTION
       This shell script allows to handle a  centralized  catalog  referencing
       other "ordinary" SGML or XML Open Catalogs.

       An  Open  Catalog contains a set of directives defined by OASIS, mostly
       used for defining equivalences between FPIs (Formal Public Identifiers)
       and  real  file  names  (see  TR9401:1997  on http://www.oasis-open.org
       <URL:http://www.oasis-open.org>).  The Open Catalogs usually reside  in
       /usr/share/sgml.

       A centralized catalog is a special Open Catalog that includes only com-
       ments and CATALOG directives pointing to other  catalogs  (or  DELEGATE
       directives if supported). The centralized catalog can be the key to all
       other SGML resources. It usually resides in /etc/sgml.

       The centralized catalog can be edited manually or through the  install-
       catalog  script to add or remove references to other ordinary catalogs.
       This script is mainly destined to  software  package  post-installation
       scripts.

       An example of a typical call to install-catalog is:

             install-catalog --add \
               /usr/share/sgml/docbook/dsssl-stylesheets-1.54/catalog \
               /etc/sgml/sgml-docbook-4.0.cat


       This call will install in /etc/sgml/sgml-docbook-4.0.cat a reference to
       /usr/share/sgml/docbook/dsssl-stylesheets-1.54/catalog.

OPTIONS
       Here is the list of options that can influence the way  install-catalog
       works:

        [  [ -d]  [ --delegate] ]


       Use DELEGATE instead of CATALOG directives to specify a pointer

ACTIONS
       Here is the list of actions that can be requested to install-catalog:

        [  [ -a centralized ordinary]  [ --add centralized ordinary] ]


       Declare a new SGML package.

        [  [ -r centralized ordinary]  [ --remove centralized ordinary] ]


       Remove a previously installed SGML package.

        [  [ -h]  [ --help] ]


       Print a short help message and exit

        [  [ -v]  [ --version] ]


       Print the version identifier and exit

FILES
       /etc/sgml/*

       The SGML centralized catalogs

AUTHORS
       Eric Bischoff <ebisch@cybercable.tm.fr>

       Developper of install-catalog.


ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:


       +---------------+-----------------------+
       |ATTRIBUTE TYPE |   ATTRIBUTE VALUE     |
       +---------------+-----------------------+
       |Availability   | data/sgml-common      |
       +---------------+-----------------------+
       |Stability      | Pass-through volatile |
       +---------------+-----------------------+
SEE ALSO
       jw(1)

       conversion from DocBook to other file formats



       nsgmls(1)

       a base component of Jade DSSSL engine



       http://sourceware.cygnus.com/docbook-tools/         <URL:http://source-
       ware.cygnus.com/docbook-tools/>

       the home page of the DocBook tools, a compendium of all tools necessary
       to process DocBook files, including the SGML-common stuff.



NOTES
       This     software     was    built    from    source    available    at
       https://github.com/oracle/solaris-userland.   The  original   community
       source       was      downloaded      from       http://pkgs.fedorapro-
       ject.org/repo/pkgs/sgml-common/sgml-com-
       mon-0.6.3.tgz/103c9828f24820df86e55e7862e28974/sgml-common-0.6.3.tgz

       Further information about this software can be found on the open source
       community website at http://www.w3.org/2003/entities/.



                                04 August 2000              INSTALL-CATALOG(8)