diff options
| -rw-r--r-- | Doc/howto/webservers.rst | 3 | ||||
| -rw-r--r-- | Doc/library/cgi.rst | 15 | ||||
| -rw-r--r-- | Doc/library/cgitb.rst | 5 |
3 files changed, 14 insertions, 9 deletions
diff --git a/Doc/howto/webservers.rst b/Doc/howto/webservers.rst index 6e0c815c4e..62c9124c0b 100644 --- a/Doc/howto/webservers.rst +++ b/Doc/howto/webservers.rst @@ -99,7 +99,8 @@ simple CGI program:: # -*- coding: UTF-8 -*- # enable debugging - import cgitb; cgitb.enable() + import cgitb + cgitb.enable() print "Content-Type: text/plain;charset=utf-8" print diff --git a/Doc/library/cgi.rst b/Doc/library/cgi.rst index 0248284b87..3879e0d9f2 100644 --- a/Doc/library/cgi.rst +++ b/Doc/library/cgi.rst @@ -67,16 +67,18 @@ Begin by writing ``import cgi``. Do not use ``from cgi import *`` --- the module defines all sorts of names for its own use or for backward compatibility that you don't want in your namespace. -When you write a new script, consider adding the line:: +When you write a new script, consider adding these lines:: - import cgitb; cgitb.enable() + import cgitb + cgitb.enable() This activates a special exception handler that will display detailed reports in the Web browser if any errors occur. If you'd rather not show the guts of your program to users of your script, you can have the reports saved to files -instead, with a line like this:: +instead, with code like this:: - import cgitb; cgitb.enable(display=0, logdir="/tmp") + import cgitb + cgitb.enable(display=0, logdir="/tmp") It's very helpful to use this feature during script development. The reports produced by :mod:`cgitb` provide information that can save you a lot of time in @@ -470,9 +472,10 @@ discarded altogether. Fortunately, once you have managed to get your script to execute *some* code, you can easily send tracebacks to the Web browser using the :mod:`cgitb` module. -If you haven't done so already, just add the line:: +If you haven't done so already, just add the lines:: - import cgitb; cgitb.enable() + import cgitb + cgitb.enable() to the top of your script. Then try running it again; when a problem occurs, you should see a detailed report that will likely make apparent the cause of the diff --git a/Doc/library/cgitb.rst b/Doc/library/cgitb.rst index 327cd17a25..052b82153f 100644 --- a/Doc/library/cgitb.rst +++ b/Doc/library/cgitb.rst @@ -26,9 +26,10 @@ as well as the values of the arguments and local variables to currently running functions, to help you debug the problem. Optionally, you can save this information to a file instead of sending it to the browser. -To enable this feature, simply add one line to the top of your CGI script:: +To enable this feature, simply add this to the top of your CGI script:: - import cgitb; cgitb.enable() + import cgitb + cgitb.enable() The options to the :func:`enable` function control whether the report is displayed in the browser and whether the report is logged to a file for later |