1 |
commit: f77a865eb07e6889e57c17c25a899d4772fead10 |
2 |
Author: Sven Eden <sven.eden <AT> gmx <DOT> de> |
3 |
AuthorDate: Mon Mar 4 17:38:02 2013 +0000 |
4 |
Commit: Sven Eden <sven.eden <AT> gmx <DOT> de> |
5 |
CommitDate: Mon Mar 4 17:38:02 2013 +0000 |
6 |
URL: http://git.overlays.gentoo.org/gitweb/?p=proj/ufed.git;a=commit;h=f77a865e |
7 |
|
8 |
Synchronized help text and man page. |
9 |
|
10 |
--- |
11 |
ufed-curses-help.c | 127 ++++++++++++++++++++++++++++++++-------------------- |
12 |
ufed.8.in | 2 +- |
13 |
2 files changed, 79 insertions(+), 50 deletions(-) |
14 |
|
15 |
diff --git a/ufed-curses-help.c b/ufed-curses-help.c |
16 |
index 10855b6..572ccec 100644 |
17 |
--- a/ufed-curses-help.c |
18 |
+++ b/ufed-curses-help.c |
19 |
@@ -47,16 +47,16 @@ static void init_lines(void) |
20 |
"to the optional features which can be compiled into those packages.", |
21 |
"", |
22 |
"For instance, packages with optional GNOME support can have this support " |
23 |
-"disabled at compile time by disabling the \"gnome\" USE setting. Enabling the " |
24 |
-"\"gnome\" USE setting would enable GNOME support in these packages.", |
25 |
+"disabled at compile time by disabling the \"gnome\" USE flag. Enabling the " |
26 |
+"\"gnome\" USE flag would enable GNOME support in these packages.", |
27 |
"", |
28 |
-"The effect of USE settings on packages is dependent on whether both the " |
29 |
-"software itself and the package ebuild supports the USE setting as an " |
30 |
+"The effect of USE flags on packages is dependent on whether both the " |
31 |
+"software itself and the package ebuild supports the USE flag as an " |
32 |
"optional feature. If the software does not have support for an optional " |
33 |
-"feature then the corresponding USE setting will obviously have no effect.", |
34 |
+"feature then the corresponding USE flag will obviously have no effect.", |
35 |
"", |
36 |
"Also many package dependencies are not considered optional by the software " |
37 |
-"and thus USE settings will have no effect on those mandatory dependencies.", |
38 |
+"and thus USE flags will have no effect on those mandatory dependencies.", |
39 |
"", |
40 |
"A list of USE keywords used by a particular package can be found by checking " |
41 |
"the IUSE line in any ebuild file.", |
42 |
@@ -75,23 +75,23 @@ static void init_lines(void) |
43 |
"", |
44 |
"--- What are \"global\" and \"local\" USE flags? ---", |
45 |
"", |
46 |
-"From the perspective of any package there is no distinction between \"local\" " |
47 |
-"and \"global\" flags. A package either listens to a specific flag or it " |
48 |
-"doesn't.", |
49 |
+"Global USE flags are called such because they represent functionality that " |
50 |
+"is found in a wider variety of packages. For example, the global flag " |
51 |
+"\"cjk\" is about adding / not adding support for Eastern-Asian languages, " |
52 |
+"which affects a multitude of various packages. Global flags are described in", |
53 |
+" /usr/portage/profiles/use.desc.", |
54 |
"", |
55 |
-"The difference is the description, and maybe the impact of whether a flag is " |
56 |
-"set or not. If a package supports a flag that has a global description in " |
57 |
-"/usr/portage/profiles/use.desc but does make use of the flag differently, " |
58 |
-"then the package maintainer has to add a local description to the packages " |
59 |
-"metadata.xml file.", |
60 |
-"The same applies to flags that have no global description, a local one must " |
61 |
-"be provided then.", |
62 |
+"Local USE flags are unique package-wise, because the functionality they " |
63 |
+"stand for is only found in that particular package and no other.", |
64 |
+"See", |
65 |
+" /usr/portage/profiles/use.local.desc", |
66 |
+"for a full, per-package listing of all local USE flags.", |
67 |
"", |
68 |
-"An example would be a package with the USE flag \"tiff\", that does not only " |
69 |
-"add support for the TIFF image format, but changes the output format of the " |
70 |
-"program installed. The USE flag then would have a different impact on the " |
71 |
-"package than described in the global description; a local description must be " |
72 |
-"provided then.", |
73 |
+"It still happens that a flag which is defined as global is also defined as " |
74 |
+"local for one or more packages. That is because the general definition of " |
75 |
+"the global flag takes on specialized semantics in some particular package. " |
76 |
+"It also occurs that multiple packages define a local flag of the same " |
77 |
+"name - the meaning of the flag differs, however, for each package.", |
78 |
"", |
79 |
"--- What are \"Masked\" and \"Forced\" flags? ---", |
80 |
"", |
81 |
@@ -99,18 +99,24 @@ static void init_lines(void) |
82 |
"forced.", |
83 |
"", |
84 |
"If a USE flag does not apply to your system, or is highly experimental, it " |
85 |
-"can be masked, making it impossible to select.", |
86 |
-"If a USE flag is mandatory for your system or for a specific package, it can " |
87 |
-"be forced, making it impossible to turn it off.", |
88 |
+"is masked and can not be enabled.", |
89 |
+"", |
90 |
+"If a USE flag is mandatory for your system or for a specific package, it is " |
91 |
+"forced and can not be disabled.", |
92 |
"", |
93 |
"Flags that are masked or forced globally have their names displayed in " |
94 |
"parentheses, and are prefixed with a '-' if they are masked. If one of these " |
95 |
"flags is set in your make.conf, you can remove it with ufed.", |
96 |
+"", |
97 |
"If a flag is only masked or forced for specific packages, a lower case 'm' " |
98 |
"or 'f' in the defaults column (see \"Display layout\" below) indicates this.", |
99 |
"", |
100 |
"--- Navigation and control ---", |
101 |
"", |
102 |
+"ufed will present you with a list of descriptions for each USE flag. If a " |
103 |
+"description is too long to fit on your screen, you can use the Left and Right " |
104 |
+"arrow keys to scroll the descriptions.", |
105 |
+"", |
106 |
"Use the Up and Down arrow keys, the Page Up and Page Down keys, the Home and " |
107 |
"End keys, or start typing the name of a flag to select it.", |
108 |
"Use the space bar to toggle the setting.", |
109 |
@@ -118,19 +124,21 @@ static void init_lines(void) |
110 |
"You can apply various filters on the flags to display. A status line on the " |
111 |
"bottom right will show you which filters are in effect.", |
112 |
"", |
113 |
-" F5: Switch between local, global or all flag descriptions.", |
114 |
-" F6: Switch between flags for which packages are installed that accept this " |
115 |
-"flag, no packages are installed or all flag descriptions.", |
116 |
-" F7: Switch between masked and forced flags, flags that are neither masked " |
117 |
-"nor forced and all flag descriptions." |
118 |
+" F5: Toggle display of local / global / all flag descriptions.", |
119 |
+"", |
120 |
+" F6: Toggle display of flags supported by at least one installed " |
121 |
+"package / supported by no installed package / all flags.", |
122 |
+"", |
123 |
+" F7: Toggle display of masked and forced flags / flags that are " |
124 |
+"neither masked nor forced / all flags." |
125 |
"", |
126 |
"The default is to display all flags that are neither masked nor forced.", |
127 |
"", |
128 |
"If ncurses is installed with the \"gpm\" use flag enabled, you can use your " |
129 |
"mouse to navigate and to toggle the settings, too.", |
130 |
"", |
131 |
-"After changing flags, press the Return or Enter key to make this permanent, " |
132 |
-"or press Escape to revert your changes.", |
133 |
+"After changing flags, press the Return or Enter key to save your USE flag " |
134 |
+"setup, or press Escape to revert your changes.", |
135 |
"", |
136 |
"Note: Depending on your system, you may need to wait a second before ufed " |
137 |
"detects the Escape key or mouse clicks; in some cases, you can use the " |
138 |
@@ -139,10 +147,6 @@ static void init_lines(void) |
139 |
"", |
140 |
"--- Display layout ---", |
141 |
"", |
142 |
-"ufed will present you with a list of descriptions for each USE flag. If a " |
143 |
-"description is too long to fit on your screen, you can use the Left and Right " |
144 |
-"arrow keys to scroll the descriptions.", |
145 |
-"", |
146 |
"ufed attempts to show you where a particular use setting came from, and what " |
147 |
"its scope and state is.", |
148 |
"", |
149 |
@@ -150,29 +154,54 @@ static void init_lines(void) |
150 |
"", |
151 |
" (s) flag M|DPC|Si| (packages) description", |
152 |
"", |
153 |
-"(s) : Your selection, either [+] to enable, [-] to disable, or empty to keep " |
154 |
+"(s) : Your selection", |
155 |
+"either [+] to enable, [-] to disable, or empty to keep " |
156 |
"the default value. If a flag is enabled or disabled by default, it will be " |
157 |
"shown as either (+) or (-).", |
158 |
-"flag : The name of the flag. If the flag is globally masked, it will be shown " |
159 |
+"", |
160 |
+"flag : The name of the flag.", |
161 |
+"If the flag is globally masked, it will be shown " |
162 |
"as (-flag). If the flag is globally forced, it will be shown as (flag).", |
163 |
-"D : [D]efault settings from make.defaults or the ebuilds of installed " |
164 |
-"packages. Masked flags are shown here as 'm', forced flags as 'f'.", |
165 |
-"P : [P]rofile package settings from package.use.", |
166 |
-"C : [C]onfiguration settings from /etc/make.conf, /etc/portage/package.use " |
167 |
-"and /etc/portage/package.use.", |
168 |
-"S : [S]cope of the description, package specific descriptions have an " |
169 |
-"'L' for \"local\".", |
170 |
-"i : [i]nstalled, indicates with an 'i' if either the listed packages are " |
171 |
-"installed on your system, or if at least one package that supports this flag " |
172 |
-"is installed. The latter applies to the global description of the flag.", |
173 |
-"(packages): List of packages that support this flag with the following " |
174 |
-"description.", |
175 |
+"", |
176 |
+"D : [D]efault settings", |
177 |
+"These are read from", |
178 |
+" /usr/portage/profiles/.../make.defaults", |
179 |
+"and the ebuild(5) IUSE defaults of installed packages. The settings in " |
180 |
+"make.defaults, however, take precedence over the ebuild IUSE settings.", |
181 |
+"Masked flags are shown here as 'm', forced flags as 'f'.", |
182 |
+"", |
183 |
+"P : [P]rofile package settings.", |
184 |
+"These are read from", |
185 |
+" /usr/portage/profiles/.../package.use.", |
186 |
+"These package specific settings take precedence over the [D]efault settings.", |
187 |
+"", |
188 |
+"C : [C]onfiguration settings", |
189 |
+"These are read from", |
190 |
+" /etc/make.conf", |
191 |
+" /etc/portage/make.conf and", |
192 |
+" /etc/portage/package.use.", |
193 |
+"These take precedence over the [D]efault and [P]rofile settings, with " |
194 |
+" package.use overriding settings from make.conf.", |
195 |
+"", |
196 |
+"S : [S]cope of the description", |
197 |
+"Local flag descriptions have an 'L' for \"local\" here.", |
198 |
+"", |
199 |
+"i : [i]nstalled", |
200 |
+"Indicates with an 'i' if either the listed packages are installed on your ", |
201 |
+"system, or if at least one package that supports this flag is installed. ", |
202 |
+"The latter applies to the global description of the flag.", |
203 |
+"", |
204 |
+"(packages): List of packages that support this flag.", |
205 |
+"", |
206 |
"description : The description of the flag from use.desc or use.local.desc.", |
207 |
"", |
208 |
"If the character in any of the D, P or C column is a + then that USE flag was " |
209 |
"set in that file(s), if it is a space then the flag was not mentioned in that " |
210 |
"file(s) and if it is a - then that flag was unset in that file(s).", |
211 |
"", |
212 |
+"Flags marked as [+] or [-] will be saved in your make.conf when you leave " |
213 |
+"the program with an Enter.", |
214 |
+"", |
215 |
"You can change the order of the (packages) and the description with the F9 " |
216 |
"key.", |
217 |
"", |
218 |
|
219 |
diff --git a/ufed.8.in b/ufed.8.in |
220 |
index 5294b65..7755b6d 100644 |
221 |
--- a/ufed.8.in |
222 |
+++ b/ufed.8.in |
223 |
@@ -41,7 +41,7 @@ See http://www.gentoo.org/doc/en/handbook/handbook-x86.xml?part=2&chap=2 |
224 |
for more information on USE flags. |
225 |
|
226 |
Please also note that if UFED describes a flag (Unknown) it generally means |
227 |
-that it is either a spelling error in one of the 3 configuration files or |
228 |
+that it is either a spelling error in one of the three configuration files or |
229 |
it is not an officially sanctioned USE flag. Sanctioned USE flags can be found |
230 |
in @GENTOO_PORTAGE_EPREFIX@/usr/portage/profiles/use.desc and |
231 |
in @GENTOO_PORTAGE_EPREFIX@/usr/portage/profiles/use.local.desc. |