From 8cb307728eb8e7a9712500e350cd10b1f68256c3 Mon Sep 17 00:00:00 2001
From: Georg Brandl <georg@python.org>
Date: Fri, 20 Jan 2006 09:34:29 +0000
Subject: [PATCH] Bug #1402224: Add warning to dl docs about crashes.

---
 Doc/lib/libdl.tex | 4 ++++
 Misc/NEWS         | 2 ++
 2 files changed, 6 insertions(+)

diff --git a/Doc/lib/libdl.tex b/Doc/lib/libdl.tex
index 358f0836a09..3da4db27525 100644
--- a/Doc/lib/libdl.tex
+++ b/Doc/lib/libdl.tex
@@ -10,6 +10,10 @@ The \module{dl} module defines an interface to the
 \UNIX{} platforms for handling dynamically linked libraries. It allows
 the program to call arbitrary functions in such a library.
 
+\warning{The \module{dl} module bypasses the Python type system and 
+error handling. If used incorrectly it may cause segmentation faults,
+crashes or other incorrect behaviour.}
+
 \note{This module will not work unless
 \code{sizeof(int) == sizeof(long) == sizeof(char *)}
 If this is not the case, \exception{SystemError} will be raised on
diff --git a/Misc/NEWS b/Misc/NEWS
index 1662110012f..4e0f7330a7b 100644
--- a/Misc/NEWS
+++ b/Misc/NEWS
@@ -727,6 +727,8 @@ Tests
 Documentation
 -------------
 
+- Bug #1402224: Add warning to dl docs about crashes.
+
 - Bug #1396471: Document that Windows' ftell() can return invalid
   values for text files with UNIX-style line endings.