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 <michelle.olson at sun.com> 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 > > -------------- next part -------------- An HTML attachment was scrubbed... URL: <http://mail.opensolaris.org/pipermail/docs-discuss/attachments/20080124/f05904bb/attachment.html>
