You are viewing a plain text version of this content. The canonical link for it is here.
Posted to docs@httpd.apache.org by Joshua Slive <jo...@slive.ca> on 2002/11/09 19:43:52 UTC
nroff man pages going away
[X-posted to dev because I don't want anybody being surprised by the
disappearance of man pages and having a fit about it.]
Question: How important is it that we distribute nroff man pages?
At the moment there is nobody updating the man pages because nobody feels
like playing with nroff. Even if they do get updated, it is difficult to
transform the nroff into a format that works well in the manual. So the
choices are:
1. Just ditch the nroff and covert to xml like the rest of the docs; stop
distributing independent man pages.
2. Leave in nroff, hope that somebody decides to update them and that we
can figure out a decent way to convert to xml/html for the manual.
3. Convert to xml, and find a way to generate nroff from the xml so that
we can continue to distribute man pages.
I believe that 2 is not a solution, since nobody has been willing to touch
the nroff pages in a long time. They are getting more and more out of
date. The best solution would be 3, but that would be quite a chunk of
work. So unless somebody comes up with a better solution, I will be
removing the nroff man pages and replacing them with xml.
Joshua.
---------------------------------------------------------------------
To unsubscribe, e-mail: docs-unsubscribe@httpd.apache.org
For additional commands, e-mail: docs-help@httpd.apache.org
Re: nroff man pages going away
Posted by André Malo <nd...@perlig.de>.
* Joshua Slive wrote:
> 3. Convert to xml, and find a way to generate nroff from the xml so that
> we can continue to distribute man pages.
I like this variant, but I think, if we don't have man pages for a while,
it's probably not a problem. We can readd them later to the distribution
(after the time we need to create an appropriate xslt).
nd
--
s s^saaaaaoaaaoaaaaooooaaoaaaomaaaa a alataa aaoat a a
a maoaa a laoata a oia a o a m a o alaoooat aaool aaoaa
matooololaaatoto aaa o a o ms;s;\s;s;g;y;s;:;s;y#mailto: #
\51/\134\137| http://www.perlig.de #;print;# > nd@perlig.de
Re: nroff man pages going away
Posted by Joshua Slive <jo...@slive.ca>.
On Sun, 10 Nov 2002, Tsuyoshi SASAMOTO wrote:
> >So the choices are:
> > :
> >3. Convert to xml, and find a way to generate nroff from the xml so that
> >we can continue to distribute man pages.
>
> As a hint...
>
> Solaris has SGML man docs. "/usr/lib/sgml/sgml2roff" can be
> used to convert SGML docs to roff ones.
There are also docbook to nroff converters. I'm not saying it isn't
possible, I'm just saying it won't be easy. Our doc format is neither
docbook, nor SGML, and even if it was, getting these types of converters
to work is often a nightmare.
Joshua.
Re: nroff man pages going away
Posted by Tsuyoshi SASAMOTO <na...@super.win.ne.jp>.
>So the choices are:
> :
>3. Convert to xml, and find a way to generate nroff from the xml so that
>we can continue to distribute man pages.
As a hint...
Solaris has SGML man docs. "/usr/lib/sgml/sgml2roff" can be
used to convert SGML docs to roff ones.
Tsuyoshi SASAMOTO
nazonazo@super.win.ne.jp
Re: nroff man pages going away
Posted by Jason Lingohr <ja...@lucid.net.au>.
On Sat, Nov 09, 2002 at 01:43:52PM -0500, Joshua Slive wrote:
> At the moment there is nobody updating the man pages because nobody feels
> like playing with nroff. Even if they do get updated, it is difficult to
I have no issues with dealing with nroff. Perhaps you and I Josh should
chat about just what needs doing.
> 2. Leave in nroff, hope that somebody decides to update them and that we
> can figure out a decent way to convert to xml/html for the manual.
Can do, if need be.
> 3. Convert to xml, and find a way to generate nroff from the xml so that
> we can continue to distribute man pages.
Agree with others -- this would be the ideal.
Jason.
---------------------------------------------------------------------
To unsubscribe, e-mail: docs-unsubscribe@httpd.apache.org
For additional commands, e-mail: docs-help@httpd.apache.org
Re: nroff man pages going away
Posted by André Malo <nd...@perlig.de>.
* Joshua Slive wrote:
> 3. Convert to xml, and find a way to generate nroff from the xml so that
> we can continue to distribute man pages.
I like this variant, but I think, if we don't have man pages for a while,
it's probably not a problem. We can readd them later to the distribution
(after the time we need to create an appropriate xslt).
nd
--
s s^saaaaaoaaaoaaaaooooaaoaaaomaaaa a alataa aaoat a a
a maoaa a laoata a oia a o a m a o alaoooat aaool aaoaa
matooololaaatoto aaa o a o ms;s;\s;s;g;y;s;:;s;y#mailto: #
\51/\134\137| http://www.perlig.de #;print;# > nd@perlig.de
---------------------------------------------------------------------
To unsubscribe, e-mail: docs-unsubscribe@httpd.apache.org
For additional commands, e-mail: docs-help@httpd.apache.org
Re: nroff man pages going away
Posted by Astrid Kessler <ke...@kess-net.de>.
Joshua Slive <jo...@slive.ca> wrote in
news:Pine.WNT.4.44.0211091333510.1476-100000@Poste3947:
> 3. Convert to xml, and find a way to generate nroff from the xml so
> that we can continue to distribute man pages.
This is the most effort, but imho the best way. Once we have an indepent
format like xml, we will be able to generate other formats. And, maybe xml
will animate to update ... ;-)
Kess
---------------------------------------------------------------------
To unsubscribe, e-mail: docs-unsubscribe@httpd.apache.org
For additional commands, e-mail: docs-help@httpd.apache.org