001    /*
002     * Jpkg - Java library and tools for operating system package creation.
003     *
004     * Copyright (c) 2007 Three Rings Design, Inc.
005     * All rights reserved.
006     *
007     * Redistribution and use in source and binary forms, with or without
008     * modification, are permitted provided that the following conditions
009     * are met:
010     * 1. Redistributions of source code must retain the above copyright
011     *    notice, this list of conditions and the following disclaimer.
012     * 2. Redistributions in binary form must reproduce the above copyright
013     *    notice, this list of conditions and the following disclaimer in the
014     *    documentation and/or other materials provided with the distribution.
015     * 3. Neither the name of the copyright owner nor the names of contributors
016     *    may be used to endorse or promote products derived from this software
017     *    without specific prior written permission.
018     *
019     * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
020     * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
021     * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
022     * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
023     * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
024     * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
025     * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
026     * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
027     * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
028     * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
029     * POSSIBILITY OF SUCH DAMAGE.
030     */
031    package com.threerings.jpkg.debian;
032    
033    /**
034     * Holds the valid Debian package priorities. Descriptions for the fields come from the Debian Policy Manual.
035     * @see <a href="http://www.debian.org/doc/debian-policy/ch-archive.html#s-priorities">Debian Policy Manual</a>
036     */
037    public enum PackagePriority
038        implements ControlFileData
039    {
040        /**
041         * "Packages which are necessary for the proper functioning of the system (usually, this means
042         * that dpkg functionality depends on these packages)."
043         */
044        REQUIRED ("required"),
045        /** "Important programs, including those which one would expect to find on any Unix-like system." */
046        IMPORTANT ("important"),
047        /** "These packages provide a reasonably small but not too limited character-mode system." */
048        STANDARD ("standard"),
049        /**
050         * "This is all the software that you might reasonably want to install if you didn't know what
051         * it was and don't have specialized requirements."
052         */
053        OPTIONAL ("optional"),
054        /**
055         * "This contains all packages that conflict with others with required, important, standard or
056         * optional priorities, or are only likely to be useful if you already know what they are or
057         * have specialized requirements."
058         */
059        EXTRA ("extra");
060    
061        PackagePriority (String name) {
062            _name = name;
063        }
064    
065        // from ControlFileData
066        public String getField ()
067        {
068            return "Priority";
069        }
070    
071        // from ControlFileData
072        public String getFieldValue ()
073        {
074            return _name;
075        }
076    
077        /** The string representation for this priority. */
078        private final String _name;
079    
080    }