update author list in license for (JAL-826)
[jalview.git] / src / jalview / util / Format.java
index e217704..d85013c 100755 (executable)
@@ -1,6 +1,6 @@
 /*
- * Jalview - A Sequence Alignment Editor and Viewer (Version 2.5)
- * Copyright (C) 2010 J Procter, AM Waterhouse, G Barton, M Clamp, S Searle
+ * Jalview - A Sequence Alignment Editor and Viewer (Version 2.7)
+ * Copyright (C) 2011 J Procter, AM Waterhouse, J Engelhardt, LM Lui, G Barton, M Clamp, S Searle
  * 
  * This file is part of Jalview.
  * 
@@ -205,66 +205,63 @@ public class Format
     }
   }
 
-/**
+  /**
    * Formats the number following printf conventions. Main limitation: Can only
    * handle one format parameter at a time Use multiple Format objects to format
    * more than one number
    * 
    * @param s
-   *                the format string following printf conventions The string
-   *                has a prefix, a format code and a suffix. The prefix and
-   *                suffix become part of the formatted output. The format code
-   *                directs the formatting of the (single) parameter to be
-   *                formatted. The code has the following structure
-   *                <ul>
-   *                <li> a % (required)
-   *                <li> a modifier (optional)
-   *                <dl>
-   *                <dt> +
-   *                <dd> forces display of + for positive numbers
-   *                <dt> 0
-   *                <dd> show leading zeroes
-   *                <dt> -
-   *                <dd> align left in the field
-   *                <dt> space
-   *                <dd> prepend a space in front of positive numbers
-   *                <dt> #
-   *                <dd> use "alternate" format. Add 0 or 0x for octal or
-   *                hexadecimal numbers. Don't suppress trailing zeroes in
-   *                general floating point format.
-   *                </dl>
-   *                <li> an integer denoting field width (optional)
-   *                <li> a period followed by an integer denoting precision
-   *                (optional)
-   *                <li> a format descriptor (required)
-   *                <dl>
-   *                <dt>f
-   *                <dd> floating point number in fixed format
-   *                <dt>e, E
-   *                <dd> floating point number in exponential notation
-   *                (scientific format). The E format results in an uppercase E
-   *                for the exponent (1.14130E+003), the e format in a lowercase
-   *                e.
-   *                <dt>g, G
-   *                <dd> floating point number in general format (fixed format
-   *                for small numbers, exponential format for large numbers).
-   *                Trailing zeroes are suppressed. The G format results in an
-   *                uppercase E for the exponent (if any), the g format in a
-   *                lowercase e.
-   *                <dt>d, i
-   *                <dd> integer in decimal
-   *                <dt>x
-   *                <dd> integer in hexadecimal
-   *                <dt>o
-   *                <dd> integer in octal
-   *                <dt>s
-   *                <dd> string
-   *                <dt>c
-   *                <dd> character
-   *                </dl>
-   *                </ul>
+   *          the format string following printf conventions The string has a
+   *          prefix, a format code and a suffix. The prefix and suffix become
+   *          part of the formatted output. The format code directs the
+   *          formatting of the (single) parameter to be formatted. The code has
+   *          the following structure
+   *          <ul>
+   *          <li>a % (required)
+   *          <li>a modifier (optional)
+   *          <dl>
+   *          <dt>+
+   *          <dd>forces display of + for positive numbers
+   *          <dt>0
+   *          <dd>show leading zeroes
+   *          <dt>-
+   *          <dd>align left in the field
+   *          <dt>space
+   *          <dd>prepend a space in front of positive numbers
+   *          <dt>#
+   *          <dd>use "alternate" format. Add 0 or 0x for octal or hexadecimal
+   *          numbers. Don't suppress trailing zeroes in general floating point
+   *          format.
+   *          </dl>
+   *          <li>an integer denoting field width (optional)
+   *          <li>a period followed by an integer denoting precision (optional)
+   *          <li>a format descriptor (required)
+   *          <dl>
+   *          <dt>f
+   *          <dd>floating point number in fixed format
+   *          <dt>e, E
+   *          <dd>floating point number in exponential notation (scientific
+   *          format). The E format results in an uppercase E for the exponent
+   *          (1.14130E+003), the e format in a lowercase e.
+   *          <dt>g, G
+   *          <dd>floating point number in general format (fixed format for
+   *          small numbers, exponential format for large numbers). Trailing
+   *          zeroes are suppressed. The G format results in an uppercase E for
+   *          the exponent (if any), the g format in a lowercase e.
+   *          <dt>d, i
+   *          <dd>integer in decimal
+   *          <dt>x
+   *          <dd>integer in hexadecimal
+   *          <dt>o
+   *          <dd>integer in octal
+   *          <dt>s
+   *          <dd>string
+   *          <dt>c
+   *          <dd>character
+   *          </dl>
+   *          </ul>
    * @exception IllegalArgumentException
-   *                    if bad format
+   *              if bad format
    * 
    */
   public static String getHexString(java.awt.Color color)