--- /dev/null
+
+ <!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.4. Wrapping</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="indentation.html" title="4.3.3. Indentation"><link rel="next" href="separation.html" title="4.3.5. Blank Lines"><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="wrapping.html#wrap-general" title="4.3.4.1. General"><link rel="subsection" href="wrapping.html#wrap-always" title="4.3.4.2. Always"><link rel="subsection" href="wrapping.html#wrap-misc" title="4.3.4.3. Misc">
+ <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.4. Wrapping</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="indentation.html">Prev</a> </td><th width="60%" align="center">4.3. Printer</th><td width="20%" align="right"> <a accesskey="n" href="separation.html">Next</a></td></tr></table><hr></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="wrapping"></a>4.3.4. Wrapping</h3></div></div><div></div></div><a class="indexterm" name="d0e2657"></a><a class="indexterm" name="d0e2660"></a><p>
+Controls when and how lines gets wrapped.
+</p><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="wrap-general"></a>4.3.4.1. General</h4></div></div><div></div></div><p>
+Lets you control the general line wrapping options.
+</p><div class="sect4" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="wrap-general-general"></a>4.3.4.1.1. General</h5></div></div><div></div></div><p>
+Lets you control the general line wrapping options.
+</p><div class="itemizedlist"><ul type="disc"><li><p><a name="wrap-use"></a>
+Wrap lines
+</p><p>
+Enables or disables the automatic line wrapping.
+</p></li><li><p><a name="wrap-sizes-line"></a>
+Line length
+</p><p>
+Lets you specify the maximum line length. Jalopy tries (more or less) to limit
+each line within the given length.
+</p><a class="indexterm" name="d0e2686"></a><a class="indexterm" name="d0e2691"></a></li><li><p><a name="wrap-sizes-deep"></a>
+Deep indent
+</p><a class="indexterm" name="d0e2697"></a><a class="indexterm" name="d0e2702"></a><p>
+Specifies the length after which a gap will be identified as "deep indented".
+Jalopy tries to avoid these kind of gaps and will force a line break or apply
+another indentation scheme, if this size is exceeded.
+</p><div class="example"><a name="ex-wrap-sizes-deep"></a><p class="title"><b>Example 4.65. Deep indent size (60) not exceeded</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+ | |
+ protected static synchronized File getANewDestinationFile(File dest, |
+ | String packageName,
+ | String filename) |
+|----------------- the gap ---------------------------|throws IOException |
+ { | |
+ } | |
+ | |
+ 60 79
+</pre></td></tr></table></div><p></p><div class="example"><a name="ex-wrap-sizes-deep-exceed"></a><p class="title"><b>Example 4.66. Deep indent size (50) exeeded</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+ | |
+ protected static synchronized File getANewDestinationFile(File dest, |
+ | String packageName,
+ | String filename) |
+|----------------- the gap ---------------------------|throws IOException |
+ { | |
+ } | |
+ | |
+ 50 79
+</pre></td></tr></table></div></li></ul></div></div><div class="sect4" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="wrap-policy"></a>4.3.4.1.2. Policy</h5></div></div><div></div></div><a class="indexterm" name="d0e2721"></a><a class="indexterm" name="d0e2726"></a><p>
+Lets you fine-control the wrapping behaviour.
+</p><div class="itemizedlist"><ul type="disc"><li><p><a name="wrap-left-parenthesis"></a>
+Wrap after left parenthesis
+</p><p>
+Lets you control the wrapping behaviour for statement and expression lists.
+</p><p>
+If left disabled, the first line break will be preferably inserted
+behind the first parameter or expression and only occurs after the left
+parenthesis if the maximum line length would be exceeded.</p><div class="example"><a name="ex-wrap-left-parenthesis-disabled"></a><p class="title"><b>Example 4.67. Wrap after left parenthesis (disabled)</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+ |
+appServerReferencesVector.add<span class="bold"><b>(</b></span>new AppServerReference<span class="bold"><b>(</b></span>
+ "RemoteApplicationManager", |
+ poa.create_reference_with_id<span class="bold"><b>(</b></span> |
+ "RemoteApplicationManager".getBytes(), |
+ RemoteApplicationManagerHelper.id()))); |
+ |
+</pre></td></tr></table></div><p>
+Otherwise the line break will always occur behind the left parenthesis.
+</p><div class="example"><a name="ex-wrap-left-parenthesis-enabled"></a><p class="title"><b>Example 4.68. Wrap after left parenthesis (enabled)</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+appServerReferencesVector.add<span class="bold"><b>(</b></span>
+ new AppServerReference<span class="bold"><b>(</b></span>
+ "RemoteApplicationManager",
+ poa.create_reference_with_id<span class="bold"><b>(</b></span>
+ "RemoteApplicationManager".getBytes(),
+ RemoteApplicationManagerHelper.id())));
+</pre></td></tr></table></div><p>
+This switch affects the output style of method/constructor declarations and
+calls, creator statements and <tt class="literal">if-else</tt>, <tt class="literal">for</tt>,
+<tt class="literal">while</tt> and <tt class="literal">do-while</tt> blocks.
+</p><p>
+As per default, the wrapped lines will be indended using
+<a href="indentation.html#indentation-policy-standard">Standard indentation</a>, but you
+may want to apply another indentation scheme. See
+<a href="indentation.html#indentation-policy" title="4.3.3.1.1. Policy">Section 4.3.3.1.1, “Policy”</a> for more information.
+</p><p></p></li><li><p><a name="wrap-right-parenthesis"></a>
+Wrap before right parenthesis
+</p><p>
+Forces a line break before the right parenthesis of parameter or expression lists.
+The parenthesis will be intended according to the current indentation level.
+Only takes action if at least one parameter/expression was indeed wrapped.
+</p><p>
+This switch affects the output style of method/constructor declarations and
+calls, creator statements and <tt class="literal">if-else</tt>, <tt class="literal">for</tt>,
+<tt class="literal">while</tt> and <tt class="literal">do-while</tt> blocks.
+</p><div class="example"><a name="ex-wrap-right-parenthesis"></a><p class="title"><b>Example 4.69. Right parenthesis (disabled)</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+public void severalParameters(String one,
+ int two,
+ String three,
+ StringObject four,
+ AnotherObject five<span class="bold"><b>)</b></span> {
+}
+</pre></td></tr></table></div><p></p><div class="example"><a name="ex-wrap-right-parenthesis-enabled"></a><p class="title"><b>Example 4.70. Right parenthesis (enabled)</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+public void severalParameters(String one,
+ int two,
+ String three,
+ StringObject four,
+ AnotherObject five
+<span class="bold"><b>)</b></span> {
+}
+</pre></td></tr></table></div><p>
+Both switches combined, looks like the following example:
+</p><div class="example"><a name="ex-wrap-left-right-parenthesis"></a><p class="title"><b>Example 4.71. Left and right parenthesis</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+appServerReferencesVector.add<span class="bold"><b>(</b></span>
+ new AppServerReference<span class="bold"><b>(</b></span>
+ "RemoteApplicationManager",
+ poa.create_reference_with_id<span class="bold"><b>(</b></span>
+ "RemoteApplicationManager".getBytes(),
+ RemoteApplicationManagerHelper.id()
+ <span class="bold"><b>)</b></span>
+ <span class="bold"><b>)</b></span>
+<span class="bold"><b>)</b></span>;
+</pre></td></tr></table></div><p>
+For blocks the output may go like this:
+</p><div class="example"><a name="ex-wrap-left-right-parenthesis-wrapped-continue"></a><p class="title"><b>Example 4.72. Left and right parenthesis (wrapped)</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+if <span class="bold"><b>(</b></span>
+ "pick".equals(m.getName()) && m.isStatic() && m.isPublic()
+<span class="bold"><b>)</b></span> {
+ pickFound = true;
+}
+else if <span class="bold"><b>(</b></span>
+ "pick".equals(m.getName()) && m.isStatic() && m.isPublic()
+<span class="bold"><b>)</b></span> {
+ pickFound = true;
+}
+</pre></td></tr></table></div><p></p></li><li><p><a name="wrap-grouping-paren"></a>
+Wrap grouping parentheses
+</p><p>
+Lets you control the wrapping behaviour for grouping parentheses. If enabled,
+linebreaks are inserted after left and before right parentheses of grouped
+expressions to let the expression(s) stand out.
+</p><div class="example"><a name="ex-wrap-grouping-no"></a><p class="title"><b>Example 4.73. Grouping parentheses (standard indented)</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+if (
+ !<span class="bold"><b>(</b></span>(bankverbindung instanceof ObjectValue)
+ || (bankverbindung instanceof PrimitiveValue<span class="bold"><b>)</b></span>)
+) {
+ throw new RuntimeException();
+}
+</pre></td></tr></table></div><p></p><div class="example"><a name="ex-wrap-grouping"></a><p class="title"><b>Example 4.74. Wrapped grouping parentheses (standard indented)</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+if (
+ !<span class="bold"><b>(</b></span>
+ (bankverbindung instanceof ObjectValue)
+ || (bankverbindung instanceof TkPrimitiveValue)
+ <span class="bold"><b>)</b></span>
+) {
+ throw new RuntimeException();
+}
+</pre></td></tr></table></div><p></p></li><li><p><a name="wrap-after-assignment"></a>
+Wrap after assignments
+</p><p>
+Lets you control the way wrapping takes action for assignments. If left disabled,
+line wrapping preferably occurs as part of the expression printing. Otherwise
+wrapping will be performed right after the assignment.
+</p><div class="example"><a name="ex-wrap-assignment-no"></a><p class="title"><b>Example 4.75. Don't wrap after assignment</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+this.interessentenNr = new InteressentenNr(
+ Fachschluesselerzeugung.createService()
+ .getNeuerFachschluessel(
+ FachschluesselerzeugungService.FACHSCHLUESSEL_KZ_INTERESSENT
+ )
+ );
+</pre></td></tr></table></div><p></p><div class="example"><a name="ex-wrap-assignment"></a><p class="title"><b>Example 4.76. Wrap after assignment</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+this.interessentenNr =
+ new InteressentenNr(
+ Fachschluesselerzeugung.createService()
+ .getNeuerFachschluessel(
+ FachschluesselerzeugungService.FACHSCHLUESSEL_KZ_INTERESSENT
+ )
+ );
+</pre></td></tr></table></div><p></p></li></ul></div><p>
+Line wrapping will often occur with statements that consist of several (possibly long)
+expressions. Here you specify whether line wrapping should occur
+before or after the expression operator.
+</p><div class="itemizedlist"><ul type="disc"><li><p><a name="wrap-before"></a>
+Wrap before operators
+</p><a class="indexterm" name="d0e2926"></a><p>
+If enabled, lines will be wrapped before the operator. The operator will be
+printed with the continuation line.
+</p><div class="example"><a name="ex-wrap-before"></a><p class="title"><b>Example 4.77. Wrap before operators</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+if ((condition1 && condition2)
+ || (condition3 && condition4)
+ || !(condition5 && condition6))
+{
+ doSomethingAboutIt();
+}
+</pre></td></tr></table></div><p></p></li><li><p><a name="wrap-after"></a>
+Wrap after operators
+</p><a class="indexterm" name="d0e2942"></a><p>
+If enabled, lines will be wrapped after the operator.
+</p><div class="example"><a name="ex-wrap-after"></a><p class="title"><b>Example 4.78. Wrap after operators</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+if ((condition1 && condition2) ||
+ (condition3 && condition4) ||
+ !(condition5 && condition6))
+{
+ doSomethingAboutIt();
+}
+</pre></td></tr></table></div><p>
+If you happen to use Sun Brace styling, you might want to enable
+<a href="indentation.html#indentation-misc-continuation-if">continuation indentation</a>
+to let the statement body stand out.
+</p><p></p></li></ul></div></div></div><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="wrap-always"></a>4.3.4.2. Always</h4></div></div><div></div></div><p>
+Lets you choose the statements/expressions that are to be wrapped always.
+</p><div class="sect4" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="wrap-always-pane"></a>4.3.4.2.1. Wrap always</h5></div></div><div></div></div><p>
+For certain cases, the need may arise to force line wrapping to achieve a
+consistent, uniform look. If you enable any of the following switches, line wrapping
+will occur for the specified cases no matter whether you have enabled general
+line wrapping or not.
+</p><div class="itemizedlist"><ul type="disc"><li><p><a name="wrap-before-extends"></a>
+Before extends keyword
+</p><p>
+Forces a line break before the extends keyword of a class/interface declaration.
+</p><div class="example"><a name="ex-wrap-before-extends"></a><p class="title"><b>Example 4.79. Class/Interface extends keyword</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+public interface Channel extends Puttable, Takable
+{
+ ...
+}
+</pre></td></tr></table></div><p></p><div class="example"><a name="ex-wrap-before-extends-wrapped"></a><p class="title"><b>Example 4.80. Class/Interface extends keyword (wrapped)</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+public interface Channel
+ extends Puttable, Takable
+{
+ ...
+}
+</pre></td></tr></table></div><p>
+You can control the space printed before the keyword with the
+<a href="indentation.html#indentation-sizes-extends">Extends Indent</a> setting.
+If you leave the switch disabled, the clause will be printed with
+<a href="indentation.html#indentation-sizes-general">standard indentation</a>.
+</p></li><li><p>
+After extends types
+</p><p>
+Forces a line wrap after each type name of the extended classes.
+</p><div class="example"><a name="ex-wrap-after-extends"></a><p class="title"><b>Example 4.81. Class/Interface extends types</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+public interface Channel extends Puttable, Takable
+{
+ ...
+}
+</pre></td></tr></table></div><p></p><div class="example"><a name="ex-wrap-after-extends-wrapped"></a><p class="title"><b>Example 4.82. Class/Interface extends types (wrapped)</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+public interface Channel extends Puttable,
+ Takable
+{
+ ...
+}
+</pre></td></tr></table></div><p></p></li><li><p><a name="wrap-before-implements"></a>
+Before implements keyword
+</p><p>
+Forces a line break before the implements keyword of a class declaration.
+</p><div class="example"><a name="ex-wrap-before-implements"></a><p class="title"><b>Example 4.83. implements keyword</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+public class SynchronizedBoolean implements Comparable, Cloneable
+{
+ ...
+}
+</pre></td></tr></table></div><p></p><div class="example"><a name="ex-wrap-before-implements-wrapped"></a><p class="title"><b>Example 4.84. implements keyword (wrapped)</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+public class SynchronizedBoolean
+ implements Comparable, Cloneable
+{
+ ...
+}
+</pre></td></tr></table></div><p>
+You can control the space printed before the keyword with the
+<a href="indentation.html#indentation-sizes-implements">Implements Indent</a> setting.
+If you leave the switch disabled, the clause will be printed with
+<a href="indentation.html#indentation-sizes-general">standard indentation</a>.
+</p></li><li><p><a name="wrap-after-implements"></a>
+After implements types
+</p><p>
+Forces a line wrap after each type name of the implemented classes.
+</p><div class="example"><a name="ex-wrap-implements-types"></a><p class="title"><b>Example 4.85. Class implements types</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+public class SynchronizedBoolean implements Comparable, Cloneable
+{
+ ...
+}
+</pre></td></tr></table></div><p></p><div class="example"><a name="ex-wrap-implements-types-wrapped"></a><p class="title"><b>Example 4.86. Class implements types (wrapped)</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+public class SynchronizedBoolean implements Comparable,
+ Cloneable
+{
+ ...
+}
+</pre></td></tr></table></div><p></p></li><li><p><a name="wrap-before-throws"></a>
+Before throws keyword
+</p><p>
+Forces a line break before the throws keyword of a method/constructor declaration.
+</p><div class="example"><a name="ex-wrap-before-throws"></a><p class="title"><b>Example 4.87. throws keyword</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+private File getDestinationFile(File dest, String packageName,
+ String filename) throws IOException
+{
+ ...
+}
+</pre></td></tr></table></div><p></p><div class="example"><a name="ex-wrap-before-throws-wrapped"></a><p class="title"><b>Example 4.88. throws keyword (wrapped)</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+private File getDestinationFile(File dest, String packageName,
+ String filename)
+ throws IOException
+{
+ ...
+}
+</pre></td></tr></table></div><p>
+You can control the space printed before the keyword with the
+<a href="indentation.html#indentation-sizes-throws">Throws Indent</a> setting. If you
+leave the switch disabled, Jalopy tries to align the throws clause with the
+method/constructor parameters as with the above example. If no alignment is
+possible, the clause will be printed with
+<a href="indentation.html#indentation-sizes-general">standard indentation</a>.
+</p></li><li><p><a name="wrap-after-throws"></a>
+After throws types
+</p><p>
+Forces a line wrap after each type name of the throws clause of a method/constructor declaration.
+</p><div class="example"><a name="ex-wrap-after-throws-types"></a><p class="title"><b>Example 4.89. throws types</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+private File getDestinationFile(File dest, String packageName,
+ String filename)
+ throws IOException, FooException
+{
+ ...
+}
+</pre></td></tr></table></div><p></p><div class="example"><a name="ex-wrap-after-throws-types-wrapped"></a><p class="title"><b>Example 4.90. throws types (wrapped)</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+private File getDestinationFile(File dest, String packageName,
+ String filename)
+ throws IOException,
+ FooException
+{
+ ...
+}
+</pre></td></tr></table></div><p></p><div class="example"><a name="ex-wrap-after-throws-types-wrapped-standard"></a><p class="title"><b>Example 4.91. throws types (standard indented)</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+private static final File getDestinationFile(File dest, String packageName,
+ String filename)
+ throws IOException,
+ FooException
+{
+ ...
+}
+</pre></td></tr></table></div><p></p></li><li><p><a name="wrap-method-params"></a>
+Method Def parameters
+</p><a class="indexterm" name="d0e3103"></a><a class="indexterm" name="d0e3106"></a><p>
+Forces a line wrap after each parameter of a method or constructor declaration.
+</p><div class="example"><a name="ex-wrap-method-params"></a><p class="title"><b>Example 4.92. Method declaration parameters</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+public static File create(File file, File directory, int backupLevel)
+ throws IOException
+{
+ ...
+}
+</pre></td></tr></table></div><p></p><div class="example"><a name="ex-wrap-method-params-wrapped"></a><p class="title"><b>Example 4.93. Method declaration parameters (wrapped)</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+public static File create(File file,
+ File directory,
+ int backupLevel)
+ throws IOException
+{
+ ...
+}
+</pre></td></tr></table></div></li><li><p><a name="wrap-call-chained"></a>
+Method Call chains
+</p><p>
+Forces a line wrap after each chained method call.
+</p><div class="example"><a name="ex-wrap-call-chained"></a><p class="title"><b>Example 4.94. Chained Method Call</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+message.format(ERROR_SOURCE_ADDRESS).param (m_session.getAimName()).send();
+</pre></td></tr></table></div><p></p><div class="example"><a name="ex-wrap-call-chained-wrapped"></a><p class="title"><b>Example 4.95. Chained Method Call (wrapped)</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+message.format(ERROR_SOURCE_ADDRESS)
+ .param (m_session.getAimName())
+ .send();
+</pre></td></tr></table></div><p></p></li><li><p><a name="wrap-method-call-params"></a>
+Method Call parameters
+</p><p>
+Forces a line wrap after each parameter of a method call.
+</p><div class="example"><a name="ex-wrap-method-call"></a><p class="title"><b>Example 4.96. Method call</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+doSomething();
+_userDatabase.addUser("Name", encryptPassword("password", _secretKey),
+ "123 fake address");
+doSomethingElse();
+</pre></td></tr></table></div><p></p><div class="example"><a name="ex-wrap-method-call-wrapped"></a><p class="title"><b>Example 4.97. Method call (wrapped)</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+doSomething();
+_userDatabase.addUser("Name",
+ encryptPassword("password",
+ _secretKey),
+ "123 fake address");
+doSomethingElse();
+</pre></td></tr></table></div><p></p></li><li><p>
+Method Call parameters if nested
+</p><p>
+Forces a line wrap after each parameter of a method call if at least one
+parameter is a method call itself. This option can prove especially useful if
+one prefers to nest method calls as parameters rather than adding local
+variables just to hold those parameters.
+</p><div class="example"><a name="ex-wrap-method-call-nested-wrapped"></a><p class="title"><b>Example 4.98. Method call if nested (wrapped)</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+doSomething();
+_userDatabase.addUser("Name",
+ encryptPassword("password", _secretKey),
+ "123 fake address");
+doSomethingElse();
+</pre></td></tr></table></div><p></p></li><li><p>
+Ternary expression question mark (<tt class="literal">?</tt>)
+</p><p>
+Forces a line wrap after the first operand.
+</p><div class="example"><a name="ex-wrap-ternary-expr"></a><p class="title"><b>Example 4.99. Ternary expression question mark (deep indented)</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+String comma = spaceAfterComma
+ ? COMMA_SPACE : COMMA;
+</pre></td></tr></table></div><p>
+Indentation for consecutive lines depends on the used <a href="indentation.html#indentation-policy" title="4.3.3.1.1. Policy">indenatation policy</a>.
+You may further want to use <a href="indentation.html#indentation-misc-ternary-if-else">continuation indentation</a>.
+</p></li><li><p><a name="wrap-ternary-colon"></a>
+Ternary expression colon (<tt class="literal">:</tt>)
+</p><p>
+Forces a line wrap after the second operand.
+</p><div class="example"><a name="ex-wrap-ternary-values"></a><p class="title"><b>Example 4.100. Ternary expression colon</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+String comma = spaceAfterComma ? COMMA_SPACE
+ : COMMA;
+</pre></td></tr></table></div><p>
+If both switches are disabled, ternary expressions are printed in one line (if everything fits in one line, that is).
+</p><div class="example"><a name="ex-wrap-ternary"></a><p class="title"><b>Example 4.101. Ternary expressions</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+String comma = spaceAfterComma ? COMMA_SPACE : COMMA;
+</pre></td></tr></table></div><p>
+If both switches are enabled, you can force a style like the following:
+</p><div class="example"><a name="ex-wrap-ternary-continued"></a><p class="title"><b>Example 4.102. Ternary expressions (continued)</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+String comma = spaceAfterComma
+ ? COMMA_SPACE
+ : COMMA;
+</pre></td></tr></table></div><p></p></li><li><p><a name="wrap-always-label"></a>
+Labels
+</p><a class="indexterm" name="d0e3222"></a><a class="indexterm" name="d0e3225"></a><p>
+Forces a line wrap after labels.
+</p><div class="example"><a name="ex-wrap-always-label"></a><p class="title"><b>Example 4.103. Label</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+// advance to the first CLASS_DEF or INTERFACE_DEF
+LOOP: for (AST child = tree.getFirstChild();
+ child != null;
+ child = child.getNextSibling())
+ {
+ switch (child.getType())
+ {
+ case JavaTokenTypes.CLASS_DEF :
+ case JavaTokenTypes.INTERFACE_DEF :
+ next = child;
+ break LOOP;
+
+ default :
+ break;
+ }
+ }
+</pre></td></tr></table></div><p></p><div class="example"><a name="ex-wraping-always-label-wrapped"></a><p class="title"><b>Example 4.104. Label (wrapped)</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+// advance to the first CLASS_DEF or INTERFACE_DEF
+LOOP:
+ for (AST child = tree.getFirstChild();
+ child != null;
+ child = child.getNextSibling())
+ {
+ switch (child.getType())
+ {
+ case JavaTokenTypes.CLASS_DEF :
+ case JavaTokenTypes.INTERFACE_DEF :
+ next = child;
+ break LOOP;
+
+ default :
+ break;
+ }
+ }
+</pre></td></tr></table></div><p></p></li></ul></div></div><div class="sect4" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="wrap-always-exceed"></a>4.3.4.2.2. Wrap always when exceed</h5></div></div><div></div></div><p>
+Lets you force wrapping for <span class="emphasis"><em>all</em></span> parameter or expressions if
+the parameter or expression list would otherwise exceed the maximal line length.
+If you enable any of the following switches, line wrapping
+may occur for the specified cases no matter whether you have enabled general
+line wrapping or not.
+</p><div class="itemizedlist"><ul type="disc"><li><p><a name="wrap-always-extends"></a>
+After extends types
+</p><p>
+Forces a line wrap after each type name of the <tt class="literal">extends</tt> clause of a
+class/interface declaration if the whole clause does not fit in one line.
+</p><div class="example"><a name="ex-wrap-always-extends"></a><p class="title"><b>Example 4.105. Extends types wrapped as needed (standard indented)</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+public interface VeryImportantInterface |
+ extends LeastImportantInterface, LessImportantInterface, |
+ ImportantInterface |
+} |
+ ... |
+} |
+</pre></td></tr></table></div><p></p><div class="example"><a name="wrap-always-extends-enabled"></a><p class="title"><b>Example 4.106. Extends types wrapping forced (standard indented)</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+public interface VeryImportantInterface |
+ extends LeastImportantInterface, |
+ LessImportantInterface, |
+ ImportantInterface |
+} |
+ ... |
+} |
+</pre></td></tr></table></div></li><li><p><a name="wrap-always-implements"></a>
+After implements types
+</p><p>
+Forces a line wrap after each type name of the <tt class="literal">implements</tt> clause of a
+class/interface declaration if the whole clause does not fit in one line.
+</p><div class="example"><a name="ex-wrap-always-implements"></a><p class="title"><b>Example 4.107. Implements types wrapped as needed (standard indented)</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+public class ImportantClass |
+ implements ImportantInterface, Serializable, Comparable, |
+ Cloneable |
+} |
+ ... |
+} |
+</pre></td></tr></table></div><p></p><div class="example"><a name="wrap-always-implements-enabled"></a><p class="title"><b>Example 4.108. Implements types wrapping forced (standard indented)</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+public class ImportantClass |
+ implements ImportantInterface, |
+ Serializable, |
+ Comparable, |
+ Cloneable |
+} |
+ ... |
+} |
+</pre></td></tr></table></div></li><li><p><a name="wrap-always-throws"></a>
+After throws types
+</p><p>
+Forces a line wrap after each type name of the <tt class="literal">throws</tt> clause of a
+method/constructor declaration if the whole clause does not fit in one line.
+</p><div class="example"><a name="ex-wrap-always-throws"></a><p class="title"><b>Example 4.109. Throws types wrapped as needed (deep indented)</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+private File getDestinationFile(File dest, String packageName, |
+ String filename) |
+ throws IOException, FooException, |
+ FooBarException |
+{ |
+ ... |
+} |
+</pre></td></tr></table></div><p></p><div class="example"><a name="wrap-always-throws-enabled"></a><p class="title"><b>Example 4.110. Throws types wrapping forced (deep indented)</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+private File getDestinationFile(File dest, String packageName, |
+ String filename) |
+ throws IOException, |
+ FooException, |
+ FooBarException |
+{ |
+ ... |
+} |
+</pre></td></tr></table></div></li><li><p><a name="wrap-always-param"></a>
+After parameters/expressions
+</p><p>
+If enabled, this switch will cause all parameters/expressions to be
+wrapped, if and only if the first parameter/expression of the list has been
+wrapped.
+</p><div class="example"><a name="ex-wrap-all"></a><p class="title"><b>Example 4.111. Expression list (all wrapped)</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+if (
+ "pick".equals(m.getName()) &&
+ m.isStatic() &&
+ m.isPublic()
+) {
+ pickFound = true;
+}
+else if (
+ "pick".equals(m.getName()) &&
+ m.isStatic() &&
+ m.isPublic()
+) {
+ pickFound = true;
+}
+</pre></td></tr></table></div><p></p></li></ul></div></div></div><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="wrap-misc"></a>4.3.4.3. Misc</h4></div></div><div></div></div><p>Lets you control miscellaneous wrapping settings.</p><div class="sect4" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="wrap-misc-arrays"></a>4.3.4.3.1. Arrays</h5></div></div><div></div></div><p>Contains options to control the wrapping for arrays.</p><div class="itemizedlist"><ul type="disc"><li><p>Wrap as needed</p><p>Enabling this options means array elements will be wrapped so that they
+will be limited within the current <a href="wrapping.html#wrap-sizes-line">line length</a> setting.</p><div class="example"><a name="ex-wrap-arrays-as-needed"></a><p class="title"><b>Example 4.112. Wrap as needed</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+String[] constraints = { |
+ "patternPanel.top=form.top", "patternPanel.hcenter=form.hcenter", |
+ "okButton.top=patternPanel.bottom+20", |
+ "okButton.right=form.hcenter-10", "cancelButton.vcenter=10", |
+ "cancelButton.left=10" |
+}; |
+</pre></td></tr></table></div><p></p></li><li><p>Wrap after element</p><p>Forces a newline after every n-th element.</p><div class="example"><a name="ex-wrap-arrays-after-one"></a><p class="title"><b>Example 4.113. Wrap after element 1</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+String[] constraints = { |
+ "patternPanel.top=form.top", |
+ "patternPanel.hcenter=form.hcenter", |
+ "okButton.top=patternPanel.bottom+20", |
+ "okButton.right=form.hcenter-10", |
+ "cancelButton.vcenter=10", |
+ "cancelButton.left=10" |
+}; |
+</pre></td></tr></table></div><p></p><div class="example"><a name="ex-wrap-arrays-after-two"></a><p class="title"><b>Example 4.114. Wrap after element 2</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+String[] constraints = { |
+ "patternPanel.top=form.top", "patternPanel.hcenter=form.hcenter",
+ "okButton.top=patternPanel.bottom+20", "okButton.right=form.hcenter-10",
+ "cancelButton.vcenter=10", "cancelButton.left=10" |
+}; |
+</pre></td></tr></table></div><p>
+If both options are left disabled, the array elements will be printed in one
+line, right after the left curly brace.
+</p></li></ul></div></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="indentation.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="separation.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">4.3.3. Indentation </td><td width="20%" align="center"><a accesskey="h" href="manual.html">Home</a></td><td width="40%" align="right" valign="top"> 4.3.5. Blank Lines</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>
\ No newline at end of file
git://source.jalview.org / jalview.git / blobdiff