>
> Hi!
>
> ----
>
> I did a quick look at DocBook/XML support for
> /usr/bin/man - AFAIK it
> should be easy to implement since all neccesary tools
> (e.g. "xsltproc"
> and the "DocBook/XML--->*roff"-stylesheets) are
> installed...
I agree. When we added the SGML support it was a fairly simple matter of
identifying the source type, ie nroff vs sgml, and then branching to a
different processing path.
Because nroff has a built in formatting capability, we decided to convert sgml
to nroff to take advantage of that.
The same could be done with XML source. Or for that matter sgml source.
The processing tools that turned the sgml source are open source as well but I
had always wanted to use something like James Clark's SX to convert to xml and
then use the other xml tools to process into nroff.
The ultimate project was to provide a curses-based viewer that would use
stylesheets to display the xml directly.
So I've always viewed the improvements of the man command as a stagged project.
There is an old PSARC case that documents the curses viewer.
>
> ... questions:
> - Where should /usr/bin/man look for DocBook/XML
> manual pages - in
> ${MANPATHELEMENT}/sman/ or a new dir called
> ${MANPATHELEMENT}/xman/ ?
Following the established convention to put different format types of source in
different directories, I would opt for the xman*
> - Should /usr/bin/man be allowed to use the DTDs from
> network if
> available (I think "no") ?
I would agree. While it could be done then one starts to get into potential
problems with style sheet incompatibilities.
> - How is localisation supported to work with SGML/XML
> manual pages ?
> Just create a matching sman subdir in
> /usr/man/ja_JP.UTF-8/ when the
> locale is "ja_JP.UTF-8" ?
Yes. that is how it has been done for the Japanese man pages that have been
translated.
ja/
ja_JP.PCK/
ja_JP.UTF-8/
japanese@
ls -ld japanese
lrwxrwxrwx 1 root root 4 Dec 16 1998 japanese -> ./ja/
> - Why are there no locale subdirs for the translated
> manual pages ?
I'm not sure if I understand but I think the answer is that there are. But they
are not installed unless one installs them specifically. The only man pages
routinly translated are Japanese, SUNWjaman. The listing above is from a system
that has that package and you can see the locale specific directories which
each have their own man* and sman* subdirectories.
--
Dennis A. Evans, Publication Tools
Sun Microsystems, Inc. dennis.evans at sun.com
4150 Network Circle, MS MPK17-101 650 786-5451
Santa Clara, CA 95054 650 786-5723 fax
This message posted from opensolaris.org
