package org.kohsuke.github;

import edu.umd.cs.findbugs.annotations.SuppressFBWarnings;

import java.util.Date;

/**
 * Represents a user in Git who authors/commits a commit.
 * <p>
 * In contrast, {@link GHUser} is an user of GitHub. Because Git allows a person to use multiple e-mail addresses and
 * names when creating a commit, there's generally no meaningful mapping between {@link GHUser} and {@link GitUser}.
 *
 * @author Kohsuke Kawaguchi
 */
@SuppressFBWarnings(value = { "UWF_UNWRITTEN_PUBLIC_OR_PROTECTED_FIELD", "UWF_UNWRITTEN_FIELD", "NP_UNWRITTEN_FIELD" },
        justification = "JSON API")
public class GitUser {
    private String name, email, date, username;

    /**
     * Gets name (e.g. from git commit).
     *
     * @return Human readable name of the user, such as "Kohsuke Kawaguchi"
     */
    public String getName() {
        return name;
    }

    /**
     * Gets email (e.g. from git commit).
     *
     * @return E-mail address, such as "foo@example.com"
     */
    public String getEmail() {
        return email;
    }

    /**
     * Gets username.
     *
     * @return GitHub username
     */
    public String getUsername() {
        return username;
    }

    /**
     * Gets date.
     *
     * @return This field doesn't appear to be consistently available in all the situations where this class is used.
     */
    public Date getDate() {
        return GitHubClient.parseDate(date);
    }
}

@@ -698,23 +698,57 @@
 ets 
-name (e.g. from
+the git user name for an author or committer on a
  git
@@ -746,33 +746,32 @@
  on a git commit
-)
 .%0A     *%0A     * 
@@ -929,24 +929,53 @@
 ets 
-email (e.g. from
+the git email for an author or committer on a
  git
@@ -981,17 +981,16 @@
 t commit
-)
 .%0A     *

address objections