OK.  It seems to me that documentation<div>has fallen somewhat in to disarray.  Man</div><div>pages were once the expected place to </div><div>look.  Even in a day of HTML now, I'd </div><div>think there'd at least just be a link in a </div>
<div>man page. They were an early, and sensible</div><div>way to approach the matter, like many of</div><div>the early concepts in Unix.</div><div><br></div><div>    -- Bob</div><div><br><br><div class="gmail_quote">On Mon, Feb 21, 2011 at 11:31 PM, Jeff DeFouw <span dir="ltr"><<a href="mailto:jeffd@i2k.com">jeffd@i2k.com</a>></span> wrote:<br>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex;"><div class="im">On Mon, Feb 21, 2011 at 05:47:31PM -0500, Bob Kline wrote:<br>
> Could someone put together a little word<br>
> salad about current day Linux documentation?<br>
> e.g., I see something like openssl-doc.  What's<br>
> a standard way to access that?<br>
><br>
> /usr/share/doc is the main repository?<br>
<br>
</div>It depends on the project and how they document.  Long manuals tend to<br>
end up in -doc packages, and the man pages tell you to go there for all<br>
but a brief overview.  There doesn't seem to be a standard structure,<br>
except that it all goes under /usr/share/doc/related-package.  Some<br>
documentation goes in /package/, some goes in /package-doc/.  Often it's<br>
HTML, but that's not always true.  Sometimes you just get a README file<br>
in /usr/share/doc/package, or Debian makes one.  If it's HTML, you can<br>
point your browser at it, but you have to figure out the directory<br>
yourself.  If you install apache, Debian automatically sets up<br>
<a href="http://localhost/doc/" target="_blank">http://localhost/doc/</a> , and some packages depend on that for easy<br>
navigation, but again, you have to know what directory to start in.<br>
<br>
--<br>
Jeff DeFouw <<a href="mailto:jeffd@i2k.com">jeffd@i2k.com</a>><br>
<font color="#888888"><br>
--<br>
</font><div><div></div><div class="h5">This message has been scanned for viruses and<br>
dangerous content by MailScanner, and is<br>
believed to be clean.<br>
<br>
_______________________________________________<br>
grlug mailing list<br>
<a href="mailto:grlug@grlug.org">grlug@grlug.org</a><br>
<a href="http://shinobu.grlug.org/cgi-bin/mailman/listinfo/grlug" target="_blank">http://shinobu.grlug.org/cgi-bin/mailman/listinfo/grlug</a><br>
</div></div></blockquote></div><br></div>
<br />-- 
<br />This message has been scanned for viruses and
<br />dangerous content by
<a href="http://www.mailscanner.info/"><b>MailScanner</b></a>, and is
<br />believed to be clean.