Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 306653 - app-editors/nano -- please document debug use flag properly
Summary: app-editors/nano -- please document debug use flag properly
Status: RESOLVED FIXED
Alias: None
Product: Gentoo Linux
Classification: Unclassified
Component: Current packages (show other bugs)
Hardware: All Linux
: High normal (vote)
Assignee: SpanKY
URL:
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2010-02-24 14:26 UTC by Doktor Notor
Modified: 2010-03-07 08:32 UTC (History)
1 user (show)

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


Attachments
matadata.xml patch (metadata.xml.diff,981 bytes, patch)
2010-02-24 20:19 UTC, Doktor Notor
Details | Diff

Note You need to log in before you can comment on or make changes to this bug.
Description Doktor Notor 2010-02-24 14:26:19 UTC
Just a quick search of bugzilla produces this (probably incomplete) list - http://tinyurl.com/yhzgb4z

There's some nondescriptive description of USE=justify in metadata.xml, but the fact that USE=debug produces unusable $EDITOR is not mentioned anywhere.
Comment 1 Jeroen Roovers (RETIRED) gentoo-dev 2010-02-24 18:53:43 UTC
(In reply to comment #0)
> Just a quick search of bugzilla produces this (probably incomplete) list -
> http://tinyurl.com/yhzgb4z
> 
> There's some nondescriptive description of USE=justify in metadata.xml, but the
> fact that USE=debug produces unusable $EDITOR is not mentioned anywhere.

How does USE=debug make nano unusable?
Comment 2 Doktor Notor 2010-02-24 18:55:20 UTC
(In reply to comment #1)
> How does USE=debug make nano unusable?

Can you please have a look at the bugs linked above? Thanks. 

Comment 3 Jeroen Roovers (RETIRED) gentoo-dev 2010-02-24 19:03:06 UTC
I don't see why I should visit tinyurl.com just to see a list of bug numbers.
Comment 4 Samuli Suominen (RETIRED) gentoo-dev 2010-02-24 19:04:49 UTC
If you enabled USE debug in make.conf and expect to get a working system, you
are badly mistaken. The USE debug does exactly what it says in the global
description for nano, enables extra debug codepath. The use flag in general is
to be used per package basis.
Comment 5 Doktor Notor 2010-02-24 19:09:04 UTC
(In reply to comment #3)
> I don't see why I should visit tinyurl.com just to see a list of bug numbers.

Because bugzilla sucks goats nuts wrt producing USABLE URLs from searches... so, enjoy this much "better" URL which will definitely make you much more happy.

http://bugs.gentoo.org/buglist.cgi?query_format=advanced&short_desc_type=allwordssubstr&short_desc=nano+debug&long_desc_type=substring&long_desc=&bug_file_loc_type=allwordssubstr&bug_file_loc=&status_whiteboard_type=allwordssubstr&status_whiteboard=&keywords_type=allwords&keywords=&bug_status=UNCONFIRMED&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&bug_status=RESOLVED&bug_status=VERIFIED&bug_status=CLOSED&emailtype1=substring&email1=&emailassigned_to2=1&emailreporter2=1&emailcc2=1&emailtype2=substring&email2=&bugidtype=include&bug_id=&votes=&chfieldfrom=&chfieldto=Now&chfieldvalue=&cmdtype=doit&order=Reuse+same+sort+as+last+time&field0-0-0=noop&type0-0-0=noop&value0-0-0=

(In reply to comment #4)
> If you enabled USE debug in make.conf and expect to get a working system, you
> are badly mistaken. The USE debug does exactly what it says in the global
> description for nano, enables extra debug codepath. The use flag in general is
> to be used per package basis.

No, I didn't. This flag just doesn't make any sense for users because it results in unusable editor. If developers are able to get something useful out of garbled screen, then can use EXTRA_ECONF to achieve this. Also as already noted above, there's pretty much nondescriptive description of USE=justify in metadata.xml, there's nothing about USE=debug which I'd expect there in the first place for similar thing. USE=debug isn't in general supposed to make the entire thing unusable for users.
Comment 6 SpanKY gentoo-dev 2010-02-24 19:12:14 UTC

*** This bug has been marked as a duplicate of bug 54208 ***
Comment 7 Doktor Notor 2010-02-24 19:27:39 UTC
There are people who care to describe what the debug USE flag actually does for the particular package, such as maintainers of app-misc/beagle, mail-filter/dspam, media-tv/mythtv or net-im/gossip. But then we have an editor that's installed on every Gentoo system by default but sure thing USE=debug doesn't need to be documented at all there simply because having an editor that only print junk on your screen just works as intended.

The time spent by 3 Gentoo developers on this bug would have been better invested in a trivial commit that'd fix the issue here as requested, either by removing the flag that's useless for $everyone out there or by documenting the result of enabling it since that's exactly what the metadata.xml file is for (http://www.gentoo.org/proj/en/glep/glep-0056.html). Sigh. Lost cause here really, so have a nice day.
Comment 8 SpanKY gentoo-dev 2010-02-24 19:30:39 UTC
(1) dont post links to any external link/log site like tinyurl
(2) post a patch to metadata.xml
Comment 9 Doktor Notor 2010-02-24 20:19:25 UTC
Created attachment 221021 [details, diff]
matadata.xml patch

Change the description of justify flag, added descriptions for debug and minimal flags.
Comment 10 SpanKY gentoo-dev 2010-03-07 06:27:19 UTC
i havent used exactly that, but thanks

http://sources.gentoo.org/app-editors/nano/metadata.xml?r1=1.3&r2=1.4
Comment 11 Doktor Notor 2010-03-07 08:32:42 UTC
Thanks as well.