From 59fef28687cf7f903d3a8727d272d85b45ffbb44 Mon Sep 17 00:00:00 2001
From: Shao Yang Hong <hongsy2006@gmail.com>
Date: Sun, 8 Nov 2020 19:19:01 +0800
Subject: [PATCH] DOC: Add caveat to to_stata with version=119

---
 pandas/core/frame.py | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/pandas/core/frame.py b/pandas/core/frame.py
index bfb633ae55095..76ae900d26a68 100644
--- a/pandas/core/frame.py
+++ b/pandas/core/frame.py
@@ -2131,6 +2131,11 @@ def to_stata(
             support Unicode characters, and version 119 supports more than
             32,767 variables.
 
+            Version 119 should usually only be used when the number of
+            variables exceeds the capacity of dta format 118. Exporting
+            smaller datasets in format 119 may have unintended consequences,
+            and, as of November 2020, Stata SE cannot read version 119 files.
+
             .. versionchanged:: 1.0.0
 
                 Added support for formats 118 and 119.