* PURPOSE. See the GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License along with Jalview. If not, see <http://www.gnu.org/licenses/>.
---!>
- <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
- <html><head>
- <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
- <title>4.3.7. Imports</title><link rel="stylesheet" href="site.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.65.1"><link rel="home" href="manual.html" title="Jalopy User Manual"><link rel="up" href="printer.html" title="4.3. Printer"><link rel="previous" href="comments.html" title="4.3.6. Comments"><link rel="next" href="environment.html" title="4.3.8. Environment"><link rel="preface" href="dedication.html" title="Dedication"><link rel="preface" href="acknowledge.html" title="Acknowledgements"><link rel="preface" href="introduction.html" title="Introduction"><link rel="part" href="part-core.html" title="Part I. Jalopy core"><link rel="chapter" href="installation.html" title="Chapter 1. Installation"><link rel="chapter" href="build.html" title="Chapter 2. Building"><link rel="chapter" href="usage.html" title="Chapter 3. Usage"><link rel="chapter" href="settings.html" title="Chapter 4. Settings"><link rel="part" href="part-plugins.html" title="Part II. Plug-ins"><link rel="chapter" href="plugin-ant.html" title="Chapter 5. Ant Plug-in task"><link rel="chapter" href="plugin-console.html" title="Chapter 6. Console Application"><link rel="chapter" href="plugin-eclipse.html" title="Chapter 7. Eclipse Plug-in"><link rel="chapter" href="plugin-jbuilder.html" title="Chapter 8. JBuilder OpenTool"><link rel="chapter" href="plugin-jdev.html" title="Chapter 9. JDeveloper Extension"><link rel="chapter" href="plugin-jedit.html" title="Chapter 10. jEdit Plug-in"><link rel="chapter" href="plugin-netbeans.html" title="Chapter 11. NetBeans/Sun ONE Studio module"><link rel="appendix" href="dependencies.html" title="Appendix A. Library Dependencies"><link rel="appendix" href="license-bsd.html" title="Appendix B. The Jalopy BSD License"><link rel="appendix" href="license-antlr.html" title="Appendix C. ANTLR SOFTWARE RIGHTS"><link rel="appendix" href="license-apache.html" title="Appendix D. The Apache Software License, Version 1.1"><link rel="appendix" href="license-gnu.html" title="Appendix E. GNU GENERAL PUBLIC LICENSE Version 2, June 1991"><link rel="appendix" href="license-gnu-doc.html" title="Appendix F. GNU Free Documentation License Version 1.1, March 2000"><link rel="appendix" href="license-common-public.html" title="Appendix G. Common Public License Version 1.0"><link rel="appendix" href="license-sun-public.html" title="Appendix H. SUN PUBLIC LICENSE Version 1.0"><link rel="index" href="ix01.html" title="Index"><link rel="subsection" href="imports.html#imports-sorting" title="4.3.7.1. General"><link rel="subsection" href="imports.html#import-grouping" title="4.3.7.2. Grouping"><link rel="subsection" href="imports.html#import-optimization" title="4.3.7.3. Optimize">
- <meta name="description" content="Jalopy Java Source Code Formatter Beautifier Pretty Printer">
- <meta http-equiv="pics-label" content='(pics-1.1 "http://www.icra.org/ratingsv02.html" l gen true for "http://jalopy.sf.net" r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true for "http://jalopy.sf.net" r (n 0 s 0 v 0 l 0))'>
- </head><body id="toppage" bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table width="700" border="0" cellpadding="0" cellspacing="0" align="left"><tbody><tr><td><table cellpadding="0" cellspacing="0" width="100%" style="border:1px solid #336699"><tbody><tr><td height="16"></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr style="border:none"><td style="border:none"><table border="0" cellspacing="0" cellpadding="0"><tbody><tr><td class="logo">JALOPY</td><td class="sublogo" valign="bottom">Java Source Code Formatter Beautifier Pretty Printer</td></tr></tbody></table></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr><td height="10"></td></tr><tr><td bgcolor="#ff8000" height="4"></td></tr><tr><td height="20" bgcolor="#336699" style="color:#ffffff;padding-left:10px"><a href="./index.html" class="navlink">Overview</a> •
- <a href="./download.html" class="navlink">Download</a> •
- <a href="./docs.html" class="navlink">Documentation</a> •
- <a href="./plugins.html" class="navlink">Plug-ins</a> •
- <a href="./links.html" class="navlink">Links</a> •
- <a href="./contact.html" class="navlink">Contact</a></td></tr><tr><td height="1" bgcolor="#ffffff"></td></tr></tbody></table></td></tr><tr valign="top"><td valign="top" bgcolor="#ffffff"><table border="0" cellpadding="0" cellspacing="0" width="100%"><tbody><tr><td height="20" bgcolor="#faebd7" style="padding-left:15px"><a href="./features.html" class="navlink2">Features</a> |
- <a href="./history.html" class="navlink2">History</a> |
- <a href="./manual.html" class="navlink2">Manual</a> |
- <a href="./faq.html" class="navlink2">FAQ</a> |
- <a href="./api/index.html" class="navlink2">Javadoc</a></td></tr><tr><td height="20" bgcolor="#ffffff"></td></tr><tr><td bgcolor="#eeeecc" height="17" align="right" style="font-size:10px;padding-right:3px">
- This page generated: <strong>June 8 2004</strong></td></tr></tbody></table><table border="0" width="100%" cellspacing="0" cellpadding="5"><tr><td><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">4.3.7. Imports</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="comments.html">Prev</a> </td><th width="60%" align="center">4.3. Printer</th><td width="20%" align="right"> <a accesskey="n" href="environment.html">Next</a></td></tr></table><hr></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="imports"></a>4.3.7. Imports</h3></div></div><div></div></div><a class="indexterm" name="d0e4017"></a><p>
-Controls the handling of import declarations.
-</p><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="imports-sorting"></a>4.3.7.1. General</h4></div></div><div></div></div><a class="indexterm" name="d0e4025"></a><p>
-Enables the sorting of import statements. Sorting the import statements makes
-it simple to browse a long list of imports.
-</p><div class="itemizedlist"><ul type="disc"><li><p>
-Sort import statements
-</p><p>
-Enables or disables the sorting of import statements. Enabling this option
-will sort all imports lexicographically.
-</p></li></ul></div></div><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="import-grouping"></a>4.3.7.2. Grouping</h4></div></div><div></div></div><a class="indexterm" name="d0e4039"></a><p>
-In addition to sorting, associated packages can be grouped together to reduce
-complexity by packing related information into a common unit.
-</p><div class="itemizedlist"><ul type="disc"><li><p><a name="imports-grouping-depth"></a>
-Default grouping depth
-</p><a class="indexterm" name="d0e4052"></a><a class="indexterm" name="d0e4059"></a><p>
-Lets you define the default grouping depth. Only takes effect if sorting is enabled.
-</p><p>
-The grouping depth specifies the number of package name parts that are to
-be taken into account in order to determine whether two import statements are to
-be grouped together. For certain packages you may want to specify a grouping
-depth that differs from the default.
-</p><p>
-Statements are to be grouped together, if all relevant parts are equal. So via
-the grouping depth you can effectively specify how many parts are relevant.
-</p><p>
-To disable grouping at all, set the grouping depth to "<tt class="literal">0</tt>".
-</p><div class="example"><a name="ex-imports-grouping-depth-one"></a><p class="title"><b>Example 4.137. Grouping depth java='1'</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
-import <span class="bold"><b>java</b></span>.awt.Color;
-import <span class="bold"><b>java</b></span>.awt.Component;
-import <span class="bold"><b>java</b></span>.awt.GridBagConstraints;
-import <span class="bold"><b>java</b></span>.awt.GridBagLayout;
-import <span class="bold"><b>java</b></span>.awt.event.ActionEvent;
-import <span class="bold"><b>java</b></span>.awt.event.ActionListener;
-import <span class="bold"><b>java</b></span>.util.ArrayList;
-import <span class="bold"><b>java</b></span>.util.List;
-</pre></td></tr></table></div><p></p><div class="example"><a name="ex-imports-grouping-depth-two"></a><p class="title"><b>Example 4.138. Grouping depth java='2'</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
-import <span class="bold"><b>java.awt</b></span>.Color;
-import <span class="bold"><b>java.awt</b></span>.Component;
-import <span class="bold"><b>java.awt</b></span>.GridBagConstraints;
-import <span class="bold"><b>java.awt</b></span>.GridBagLayout;
-import <span class="bold"><b>java.awt</b></span>.event.ActionEvent;
-import <span class="bold"><b>java.awt</b></span>.event.ActionListener;
-
-import <span class="bold"><b>java.util</b></span>.ArrayList;
-import <span class="bold"><b>java.util</b></span>.List;
-</pre></td></tr></table></div><p></p><div class="example"><a name="ex-imports-grouping-depth-three"></a><p class="title"><b>Example 4.139. Grouping depth java= '3'</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
-import <span class="bold"><b>java.awt</b></span>.Color;
-import <span class="bold"><b>java.awt</b></span>.Component;
-import <span class="bold"><b>java.awt</b></span>.GridBagConstraints;
-import <span class="bold"><b>java.awt</b></span>.GridBagLayout;
-
-import <span class="bold"><b>java.awt.event</b></span>.ActionEvent;
-import <span class="bold"><b>java.awt.event</b></span>.ActionListener;
-
-import <span class="bold"><b>java.util</b></span>.ArrayList;
-import <span class="bold"><b>java.util</b></span>.List;
-</pre></td></tr></table></div><p></p></li></ul></div><p>
-You can add/remove package fragments (e.g. javax, javax.swing or com.foo.sarah)
-via the <span><b class="guibutton">Add...</b></span> and <span><b class="guibutton">Remove</b></span>
-buttons to fine-tune the appearance for certain packages.
-</p><p>
-To specify the order in which related statements should appear, you
-may want to use the <span><b class="guibutton">Up</b></span> and <span><b class="guibutton">Down</b></span> buttons.
-</p><p>
-Note that the <tt class="literal">asterix</tt> represents all undefined packages.
-</p></div><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="import-optimization"></a>4.3.7.3. Optimize</h4></div></div><div></div></div><p>
-Optimizes the import statements by either expanding or collapsing them. This
-is a nice feature that is currently only available with the Ant and
-JBuilder Plug-in.
-</p><a class="indexterm" name="d0e4189"></a><div class="itemizedlist"><ul type="disc"><li><p><a name="import-optimization-expand"></a>
-Expand on-demand imports
-<a class="indexterm" name="d0e4198"></a>
-</p><p>
-If enabled, tries to expand all on-demand import statements.
-</p><p><a name="imports-on-demand"></a>
-Expanding means to resolve all on-demand import statements (sometimes called
-wildcard imports) and replace them with single-type import statements (sometimes
-called explicit imports) of the types that are actually used in the source file.
-</p><a class="indexterm" name="d0e4208"></a><p>
-So the following on-demand import statement may be expanded into two
-single-type import statements that reference the needed types for this package.
-</p><div class="example"><a name="ex-imports-on-demand"></a><p class="title"><b>Example 4.140. On-demand import statement</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
-import java.util.*;
-</pre></td></tr></table></div><p></p><div class="example"><a name="ex-import-single-type"></a><p class="title"><b>Example 4.141. Single-type import statements</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
-import java.util.ArrayList;
-import java.util.List;
-</pre></td></tr></table></div><p>
-Using single-type imports is quite useful and an absolute requirement in the
-open source community as this code is usually really reviewed. Using
-single-type imports makes it easy for the code reader to quickly find
-out the package a particular type is in: You just search for the type name
-from the start of the source file.
-</p></li></ul></div><div class="itemizedlist"><ul type="disc"><li><p><a name="import-optimization-collapse"></a>
-Collapse single-type imports
-<a class="indexterm" name="d0e4232"></a>
-<a class="indexterm" name="d0e4238"></a>
-</p><p>
-If enabled, tries to collapse all single-type statements.
-</p><p>
-Collapsing means to remove all single-type imports of a given package and
-replace them with one on-demand import statement.
-</p></li></ul></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="comments.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="printer.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="environment.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">4.3.6. Comments </td><td width="20%" align="center"><a accesskey="h" href="manual.html">Home</a></td><td width="40%" align="right" valign="top"> 4.3.8. Environment</td></tr></table></div></td></tr></table></td></tr><tr><td bgcolor="#eeeecc" height="17" style="font-size:9px;padding-left:5px"><a href="#toppage">to top</a></td></tr><tr><td height="30"><br></td></tr><tr><td height="3"></td></tr><tr><td bgcolor="#336699" height="1"></td></tr><tr><td height="1"></td></tr><tr><td bgcolor="#336699" height="16"></td></tr><tr><td bgcolor="#ff9966" height="4"></td></tr><tr><td class="footer" align="center" height="15" valign="middle">
- Copyright © 2001-2004, <a class="footer" href="./contact.html">Marco Hunsicker</a>. All rights reserved. Hosted by <a href="http://sourceforge.net">SourceForge.net</a></td></tr></tbody></table><img src="http://sourceforge.net/sflogo.php?group_id=45216&type=1" width="1" height="1" border="0" hspace="0" vspace="0" alt=""></body></html>
+-->
git://source.jalview.org / jalview.git / blobdiff