/**
 * Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco.
 * @author kilroy
 * @see Example2
 * @see http://wiki.ecipse.org
 * @deprecated Do not use this class, it's only to test formatting on. One two three four five six seven eight nine ten.
 */
public class Example {
	/**
	 * Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.
	 * @param first the first param. Nullam nec ex vitae felis eleifend lacinia in in velit.
	 * @param second a second apram. Curabitur commodo tortor vel sapien elementum, sit amet varius eros varius.
	 * @param x a third param. Pellentesque ac ipsum. Quisque ac nunc odioque id nunc convallis nec mi.
	 * @throws Exception1 when the first thing happens. Nam nec sodales sem. Curabitur odio sem, sodales ac lorem eget, pretium tincidunt ligula. Ut eget placerat justo.
	 * @throws OtherException when some other thing happens. Duis feugiat ultricies magna, sit amet sagittis nibh eleifend eu. Curabitur in egestas velit.
	 * @return Lorem consectetur adipiscing ut enim ad minim veniam, quis nostrud exercitation ullamco. Nullam nec ex vitae felis eleifend lacinia in in velit.
	 * @since 1.1.1
	 */
	void method1() {}
	/**
	 * Curabitur commodo tortor vel sapien elementum, sit amet varius eros varius.  Morbi posuere ex sit amet lorem vestibulum pulvinar. In in sagittis urna, euismod tempus eros.
	 * @param parameterOne the first param. <li>item1</li><li>item2</li><li>item3</li>
	 * @param theSecondParameter the second param. <code>line1
	 * line2</code>
	 * @deprecated method1 should be used instead
	 */
	void method2() {}
	/**
	 * Curabitur rhoncus felis non elit malesuada, et gravida enim tempus. Morbi sit amet viverra est. Sed eu libero in mauris facilisis condimentum.
	 * @see <a href="http://bugs.eclipse.org">bugzilla</a>
	 * @see method1
	 * @return
	 * @throws RuntimeException Curabitur morbi sit amet viverra est. Sed eu libero in mauris facilisis condimentum.
	 */
	void method3() {}
	/**
	 * @param argument Integer diam sapien, interdum a dolor sit amet, vestibulum vehicula ante. Mauris ultricies odio sit amet nunc laoreet, sed venenatis enim efficitur.
	 * @throws e Proin dignissim enim eu erat cursus fringilla.<p>Aliquam efficitur sed turpis ut cursus.<p>Nunc pharetra aliquam massa et sagittis.
	 * @param param <pre>int i = 1234   ;</pre>
	 * @return Nunc ultricies neque eu elit porttitor, vel scelerisque metus accumsan. Curabitur dictum arcu magna, eget mattis lacus congue id.
	 * @gibberish invalid tag?
	 */
	void method5() {}
	
	
	 /** 
     * Draws as much of the specified image as is currently available
     * with its northwest corner at the specified coordinate (x, y).
     * This method will return immediately in all cases, even if the
     * entire image has not yet been scaled, dithered and converted
     * for the current output device.
     * <p>
     * If the current output representation is not yet complete then
     * the method will return false and the indicated 
     * {@link ImageObserver} object will be notified as the
     * conversion process progresses.
     *
     * @param img       the image to be drawn
     * @param x         the x-coordinate of the northwest corner
     *                  of the destination rectangle in pixels
     * @param y         the y-coordinate of the northwest corner
     *                  of the destination rectangle in pixels
     * @param observer  the image observer to be notified as more
     *                  of the image is converted.  May be 
     *                  <code>null</code>
     * @return          <code>true</code> if the image is completely 
     *                  loaded and was painted successfully; 
     *                  <code>false</code> otherwise.
     * @see             Image
     * @see             ImageObserver
     * @since           1.0
     */
    public abstract boolean drawImage(Image img, int x, int y, 
                                      ImageObserver observer);
    
    
}