Bug 1471140

Summary:	Missing detailed configuration file
Product:	Red Hat Enterprise Linux 7	Reporter:	Eduardo <eddie>
Component:	squid	Assignee:	Luboš Uhliarik <luhliari>
Status:	CLOSED ERRATA	QA Contact:	Maryna Nalbandian <mnalband>
Severity:	low	Docs Contact:
Priority:	unspecified
Version:	7.3	CC:	bnater, jorton
Target Milestone:	rc	Keywords:	EasyFix, Patch
Target Release:	---
Hardware:	Unspecified
OS:	Unspecified
Whiteboard:
Fixed In Version:	squid-3.5.20-12.el7	Doc Type:	If docs needed, set a value
Doc Text:		Story Points:	---
Clone Of:
Clones:	1679526 (view as bug list)		Environment:
Last Closed:	2018-04-10 14:44:55 UTC	Type:	Bug
Regression:	---	Mount Type:	---
Documentation:	---	CRM:
Verified Versions:		Category:	---
oVirt Team:	---	RHEL 7.3 requirements from Atomic Host:
Cloudforms Team:	---	Target Upstream Version:
Embargoed:
Bug Depends On:
Bug Blocks:	1679526

Description Eduardo 2017-07-14 13:47:02 UTC

Description of problem:
The file '/etc/squid/squid.conf.documented' is missing in the default location.
This file is mentioned in the manpage of squid, therefore I must assume is available on the system.

Version-Release number of selected component (if applicable):

Version     : 3.5.20
Release     : 2.el7_3.3
Architecture: x86_64


How reproducible:
Install squid

Steps to Reproduce:
1. yum install squid
2. ls /etc/squid/squid.conf.documented
3.

Actual results:

The file can be found in /usr/share/doc/squid-3.5.20/squid.conf.documented

Expected results:
A symbolic link in /etc/squid pointing to the actual file.

Additional info:

Comment 2 Luboš Uhliarik 2017-07-18 11:08:06 UTC

You are right, this file is specified in man page, but it is missing at specified location.

From man page:
"This manual page only lists the command line arguments.  For details on how to configure Squid see the file /etc/squid/squid.conf.documented, the Squid wiki  FAQ and examples at http://wiki.squid-cache.org/ , or the configuration manual on the Squid home page http://www.squid-cache.org/Doc/config/"

Comment 4 Luboš Uhliarik 2017-10-02 14:02:21 UTC

Since, we consider this file as a documentation, I will leave it in %doc dir (/usr/share/doc/squid-%{version}), as it is in Fedora and previous RHEL versions, but I will change appropriate location in squid.8 manpage.

Comment 13 errata-xmlrpc 2018-04-10 14:44:55 UTC

Since the problem described in this bug report should be
resolved in a recent advisory, it has been closed with a
resolution of ERRATA.

For information on the advisory, and where to find the updated
files, follow the link below.

If the solution does not work for you, open a new bug report.

https://access.redhat.com/errata/RHBA-2018:0825