From 2fdaa9870670813b556e3b7c3dc4f4011dccc692 Mon Sep 17 00:00:00 2001 From: Eli Bendersky Date: Fri, 21 Jul 2017 06:36:37 -0700 Subject: Add README clarification re -OO; relevant to #198 --- README.rst | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/README.rst b/README.rst index e94bb7e..951946e 100644 --- a/README.rst +++ b/README.rst @@ -87,6 +87,13 @@ Prerequisites uses is PLY, which is bundled in ``pycparser/ply``. The current PLY version is 3.10, retrieved from ``_ +Note that **pycparser** (and PLY) uses docstrings for grammar specifications. +Python installations that strip docstrings (such as when using the Python +``-OO`` option) will fail to instantiate and use **pycparser**. You can try to +work around this problem by making sure the PLY parsing tables are pre-generated +in normal mode; this isn't an officially supported/tested mode of operation, +though. + Installation process -------------------- -- cgit v1.2.1