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.util.*;
023    import java.text.MessageFormat;
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 (final ConsoleReader reader, final List candidates,
041                    final int position)
042                    throws IOException
043            {
044                    throw new IllegalStateException (
045                            "CandidateCycleCompletionHandler unimplemented");
046            }
047    }
048