/*
 * #%L
 * ImageJ software for multidimensional image processing and analysis.
 * %%
 * Copyright (C) 2009 - 2012 Board of Regents of the University of
 * Wisconsin-Madison, Broad Institute of MIT and Harvard, and Max Planck
 * Institute of Molecular Cell Biology and Genetics.
 * %%
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions are met:
 * 
 * 1. Redistributions of source code must retain the above copyright notice,
 *    this list of conditions and the following disclaimer.
 * 2. Redistributions in binary form must reproduce the above copyright notice,
 *    this list of conditions and the following disclaimer in the documentation
 *    and/or other materials provided with the distribution.
 * 
 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
 * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS OR CONTRIBUTORS BE
 * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 * POSSIBILITY OF SUCH DAMAGE.
 * 
 * The views and conclusions contained in the software and documentation are
 * those of the authors and should not be interpreted as representing official
 * policies, either expressed or implied, of any organization.
 * #L%
 */

package imagej.module;

/**
 * Defines the "visibility" of a {@link ModuleItem}.
 * <p>
 * Choices are:
 * </p>
 * <ul>
 * <li>NORMAL: item is included in the history for purposes of data provenance,
 * and included as a parameter when recording scripts.</li>
 * <li>TRANSIENT: item is excluded from the history for the purposes of data
 * provenance, but still included as a parameter when recording scripts.</li>
 * <li>INVISIBLE: item is excluded from the history for the purposes of data
 * provenance, and also excluded as a parameter when recording scripts. This
 * option should only be used for items with no effect on the final output, such
 * as a "verbose" flag.</li>
 * <li>MESSAGE: as INVISIBLE, and further indicating that the item's value is
 * intended as a message to the user (e.g., in the input harvester panel) rather
 * than an actual parameter to the module execution.</li>
 * </ul>
 * 
 * @author Curtis Rueden
 */
public enum ItemVisibility {
	NORMAL, TRANSIENT, INVISIBLE, MESSAGE
}

@@ -1907,60 +1907,78 @@
 %0A * 
-%3Cp%3E
 %0A * 
-Choices are:%0A * %3C/p%3E%0A * %3Cul%3E%0A * %3Cli%3ENORMAL: i
+@author Curtis Rueden%0A */%0Apublic enum ItemVisibility %7B%0A%0A%09/**%0A%09 * I
 tem 
@@ -2040,15 +2040,16 @@
 nce,
-%0A *
  and
+%0A%09 *
  inc
@@ -2096,33 +2096,34 @@
 pts.
-%3C/li%3E%0A * %3Cli%3ETRANSIENT: i
+%0A%09 */%0A%09NORMAL,%0A%0A%09/**%0A%09 * I
 tem 
@@ -2167,35 +2167,32 @@
 purposes of data
-%0A *
  provenance, but
@@ -2191,16 +2191,20 @@
 nce, but
+%0A%09 *
  still i
@@ -2253,33 +2253,37 @@
 pts.
-%3C/li%3E%0A * %3Cli%3EINVISIBLE: i
+%0A%09 */%0A%09TRANSIENT,%0A%0A%09/**%0A%09 * I
 tem 
@@ -2335,19 +2335,16 @@
  of data
-%0A *
  provena
@@ -2351,16 +2351,20 @@
 nce, and
+%0A%09 *
  also ex
@@ -2413,19 +2413,16 @@
 ts. This
-%0A *
  option 
@@ -2427,16 +2427,20 @@
 n should
+%0A%09 *
  only be
@@ -2499,16 +2499,17 @@
 such
-%0A *
  as a
+%0A%09 *
  %22ve
@@ -2524,33 +2524,47 @@
 lag.
-%3C/li%3E%0A * %3Cli%3EMESSAGE: as 
+%0A%09 */%0A%09INVISIBLE,%0A%0A%09/**%0A%09 * As %7B@link #
 INVI
@@ -2568,16 +2568,17 @@
 NVISIBLE
+%7D
 , and fu
@@ -2619,16 +2619,17 @@
 alue is%0A
+%09
  * inten
@@ -2697,18 +2697,19 @@
 nel)
+%0A%09 *
  rather
-%0A *
  tha
@@ -2758,122 +2758,21 @@
 ion.
-%3C/li%3E%0A * %3C/ul%3E%0A * %0A * @author Curtis Rueden%0A */%0Apublic enum ItemVisibility %7B%0A%09NORMAL, TRANSIENT, INVISIBLE, 
+%0A%09 */%0A%09
 MESSAGE%0A
 %7D%0A
@@ -2769,10 +2769,11 @@
 MESSAGE%0A
+%0A
 %7D%0A

improve javadoc