Added skeletal "Building Extensions: Tips and Tricks" section. This

is where all the FAQs about extension-building will be answered.

diff --git a/Doc/inst/inst.tex b/Doc/inst/inst.tex
index d7b8950177d93794b390d50ff6dfc532dc1edefd..657849698686f76dbec63d0b80e51385ffa1160d 100644 (file)
--- a/Doc/inst/inst.tex
+++ b/Doc/inst/inst.tex
@@ -391,6 +391,31 @@ installations in the next section.
              {\longprogramopt{install-data}}
    \end{tableiii}}
 
+
+\section{Building Extensions: Tips and Tricks}
+\label{building-ext}
+
+(This is the section to read for people doing any sort of interesting
+build.  Things to talk about:
+\begin{itemize}
+\item the \file{Setup} file (any platform now, but Unix-biased)
+\item CFLAGS and LDFLAGS (must implement them first!)
+\item using non-MS compilers on Windows (how to convert
+  Python's library, ...)  
+\end{itemize}
+
+
+\subsection{Tweaking compiler/linker flags}
+\label{tweak-flags}
+
+
+\subsection{Using non-Microsoft compilers on Windows}
+\label{non-ms-compilers}
+
+\XXX{One place to look: \url{http://www.cyberus.ca/~g_will/pyExtenDL.shtml}}
+
+
+
 \section{Alternate Installation}
 \label{alt-install}