summaryrefslogtreecommitdiff
blob: 9c417afb90e1162f1383d39e1f28c00e40439dc4 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
<sect1 id='package-ebuild-helper-functions'>
	<title>Helper Functions</title>
	<sect2 id='package-ebuild-helper-functions-output'>
	<title>Output</title>
	<sect3 id='package-ebuild-helper-functions-output-ebegin'>
	<title>ebegin</title>
	<para>
	Like einfo, we output a helpful message and then hint that the following
	operation may take some time to complete. Once the task is finished, you
	need to call eend.
	</para>
	</sect3>
	<sect3 id='package-ebuild-helper-functions-output-eend'>
	<title>eend</title>
	<para>
	Followup the ebegin message with an appropriate "OK" or "!!" (for errors)
	marker. If status is non-zero, then the additional error message is
	displayed.
	</para>
	</sect3>
	<sect3 id='package-ebuild-helper-functions-output-einfo'>
	<title>einfo</title>
	<para>
	Same as elog, but should be used when the message isn't important
	to the user (like progress or status messages during the build process).
	</para>
	</sect3>
	<sect3 id='package-ebuild-helper-functions-output-elog'>
	<title>elog</title>
	<para>
	If you need to display a message that you wish the user to read
	and take notice of, then use elog. It works just like echo(1),
	but adds a little more to the output so as to catch the user's eye.
	The message will also be logged by portage for later review.
	</para>
	</sect3>
	<sect3 id='package-ebuild-helper-functions-output-eqawarn'>
	<title>eqawarn</title>
	<para>
	Same as einfo, but should be used when showing a QA warning to the user.
	</para>
	</sect3>
	<sect3 id='package-ebuild-helper-functions-output-ewarn'>
	<title>ewarn</title>
	<para>
	Same as einfo, but should be used when showing a warning to the user.
	</para>
	</sect3>
	</sect2>
</sect1>