Hi Joerg,
you wrote:
BTW: Why did Sun switch to XML?
We moved from nroff to SGML years ago, I believe to drive consistent look/feel
throughout the content in all published forms and languages. We are currently
scheduling the move from SGML to XML in order to enable collaboration with you
and the rest of the opensolaris community. With SGML, we have limited free
tools to choose from, so to expand that field of tools we are planning the move
to XML. The ultimate goal is a Mercurial repo on opensolaris with all the man
pages in XML. What do you think?
Thanks,
Michelle
Joerg Schilling wrote:
michelle olson <[EMAIL PROTECTED]> wrote:
Hi Joerg,
For the overprinting and too many line breaks issues, can you provide
the specific pages that have this problem as you find them? We can fix
it if we know which pages have the problem.
I am not sure whether this problem may occur for you.
It did occur for me after I added a correctly formatted part (according to
man -s 5 man) to the OPTIONS part of a man page. I had to completely reformat
the whole OPTIONS part in order to make it work again.
The corrected sccs-admin.1 man page is in
ftp://ftp.berlios.de/pub/schily/schily-2008-01-10.tar.bz2
I realize that the roff pages are difficult for you to edit, we are
working hard to transition to an XML man page gate on opensolaris.org.
After we complete that work, you can clone a workspace with exact same
sources as we use inside Sun.
Of course, then we will have to work on new tools for processing to
nroff or new command to read XML... I appreciate your patience, help,
and advice on this strategy.
If I create portable software from previously Solaris only software, I need to
take care about usability of man pages on other platforms too. The only format
that is portable to all platforms seems to be troff.
BTW: Why did Sun switch to XML?
Jörg
_______________________________________________
opensolaris-code mailing list
[email protected]
http://mail.opensolaris.org/mailman/listinfo/opensolaris-code
