some updates, and adding the interfacing notes.

Author: ChrisBarker-NOAA

Sources/requirements.txt

@@ -5,6 +5,6 @@ Sphinx
 docutils
 sphinx-rtd-theme
 gnureadline
-hieroglyph
+# hieroglyph
 ipython
 libsass

Sources/source/conf.py

@@ -1,6 +1,6 @@
 # -*- coding: utf-8 -*-
 #
-# Pyhton Topics build configuration file, created by
+# Python Topics build configuration file, created by
 # sphinx-quickstart on Wed Apr  2 18:42:06 2014.
 #
 # This file is execfile()d with the current directory set to its
@@ -30,12 +30,12 @@
 # extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
 # ones.
 extensions = [
-    'sphinx.ext.doctest',
-    'sphinx.ext.intersphinx',
+#    'sphinx.ext.doctest',
+#    'sphinx.ext.intersphinx',
     'sphinx.ext.todo',
-    'sphinx.ext.coverage',
-    'sphinx.ext.imgmath',
-    'sphinx.ext.ifconfig',
+#    'sphinx.ext.coverage',
+#    'sphinx.ext.imgmath',
+#    'sphinx.ext.ifconfig',
     'IPython.sphinxext.ipython_console_highlighting',
     # 'IPython.sphinxext.ipython_directive',
 ]
@@ -53,17 +53,17 @@
 master_doc = 'index'
 
 # General information about the project.
-project = u'Python Topics'
-copyright = u'2014, Christopher Barker'
+project = 'Python Topics'
+copyright = '2014-2025, Christopher Barker'
 
 # The version info for the project you're documenting, acts as replacement for
 # |version| and |release|, also used in various other places throughout the
 # built documents.
 #
 # The short X.Y version.
-version = '1.0'
+version = '2.0'
 # The full version, including alpha/beta/rc tags.
-release = '1.0.0'
+release = '2.0.0'
 
 # The language for content autogenerated by Sphinx. Refer to documentation
 # for a list of supported languages.
@@ -116,8 +116,8 @@
 #html_theme_options = {}
 
 # Add any paths that contain custom themes here, relative to this directory.
-#html_theme_path = []
-html_theme_path = [sphinx_rtd_theme.get_html_theme_path()]
+# html_theme_path = []
+# html_theme_path = [sphinx_rtd_theme.get_html_theme_path()]
 
 # The name for this set of Sphinx documents.  If None, it defaults to
 # "<project> v<release> documentation".
@@ -368,4 +368,4 @@
 
 
 # Example configuration for intersphinx: refer to the Python standard library.
-intersphinx_mapping = {'http://docs.python.org/': None}
+# intersphinx_mapping = {'http://docs.python.org/': None}

Sources/source/interfacing_with_c/c_python.rst

@@ -43,7 +43,7 @@ https://cython.org/
 ctypes
 ------
 
-Ctypes comes with PYthon out of the box.
+Ctypes comes with Python out of the box.
 
 
 SWIG, SIP, ETC.
@@ -57,7 +57,14 @@ EXAMPLE:
 
 Same as the one for fortran: a automatic gain control filter:
 
-:download:`agc_example.zip`
+:download:`agc_example/agc_c.c`
+
+:download:`agc_example/agc_c_cy.pyx`
+
+:download:`agc_example/agc_cython.pyx`
+
+:download:`agc_example/agc_python.py` 
+
 
 
 

Sources/source/weak_references.rst

@@ -13,6 +13,8 @@ Chris Barker
 
 ``https://github.com/PythonCHB``
 
+**NOTE:** These notes were written for Python 2. The principles remain the same (for now... work on a GIL-free python is close!), but Python 3 has stronger and smarter support for garbage collection, so this is all less critical (though still good to understand!) 
+
 ==================
 Memory Management
 ==================