Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 368207 - dev-lang/python-2.7.1-r1 instructs user to run python-updater '${options}'
Summary: dev-lang/python-2.7.1-r1 instructs user to run python-updater '${options}'
Status: RESOLVED FIXED
Alias: None
Product: Gentoo Linux
Classification: Unclassified
Component: [OLD] Core system (show other bugs)
Hardware: All Linux
: Normal normal (vote)
Assignee: Python Gentoo Team
URL:
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2011-05-20 18:44 UTC by Nathan Phillip Brink (binki) (RETIRED)
Modified: 2012-04-12 09:39 UTC (History)
1 user (show)

See Also:
Package list:
Runtime testing required: ---


Attachments
emerge --info (emerge--info.txt,3.97 KB, text/plain)
2011-05-20 18:44 UTC, Nathan Phillip Brink (binki) (RETIRED)
Details

Note You need to log in before you can comment on or make changes to this bug.
Description Nathan Phillip Brink (binki) (RETIRED) gentoo-dev 2011-05-20 18:44:57 UTC
Created attachment 274149 [details]
emerge --info

After a successful installation of python, I see the following message. It appears that I'm supposed to be told some particular, ebuild-generated options to pass to python-updater but that this helpful information is lost by over-escaping:

The following is a snippet of the dev-lang/python-2.7.1-r1 installation:
``
 * 
 * ************************************************************************
 * 
 * You have just upgraded from an older version of Python.
 * You should run 'python-updater ${options}' to rebuild Python modules.
 * 
 * ************************************************************************
 * 
''

I saw this also on my non-prefix system, but I'm attaching the emerge --info from my prefix where I last saw this.

If it is intended for the user to come up with his own arguments to pass to python-updater, then a more standard placeholder syntax such as

ewarn "You should run 'python-updater <options>' to rebuild Python modules."

or just

ewarn "You should run 'python-updater' to rebuild Python modules."

since the user can be expected to examine python-updater --help if necessary and python-updater should ideally not need any options to be specified by default.
Comment 1 Gokdeniz Karadag 2012-02-20 10:11:51 UTC
This warning is also present in python-3.2.2 which was recently made stable.


Additionally, the ewarn includes control characters, which makes the message ugly in an e-mail ebuild log. Like below:


[1;31m************************************************************************[0m

You have just upgraded from an older version of Python.
You should run 'python-updater ${options}' to rebuild Python modules.

[1;31m************************************************************************[0m
Comment 2 Arfrever Frehtes Taifersar Arahesis 2012-02-25 20:02:57 UTC
The message is correct. ${options} means that users can pass additional options.
Comment 3 aditsu 2012-02-25 20:10:04 UTC
I disagree. ${options} means expanding the "options" environment variable.
Something like <options> or [options] would mean that users can pass additional
options.
Comment 4 Dirkjan Ochtman (RETIRED) gentoo-dev 2012-04-12 09:39:21 UTC
Fixed in python-2.7.3, hitting the tree shortly.