Commit | Line | Data |
---|---|---|
1479465f GJ |
1 | /* |
2 | * dselect - Debian package maintenance user interface | |
3 | * helpmsgs.cc - list of help messages | |
4 | * | |
5 | * Copyright © 1995 Ian Jackson <ijackson@chiark.greenend.org.uk> | |
6 | * | |
7 | * This is free software; you can redistribute it and/or modify | |
8 | * it under the terms of the GNU General Public License as published by | |
9 | * the Free Software Foundation; either version 2 of the License, or | |
10 | * (at your option) any later version. | |
11 | * | |
12 | * This is distributed in the hope that it will be useful, | |
13 | * but WITHOUT ANY WARRANTY; without even the implied warranty of | |
14 | * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | |
15 | * GNU General Public License for more details. | |
16 | * | |
17 | * You should have received a copy of the GNU General Public License | |
18 | * along with this program. If not, see <https://www.gnu.org/licenses/>. | |
19 | */ | |
20 | ||
21 | #include <config.h> | |
22 | #include <compat.h> | |
23 | ||
24 | #include <dpkg/i18n.h> | |
25 | ||
26 | #include "helpmsgs.h" | |
27 | ||
28 | const struct helpmessage hlp_listkeys = { | |
29 | N_("Keystrokes"), N_("\ | |
30 | Motion keys: Next/Previous, Top/End, Up/Down, Backwards/Forwards:\n\ | |
31 | j, Down-arrow k, Up-arrow move highlight\n\ | |
32 | N, Page-down, Space P, Page-up, Backspace scroll list by 1 page\n\ | |
33 | ^n ^p scroll list by 1 line\n\ | |
34 | t, Home e, End jump to top/end of list\n\ | |
35 | u d scroll info by 1 page\n\ | |
36 | ^u ^d scroll info by 1 line\n\ | |
37 | B, Left-arrow F, Right-arrow pan display by 1/3 screen\n\ | |
38 | ^b ^f pan display by 1 character\n\n\ | |
39 | \ | |
40 | Mark packages for later processing:\n\ | |
41 | +, Insert install or upgrade =, H hold in present state\n\ | |
42 | -, Delete remove :, G unhold: upgrade or leave uninstalled\n\ | |
43 | _ remove & purge config\n\ | |
44 | Miscellaneous:\n\ | |
45 | Quit, exit, overwrite (note capitals!): ?, F1 request help (also Help)\n\ | |
46 | Return Confirm, quit (check dependencies) i, I toggle/cycle info displays\n\ | |
47 | Q Confirm, quit (override dep.s) o, O cycle through sort options\n\ | |
48 | X, Esc eXit, abandoning any changes made v, A, V change status display opts\n\ | |
49 | R Revert to state before this list ^l redraw display\n\ | |
50 | U set all to sUggested state / search (Return to cancel)\n\ | |
51 | D set all to Directly requested state n, \\ repeat last search\n") | |
52 | }; | |
53 | ||
54 | const struct helpmessage hlp_mainintro = { | |
55 | N_("Introduction to package selections"), N_("\ | |
56 | Welcome to dselect's main package listing.\n\n\ | |
57 | \ | |
58 | You will be presented with a list of packages which are installed or available\n\ | |
59 | for installation. You can navigate around the list using the cursor keys,\n\ | |
60 | mark packages for installation (using '+') or deinstallation (using '-').\n\ | |
61 | Packages can be marked either singly or in groups; initially you will see that\n\ | |
62 | the line 'All packages' is selected. '+', '-' and so on will affect all the\n\ | |
63 | packages described by the highlighted line.\n\n\ | |
64 | \ | |
65 | Some of your choices will cause conflicts or dependency problems; you will be\n\ | |
66 | given a sub-list of the relevant packages, so that you can solve the problems.\n\n\ | |
67 | \ | |
68 | You should read the list of keys and the explanations of the display.\n\ | |
69 | Much on-line help is available, please make use of it - press '?' at\n\ | |
70 | any time for help.\n\n\ | |
71 | \ | |
72 | When you have finished selecting packages, press <enter> to confirm changes,\n\ | |
73 | or 'X' to quit without saving changes. A final check on conflicts and\n\ | |
74 | dependencies will be done - here too you may see a sublist.\n\n\ | |
75 | \ | |
76 | Press <space> to leave help and enter the list now.\n") | |
77 | }; | |
78 | ||
79 | const struct helpmessage hlp_readonlyintro = { | |
80 | N_("Introduction to read-only package list browser"), N_("\ | |
81 | Welcome to dselect's main package listing.\n\n\ | |
82 | \ | |
83 | You will be presented with a list of packages which are installed or available\n\ | |
84 | for installation. Since you do not have the privilege necessary to update\n\ | |
85 | package states, you are in a read-only mode. You can navigate around the\n\ | |
86 | list using the cursor keys (please see the 'Keystrokes' help screen), observe\n\ | |
87 | the status of the packages and read information about them.\n\n\ | |
88 | \ | |
89 | You should read the list of keys and the explanations of the display.\n\ | |
90 | Much on-line help is available, please make use of it - press '?' at\n\ | |
91 | any time for help.\n\n\ | |
92 | \ | |
93 | When you have finished browsing, press 'Q' or <enter> to quit.\n\n\ | |
94 | \ | |
95 | Press <space> to leave help and enter the list now.\n") | |
96 | }; | |
97 | ||
98 | const struct helpmessage hlp_recurintro = { | |
99 | N_("Introduction to conflict/dependency resolution sub-list"), N_("\ | |
100 | Dependency/conflict resolution - introduction.\n\n\ | |
101 | \ | |
102 | One or more of your choices have raised a conflict or dependency problem -\n\ | |
103 | some packages should only be installed in conjunction with certain others, and\n\ | |
104 | some combinations of packages may not be installed together.\n\n\ | |
105 | \ | |
106 | You will see a sub-list containing the packages involved. The bottom half of\n\ | |
107 | the display shows relevant conflicts and dependencies; use 'i' to cycle between\n\ | |
108 | that, the package descriptions and the internal control information.\n\n\ | |
109 | \ | |
110 | A set of 'suggested' packages has been calculated, and the initial markings in\n\ | |
111 | this sub-list have been set to match those, so you can just hit Return to\n\ | |
112 | accept the suggestions if you wish. You may abort the change(s) which caused\n\ | |
113 | the problem(s), and go back to the main list, by pressing capital 'X'.\n\n\ | |
114 | \ | |
115 | You can also move around the list and change the markings so that they are more\n\ | |
116 | like what you want, and you can 'reject' my suggestions by using the capital\n\ | |
117 | 'D' or 'R' keys (see the keybindings help screen). You can use capital 'Q' to\n\ | |
118 | force me to accept the situation currently displayed, in case you want to\n\ | |
119 | override a recommendation or think that the program is mistaken.\n\n\ | |
120 | \ | |
121 | Press <space> to leave help and enter the sub-list; remember: press '?' for help.\n") | |
122 | }; | |
123 | ||
124 | const struct helpmessage hlp_displayexplain1 = { | |
125 | N_("Display, part 1: package listing and status chars"), N_("\ | |
126 | The top half of the screen shows a list of packages. For each package you see\n\ | |
127 | four columns for its current status on the system and mark. In terse mode (use\n\ | |
128 | 'v' to toggle verbose display) these are single characters, from left to right:\n\n\ | |
129 | \ | |
130 | Error flag: Space - no error (but package may be in broken state - see below)\n\ | |
131 | 'R' - serious error during installation, needs reinstallation;\n\ | |
132 | Installed state: Space - not installed;\n\ | |
133 | '*' - installed;\n\ | |
134 | '-' - not installed but config files remain;\n\ | |
135 | packages in these { 'U' - unpacked but not yet configured;\n\ | |
136 | states are not { 'C' - half-configured (an error happened);\n\ | |
137 | (quite) properly { 'I' - half-installed (an error happened);\n\ | |
138 | installed { 'W','t' - triggers are awaited resp. pending.\n\ | |
139 | Old mark: what was requested for this package before presenting this list;\n\ | |
140 | Mark: what is requested for this package:\n\ | |
141 | '*': marked for installation or upgrade;\n\ | |
142 | '-': marked for removal, but any configuration files will remain;\n\ | |
143 | '=': on hold: package will not be processed at all;\n\ | |
144 | '_': marked for purge completely - even remove configuration;\n\ | |
145 | 'n': package is new and has yet to be marked for install/remove/&c.\n\n\ | |
146 | \ | |
147 | Also displayed are each package's Priority, Section, name, installed and\n\ | |
148 | available version numbers (shift-V to display/hide) and summary description.\n") | |
149 | }; | |
150 | ||
151 | const struct helpmessage hlp_displayexplain2 = { | |
152 | N_("Display, part 2: list highlight; information display"), N_("\ | |
153 | * Highlight: One line in the package list will be highlighted. It indicates\n\ | |
154 | which package(s) will be affected by presses of '+', '-' and '_'.\n\n\ | |
155 | \ | |
156 | * The dividing line in the middle of the screen shows a brief explanation of\n\ | |
157 | the status of the currently-highlighted package, or a description of which\n\ | |
158 | group is highlighted if a group line is. If you don't understand the\n\ | |
159 | meaning of some of the status characters displayed, go to the relevant\n\ | |
160 | package and look at this divider line, or use the 'v' key for a verbose\n\ | |
161 | display (press 'v' again to go back to the terse display).\n\n\ | |
162 | \ | |
163 | * The bottom of the screen shows more information about the\n\ | |
164 | currently-highlighted package (if there is only one).\n\n\ | |
165 | \ | |
166 | It can show an extended description of the package, the internal package\n\ | |
167 | control details (either for the installed or available version of the\n\ | |
168 | package), or information about conflicts and dependencies involving the\n\ | |
169 | current package (in conflict/dependency resolution sublists).\n\n\ | |
170 | \ | |
171 | Use the 'i' key to cycle through the displays, and 'I' to hide the\n\ | |
172 | information display or expand it to use almost all of the screen.\n") | |
173 | }; | |
174 | ||
175 | const struct helpmessage hlp_methintro = { | |
176 | N_("Introduction to method selection display"), N_("\ | |
177 | dselect and dpkg can do automatic installation, loading the package files to be\n\ | |
178 | installed from one of a number of different possible places.\n\n\ | |
179 | \ | |
180 | This list allows you to select one of these installation methods.\n\n\ | |
181 | \ | |
182 | Move the highlight to the method you wish to use, and hit Enter. You will then\n\ | |
183 | be prompted for the information required to do the installation.\n\n\ | |
184 | \ | |
185 | As you move the highlight a description of each method, where available, is\n\ | |
186 | displayed in the bottom half of the screen.\n\n\ | |
187 | \ | |
188 | If you wish to quit without changing anything use the 'x' key while in the list\n\ | |
189 | of installation methods.\n\n\ | |
190 | \ | |
191 | A full list of keystrokes is available by pressing 'k' now, or from the help\n\ | |
192 | menu reachable by pressing '?'.\n") | |
193 | }; | |
194 | ||
195 | const struct helpmessage hlp_methkeys = { | |
196 | N_("Keystrokes for method selection"), N_("\ | |
197 | Motion keys: Next/Previous, Top/End, Up/Down, Backwards/Forwards:\n\ | |
198 | j, Down-arrow k, Up-arrow move highlight\n\ | |
199 | N, Page-down, Space P, Page-up, Backspace scroll list by 1 page\n\ | |
200 | ^n ^p scroll list by 1 line\n\ | |
201 | t, Home e, End jump to top/end of list\n\ | |
202 | u d scroll info by 1 page\n\ | |
203 | ^u ^d scroll info by 1 line\n\ | |
204 | B, Left-arrow F, Right-arrow pan display by 1/3 screen\n\ | |
205 | ^b ^f pan display by 1 character\n\ | |
206 | (These are the same motion keys as in the package list display.)\n\n\ | |
207 | \ | |
208 | Quit:\n\ | |
209 | Return, Enter select this method and go to its configuration dialogue\n\ | |
210 | x, X exit without changing or setting up the installation method\n\n\ | |
211 | \ | |
212 | Miscellaneous:\n\ | |
213 | ?, Help, F1 request help\n\ | |
214 | ^l redraw display\n\ | |
215 | / search (just return to cancel)\n\ | |
216 | \\ repeat last search\n") | |
217 | }; |