On 07/05/2010 09:19 PM, Mark Loeser wrote:
>> As there was no further response and next EAPI isn't around the corner I
>> propose getting the ball rolling with option 1. I will commit the patch
>> next Sunday with needed documentation unless something comes up.
> Could you please give a description as to when you believe this function
> should be used. Preferably as a patch for devmanual
Attached is the patch I plan on pushing with the eclass commit.
diff --git a/ebuild-writing/messages/text.xml b/ebuild-writing/messages/text.xml
index 4720be4..2bb348a 100644
@@ -95,6 +95,19 @@ is mainly used for displaying additional error details before bailing out.
+ The <c>eqawarn</c> function can be used by eclass authors to notify ebuild writers about
+ deprecated functionality. eqawarn is defined in eutils. Portage doesn't log the qa message
+ class by default so users don't get annoyed by seeing messages they can't do much about.
<title>Message function reference</title>
diff --git a/function-reference/message-functions/text.xml b/function-reference/message-functions/text.xml
index 97c86e6..24f4b82 100644
@@ -77,9 +77,9 @@ displaying informational messages.
- The following are available from <c>eutils.eclass</c> in EAPIs 0, 1 and 2.
- They are deprecated in favor of GLEP 42 news items and package manager
- message logging functionality.
+ The following are available from <c>eutils.eclass</c> . ebeep and epause
+ are deprecated in EAPIS 0, 1 and 2 in favor of GLEP 42 news items and
+ package manager message logging functionality.
@@ -108,6 +108,14 @@ displaying informational messages.
Beep the specified number (must be a positive integer) of times. Defaults to a sane value.
+ Used by eclass authors to notify ebuild writers that they are using deprecated functionality.