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 :) > > Thanks, >
Attached is the patch I plan on pushing with the eclass commit. Regards, Petteri
diff --git a/ebuild-writing/messages/text.xml b/ebuild-writing/messages/text.xml
index 4720be4..2bb348a 100644
--- a/ebuild-writing/messages/text.xml
+++ b/ebuild-writing/messages/text.xml
@@ -95,6 +95,19 @@ is mainly used for displaying additional error details
before bailing out.
</section>
<section>
+<title>QA warnings</title>
+<body>
+
+<p>
+ 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.
+</p>
+
+</body>
+</section>
+
+<section>
<title>Message function reference</title>
<body>
diff --git a/function-reference/message-functions/text.xml
b/function-reference/message-functions/text.xml
index 97c86e6..24f4b82 100644
--- a/function-reference/message-functions/text.xml
+++ b/function-reference/message-functions/text.xml
@@ -77,9 +77,9 @@ displaying informational messages.
</table>
<p>
- 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.
</p>
<table>
@@ -108,6 +108,14 @@ displaying informational messages.
Beep the specified number (must be a positive integer) of times.
Defaults to a sane value.
</ti>
</tr>
+ <tr>
+ <ti>
+ <c>eqawarn</c>
+ </ti>
+ <ti>
+ Used by eclass authors to notify ebuild writers that they are using
deprecated functionality.
+ </ti>
+ </tr>
</table>
<p>
signature.asc
Description: OpenPGP digital signature
