001    /**
002     * jline - Java console input library
003     * Copyright (c) 2002,2003 Marc Prud'hommeaux mwp1@cornell.edu
004     *
005     * This library is free software; you can redistribute it and/or
006     * modify it under the terms of the GNU Lesser General Public
007     * License as published by the Free Software Foundation; either
008     * version 2.1 of the License, or (at your option) any later version.
009     *
010     * This library is distributed in the hope that it will be useful,
011     * but WITHOUT ANY WARRANTY; without even the implied warranty of
012     * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
013     * Lesser General Public License for more details.
014     *
015     * You should have received a copy of the GNU Lesser General Public
016     * License along with this library; if not, write to the Free Software
017     * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
018     */
019    package jline;
020    
021    import java.io.*;
022    import java.text.*;
023    import java.util.*;
024    
025    /** 
026     *      <p>
027     *      A {@link CompletionHandler} that deals with multiple distinct completions
028     *      by cycling through each one every time tab is pressed. This
029     *      mimics the behavior of the
030     *      <a href="http://packages.qa.debian.org/e/editline.html">editline</a>
031     *      library.
032     *      </p>
033     *      <p><strong>This class is currently a stub; it does nothing</strong></p>
034     *
035     *  @author  <a href="mailto:mwp1@cornell.edu">Marc Prud'hommeaux</a>
036     */
037    public class CandidateCycleCompletionHandler
038            implements CompletionHandler
039    {
040            public boolean complete (ConsoleReader reader, List candidates,
041                    int position)
042                    throws IOException
043            {
044                    throw new IllegalStateException (
045                            "CandidateCycleCompletionHandler unimplemented");
046            }
047    }
048