1INSTALL-CATALOG(8)                                          INSTALL-CATALOG(8)
2
3
4

NAME

6       install-catalog - Manage a SGML or XML centralized catalog
7

SYNOPSIS

9       install-catalog [ option ]  action  ... [  [ -d]  [ --delegate] ]  [  [
10       -a centralized ordinary]  [ --add centralized ordinary]
11
12        [ -r centralized ordinary]  [ --remove centralized ordinary]
13
14        [ -h]  [ --help]
15
16        [ -v]  [ --version] ]
17
18

DESCRIPTION

20       This shell script allows to handle a  centralized  catalog  referencing
21       other "ordinary" SGML or XML Open Catalogs.
22
23       An  Open  Catalog contains a set of directives defined by OASIS, mostly
24       used for defining equivalences between FPIs (Formal Public Identifiers)
25       and  real  file  names  (see  TR9401:1997  on http://www.oasis-open.org
26       <URL:http://www.oasis-open.org>).  The Open Catalogs usually reside  in
27       /usr/share/sgml.
28
29       A centralized catalog is a special Open Catalog that includes only com‐
30       ments and CATALOG directives pointing to other  catalogs  (or  DELEGATE
31       directives if supported). The centralized catalog can be the key to all
32       other SGML resources. It usually resides in /etc/sgml.
33
34       The centralized catalog can be edited manually or through the  install-
35       catalog  script to add or remove references to other ordinary catalogs.
36       This script is mainly destined to  software  package  post-installation
37       scripts.
38
39       An example of a typical call to install-catalog is:
40
41             install-catalog --add \
42               /usr/share/sgml/docbook/dsssl-stylesheets-1.54/catalog \
43               /etc/sgml/sgml-docbook-4.0.cat
44
45
46       This call will install in /etc/sgml/sgml-docbook-4.0.cat a reference to
47       /usr/share/sgml/docbook/dsssl-stylesheets-1.54/catalog.
48

OPTIONS

50       Here is the list of options that can influence the way  install-catalog
51       works:
52
53        [  [ -d]  [ --delegate] ]
54
55
56       Use DELEGATE instead of CATALOG directives to specify a pointer
57

ACTIONS

59       Here is the list of actions that can be requested to install-catalog:
60
61        [  [ -a centralized ordinary]  [ --add centralized ordinary] ]
62
63
64       Declare a new SGML package.
65
66        [  [ -r centralized ordinary]  [ --remove centralized ordinary] ]
67
68
69       Remove a previously installed SGML package.
70
71        [  [ -h]  [ --help] ]
72
73
74       Print a short help message and exit
75
76        [  [ -v]  [ --version] ]
77
78
79       Print the version identifier and exit
80

FILES

82       /etc/sgml/*
83
84       The SGML centralized catalogs
85

AUTHORS

87       Eric Bischoff <ebisch@cybercable.tm.fr>
88
89       Developper of install-catalog.
90

SEE ALSO

92       jw(1)
93
94       conversion from DocBook to other file formats
95
96
97
98       nsgmls(1)
99
100       a base component of Jade DSSSL engine
101
102
103
104       http://sourceware.cygnus.com/docbook-tools/         <URL:http://source
105       ware.cygnus.com/docbook-tools/>
106
107       the home page of the DocBook tools, a compendium of all tools necessary
108       to process DocBook files, including the SGML-common stuff.
109
110
111
112                                04 August 2000              INSTALL-CATALOG(8)
Impressum