<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 TRANSITIONAL//EN">
<HTML>
<HEAD>
  <META HTTP-EQUIV="Content-Type" CONTENT="text/html; CHARSET=UTF-8">
  <META NAME="GENERATOR" CONTENT="GtkHTML/3.26.0">
</HEAD>
<BODY>
On Sun, 2010-08-22 at 10:17 +0200, Mark Kettenis wrote:<BR>
<BLOCKQUOTE TYPE=CITE>
    <TT><FONT COLOR="#737373">&gt; There is no harm done in providing this information and stating when</FONT></TT><BR>
    <TT><FONT COLOR="#737373">&gt; it is applicable.</FONT></TT><BR>
    <BR>
    <TT><FONT COLOR="#1a1a1a">I disagree.&nbsp; </FONT></TT><BR>
    <BR>
</BLOCKQUOTE>
I don't have a strong opinion on that. Help me out with good examples on how other man pages deal<BR>
with a situation where the content might vary based on the computer where the software is installed.<BR>
I think this is this only module in xorg that does that. If this is preferable, then perhaps other modules should <BR>
do so as well. Some have several configure options.<BR>
<BR>
<BLOCKQUOTE TYPE=CITE>
    <TT><FONT COLOR="#737373">&gt; +This resource is valid only when the arc4random() function</FONT></TT><BR>
    <TT><FONT COLOR="#737373">&gt; +has been detected at installation.</FONT></TT><BR>
    <BR>
    <TT><FONT COLOR="#1a1a1a">How should a non-technical know whether arc4random() is present on the</FONT></TT><BR>
    <TT><FONT COLOR="#1a1a1a">system?</FONT></TT><BR>
    <BR>
</BLOCKQUOTE>
Related to my question above, is that the role of the man page? A more common situation is platform information.<BR>
Should the man page display only information relevant to the platform on which it is installed? My experience with past projects is that all information was given with some platform indication.<BR>
<BR>
What also makes me think it is not common practice to customize documentation, is the lack of support for doing so,<BR>
either in man pages, html, pdf or DocBook.<BR>
<BR>
Thanks for taking the time to reply.<BR>
Gaetan
</BODY>
</HTML>