dselect.8 2.9 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899
  1. .\" Hey, Emacs! This is an -*- nroff -*- source file.
  2. .TH DSELECT 8 "January 2000" "Debian Project" "Debian GNU/Linux"
  3. .SH NAME
  4. dselect \- console Debian package handling frontend
  5. .SH SYNOPSIS
  6. .B dselect
  7. [--admindir <directory>] [--help] [--version] [--licence | --license]
  8. [--expert] [--debug <file> | -D <file>] [\fI<action>\fP]
  9. .SH DESCRIPTION
  10. .B dselect
  11. is the primary user interface for installing, removing and managing
  12. Debian GNU/Linux packages. It is an front-end to
  13. .B dpkg(8).
  14. Normally
  15. .B dselect
  16. is invoked without parameters, but some commandline parameters are still
  17. available.
  18. .PP
  19. The usage of
  20. .B dselect
  21. is pretty self-explanatory, and an internal help-system is included,
  22. which describes the keystrokes and some general concepts.
  23. .I Read the help.
  24. .SS ACTIONS
  25. .TP
  26. .B Access
  27. Chooses an access `method' to use to find package repository. By default,
  28. there exist several methods such as "floppy", "harddisk", "cdrom", but
  29. other packages you install can provide additional methods, e.g. "apt"
  30. or "multi_cd" etc.
  31. .TP
  32. .B Update
  33. Updates list of packages available to dpkg/dselect with data from the
  34. chosen repository Packages file(s).
  35. .TP
  36. .B Select
  37. Selects individual packages to install.
  38. .TP
  39. .B Install
  40. Installs selected packages.
  41. .TP
  42. .B Config
  43. Configures any previously not configured packages.
  44. .TP
  45. .B Remove
  46. Removes or purges deselected packages.
  47. .TP
  48. .B Quit
  49. Exit dselect (successfully).
  50. .SH OPTIONS
  51. All options can be specified both on the commandline and in the \fBdselect\fP
  52. configuration file \fI/etc/dpkg/dselect.cfg\fP. Each line in the configuration
  53. file is either an option (exactly the same as the commandline option but
  54. without leading dashes) or a comment (if it starts with a \fB#\fR).
  55. .br
  56. .TP
  57. .B --admindir <directory>
  58. Changes the directory where the dpkg `status', `available' and similar
  59. files are located. This defaults to
  60. .I /var/lib/dpkg
  61. and normally there shouldn't be any need to change it.
  62. .TP
  63. .B --debug <file> | -D<file>
  64. Turn on debugging. Debugging information is sent to
  65. .I <file>.
  66. .TP
  67. .B --expert
  68. Turns on expert mode, i.e. doesn't display possibly annoying help messages.
  69. .TP
  70. .B --help
  71. Print a brief help text and exit successfully.
  72. .TP
  73. .B --licence | --license
  74. Displays the dselect copyright and license information and exits successfully.
  75. .TP
  76. .B --version
  77. Print version information and exit successfully.
  78. .SH BUGS
  79. The
  80. .B dselect
  81. package selection interface is confusing or even alarming to a new user.
  82. .sp
  83. .B dselect
  84. doesn't handle Recommends: field very well, and doesn't understand
  85. Replaces: at all.
  86. .sp
  87. There is no easy way to automatically download and install packages
  88. via anonymous FTP with default access methods (APT does this).
  89. .SH SEE ALSO
  90. .BR dpkg (8),
  91. .BR deb (5).
  92. .SH AUTHORS
  93. .B dselect
  94. was written by Ian Jackson (ijackson@gnu.ai.mit.edu). Full list of
  95. contributors may be found in `dselect --license'.
  96. .br
  97. This manual page was written by Juho Vuori <javuori@cc.helsinki.fi>
  98. and updated by Josip Rodin.