From ffd4d47d0b88a4b2ef8b1d0e3972a0f5d75fc102 Mon Sep 17 00:00:00 2001
From: Antoine Pitrou <solipsis@pitrou.net>
Date: Fri, 22 Jun 2012 22:07:01 +0200
Subject: [PATCH] Add a docstring at the top of Tools/ssl/make_ssl_data.py

---
 Tools/ssl/make_ssl_data.py | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/Tools/ssl/make_ssl_data.py b/Tools/ssl/make_ssl_data.py
index 87b3ec2c6b3..10244d106f0 100644
--- a/Tools/ssl/make_ssl_data.py
+++ b/Tools/ssl/make_ssl_data.py
@@ -1,5 +1,16 @@
 #! /usr/bin/env python3
 
+"""
+This script should be called *manually* when we want to upgrade SSLError
+`library` and `reason` mnemnonics to a more recent OpenSSL version.
+
+It takes two arguments:
+- the path to the OpenSSL include files' directory
+  (e.g. openssl-1.0.1-beta3/include/openssl/)
+- the path to the C file to be generated
+  (probably Modules/_ssl_data.h)
+"""
+
 import datetime
 import os
 import re