diff options
Diffstat (limited to 'dselect/helpmsgs.cc')
| -rw-r--r-- | dselect/helpmsgs.cc | 217 |
1 files changed, 217 insertions, 0 deletions
diff --git a/dselect/helpmsgs.cc b/dselect/helpmsgs.cc new file mode 100644 index 0000000..d1641dd --- /dev/null +++ b/dselect/helpmsgs.cc @@ -0,0 +1,217 @@ +/* + * dselect - Debian package maintenance user interface + * helpmsgs.cc - list of help messages + * + * Copyright © 1995 Ian Jackson <ijackson@chiark.greenend.org.uk> + * + * This is free software; you can redistribute it and/or modify + * it under the terms of the GNU General Public License as published by + * the Free Software Foundation; either version 2 of the License, or + * (at your option) any later version. + * + * This is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU General Public License for more details. + * + * You should have received a copy of the GNU General Public License + * along with this program. If not, see <https://www.gnu.org/licenses/>. + */ + +#include <config.h> +#include <compat.h> + +#include <dpkg/i18n.h> + +#include "helpmsgs.h" + +const struct helpmessage hlp_listkeys = { + N_("Keystrokes"), N_("\ +Motion keys: Next/Previous, Top/End, Up/Down, Backwards/Forwards:\n\ + j, Down-arrow k, Up-arrow move highlight\n\ + N, Page-down, Space P, Page-up, Backspace scroll list by 1 page\n\ + ^n ^p scroll list by 1 line\n\ + t, Home e, End jump to top/end of list\n\ + u d scroll info by 1 page\n\ + ^u ^d scroll info by 1 line\n\ + B, Left-arrow F, Right-arrow pan display by 1/3 screen\n\ + ^b ^f pan display by 1 character\n\n\ +\ +Mark packages for later processing:\n\ + +, Insert install or upgrade =, H hold in present state\n\ + -, Delete remove :, G unhold: upgrade or leave uninstalled\n\ + _ remove & purge config\n\ + Miscellaneous:\n\ +Quit, exit, overwrite (note capitals!): ?, F1 request help (also Help)\n\ + Return Confirm, quit (check dependencies) i, I toggle/cycle info displays\n\ + Q Confirm, quit (override dep.s) o, O cycle through sort options\n\ + X, Esc eXit, abandoning any changes made v, A, V change status display opts\n\ + R Revert to state before this list ^l redraw display\n\ + U set all to sUggested state / search (Return to cancel)\n\ + D set all to Directly requested state n, \\ repeat last search\n") +}; + +const struct helpmessage hlp_mainintro = { + N_("Introduction to package selections"), N_("\ +Welcome to dselect's main package listing.\n\n\ +\ +You will be presented with a list of packages which are installed or available\n\ +for installation. You can navigate around the list using the cursor keys,\n\ +mark packages for installation (using '+') or deinstallation (using '-').\n\ +Packages can be marked either singly or in groups; initially you will see that\n\ +the line 'All packages' is selected. '+', '-' and so on will affect all the\n\ +packages described by the highlighted line.\n\n\ +\ +Some of your choices will cause conflicts or dependency problems; you will be\n\ +given a sub-list of the relevant packages, so that you can solve the problems.\n\n\ +\ +You should read the list of keys and the explanations of the display.\n\ +Much on-line help is available, please make use of it - press '?' at\n\ +any time for help.\n\n\ +\ +When you have finished selecting packages, press <enter> to confirm changes,\n\ +or 'X' to quit without saving changes. A final check on conflicts and\n\ +dependencies will be done - here too you may see a sublist.\n\n\ +\ +Press <space> to leave help and enter the list now.\n") +}; + +const struct helpmessage hlp_readonlyintro = { + N_("Introduction to read-only package list browser"), N_("\ +Welcome to dselect's main package listing.\n\n\ +\ +You will be presented with a list of packages which are installed or available\n\ +for installation. Since you do not have the privilege necessary to update\n\ +package states, you are in a read-only mode. You can navigate around the\n\ +list using the cursor keys (please see the 'Keystrokes' help screen), observe\n\ +the status of the packages and read information about them.\n\n\ +\ +You should read the list of keys and the explanations of the display.\n\ +Much on-line help is available, please make use of it - press '?' at\n\ +any time for help.\n\n\ +\ +When you have finished browsing, press 'Q' or <enter> to quit.\n\n\ +\ +Press <space> to leave help and enter the list now.\n") +}; + +const struct helpmessage hlp_recurintro = { + N_("Introduction to conflict/dependency resolution sub-list"), N_("\ +Dependency/conflict resolution - introduction.\n\n\ +\ +One or more of your choices have raised a conflict or dependency problem -\n\ +some packages should only be installed in conjunction with certain others, and\n\ +some combinations of packages may not be installed together.\n\n\ +\ +You will see a sub-list containing the packages involved. The bottom half of\n\ +the display shows relevant conflicts and dependencies; use 'i' to cycle between\n\ +that, the package descriptions and the internal control information.\n\n\ +\ +A set of 'suggested' packages has been calculated, and the initial markings in\n\ +this sub-list have been set to match those, so you can just hit Return to\n\ +accept the suggestions if you wish. You may abort the change(s) which caused\n\ +the problem(s), and go back to the main list, by pressing capital 'X'.\n\n\ +\ +You can also move around the list and change the markings so that they are more\n\ +like what you want, and you can 'reject' my suggestions by using the capital\n\ +'D' or 'R' keys (see the keybindings help screen). You can use capital 'Q' to\n\ +force me to accept the situation currently displayed, in case you want to\n\ +override a recommendation or think that the program is mistaken.\n\n\ +\ +Press <space> to leave help and enter the sub-list; remember: press '?' for help.\n") +}; + +const struct helpmessage hlp_displayexplain1 = { + N_("Display, part 1: package listing and status chars"), N_("\ +The top half of the screen shows a list of packages. For each package you see\n\ +four columns for its current status on the system and mark. In terse mode (use\n\ +'v' to toggle verbose display) these are single characters, from left to right:\n\n\ +\ + Error flag: Space - no error (but package may be in broken state - see below)\n\ + 'R' - serious error during installation, needs reinstallation;\n\ + Installed state: Space - not installed;\n\ + '*' - installed;\n\ + '-' - not installed but config files remain;\n\ + packages in these { 'U' - unpacked but not yet configured;\n\ + states are not { 'C' - half-configured (an error happened);\n\ + (quite) properly { 'I' - half-installed (an error happened);\n\ + installed { 'W','t' - triggers are awaited resp. pending.\n\ + Old mark: what was requested for this package before presenting this list;\n\ + Mark: what is requested for this package:\n\ + '*': marked for installation or upgrade;\n\ + '-': marked for removal, but any configuration files will remain;\n\ + '=': on hold: package will not be processed at all;\n\ + '_': marked for purge completely - even remove configuration;\n\ + 'n': package is new and has yet to be marked for install/remove/&c.\n\n\ +\ +Also displayed are each package's Priority, Section, name, installed and\n\ +available version numbers (shift-V to display/hide) and summary description.\n") +}; + +const struct helpmessage hlp_displayexplain2 = { + N_("Display, part 2: list highlight; information display"), N_("\ +* Highlight: One line in the package list will be highlighted. It indicates\n\ + which package(s) will be affected by presses of '+', '-' and '_'.\n\n\ +\ +* The dividing line in the middle of the screen shows a brief explanation of\n\ + the status of the currently-highlighted package, or a description of which\n\ + group is highlighted if a group line is. If you don't understand the\n\ + meaning of some of the status characters displayed, go to the relevant\n\ + package and look at this divider line, or use the 'v' key for a verbose\n\ + display (press 'v' again to go back to the terse display).\n\n\ +\ +* The bottom of the screen shows more information about the\n\ + currently-highlighted package (if there is only one).\n\n\ +\ + It can show an extended description of the package, the internal package\n\ + control details (either for the installed or available version of the\n\ + package), or information about conflicts and dependencies involving the\n\ + current package (in conflict/dependency resolution sublists).\n\n\ +\ + Use the 'i' key to cycle through the displays, and 'I' to hide the\n\ + information display or expand it to use almost all of the screen.\n") +}; + +const struct helpmessage hlp_methintro = { + N_("Introduction to method selection display"), N_("\ +dselect and dpkg can do automatic installation, loading the package files to be\n\ +installed from one of a number of different possible places.\n\n\ +\ +This list allows you to select one of these installation methods.\n\n\ +\ +Move the highlight to the method you wish to use, and hit Enter. You will then\n\ +be prompted for the information required to do the installation.\n\n\ +\ +As you move the highlight a description of each method, where available, is\n\ +displayed in the bottom half of the screen.\n\n\ +\ +If you wish to quit without changing anything use the 'x' key while in the list\n\ +of installation methods.\n\n\ +\ +A full list of keystrokes is available by pressing 'k' now, or from the help\n\ +menu reachable by pressing '?'.\n") +}; + +const struct helpmessage hlp_methkeys = { + N_("Keystrokes for method selection"), N_("\ +Motion keys: Next/Previous, Top/End, Up/Down, Backwards/Forwards:\n\ + j, Down-arrow k, Up-arrow move highlight\n\ + N, Page-down, Space P, Page-up, Backspace scroll list by 1 page\n\ + ^n ^p scroll list by 1 line\n\ + t, Home e, End jump to top/end of list\n\ + u d scroll info by 1 page\n\ + ^u ^d scroll info by 1 line\n\ + B, Left-arrow F, Right-arrow pan display by 1/3 screen\n\ + ^b ^f pan display by 1 character\n\ +(These are the same motion keys as in the package list display.)\n\n\ +\ +Quit:\n\ + Return, Enter select this method and go to its configuration dialogue\n\ + x, X exit without changing or setting up the installation method\n\n\ +\ +Miscellaneous:\n\ + ?, Help, F1 request help\n\ + ^l redraw display\n\ + / search (just return to cancel)\n\ + \\ repeat last search\n") +}; |