Author: ieb
Date: Thu Jul 24 02:38:51 2008
New Revision: 679328

URL: http://svn.apache.org/viewvc?rev=679328&view=rev
Log:
Reformatted the javadoc to to 100 char line wrap and same line for param 
statements.
(my eclipse code tempalte was wrong).

Modified:
    
incubator/shindig/trunk/java/social-api/src/main/java/org/apache/shindig/social/opensocial/model/Person.java

Modified: 
incubator/shindig/trunk/java/social-api/src/main/java/org/apache/shindig/social/opensocial/model/Person.java
URL: 
http://svn.apache.org/viewvc/incubator/shindig/trunk/java/social-api/src/main/java/org/apache/shindig/social/opensocial/model/Person.java?rev=679328&r1=679327&r2=679328&view=diff
==============================================================================
--- 
incubator/shindig/trunk/java/social-api/src/main/java/org/apache/shindig/social/opensocial/model/Person.java
 (original)
+++ 
incubator/shindig/trunk/java/social-api/src/main/java/org/apache/shindig/social/opensocial/model/Person.java
 Thu Jul 24 02:38:51 2008
@@ -27,17 +27,16 @@
 import java.util.Set;
 
 /**
- * see
- * 
http://code.google.com/apis/opensocial/docs/0.8/reference/#opensocial.Person.Field
- * for all field meanings. All fields are represented in the js api at this 
time
- * except for lastUpdated. This field is currently only in the RESTful spec.
+ * see 
http://code.google.com/apis/opensocial/docs/0.8/reference/#opensocial.Person.Field
 for all
+ * field meanings. All fields are represented in the js api at this time 
except for lastUpdated.
+ * This field is currently only in the RESTful spec.
  *
  */
 @ImplementedBy(PersonImpl.class)
 public interface Person {
 
   /**
-   * The fields tha represent the person object ion json form.
+   * The fields that represent the person object ion json form.
    */
   public static enum Field {
     /** the json field for aboutMe. */
@@ -171,6 +170,7 @@
 
     /**
      * create a field base on the a json element.
+     *
      * @param jsonString the name of the element
      */
     private Field(String jsonString) {
@@ -179,6 +179,7 @@
 
     /**
      * emit the field as a json element.
+     *
      * @return the field name
      */
     @Override
@@ -188,25 +189,24 @@
   }
 
   /**
-   * Get a general statement about the person, specified as a string. Container
-   * support for this field is OPTIONAL.
-   * 
+   * Get a general statement about the person, specified as a string. 
Container support for this
+   * field is OPTIONAL.
+   *
    * @return the value of aboutMe
    */
   String getAboutMe();
 
   /**
-   * Set a general statement about the person, specified as a string. Container
-   * support for this field is OPTIONAL.
+   * Set a general statement about the person, specified as a string. 
Container support for this
+   * field is OPTIONAL.
    *
-   * @param aboutMe
-   *                the value of aboutMe
+   * @param aboutMe the value of aboutMe
    */
   void setAboutMe(String aboutMe);
 
   /**
-   * Get the person's favorite activities, specified as an List of strings.
-   * Container support for this field is OPTIONAL.
+   * Get the person's favorite activities, specified as an List of strings. 
Container support for
+   * this field is OPTIONAL.
    *
    * @return list of activities.
    */
@@ -215,403 +215,371 @@
   /**
    * Set the person's favorite activities, specified as an List of strings.
    *
-   * @param activities
-   *                a list of activities
+   * @param activities a list of activities
    */
   void setActivities(List<String> activities);
 
   /**
-   * Get addresses associated with the person, specified as an List of Address
-   * objects. Container support for this field is OPTIONAL.
+   * Get addresses associated with the person, specified as an List of Address 
objects. Container
+   * support for this field is OPTIONAL.
    *
    * @return a List of address objects
    */
   List<Address> getAddresses();
 
   /**
-   * Set addresses associated with the person, specified as an List of Address
-   * objects. Container support for this field is OPTIONAL.
+   * Set addresses associated with the person, specified as an List of Address 
objects. Container
+   * support for this field is OPTIONAL.
    *
-   * @param addresses
-   *                a list of address objects
+   * @param addresses a list of address objects
    */
   void setAddresses(List<Address> addresses);
 
   /**
-   * Get the person's age, specified as a number. Container support for this
-   * field is OPTIONAL.
+   * Get the person's age, specified as a number. Container support for this 
field is OPTIONAL.
    *
    * @return the persons age
    */
   Integer getAge();
 
   /**
-   * Set the person's age, specified as a number. Container support for this
-   * field is OPTIONAL.
+   * Set the person's age, specified as a number. Container support for this 
field is OPTIONAL.
    *
    * @param age the persons age
    */
   void setAge(Integer age);
 
   /**
-   * Get the person's body characteristics, specified as an BodyType. Container
-   * support for this field is OPTIONAL.
+   * Get the person's body characteristics, specified as an BodyType. 
Container support for this
+   * field is OPTIONAL.
    *
    * @return the BodyType
    */
   BodyType getBodyType();
 
   /**
-   * Set the person's body characteristics, specified as an BodyType. Container
-   * support for this field is OPTIONAL.
+   * Set the person's body characteristics, specified as an BodyType. 
Container support for this
+   * field is OPTIONAL.
    *
-   * @param bodyType
-   *                the person's BodyType
+   * @param bodyType the person's BodyType
    */
   void setBodyType(BodyType bodyType);
 
   /**
-   * Get the person's favorite books, specified as an List of strings. 
Container
-   * support for this field is OPTIONAL.
+   * Get the person's favorite books, specified as an List of strings. 
Container support for this
+   * field is OPTIONAL.
    *
    * @return list of books as strings
    */
   List<String> getBooks();
 
   /**
-   * Set the person's favorite books, specified as an List of strings. 
Container
-   * support for this field is OPTIONAL.
+   * Set the person's favorite books, specified as an List of strings. 
Container support for this
+   * field is OPTIONAL.
    *
-   * @param books
-   *                a list of the person's books
+   * @param books a list of the person's books
    */
   void setBooks(List<String> books);
 
   /**
-   * Get the person's favorite cars, specified as an List of strings. Container
-   * support for this field is OPTIONAL.
+   * Get the person's favorite cars, specified as an List of strings. 
Container support for this
+   * field is OPTIONAL.
    *
    * @return the persons favorite cars
    */
   List<String> getCars();
 
   /**
-   * Set the person's favorite cars, specified as an List of strings. Container
-   * support for this field is OPTIONAL.
+   * Set the person's favorite cars, specified as an List of strings. 
Container support for this
+   * field is OPTIONAL.
    *
-   * @param cars
-   *                a list of the persons favorite cars
+   * @param cars a list of the persons favorite cars
    */
   void setCars(List<String> cars);
 
   /**
-   * Get a description of the person's children, specified as a string.
-   * Container support for this field is OPTIONAL.
+   * Get a description of the person's children, specified as a string. 
Container support for this
+   * field is OPTIONAL.
    *
    * @return the persons children
    */
   String getChildren();
 
   /**
-   * Set a description of the person's children, specified as a string.
-   * Container support for this field is OPTIONAL.
+   * Set a description of the person's children, specified as a string. 
Container support for this
+   * field is OPTIONAL.
    *
    * @param children the persons children
    */
   void setChildren(String children);
 
   /**
-   * Get the person's current location, specified as an [EMAIL PROTECTED] 
Address}.
-   * Container support for this field is OPTIONAL.
+   * Get the person's current location, specified as an [EMAIL PROTECTED] 
Address}. Container support for this
+   * field is OPTIONAL.
    *
    * @return the persons current location
    */
   Address getCurrentLocation();
 
   /**
-   * Set the person's current location, specified as an [EMAIL PROTECTED] 
Address}.
-   * Container support for this field is OPTIONAL.
+   * Set the person's current location, specified as an [EMAIL PROTECTED] 
Address}. Container support for this
+   * field is OPTIONAL.
    *
-   * @param currentLocation
-   *                the persons current location
+   * @param currentLocation the persons current location
    */
   void setCurrentLocation(Address currentLocation);
 
   /**
-   * Get the person's date of birth, specified as a [EMAIL PROTECTED] Date} 
object.
-   * Container support for this field is OPTIONAL.
+   * Get the person's date of birth, specified as a [EMAIL PROTECTED] Date} 
object. Container support for this
+   * field is OPTIONAL.
    *
    * @return the person's data of birth
    */
   Date getDateOfBirth();
 
   /**
-   * Set the person's date of birth, specified as a [EMAIL PROTECTED] Date} 
object.
-   * Container support for this field is OPTIONAL.
+   * Set the person's date of birth, specified as a [EMAIL PROTECTED] Date} 
object. Container support for this
+   * field is OPTIONAL.
    *
-   * @param dateOfBirth
-   *                the person's data of birth
+   * @param dateOfBirth the person's data of birth
    */
   void setDateOfBirth(Date dateOfBirth);
 
   /**
-   * Get the person's drinking status, specified as an [EMAIL PROTECTED] Enum} 
with the
-   * enum's key referencing [EMAIL PROTECTED] Enum.Drinker}. Container support 
for this
-   * field is OPTIONAL.
+   * Get the person's drinking status, specified as an [EMAIL PROTECTED] Enum} 
with the enum's key referencing
+   * [EMAIL PROTECTED] Enum.Drinker}. Container support for this field is 
OPTIONAL.
    *
    * @return the persons drinking status
    */
   Enum<Enum.Drinker> getDrinker();
 
   /**
-   * Get the person's drinking status, specified as an [EMAIL PROTECTED] Enum} 
with the
-   * enum's key referencing [EMAIL PROTECTED] Enum.Drinker}. Container support 
for this
-   * field is OPTIONAL.
+   * Get the person's drinking status, specified as an [EMAIL PROTECTED] Enum} 
with the enum's key referencing
+   * [EMAIL PROTECTED] Enum.Drinker}. Container support for this field is 
OPTIONAL.
    *
-   * @param newDrinker
-   *                the persons drinking status
+   * @param newDrinker the persons drinking status
    */
   void setDrinker(Enum<Enum.Drinker> newDrinker);
 
   /**
-   * Get the person's Emails associated with the person, specified as an List 
of
-   * [EMAIL PROTECTED] Email}. Container support for this field is OPTIONAL.
+   * Get the person's Emails associated with the person, specified as an List 
of [EMAIL PROTECTED] Email}.
+   * Container support for this field is OPTIONAL.
    *
    * @return a list of the person's emails
    */
   List<Email> getEmails();
 
   /**
-   * Set the person's Emails associated with the person, specified as an List 
of
-   * [EMAIL PROTECTED] Email}. Container support for this field is OPTIONAL.
+   * Set the person's Emails associated with the person, specified as an List 
of [EMAIL PROTECTED] Email}.
+   * Container support for this field is OPTIONAL.
    *
-   * @param emails
-   *                a list of the person's emails
+   * @param emails a list of the person's emails
    */
   void setEmails(List<Email> emails);
 
   /**
-   * Get the person's ethnicity, specified as a string. Container support for
-   * this field is OPTIONAL.
+   * Get the person's ethnicity, specified as a string. Container support for 
this field is
+   * OPTIONAL.
    *
    * @return the person's ethnicity
    */
   String getEthnicity();
 
   /**
-   * Set the person's ethnicity, specified as a string. Container support for
-   * this field is OPTIONAL.
+   * Set the person's ethnicity, specified as a string. Container support for 
this field is
+   * OPTIONAL.
    *
-   * @param ethnicity
-   *                the person's ethnicity
+   * @param ethnicity the person's ethnicity
    */
   void setEthnicity(String ethnicity);
 
   /**
-   * Get the person's thoughts on fashion, specified as a string. Container
-   * support for this field is OPTIONAL.
+   * Get the person's thoughts on fashion, specified as a string. Container 
support for this field
+   * is OPTIONAL.
    *
    * @return the person's thoughts on fashion
    */
   String getFashion();
 
   /**
-   * Set the person's thoughts on fashion, specified as a string. Container
-   * support for this field is OPTIONAL.
+   * Set the person's thoughts on fashion, specified as a string. Container 
support for this field
+   * is OPTIONAL.
    *
-   * @param fashion
-   *                the person's thoughts on fashion
+   * @param fashion the person's thoughts on fashion
    */
   void setFashion(String fashion);
 
   /**
-   * Get the person's favorite food, specified as an List of strings. Container
-   * support for this field is OPTIONAL.
+   * Get the person's favorite food, specified as an List of strings. 
Container support for this
+   * field is OPTIONAL.
    *
    * @return the person's favorite food
    */
   List<String> getFood();
 
   /**
-   * Set the person's favorite food, specified as an List of strings. Container
-   * support for this field is OPTIONAL.
+   * Set the person's favorite food, specified as an List of strings. 
Container support for this
+   * field is OPTIONAL.
    *
-   * @param food
-   *                the person's favorite food
+   * @param food the person's favorite food
    */
   void setFood(List<String> food);
 
   /**
-   * Get a person's gender, specified as an [EMAIL PROTECTED] Enum} with the 
enum's key
-   * referencing [EMAIL PROTECTED] Enum.Gender} Container support for this 
field is
-   * OPTIONAL.
+   * Get a person's gender, specified as an [EMAIL PROTECTED] Enum} with the 
enum's key referencing
+   * [EMAIL PROTECTED] Enum.Gender} Container support for this field is 
OPTIONAL.
    *
    * @return the person's gender
    */
   Enum<Enum.Gender> getGender();
 
   /**
-   * Set a person's gender, specified as an [EMAIL PROTECTED] Enum} with the 
enum's key
-   * referencing [EMAIL PROTECTED] Enum.Gender} Container support for this 
field is
-   * OPTIONAL.
+   * Set a person's gender, specified as an [EMAIL PROTECTED] Enum} with the 
enum's key referencing
+   * [EMAIL PROTECTED] Enum.Gender} Container support for this field is 
OPTIONAL.
    *
-   * @param newGender
-   *                the person's gender
+   * @param newGender the person's gender
    */
   void setGender(Enum<Enum.Gender> newGender);
 
   /**
-   * Get a description of when the person is happiest, specified as a string.
-   * Container support for this field is OPTIONAL.
+   * Get a description of when the person is happiest, specified as a string. 
Container support for
+   * this field is OPTIONAL.
    *
    * @return a description of when the person is happiest
    */
   String getHappiestWhen();
 
   /**
-   * Set a description of when the person is happiest, specified as a string.
-   * Container support for this field is OPTIONAL.
+   * Set a description of when the person is happiest, specified as a string. 
Container support for
+   * this field is OPTIONAL.
    *
-   * @param happiestWhen
-   *                a description of when the person is happiest
+   * @param happiestWhen a description of when the person is happiest
    */
   void setHappiestWhen(String happiestWhen);
 
   /**
-   * Get if the person has used the current app. Container support for this
-   * field is OPTIONAL.
+   * Get if the person has used the current app. Container support for this 
field is OPTIONAL.
    *
    * @return true the current app has been used
    */
   Boolean getHasApp();
 
   /**
-   * Set if the person has used the current app. Container support for this
-   * field is OPTIONAL.
+   * Set if the person has used the current app. Container support for this 
field is OPTIONAL.
    *
-   * @param hasApp
-   *                set true the current app has been used
+   * @param hasApp set true the current app has been used
    */
   void setHasApp(Boolean hasApp);
 
   /**
-   * Get a person's favorite heroes, specified as an Array of strings. 
Container
-   * support for this field is OPTIONAL.
+   * Get a person's favorite heroes, specified as an Array of strings. 
Container support for this
+   * field is OPTIONAL.
    *
    * @return a list of the person's favorite heroes
    */
   List<String> getHeroes();
 
   /**
-   * Set a person's favorite heroes, specified as an Array of strings. 
Container
-   * support for this field is OPTIONAL.
+   * Set a person's favorite heroes, specified as an Array of strings. 
Container support for this
+   * field is OPTIONAL.
    *
-   * @param heroes
-   *                a list of the person's favorite heroes
+   * @param heroes a list of the person's favorite heroes
    */
   void setHeroes(List<String> heroes);
 
   /**
-   * Get the person's thoughts on humor, specified as a string. Container
-   * support for this field is OPTIONAL.
+   * Get the person's thoughts on humor, specified as a string. Container 
support for this field is
+   * OPTIONAL.
    *
    * @return the person's thoughts on humor
    */
   String getHumor();
 
   /**
-   * Set the person's thoughts on humor, specified as a string. Container
-   * support for this field is OPTIONAL.
+   * Set the person's thoughts on humor, specified as a string. Container 
support for this field is
+   * OPTIONAL.
    *
-   * @param humor
-   *                the person's thoughts on humor
+   * @param humor the person's thoughts on humor
    */
   void setHumor(String humor);
 
   /**
-   * Get A string ID that can be permanently associated with this person.
-   * Container support for this field is REQUIRED.
+   * Get A string ID that can be permanently associated with this person. 
Container support for this
+   * field is REQUIRED.
    *
    * @return the permanent ID of the person
    */
   String getId();
 
   /**
-   * Set A string ID that can be permanently associated with this person.
-   * Container support for this field is REQUIRED.
+   * Set A string ID that can be permanently associated with this person. 
Container support for this
+   * field is REQUIRED.
    *
-   * @param id
-   *                the permanent ID of the person
+   * @param id the permanent ID of the person
    */
   void setId(String id);
 
   /**
-   * Get the person's interests, hobbies or passions, specified as an List of
-   * strings. Container support for this field is OPTIONAL.
+   * Get the person's interests, hobbies or passions, specified as an List of 
strings. Container
+   * support for this field is OPTIONAL.
    *
    * @return the person's interests, hobbies or passions
    */
   List<String> getInterests();
 
   /**
-   * Set the person's interests, hobbies or passions, specified as an List of
-   * strings. Container support for this field is OPTIONAL.
+   * Set the person's interests, hobbies or passions, specified as an List of 
strings. Container
+   * support for this field is OPTIONAL.
    *
-   * @param interests
-   *                the person's interests, hobbies or passions
+   * @param interests the person's interests, hobbies or passions
    */
   void setInterests(List<String> interests);
 
   /**
-   * Get the Person's favorite jobs, or job interests and skills, specified as 
a
-   * string. Container support for this field is OPTIONAL
+   * Get the Person's favorite jobs, or job interests and skills, specified as 
a string. Container
+   * support for this field is OPTIONAL
    *
    * @return the Person's favorite jobs, or job interests and skills
    */
   String getJobInterests();
 
   /**
-   * Set the Person's favorite jobs, or job interests and skills, specified as 
a
-   * string. Container support for this field is OPTIONAL
+   * Set the Person's favorite jobs, or job interests and skills, specified as 
a string. Container
+   * support for this field is OPTIONAL
    *
-   * @param jobInterests
-   *                the Person's favorite jobs, or job interests and skills
+   * @param jobInterests the Person's favorite jobs, or job interests and 
skills
    */
   void setJobInterests(String jobInterests);
 
   /**
-   * Get the Jobs the person has held, specified as an List of
-   * [EMAIL PROTECTED] Organization}. Container support for this field is 
OPTIONAL.
+   * Get the Jobs the person has held, specified as an List of [EMAIL 
PROTECTED] Organization}. Container
+   * support for this field is OPTIONAL.
    *
    * @return the Jobs the person has held
    */
   List<Organization> getJobs();
 
   /**
-   * Set the Jobs the person has held, specified as an List of
-   * [EMAIL PROTECTED] Organization}. Container support for this field is 
OPTIONAL.
+   * Set the Jobs the person has held, specified as an List of [EMAIL 
PROTECTED] Organization}. Container
+   * support for this field is OPTIONAL.
    *
-   * @param jobs
-   *                the Jobs the person has held
+   * @param jobs the Jobs the person has held
    */
   void setJobs(List<Organization> jobs);
 
   /**
-   * Get a List of the languages that the person speaks as ISO 639-1 codes,
-   * specified as an List of strings. Container support for this field is
-   * OPTIONAL.
+   * Get a List of the languages that the person speaks as ISO 639-1 codes, 
specified as an List of
+   * strings. Container support for this field is OPTIONAL.
    *
    * @return a List of the languages that the person speaks
    */
   List<String> getLanguagesSpoken();
 
   /**
-   * Set a List of the languages that the person speaks as ISO 639-1 codes,
-   * specified as an List of strings. Container support for this field is
-   * OPTIONAL.
+   * Set a List of the languages that the person speaks as ISO 639-1 codes, 
specified as an List of
+   * strings. Container support for this field is OPTIONAL.
    *
-   * @param languagesSpoken
-   *                a List of the languages that the person speaks
+   * @param languagesSpoken a List of the languages that the person speaks
    */
   void setLanguagesSpoken(List<String> languagesSpoken);
 
@@ -625,80 +593,73 @@
   /**
    * Set the time this record was last updated.
    *
-   * @param updated
-   *                the last update time
+   * @param updated the last update time
    */
   void setUpdated(Date updated);
 
   /**
-   * Get a description of the person's living arrangement, specified as a
-   * string. Container support for this field is OPTIONAL.
+   * Get a description of the person's living arrangement, specified as a 
string. Container support
+   * for this field is OPTIONAL.
    *
    * @return a description of the person's living arrangement
    */
   String getLivingArrangement();
 
   /**
-   * Set a description of the person's living arrangement, specified as a
-   * string. Container support for this field is OPTIONAL.
+   * Set a description of the person's living arrangement, specified as a 
string. Container support
+   * for this field is OPTIONAL.
    *
-   * @param livingArrangement
-   *                a description of the person's living arrangement
+   * @param livingArrangement a description of the person's living arrangement
    */
   void setLivingArrangement(String livingArrangement);
 
   /**
-   * Get a person's statement about who or what they are looking for, or what
-   * they are interested in meeting people for. Specified as an List of
-   * [EMAIL PROTECTED] Enum} with the enum's key referencing [EMAIL PROTECTED] 
Enum.LookingFor}
-   * Container support for this field is OPTIONAL.
+   * Get a person's statement about who or what they are looking for, or what 
they are interested in
+   * meeting people for. Specified as an List of [EMAIL PROTECTED] Enum} with 
the enum's key referencing
+   * [EMAIL PROTECTED] Enum.LookingFor} Container support for this field is 
OPTIONAL.
    *
    * @return person's statement about who or what they are looking for
    */
   String getLookingFor();
 
   /**
-   * Get a person's statement about who or what they are looking for, or what
-   * they are interested in meeting people for. Specified as an List of
-   * [EMAIL PROTECTED] Enum} with the enum's key referencing [EMAIL PROTECTED] 
Enum.LookingFor}
-   * Container support for this field is OPTIONAL.
+   * Get a person's statement about who or what they are looking for, or what 
they are interested in
+   * meeting people for. Specified as an List of [EMAIL PROTECTED] Enum} with 
the enum's key referencing
+   * [EMAIL PROTECTED] Enum.LookingFor} Container support for this field is 
OPTIONAL.
    *
-   * @param lookingFor
-   *                person's statement about who or what they are looking for
+   * @param lookingFor person's statement about who or what they are looking 
for
    */
   void setLookingFor(String lookingFor);
 
   /**
-   * Get the Person's favorite movies, specified as an List of strings.
-   * Container support for this field is OPTIONAL.
+   * Get the Person's favorite movies, specified as an List of strings. 
Container support for this
+   * field is OPTIONAL.
    *
    * @return the Person's favorite movies
    */
   List<String> getMovies();
 
   /**
-   * Set the Person's favorite movies, specified as an List of strings.
-   * Container support for this field is OPTIONAL.
+   * Set the Person's favorite movies, specified as an List of strings. 
Container support for this
+   * field is OPTIONAL.
    *
-   * @param movies
-   *                the Person's favorite movies
+   * @param movies the Person's favorite movies
    */
   void setMovies(List<String> movies);
 
   /**
-   * Get the Person's favorite music, specified as an List of strings Container
-   * support for this field is OPTIONAL.
+   * Get the Person's favorite music, specified as an List of strings 
Container support for this
+   * field is OPTIONAL.
    *
    * @return Person's favorite music
    */
   List<String> getMusic();
 
   /**
-   * Set the Person's favorite music, specified as an List of strings Container
-   * support for this field is OPTIONAL.
+   * Set the Person's favorite music, specified as an List of strings 
Container support for this
+   * field is OPTIONAL.
    *
-   * @param music
-   *                Person's favorite music
+   * @param music Person's favorite music
    */
   void setMusic(List<String> music);
 
@@ -712,27 +673,23 @@
   /**
    * Set the person's name Container support for this field is REQUIRED.
    *
-   * @param name
-   *                the person's name
+   * @param name the person's name
    */
   void setName(Name name);
 
   /**
-   * Get the person's current network status. Specified as an [EMAIL 
PROTECTED] Enum} with
-   * the enum's key referencing [EMAIL PROTECTED] Enum.Presence}. Container 
support for
-   * this field is OPTIONAL.
+   * Get the person's current network status. Specified as an [EMAIL 
PROTECTED] Enum} with the enum's key
+   * referencing [EMAIL PROTECTED] Enum.Presence}. Container support for this 
field is OPTIONAL.
    *
    * @return the person's current network status
    */
   Enum<Enum.NetworkPresence> getNetworkPresence();
 
   /**
-   * Set the person's current network status. Specified as an [EMAIL 
PROTECTED] Enum} with
-   * the enum's key referencing [EMAIL PROTECTED] Enum.Presence}. Container 
support for
-   * this field is OPTIONAL.
+   * Set the person's current network status. Specified as an [EMAIL 
PROTECTED] Enum} with the enum's key
+   * referencing [EMAIL PROTECTED] Enum.Presence}. Container support for this 
field is OPTIONAL.
    *
-   * @param networkPresence
-   *                the person's current network status
+   * @param networkPresence the person's current network status
    */
   void setNetworkPresence(Enum<Enum.NetworkPresence> networkPresence);
 
@@ -744,338 +701,287 @@
   String getNickname();
 
   /**
-   * Set the the person's nickname. Container support for this field is
-   * REQUIRED.
+   * Set the the person's nickname. Container support for this field is 
REQUIRED.
    *
-   * @param nickname
-   *                the person's nickname.
+   * @param nickname the person's nickname.
    */
   void setNickname(String nickname);
 
   /**
-   * Get a description of the person's pets Container support for this field is
-   * OPTIONAL.
+   * Get a description of the person's pets Container support for this field 
is OPTIONAL.
    *
    * @return a description of the person's pets
    */
   String getPets();
 
   /**
-   * Set a description of the person's pets Container support for this field is
-   * OPTIONAL.
+   * Set a description of the person's pets Container support for this field 
is OPTIONAL.
    *
-   * @param pets
-   *                a description of the person's pets
+   * @param pets a description of the person's pets
    */
   void setPets(String pets);
 
   /**
-   * Get the Phone numbers associated with the person, specified as an List of
-   * [EMAIL PROTECTED] Phones}. Container support for this field is OPTIONAL.
+   * Get the Phone numbers associated with the person, specified as an List of 
[EMAIL PROTECTED] Phones}.
+   * Container support for this field is OPTIONAL.
    *
    * @return the Phone numbers associated with the person
    */
   List<Phone> getPhoneNumbers();
 
   /**
-   * Set the Phone numbers associated with the person, specified as an List of
-   * [EMAIL PROTECTED] Phones}. Container support for this field is OPTIONAL.
+   * Set the Phone numbers associated with the person, specified as an List of 
[EMAIL PROTECTED] Phones}.
+   * Container support for this field is OPTIONAL.
    *
-   * @param phoneNumbers
-   *                the Phone numbers associated with the person
+   * @param phoneNumbers the Phone numbers associated with the person
    */
   void setPhoneNumbers(List<Phone> phoneNumbers);
 
   /**
-   * Get the Person's political views, specified as a string. Container support
-   * for this field is OPTIONAL.
+   * Get the Person's political views, specified as a string. Container 
support for this field is
+   * OPTIONAL.
    *
    * @return the Person's political views
    */
   String getPoliticalViews();
 
   /**
-   * Set the Person's political views, specified as a string. Container support
-   * for this field is OPTIONAL.
+   * Set the Person's political views, specified as a string. Container 
support for this field is
+   * OPTIONAL.
    *
-   * @param politicalViews
-   *                the Person's political views
+   * @param politicalViews the Person's political views
    */
   void setPoliticalViews(String politicalViews);
 
   /**
-   * Get the Person's profile song, specified as an [EMAIL PROTECTED] Url}. 
Container
-   * support for this field is OPTIONAL.
+   * Get the Person's profile song, specified as an [EMAIL PROTECTED] Url}. 
Container support for this field
+   * is OPTIONAL.
    *
    * @return the Person's profile song
    */
   Url getProfileSong();
 
   /**
-   * Set the Person's profile song, specified as an [EMAIL PROTECTED] Url}. 
Container
-   * support for this field is OPTIONAL.
+   * Set the Person's profile song, specified as an [EMAIL PROTECTED] Url}. 
Container support for this field
+   * is OPTIONAL.
    *
-   * @param profileSong
-   *                the Person's profile song
+   * @param profileSong the Person's profile song
    */
   void setProfileSong(Url profileSong);
 
   /**
-   * Get the person's profile URL. This URL must be fully qualified. Relative
-   * URLs will not work in gadgets Container support for this field is 
OPTIONAL.
+   * Get the person's profile URL. This URL must be fully qualified. Relative 
URLs will not work in
+   * gadgets Container support for this field is OPTIONAL.
    *
    * @return the person's profile URL
    */
   String getProfileUrl();
 
   /**
-   * Set the person's profile URL. This URL must be fully qualified. Relative
-   * URLs will not work in gadgets Container support for this field is 
OPTIONAL.
+   * Set the person's profile URL. This URL must be fully qualified. Relative 
URLs will not work in
+   * gadgets Container support for this field is OPTIONAL.
    *
-   * @param profileUrl
-   *                the person's profile URL
+   * @param profileUrl the person's profile URL
    */
   void setProfileUrl(String profileUrl);
 
   /**
-   * Get the Person's profile video. Container support for this field is
-   * OPTIONAL.
+   * Get the Person's profile video. Container support for this field is 
OPTIONAL.
    *
    * @return the Person's profile video
    */
   Url getProfileVideo();
 
   /**
-   * Set the Person's profile video. Container support for this field is
-   * OPTIONAL.
+   * Set the Person's profile video. Container support for this field is 
OPTIONAL.
    *
-   * @param profileVideo
-   *                the Person's profile video
+   * @param profileVideo the Person's profile video
    */
   void setProfileVideo(Url profileVideo);
 
   /**
-   * Get the person's favorite quotes Container support for this field is
-   * OPTIONAL.
+   * Get the person's favorite quotes Container support for this field is 
OPTIONAL.
    *
    * @return the person's favorite quotes
    */
   List<String> getQuotes();
 
   /**
-   * Set the person's favorite quotes. Container support for this field is
-   * OPTIONAL.
+   * Set the person's favorite quotes. Container support for this field is 
OPTIONAL.
    *
-   * @param quotes
-   *                the person's favorite quotes
+   * @param quotes the person's favorite quotes
    */
   void setQuotes(List<String> quotes);
 
   /**
-   * Get the person's relationship status. Container support for this field is
-   * OPTIONAL.
+   * Get the person's relationship status. Container support for this field is 
OPTIONAL.
    *
    * @return the person's relationship status
    */
   String getRelationshipStatus();
 
   /**
-   * Set the person's relationship status. Container support for this field is
-   * OPTIONAL.
+   * Set the person's relationship status. Container support for this field is 
OPTIONAL.
    *
-   * @param relationshipStatus
-   *                the person's relationship status
+   * @param relationshipStatus the person's relationship status
    */
   void setRelationshipStatus(String relationshipStatus);
 
   /**
-   * Get the person's relgion or religious views. Container support for this
-   * field is OPTIONAL.
+   * Get the person's relgion or religious views. Container support for this 
field is OPTIONAL.
    *
    * @return the person's relgion or religious views
    */
   String getReligion();
 
   /**
-   * Set the person's relgion or religious views. Container support for this
-   * field is OPTIONAL.
+   * Set the person's relgion or religious views. Container support for this 
field is OPTIONAL.
    *
-   * @param religion
-   *                the person's relgion or religious views
+   * @param religion the person's relgion or religious views
    */
   void setReligion(String religion);
 
   /**
-   * Get the person's comments about romance. Container support for this field
-   * is OPTIONAL.
+   * Get the person's comments about romance. Container support for this field 
is OPTIONAL.
    *
    * @return the person's comments about romance,
    */
   String getRomance();
 
   /**
-   * Set a the person's comments about romance, Container support for this 
field
-   * is OPTIONAL.
+   * Set a the person's comments about romance, Container support for this 
field is OPTIONAL.
    *
-   * @param romance
-   *                the person's comments about romance,
+   * @param romance the person's comments about romance,
    */
   void setRomance(String romance);
 
   /**
-   * Get what the person is scared of Container support for this field is
-   * OPTIONAL.
+   * Get what the person is scared of Container support for this field is 
OPTIONAL.
    *
    * @return what the person is scared of
    */
   String getScaredOf();
 
   /**
-   * Set what the person is scared of Container support for this field is
-   * OPTIONAL.
+   * Set what the person is scared of Container support for this field is 
OPTIONAL.
    *
-   * @param scaredOf
-   *                what the person is scared of
+   * @param scaredOf what the person is scared of
    */
   void setScaredOf(String scaredOf);
 
   /**
-   * Get schools the person has attended Container support for this field is
-   * OPTIONAL.
+   * Get schools the person has attended Container support for this field is 
OPTIONAL.
    *
    * @return schools the person has attended
    */
   List<Organization> getSchools();
 
   /**
-   * Set schools the person has attended Container support for this field is
-   * OPTIONAL.
+   * Set schools the person has attended Container support for this field is 
OPTIONAL.
    *
-   * @param schools
-   *                schools the person has attended
+   * @param schools schools the person has attended
    */
   void setSchools(List<Organization> schools);
 
   /**
-   * Get the person's sexual orientation. Container support for this field is
-   * OPTIONAL.
+   * Get the person's sexual orientation. Container support for this field is 
OPTIONAL.
    *
    * @return the person's sexual orientation
    */
   String getSexualOrientation();
 
   /**
-   * Set the person's sexual orientation Container support for this field is
-   * OPTIONAL.
+   * Set the person's sexual orientation Container support for this field is 
OPTIONAL.
    *
-   * @param sexualOrientation
-   *                the person's sexual orientation
+   * @param sexualOrientation the person's sexual orientation
    */
   void setSexualOrientation(String sexualOrientation);
 
   /**
-   * Get the person's smoking status. Container support for this field is
-   * OPTIONAL.
+   * Get the person's smoking status. Container support for this field is 
OPTIONAL.
    *
    * @return the person's smoking status
    */
   Enum<Enum.Smoker> getSmoker();
 
   /**
-   * Set the person's smoking status. Container support for this field is
-   * OPTIONAL.
+   * Set the person's smoking status. Container support for this field is 
OPTIONAL.
    *
-   * @param newSmoker
-   *                the person's smoking status
+   * @param newSmoker the person's smoking status
    */
   void setSmoker(Enum<Enum.Smoker> newSmoker);
 
   /**
-   * Get the person's favorite sports. Container support for this field is
-   * OPTIONAL.
+   * Get the person's favorite sports. Container support for this field is 
OPTIONAL.
    *
    * @return the person's favorite sports
    */
   List<String> getSports();
 
   /**
-   * Set the person's favorite sports. Container support for this field is
-   * OPTIONAL.
+   * Set the person's favorite sports. Container support for this field is 
OPTIONAL.
    *
-   * @param sports
-   *                the person's favorite sports
+   * @param sports the person's favorite sports
    */
   void setSports(List<String> sports);
 
   /**
-   * Get the person's status, headline or shoutout. Container support for this
-   * field is OPTIONAL.
+   * Get the person's status, headline or shoutout. Container support for this 
field is OPTIONAL.
    *
    * @return the person's status, headline or shoutout
    */
   String getStatus();
 
   /**
-   * Set the person's status, headline or shoutout. Container support for this
-   * field is OPTIONAL.
+   * Set the person's status, headline or shoutout. Container support for this 
field is OPTIONAL.
    *
-   * @param status
-   *                the person's status, headline or shoutout
+   * @param status the person's status, headline or shoutout
    */
   void setStatus(String status);
 
   /**
-   * Get arbitrary tags about the person. Container support for this field is
-   * OPTIONAL.
+   * Get arbitrary tags about the person. Container support for this field is 
OPTIONAL.
    *
    * @return arbitrary tags about the person.
    */
   List<String> getTags();
 
   /**
-   * Set arbitrary tags about the person. Container support for this field is
-   * OPTIONAL.
+   * Set arbitrary tags about the person. Container support for this field is 
OPTIONAL.
    *
-   * @param tags
-   *                arbitrary tags about the person.
+   * @param tags arbitrary tags about the person.
    */
   void setTags(List<String> tags);
 
   /**
-   * Get the person's photo thumbnail URL, specified as a string. This URL must
-   * be fully qualified. Relative URLs will not work in gadgets. Container
-   * support for this field is OPTIONAL.
+   * Get the person's photo thumbnail URL, specified as a string. This URL 
must be fully qualified.
+   * Relative URLs will not work in gadgets. Container support for this field 
is OPTIONAL.
    *
    * @return the person's photo thumbnail URL
    */
   String getThumbnailUrl();
 
   /**
-   * Set the person's photo thumbnail URL, specified as a string. This URL must
-   * be fully qualified. Relative URLs will not work in gadgets. Container
-   * support for this field is OPTIONAL.
+   * Set the person's photo thumbnail URL, specified as a string. This URL 
must be fully qualified.
+   * Relative URLs will not work in gadgets. Container support for this field 
is OPTIONAL.
    *
-   * @param thumbnailUrl
-   *                the person's photo thumbnail URL
+   * @param thumbnailUrl the person's photo thumbnail URL
    */
   void setThumbnailUrl(String thumbnailUrl);
 
   /**
-   * Get the Person's time zone, specified as the difference in minutes between
-   * Greenwich Mean Time (GMT) and the user's local time. Container support for
-   * this field is OPTIONAL.
+   * Get the Person's time zone, specified as the difference in minutes 
between Greenwich Mean Time
+   * (GMT) and the user's local time. Container support for this field is 
OPTIONAL.
    *
    * @return the Person's time zone
    */
   Long getTimeZone();
 
   /**
-   * Set the Person's time zone, specified as the difference in minutes between
-   * Greenwich Mean Time (GMT) and the user's local time. Container support for
-   * this field is OPTIONAL.
+   * Set the Person's time zone, specified as the difference in minutes 
between Greenwich Mean Time
+   * (GMT) and the user's local time. Container support for this field is 
OPTIONAL.
    *
-   * @param timeZone
-   *                the Person's time zone
+   * @param timeZone the Person's time zone
    */
   void setTimeZone(Long timeZone);
 
@@ -1089,8 +995,7 @@
   /**
    * Set the person's turn offs. Container support for this field is OPTIONAL.
    *
-   * @param turnOffs
-   *                the person's turn offs
+   * @param turnOffs the person's turn offs
    */
   void setTurnOffs(List<String> turnOffs);
 
@@ -1104,42 +1009,37 @@
   /**
    * Set the person's turn ons. Container support for this field is OPTIONAL.
    *
-   * @param turnOns
-   *                the person's turn ons
+   * @param turnOns the person's turn ons
    */
   void setTurnOns(List<String> turnOns);
 
   /**
-   * Get the person's favorite TV shows. Container support for this field is
-   * OPTIONAL.
+   * Get the person's favorite TV shows. Container support for this field is 
OPTIONAL.
    *
    * @return the person's favorite TV shows.
    */
   List<String> getTvShows();
 
   /**
-   * Set the person's favorite TV shows. Container support for this field is
-   * OPTIONAL.
+   * Set the person's favorite TV shows. Container support for this field is 
OPTIONAL.
    *
-   * @param tvShows
-   *                the person's favorite TV shows.
+   * @param tvShows the person's favorite TV shows.
    */
   void setTvShows(List<String> tvShows);
 
   /**
-   * Get the URLs related to the person, their webpages, or feeds Container
-   * support for this field is OPTIONAL.
+   * Get the URLs related to the person, their webpages, or feeds Container 
support for this field
+   * is OPTIONAL.
    *
    * @return the URLs related to the person, their webpages, or feeds
    */
   List<Url> getUrls();
 
   /**
-   * Set the URLs related to the person, their webpages, or feeds Container
-   * support for this field is OPTIONAL.
+   * Set the URLs related to the person, their webpages, or feeds Container 
support for this field
+   * is OPTIONAL.
    *
-   * @param urls
-   *                the URLs related to the person, their webpages, or feeds
+   * @param urls the URLs related to the person, their webpages, or feeds
    */
   void setUrls(List<Url> urls);
 
@@ -1149,8 +1049,7 @@
   boolean getIsOwner();
 
   /**
-   * @param isOwner
-   *                the isOwnerflag
+   * @param isOwner the isOwnerflag
    */
   void setIsOwner(boolean isOwner);
 
@@ -1160,8 +1059,7 @@
   boolean getIsViewer();
 
   /**
-   * @param isViewer
-   *                the isViewer Flag
+   * @param isViewer the isViewer Flag
    */
   void setIsViewer(boolean isViewer);
 


Reply via email to