remove trailing whitespace

This commit is contained in:
Benjamin Peterson 2016-09-19 22:16:36 -07:00
parent 274a76323c
commit 0f5497e4c5
1 changed files with 18 additions and 18 deletions

View File

@ -45,10 +45,10 @@ extern "C" {
* Define macros for handling SIGFPE. * Define macros for handling SIGFPE.
* Lee Busby, LLNL, November, 1996 * Lee Busby, LLNL, November, 1996
* busby1@llnl.gov * busby1@llnl.gov
* *
********************************************* *********************************************
* Overview of the system for handling SIGFPE: * Overview of the system for handling SIGFPE:
* *
* This file (Include/pyfpe.h) defines a couple of "wrapper" macros for * This file (Include/pyfpe.h) defines a couple of "wrapper" macros for
* insertion into your Python C code of choice. Their proper use is * insertion into your Python C code of choice. Their proper use is
* discussed below. The file Python/pyfpe.c defines a pair of global * discussed below. The file Python/pyfpe.c defines a pair of global
@ -59,33 +59,33 @@ extern "C" {
* named fpectl. This module is standard in every respect. It can be loaded * named fpectl. This module is standard in every respect. It can be loaded
* either statically or dynamically as you choose, and like any other * either statically or dynamically as you choose, and like any other
* Python module, has no effect until you import it. * Python module, has no effect until you import it.
* *
* In the general case, there are three steps toward handling SIGFPE in any * In the general case, there are three steps toward handling SIGFPE in any
* Python code: * Python code:
* *
* 1) Add the *_PROTECT macros to your C code as required to protect * 1) Add the *_PROTECT macros to your C code as required to protect
* dangerous floating point sections. * dangerous floating point sections.
* *
* 2) Turn on the inclusion of the code by adding the ``--with-fpectl'' * 2) Turn on the inclusion of the code by adding the ``--with-fpectl''
* flag at the time you run configure. If the fpectl or other modules * flag at the time you run configure. If the fpectl or other modules
* which use the *_PROTECT macros are to be dynamically loaded, be * which use the *_PROTECT macros are to be dynamically loaded, be
* sure they are compiled with WANT_SIGFPE_HANDLER defined. * sure they are compiled with WANT_SIGFPE_HANDLER defined.
* *
* 3) When python is built and running, import fpectl, and execute * 3) When python is built and running, import fpectl, and execute
* fpectl.turnon_sigfpe(). This sets up the signal handler and enables * fpectl.turnon_sigfpe(). This sets up the signal handler and enables
* generation of SIGFPE whenever an exception occurs. From this point * generation of SIGFPE whenever an exception occurs. From this point
* on, any properly trapped SIGFPE should result in the Python * on, any properly trapped SIGFPE should result in the Python
* FloatingPointError exception. * FloatingPointError exception.
* *
* Step 1 has been done already for the Python kernel code, and should be * Step 1 has been done already for the Python kernel code, and should be
* done soon for the NumPy array package. Step 2 is usually done once at * done soon for the NumPy array package. Step 2 is usually done once at
* python install time. Python's behavior with respect to SIGFPE is not * python install time. Python's behavior with respect to SIGFPE is not
* changed unless you also do step 3. Thus you can control this new * changed unless you also do step 3. Thus you can control this new
* facility at compile time, or run time, or both. * facility at compile time, or run time, or both.
* *
******************************** ********************************
* Using the macros in your code: * Using the macros in your code:
* *
* static PyObject *foobar(PyObject *self,PyObject *args) * static PyObject *foobar(PyObject *self,PyObject *args)
* { * {
* .... * ....
@ -94,17 +94,17 @@ extern "C" {
* PyFPE_END_PROTECT(result) * PyFPE_END_PROTECT(result)
* .... * ....
* } * }
* *
* If a floating point error occurs in dangerous_op, foobar returns 0 (NULL), * If a floating point error occurs in dangerous_op, foobar returns 0 (NULL),
* after setting the associated value of the FloatingPointError exception to * after setting the associated value of the FloatingPointError exception to
* "Error in foobar". ``Dangerous_op'' can be a single operation, or a block * "Error in foobar". ``Dangerous_op'' can be a single operation, or a block
* of code, function calls, or any combination, so long as no alternate * of code, function calls, or any combination, so long as no alternate
* return is possible before the PyFPE_END_PROTECT macro is reached. * return is possible before the PyFPE_END_PROTECT macro is reached.
* *
* The macros can only be used in a function context where an error return * The macros can only be used in a function context where an error return
* can be recognized as signaling a Python exception. (Generally, most * can be recognized as signaling a Python exception. (Generally, most
* functions that return a PyObject * will qualify.) * functions that return a PyObject * will qualify.)
* *
* Guido's original design suggestion for PyFPE_START_PROTECT and * Guido's original design suggestion for PyFPE_START_PROTECT and
* PyFPE_END_PROTECT had them open and close a local block, with a locally * PyFPE_END_PROTECT had them open and close a local block, with a locally
* defined jmp_buf and jmp_buf pointer. This would allow recursive nesting * defined jmp_buf and jmp_buf pointer. This would allow recursive nesting
@ -112,17 +112,17 @@ extern "C" {
* variables need to be declared with the "volatile" type qualifier to keep * variables need to be declared with the "volatile" type qualifier to keep
* setjmp from corrupting their values. Some current implementations seem * setjmp from corrupting their values. Some current implementations seem
* to be more restrictive. For example, the HPUX man page for setjmp says * to be more restrictive. For example, the HPUX man page for setjmp says
* *
* Upon the return from a setjmp() call caused by a longjmp(), the * Upon the return from a setjmp() call caused by a longjmp(), the
* values of any non-static local variables belonging to the routine * values of any non-static local variables belonging to the routine
* from which setjmp() was called are undefined. Code which depends on * from which setjmp() was called are undefined. Code which depends on
* such values is not guaranteed to be portable. * such values is not guaranteed to be portable.
* *
* I therefore decided on a more limited form of nesting, using a counter * I therefore decided on a more limited form of nesting, using a counter
* variable (PyFPE_counter) to keep track of any recursion. If an exception * variable (PyFPE_counter) to keep track of any recursion. If an exception
* occurs in an ``inner'' pair of macros, the return will apparently * occurs in an ``inner'' pair of macros, the return will apparently
* come from the outermost level. * come from the outermost level.
* *
*/ */
#ifdef WANT_SIGFPE_HANDLER #ifdef WANT_SIGFPE_HANDLER
@ -146,14 +146,14 @@ if (!PyFPE_counter++ && setjmp(PyFPE_jbuf)) { \
* this statement so that it gets executed *before* the unsafe expression * this statement so that it gets executed *before* the unsafe expression
* which we're trying to protect. That pretty well messes things up, * which we're trying to protect. That pretty well messes things up,
* of course. * of course.
* *
* If the expression(s) you're trying to protect don't happen to return a * If the expression(s) you're trying to protect don't happen to return a
* value, you will need to manufacture a dummy result just to preserve the * value, you will need to manufacture a dummy result just to preserve the
* correct ordering of statements. Note that the macro passes the address * correct ordering of statements. Note that the macro passes the address
* of its argument (so you need to give it something which is addressable). * of its argument (so you need to give it something which is addressable).
* If your expression returns multiple results, pass the last such result * If your expression returns multiple results, pass the last such result
* to PyFPE_END_PROTECT. * to PyFPE_END_PROTECT.
* *
* Note that PyFPE_dummy returns a double, which is cast to int. * Note that PyFPE_dummy returns a double, which is cast to int.
* This seeming insanity is to tickle the Floating Point Unit (FPU). * This seeming insanity is to tickle the Floating Point Unit (FPU).
* If an exception has occurred in a preceding floating point operation, * If an exception has occurred in a preceding floating point operation,