Bug 61205

Summary: Manual should be in %docdir, not /var
Product: [Retired] Red Hat Linux Reporter: kenneth_porter
Component: apacheAssignee: Joe Orton <jorton>
Status: CLOSED CURRENTRELEASE QA Contact: Brian Brock <bbrock>
Severity: medium Docs Contact:
Priority: medium    
Version: 7.2   
Target Milestone: ---   
Target Release: ---   
Hardware: All   
OS: Linux   
Whiteboard:
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2004-09-21 10:15:52 UTC Type: ---
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:
Embargoed:

Description kenneth_porter 2002-03-15 14:08:22 UTC
I installed php-manual, which installs itself into the Apache document tree, and discovered that 
my root paritition (which includes /var) all but filled up.

I think this violates the 
principle of least surprise. The Apache documentation is not variable data, so it should be in 
/usr/share/doc. When installing documentation, one expects it to go into /usr.

The default 
Apache installation should symlink from the HTML document directory (/var/www/html) to this. 
Separate module packages (such as PHP) should follow this model and keep their documentation in 
/usr/share/doc/<package>, symlinked from the appropriate subdirectory of the Apache 
documentation.

Comment 1 Joe Orton 2004-09-21 10:15:52 UTC
Thanks for the report.  php-manual is no longer included in Fedora
Core or Red Hat Enterprise Linux, which should avoid this particular
issue.

/var/www is the place where all web content is stored by default, so
is appropriate as the location of the manuals.