Sorry about the delay in seeing this thread - Barry, I assume that this means that despite the pain you have at least some sort of working Sphinx. I hesitated to add anything related to Sphinx to the existing docs build (controlled by the makefiles) yet, but as more things are ported there that would make sense. 


Am 07.07.2020 um 14:18 schrieb Barry Smith <bsmith@petsc.dev>:

  "Any Python package that you install with brew will install the Homebrew Python build."

  Sure in general with python on Apple, but you ignored my statement:  

$ which sphinx-build
/usr/local/opt/sphinx-doc/bin/sphinx-build
~/Src/petsc/src/ksp/ksp/interface (master=) arch-master
$ more /usr/local/opt/sphinx-doc/bin/sphinx-build
#!/usr/local/Cellar/sphinx-doc/3.0.4/libexec/bin/python3.8
# -*- coding: utf-8 -*-
import re
import sys
from sphinx.cmd.build import main

sphinx seems to be carrying around its own python internally, thus quite rightly getting Jed upset about packaging on Apple of open source software.  Or perhaps I misunderstand that line.

  Barry


On Jul 7, 2020, at 2:40 AM, Lisandro Dalcin <dalcinl@gmail.com> wrote:



On Tue, 7 Jul 2020 at 05:37, Barry Smith <bsmith@petsc.dev> wrote:

  My fault, for some reason sphinx from brew installed its own private python so I had to do the pip at that.


Any Python package that you install with brew will install the Homebrew Python build. Start using that one, and forget about the system Python install.
From brew you get `/usr/local/bin/python3`, and then you can freely `python3 -m pip install <package>`
I further symlink `/usr/local/bin/{python|pip}3` to `~/bin/{python|pip}`, so I don't have to deal ever again with the EOLed system Apple Python 2.

--
Lisandro Dalcin
============
Research Scientist
Extreme Computing Research Center (ECRC)
King Abdullah University of Science and Technology (KAUST)
http://ecrc.kaust.edu.sa/