001    package ezvcard.io;
002    
003    /**
004     * Copyright 2011 George El-Haddad. All rights reserved.
005     * 
006     * Redistribution and use in source and binary forms, with or without modification, are
007     * permitted provided that the following conditions are met:
008     * 
009     *    1. Redistributions of source code must retain the above copyright notice, this list of
010     *       conditions and the following disclaimer.
011     * 
012     *    2. Redistributions in binary form must reproduce the above copyright notice, this list
013     *       of conditions and the following disclaimer in the documentation and/or other materials
014     *       provided with the distribution.
015     * 
016     * THIS SOFTWARE IS PROVIDED BY GEORGE EL-HADDAD ''AS IS'' AND ANY EXPRESS OR IMPLIED
017     * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
018     * FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL GEORGE EL-HADDAD OR
019     * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
020     * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
021     * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
022     * ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
023     * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
024     * ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
025     * 
026     * The views and conclusions contained in the software and documentation are those of the
027     * authors and should not be interpreted as representing official policies, either expressed
028     * or implied, of George El-Haddad.
029     */
030    
031    /*
032     Copyright (c) 2012, Michael Angstadt
033     All rights reserved.
034    
035     Redistribution and use in source and binary forms, with or without
036     modification, are permitted provided that the following conditions are met: 
037    
038     1. Redistributions of source code must retain the above copyright notice, this
039     list of conditions and the following disclaimer. 
040     2. Redistributions in binary form must reproduce the above copyright notice,
041     this list of conditions and the following disclaimer in the documentation
042     and/or other materials provided with the distribution. 
043    
044     THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
045     ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
046     WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
047     DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR
048     ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
049     (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
050     LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
051     ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
052     (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
053     SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
054    
055     The views and conclusions contained in the software and documentation are those
056     of the authors and should not be interpreted as representing official policies, 
057     either expressed or implied, of the FreeBSD Project.
058     */
059    
060    /**
061     * Specifies which mail client the vCard is coming from or is destined for.
062     * @author George El-Haddad
063     * @author Michael Angstadt
064     */
065    public enum CompatibilityMode {
066            /**
067             * <p>
068             * Default compatibility mode for adhering to the RFC specs.
069             * </p>
070             */
071            RFC,
072    
073            MS_OUTLOOK,
074    
075            I_PHONE,
076    
077            MAC_ADDRESS_BOOK,
078    
079            /**
080             * <p>
081             * Compatibility mode for use with the KDE Address Book application.
082             * <ol>
083             * <li>Uses escaped commas in the CATEGORIES feature when there is more than
084             * one category. The RFC-2426 explicitly states &quot;One or more text
085             * values separated by a COMMA character&quot;</li>
086             * <li>Escapes commas in CATEGORIES feature when writing vcard.</li>
087             * </ol>
088             * </p>
089             */
090            KDE_ADDRESS_BOOK,
091    
092            IOS_EXPORTER,
093    
094            EVOLUTION,
095    
096            GMAIL;
097    }