From: Georg Brandl <georg@python.org>
Date: Fri, 20 Jan 2006 09:34:29 +0000 (+0000)
Subject: Bug #1402224: Add warning to dl docs about crashes.
X-Git-Tag: v2.5a0~790
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=8cb307728eb8e7a9712500e350cd10b1f68256c3;p=python

Bug #1402224: Add warning to dl docs about crashes.
---

diff --git a/Doc/lib/libdl.tex b/Doc/lib/libdl.tex
index 358f0836a0..3da4db2752 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 1662110012..4e0f7330a7 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.