dselect/helpmsgs.cc

   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 version\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 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 installed, upgraded or removed;\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 };