Released on 2004/01/23, its state was beta.
* Recognize two default catalog files, one for XML and one for SGML,
instead of only one as in previous versions.
* Added the `-h' option to xmlcatmgr, which shows a descriptive usage
message.
* Added multiple comments to the code, explaining what each function does.
* Some bug fixes.
The version in the buildlink2.mk file is bumped because there were some
incompatible changes done in the previous version that may cause problems
to people upgrading an already installed package. This should have really
happened in the previous version... but well, as this is now beta, there
shouldn't be any interface changes any more.
"Package Makefiles should refer to PKG_SYSCONFBASEDIR instead of
PKG_SYSCONFBASE when they want PKG_SYSCONFDIR stripped of
PKG_SYSCONFSUBDIR. This makes PKG_SYSCONFBASE=/etc work with pkgviews by
installing all config files into /etc/packages/<pkg> instead of
occasionally putting some directly into /etc."
variables from the catalogs.mk file to buildlink2.mk. These may be needed in
a package that does *not* provide catalog files (i.e., all the functionality
in catalogs.mk is not required).
* Added XML Catalogs management. You must use the new `-s' flag to handle
SGML Catalogs as XML format becomes the default.
* Dropped use of getopt in favour of getopts, as the former does not handle whitespace in variables properly.
* Handle comments in SGML catalogs properly.
* Several manpage improvements.
Changes in the package:
* Implement a new framework to automatically register/deregister catalog
entries. This is available through the catalogs.mk file. Packages do
not need to call xmlcatmgr directly any more, nor do tricky things in
their PLISTs.
* Install two catalog files under PKG_SYSCONFDIR, one called sgml/catalog
and the other xml/catalog. Both are completely different things, so they
can't be mixed. Also avoid that any of these catalogs refer to the other
one, as this could cause problems.
xmlcatmgr is a command line script used to manipulate SGML and XML catalogs.
It is designed with simplicity in mind: it does not depend on external
programs nor libraries, so it is ideal to manage catalog files from inside
pkgsrc.
XML catalogs are files that contain mappings from public identifiers to
system identifiers. This allows XML parsers to locate public identifiers
in the local system.
