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.
Released on 2004/01/17, its state was alpha.
* Fixes to allow multiple entries with the same content in both SGML and
XML catalog files. Sorry but this may break command line compatibility
with old versions in some scenarios; that is, the "remove" action now
takes pairs of values. Even though, if just one argument is given to
"remove", it behaves as before to help the transition to newer versions.
* New catalogs are created now in memory before writting them to disk.
This ensures that they will look exactly the same after creation and
after some manipulation (addition and removal of entries).
* Added an option to configure, '-n doc', to disable installation of
distribution documentation files in the system.
* Some bug fixes.
"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."
I'm updating the package to this version because it should fix many
portability issues (avoiding the installation of GNU tools), and because
it is a lot safer when modifying existing catalog files (not line oriented
any more and with real file locking).
I've tested the program under several other systems and platforms (including
FreeBSD, Linux and Solaris, the later with the sunpro compiler too), and it
built and worked fine. Thanks to simonb@ for testing under an Alpha system
with pkgsrc.
Change log follows:
Released on 2003/12/23, its state was alpha.
* xmlcatmgr has been completely rewritten in C. Even though, command line
compatibility has been kept, so that existing scripts using this program
do not break.
* Buildtool is not used any more. A custom build infrastructure has been
implemented, as something small and very portable was needed.
* Added the `lookup' action, used to search for entries in catalogs.
* Added real parsers to manipulate SGML and XML catalogs. The program is
not line oriented any more, thus beeing a lot more flexible.
* Multiple race conditions fixed, which were unavoidable from a shell
script.
* Better handling of special characters and spaces in strings, difficult
to handle from shell scripts.
Released on 2003/12/16, its state was stable.
* Added the BT_PROG_GREP variable to the build system; this is to allow the
user override the grep program used by xmlcatmgr. In some systems, like
Solaris, the -F flag is not supported, so an alternative must be used.
* Fixed AWK code generation to work with the mawk interpreter.
* Fixed Makefile.boot to install documentation inside the directory pointed
by the BT_DIR_DOC variable.
Thanks to reed@ for mawk fixes and grant@ for Solaris tests.
* Adapted Buildtool scripts to the latest version, 0.14. As a side effect,
distribution documentation is now installed into the system.
* Minor manpage fixes.
* Code cleanup.
Fixes in the package: avoid overwriting catalog files when using 'make
replace' (if you have 0.2 installed actually, it won't take any effect, so
be careful by backing up pkg/share/{sgml,xml}/catalog). 'make update' will
work fine.
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.
have it be automatically included by bsd.pkg.mk if USE_PKGINSTALL is set
to "YES". This enforces the requirement that bsd.pkg.install.mk be
included at the end of a package Makefile. Idea suggested by Julio M.
Merino Vidal <jmmv at menta.net>.
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.
