Bug 672706

Summary: Yum color option parser does not work or manpage is broken
Product: [Fedora] Fedora Reporter: abugreporter
Component: yumAssignee: Seth Vidal <skvidal>
Status: CLOSED UPSTREAM QA Contact: Fedora Extras Quality Assurance <extras-qa>
Severity: unspecified Docs Contact:
Priority: unspecified    
Version: 14CC: ffesti, james.antill, maxamillion, pmatilai, tla
Target Milestone: ---   
Target Release: ---   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2011-05-24 21:08:46 UTC Type: ---
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:

Description abugreporter 2011-01-25 22:59:25 UTC
Description of problem:
If one reads just man yum.conf it is easy to believe that the line containing color is correct. 

########################
[main]
color
<other main stuff>
#########################

The manpage says:

              color  Display  colorized output automatically, depending on the
              output terminal, always (using ANSI codes) or  never.   Command-
              line option: --color

The first word is in bold and there is no mention of having to assign it a value and if any which are the valid values. Now, I did find where the valid values are documented (man yum), but one should be able to read the manpage to get the grammar that is valid for a configuration file from just one manpage. This manpage fails at this point. So, you can either change the software or you can change the documentation. 

The error you get is something like this: 

CRITICAL:yum.cli:Config Error: Parsing file failed: File contains parsing errors: file:///etc/yum.conf
	[line 11]: color

Comment 1 Tim Lauridsen 2011-01-27 17:14:41 UTC
every option in yum.conf has the format

option=<value>

So it would be a little strange to think that just typing 'color' would be ok :)

But you are right, it not described in the yum.conf man file, that you should use 
option=<value>, just descriptions of the options and the values.