Add nodoc tag to DEB_BUILD_OPTIONS
[debian-policy.git] / virtual-package-names-list.txt
blobd5d9f645388498cf03e39d48e5d8ee1096dd9fc3
2               AUTHORITATIVE LIST OF VIRTUAL PACKAGE NAMES
4                               December 2016
7 Below is an authoritative list of virtual package names currently
8 in-use or proposed and not objected to.  Please check the list below
9 for things relevant to your packages.
11 New packages MUST use virtual package names where appropriate (this
12 includes making new ones - read on).
14 Packages MUST NOT use virtual package names (except privately, amongst
15 a cooperating group of packages) unless they have been agreed upon and
16 appear in this list.
18 The latest version of this file can be found in the debian-policy, or at
19 http://www.debian.org/doc/packaging-manuals/virtual-package-names-list.txt
20 (or any other Debian web mirror).
22 The procedure for updating the list is as follows:
24 1. Post to debian-devel saying what names you intend to use or what
25    other changes you wish to make, and file a wish list bug against the
26    package debian-policy.
28 2. Wait a few days for comment (some of the comments may be on the
29    debian-policy list, if you are not subscribed, ask for mail to be CC'd
30    to you).
32 3. Mail the maintainer of the virtual package name list (which is the
33    Debian Policy list <debian-policy@lists.debian.org>) notifying them
34    of the consensus reached (or your suggestions if noone objected).
35    Please update the bug report at the same time.
37    Please include a proposed brief description of the new virtual name(s)
38    for the list.  The list maintainer will then include the updated list
39    in the next release of Policy.
41 4. Go and use the new or changed names.
43 Manoj
44 (based on earlier versions by Warwick and Ian Jackson and Chris Schwarz)
47 Now, the list:
49 Format:
50  <virtual package name>  <packages that provide it include...>
52 [Those marked with a (*) are handled using the alternatives mechanism;
53 others may do so as well.]
55 Miscellaneous
56 -------------
57  awk                     a suitable /usr/bin/{awk,nawk} (*)
58  c-shell                 a suitable /bin/csh (*)
59  dotfile-module          a module for the Dotfile Generator
60  emacsen                 the GNU emacs or a compatible editor
61  lzh-archiver            an LZH archiver package
62  tclsh                   a /usr/bin/tclsh (*)
63  wish                    a /usr/bin/wish (*)
65 Development
66 -----------
67  c-compiler              a C compiler
68  debconf-2.0             the debconf protocol
69  fortran77-compiler      a Fortran77 compiler
70  kernel-headers          kernel header files (<linux/*.h>, <asm/*.h>)
71  kernel-image            kernel image (vmlinuz, System.map, modules)
72  kernel-source           kernel source code
73  libc-dev                header and object files of `libc'
75 System
76 ------
77  flexmem                 anything that can access flexible memory via the
78                          OBEX Protocol
79  foomatic-data           PPD printer description files
80  linux-kernel-log-daemon a daemon to facilitate logging for the Linux kernel
81  system-log-daemon       a daemon that provides a logging facility for
82                          other applications
83  time-daemon             anything that serves as a time daemon
84  ups-monitor             anything that is capable of controlling an UPS
85  cron-daemon             Any cron daemon that correctly follows policy
86                          requirements
88 Documentation
89 -------------
90  dict-client             clients for the Dictionary Server
91  dict-server             the Dictionary Server
92  dictd-dictionary        a dictionary for the dictd Dictionary Server
93  info-browser            something that can browse GNU Info files
94  ispell-dictionary       a dictionary for the ispell system
95  myspell-dictionary      a dictionary for the myspell system
96  man-browser             something that can read man pages
97  stardict-dictionary     a dictionary for stardict
98  stardict                application capable of reading stardict-dictdata
99  stardict-dictdata       dictionary data which can be read from stardict    
100  wordlist                a /usr/share/dict/words (*)
101  www-browser             something that can browse HTML files
103 Network
104 -------
105  dhcp-client             a DHCP client
106  ftp-server              a FTP server
107  httpd                   a HTTP server
108  httpd-cgi               a CGI-capable HTTP server
109  httpd-wsgi              a WSGI-capable HTTP server (python 2 API)
110  httpd-wsgi3             a WSGI-capable HTTP server (python 3 API)
111  ident-server            an identd daemon
112  inet-superserver        an inetd server
113  lambdamoo-core          a lambdamoo-compatible database package  
114  lambdamoo-server        anything running a moo using a lambdamoo-core
115  radius-server           a RADIUS server for acct/auth
116  rsh-client              an rsh client
117  rsh-server              an rsh server
118  telnet-client           a telnet client
119  telnet-server           a telnet server
121 News and Mail
122 -------------
123  imap-client             a mail reader capable of accessing remote mail
124                          folders using the IMAP protocol (e.g. Pine)
125  imap-server             an IMAP mail server
126  mail-reader             a mail user agent (e.g. Pine, Elm, mailx, &c)
127  mail-transport-agent    a mail transport agent (e.g. Smail, Sendmail, &c)
128  mailx                   a /usr/bin/mailx binary that provides at least
129                          the POSIX mailx interface (*)
130  news-reader             a news reader (e.g. trn, tin, &c)
131  news-transport-system   a local news system (e.g. INN, C News or B News)
132  pgp                     a version of PGP (International or US)
133  pop3-server             a POP3 Server
135 X Window System
136 ---------------
137  x-display-manager       an X client which manages a collection of X servers
138  x-session-manager       a program which starts a desktop environment
139                          or launches a general X session
140  x-terminal-emulator     an X client which emulates a terminal with a
141                          terminfo description in the ncurses-base package
142  x-window-manager        an X client which provides window management
143                          services
144  xserver                 an X server that (directly or indirectly) manages
145                          physical input and display hardware
147 Fonts
148 -----
149  fonts-japanese-gothic   Gothic-style Japanese font
150  fonts-japanese-mincho   Mincho-style Japanese font
152 Graphics and MultiMedia
153 -----------------------
154  audio-mixer             a utility to control the input and output levels
155                          of a sound card, with a tty interface
156  x-audio-mixer           a utility to control the input and output levels
157                          of a sound card, X Window System interface
158  mpd-client              a client that can control the Music Player Daemon
159  pdf-preview             a preprocessor that creates PDF output
160  pdf-viewer              anything that can display PDF files
161  postscript-preview      a preprocessor that creates Postscript output
162  postscript-viewer       anything that can display Postscript files
164 Java and virtual machines
165 -------------------------
166  java5-runtime           a Java runtime environment, Java version 5
167  java6-runtime           a Java runtime environment, Java version 6
168  java7-runtime           a Java runtime environment, Java version 7
169  java8-runtime           a Java runtime environment, Java version 8
170  java9-runtime           a Java runtime environment, Java version 9
171  java5-runtime-headless  a non-graphical Java runtime environment, Java ver. 5
172  java6-runtime-headless  a non-graphical Java runtime environment, Java ver. 6
173  java7-runtime-headless  a non-graphical Java runtime environment, Java ver. 7
174  java8-runtime-headless  a non-graphical Java runtime environment, Java ver. 8
175  java9-runtime-headless  a non-graphical Java runtime environment, Java ver. 9
177 Scheme and interpreters
178 -------------------------
179  scheme-r4rs             Scheme interpreter with the R4RS environment
180  scheme-r5rs             Scheme interpreter with the R5RS environment
181  scheme-ieee-11878-1900  Scheme interpreter with the IEEE-11878-1900
182                          environment            
183  scheme-srfi-0           Scheme interpreter accepting the SRFI 0 language
184                          extension
185  scheme-srfi-7           Scheme interpreter accepting the SRFI 7 language
186                          extension
187  scheme-srfi-55          Scheme interpreter accepting the SRFI 55 language
188                          extension
190 Games and Game-related
191 ----------------------
192  doom-engine             An executable Doom engine
193  boom-engine             An executable Doom engine supporting the 'boom'
194                          feature-set
195  doom-wad                The data component of a Doom game, compatible with
196                          the original Doom engine
197  boom-wad                The data component of a Doom game, using features
198                          from the "boom" engine family
200 Old and obsolete virtual package names
201 --------------------------------------
202 Note, that no other package then the ones listed here should use
203 these virtual package names.
205 [There are currently no such package names in use]
207 Changelog
208 ---------
210 Ian Jackson:
211   22 Sep 1995 Initial revision.
213 Andrew Howell:
214   26 Mar 1996 Added www-browser.
216 Manoj Srivastava:
217   11 May 1996 Added kernel-image, added new location of this file
219 Warwick Harvey:
220   19 May 1996 Took over maintenance of list, changed instructions for
221               updating list
222   25 Jul 1996 Added awk as per Chris Fearnley's suggestion
223               Added c-shell, which seemed to have dropped off at some stage
224    2 Aug 1996 Added pdf-{viewer,preview}, compress, emacs
225    5 Aug 1996 Added imap-{client,server}
226    8 Aug 1996 Added editor
227   20 Aug 1996 Added sgmls, removed metafont, dvilj, dvips
228   25 Nov 1996 Removed editor (should have done this a long time ago)
230 Christian Schwarz:
231   29 Apr 1997 New maintainer of this list
232    5 May 1997 Added wordlist
233   29 May 1997 Added dotfile-module, ups-monitor, tcl-interpreter,
234               tk-interpreter
235   21 Jun 1997 Removed obsolete virtual packages: xR6shlib, xlibraries,
236               compress, emacs, sgmls, inews, gs_x, gs_svga, gs_both, xpmR6
237               Added new section about obsolete names
238    1 Sep 1997 Renamed `tcl/tk-interpreter' to `tclsh/wish'
239   21 Oct 1997 Added emacs, c-compiler, fortran77-compiler, lambdamoo-core,
240               lambdamoo-server
241   29 Jan 1998 Added libc-dev, emacsen
242   14 Apr 1998 Removed obsolete virtual package `emacs'
244 Manoj Srivastava:
245   23 Jun 1999 Added pop3-server
246   13 Jul 1999 Added ftp-server
248 Julian Gilbey:
249   26 Oct 1999 Added ispell-dictionary
250               Added man-browser
251               Added ident-server
252               Alphabeticised lists
254 Manoj Srivastava:
255   11 Jul 2000 Added x-terminal-emulator
256               Added x-window-manager
257               Added xserver
258               Added linux-kernel-log-daemon
259               Added system-log-faemon
260   24 Aug 2000 Added mp3-encoder
261               Added mp3-decoder
262               Added time-daemon
263               Added rsh-client
264               Added telnet-client
265   16 Jan 2001 Added rsh server
266               Added telnet-server
268 Julian Gilbey:
269   13 Feb 2001 Removed libc.4.so
270               Removed xcompat virtual package names
272 Manoj Srivastava:
273   14 Mar 2002 Added java-compiler, java2-compiler
274               Added java-virtual-machine
275               Added java1-runtime and java2-runtime
276               Added dict-client
277               Added foomatic-data
278               Added audio-mixer and x-audio-mixer
279   30 Aug 2002 Added debconf-2.0
280               Added dhcp-client
281               Added aspell-dictionary
282               Added radius-server
283    9 Sep 2002 Added dict-server
284    3 Aug 2003 Added myspell-dictionary
286 Andreas Barth:
287   25 Apr 2004 Added stardict-dictionary
288               Added inetd-superserver
290 Manoj Srivastava:
291   25 Jun 2004 Added cron-daemon
293 Manoj Srivastava:
294    4 Feb 2005 Added mpd-client
295               Added flexmem
297 Manoj Srivastava:
298    16 Jun 2005  Removed aspell-dictionary
300 Manoj Srivastava:
301    18 Jun 2005  Added x-session-manager
302                 Added the section on Scheme and interpreters, which
303                 includes: 
304                   scheme-r4rs                 
305                   scheme-r5rs                 
306                   scheme-ieee-11878-1900      
307                   scheme-srfi-0               
308                   scheme-srfi-7               
309                   scheme-srfi-55          
310                 Added x-display-manager
312 Manoj Srivastava:
313    26 April 2006 Added httpd-cgi
315 Manoj Srivastava:
316    02 October 2006 Added stardict
317                    Added stardict-dictdata
318                    Added lzh-archiver
320 Russ Allbery:
321    8 Jul 2007 Added dictd-dictionary
322               Rename inetd-superserver to inet-superserver
323    2 Dec 2007 Added ttf-japanese-gothic
324               Added ttf-japanese-mincho
326 Manoj Srivastava:
327   21 Nov 2009 (Re)Added cron-daemon
329 Russ Allbery:
330   27 Aug 2010 Added mailx
332 Bill Allombert:
333   22 Feb 2012 Rename ttf-japanese-gothic to fonts-japanese-gothic
334               Rename ttf-japanese-mincho to fonts-japanese-mincho
335               Removed java-compiler
336               Removed java2-compiler
337               Removed java-virtual-machine
339 Charles Plessy:
340   03 Aug 2013 Removed mp3-encoder
341   17 Aug 2013 Removed mp3-decoder
343 Bill Allombert:
344   16 Jul 2014 Added java{5,6,7,8,9}-runtime{,-headless}
345               Removed java1-runtime, java2-runtime
346   30 Jul 2014 Added httpd-wsgi
348 Russ Allbery:
349   31 Dec 2016 Added httpd-wsgi3