[Gsrc-commit] /srv/bzr/gsrc/trunk r944: include more info on python config in manual

[Brandon Invergo]

------------------------------------------------------------
revno: 944
committer: Brandon Invergo <address@hidden>
branch nick: trunk
timestamp: Sun 2012-09-23 18:44:42 +0200
message:
  include more info on python config in manual
modified:
  doc/gsrc.texi

=== modified file 'doc/gsrc.texi'
--- a/doc/gsrc.texi     2012-09-22 17:51:09 +0000
+++ b/doc/gsrc.texi     2012-09-23 16:44:42 +0000
@@ -540,33 +540,35 @@
 
 These template files may, however, be greatly expanded and customized
 to fit the needs of a given software package. To this end, several
-Autoconf macros are included in the @file{m4/python.m4} file. Notable
-macros include:
+Autoconf macros are included in the @file{m4/python.m4} file. This
+file defines Python as a language in Autoconf, meaning that, for
+example, you can include arbitrary Python code with
address@hidden Furthermore, several useful macros are defined:
 
address@hidden @columnfractions .40 .30 .30
address@hidden @columnfractions .33 .33 .33
 @headitem
-Macro Name
+Macro Name & Arguments
 @tab
 Description
 @tab
 Variables exported
 
 @item
address@hidden
address@hidden([NAME-TO-CHECK])}
 @tab
 Find a Python interpreter
 @tab
-PYTHON
address@hidden
 
 @item
address@hidden
address@hidden([NAME-TO-CHECK])}
 @tab
 Find a python-config program
 @tab
-PYTHON_CONFIG
address@hidden
 
 @item
address@hidden
address@hidden(VERSION, [ACTION-IF-TRUE], [ACTION-IF-NOT-TRUE])}
 @tab
 Verify that the Python interpreter is of a sufficient version number
 @tab
@@ -576,28 +578,85 @@
 @tab
 Get the version of the Python interpreter
 @tab
-PYTHON_VERSION
address@hidden
+
address@hidden
address@hidden
address@hidden
+Check what Python thinks is the prefix
address@hidden
address@hidden
+
address@hidden
address@hidden
address@hidden
+Check what Python thinks is the exec_prefix
address@hidden
address@hidden
+
address@hidden
address@hidden
address@hidden
+Check the include flags ('-I[header]...') for including the Python
+header files
address@hidden
address@hidden
 
 @item
 @code{PC_PYTHON_CHECK_HEADERS}
 @tab
 Check for the Python header files (i.e. @file{Python.h})
 @tab
-HAVE_PYTHON_H
address@hidden
 
 @item
 @code{PC_PYTHON_CHECK_LIBS}
 @tab
 Check for the proper LIBS flags to load the Python shared libraries
 @tab
-PYTHON_LIBS
address@hidden
 
 @item
 @code{PC_PYTHON_TEST_LIBS}
 @tab
 Test for the presence of the Python shared libraries
 @tab
-HAVE_LIBPYTHON
address@hidden
+
address@hidden
address@hidden
address@hidden
+Find the CFLAGS that Python expects
address@hidden
address@hidden
+
address@hidden
address@hidden
address@hidden
+Find the LDFLAGS that Python expects
address@hidden
address@hidden
+
address@hidden
address@hidden
address@hidden
+Check the extension suffix given to Python extension modules (Python 3
+only)
address@hidden
address@hidden
+
address@hidden
address@hidden
address@hidden
+Check the ABI flags used by Python (Python 3 only)
address@hidden
address@hidden
+
address@hidden
address@hidden
address@hidden
+Check what platform Python thinks this is
address@hidden
 
 @item
 @code{PC_PYTHON_CHECK_SITE_DIR}
@@ -605,14 +664,28 @@
 Check the appropriate place to install Python packages (i.e.
 @file{$(prefix)/lib/python2.7/site-packages})
 @tab
-pythondir
address@hidden
 
 @item
 @code{PC_PYTHON_SITE_PACKAGE_DIR}
 @tab
 A convenience macro; adds the package's name to @code{pythondir}
 @tab
-pkgpythondir
address@hidden
+
address@hidden
address@hidden
address@hidden
+Check directory for installing Python extension modules
address@hidden
address@hidden
+
address@hidden
address@hidden
address@hidden
+A convenience macro; adds the package's name to @code{pyexecdir}
address@hidden
address@hidden
 
 @item
 @code{PC_PYTHON_CHECK_MODULE}
@@ -623,7 +696,7 @@
 @item
 @code{PC_PYTHON_CHECK_FUNC}
 @tab
-Test if a given function foo.bar() can be called successfully.
+Test if a given Python function can be called successfully.
 @tab
 @end multitable