Index: Doc/library/os.rst
===================================================================
--- Doc/library/os.rst	(revision 88145)
+++ Doc/library/os.rst	(working copy)
@@ -1080,8 +1080,9 @@
 
 .. function:: lstat(path)
 
-   Like :func:`stat`, but do not follow symbolic links.  This is an alias for
-   :func:`stat` on platforms that do not support symbolic links.
+   Like :func:`os.stat`, but do not follow symbolic links. If a symlink is provided then
+   the symlink is stat-ed. This is an alias for :func:`os.stat` on platforms that
+   do not support symbolic links.
 
    .. versionchanged:: 3.2
       Added support for Windows 6.0 (Vista) symbolic links.
@@ -1327,6 +1328,12 @@
       :attr:`st_mtime` has 2-second resolution, and :attr:`st_atime` has only 1-day
       resolution.  See your operating system documentation for details.
 
+   .. note::
+
+      This function follows symlinks so to stat a symlink :func:`lstat` function
+      should be used.
+
+
    Availability: Unix, Windows.