From a9f350eb94eb9f165bb5dd13912fbde3eced2dbc Mon Sep 17 00:00:00 2001
From: Gary Gregory <ggregory@apache.org>
Date: Wed, 14 Dec 2016 14:28:40 -0800
Subject: [PATCH] [LANG-1297] SystemUtils.getHostName() API. Javadoc.

---
 src/main/java/org/apache/commons/lang3/SystemUtils.java | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/src/main/java/org/apache/commons/lang3/SystemUtils.java b/src/main/java/org/apache/commons/lang3/SystemUtils.java
index f850f656f..8425c5ca0 100644
--- a/src/main/java/org/apache/commons/lang3/SystemUtils.java
+++ b/src/main/java/org/apache/commons/lang3/SystemUtils.java
@@ -1494,7 +1494,11 @@ public static File getJavaHome() {
     }
 
     /**
-     * Gets the host name.
+     * Gets the host name from an environment variable.
+     * 
+     * <p>
+     * If you want to know what the network stack says is the host name, you should use {@code InetAddress.getLocalHost().getHostName()}.
+     * </p>
      * 
      * @return the host name.
      * @since 3.6