Re: [docs] commands to do "pip install" in docs README file need enhancing

On Thu, 20 Aug 2026, Quentin Schulz wrote:

>
>
> On 8/20/26 4:58 PM, Robert P. J. Day wrote:

... snip ...
> > need installation to run the executable commands sphinx-lint and vale
> > are the packages with the same names, and they are special cases since
> > their purpose is to supply those commands, so the simple solution is
> > to install using "pipx", which is designed precisely for that purpose.
> >
> >    one can install pipx with pip, then follow that with:
> >
> >    $ pipx install sphinx-lint
> >    $ pipx install vale
> >
> > and it all now works just fine on debian 13. maybe down the road get
>
> Does it? I tried from within a container. First it tells me the path
> pipx installed to isn't in PATH so it won't be available. Then it
> tells me to run pipx ensurepath, which I do, and it then asks me to
> logoff or source ~/.bashrc. Only then do i have sphinx-lint. What a
> pain.

  FWIW, here's why this just worked for me. on debian 13,
/etc/skel/.profile contains:

  # set PATH so it includes user's private bin if it exists
  if [ -d "$HOME/.local/bin" ] ; then
    PATH="$HOME/.local/bin:$PATH"
  fi

well, it just so happens that, for whatever reason, on my debian 13
system, i have that directory so that it's automatically added to my
search PATH upon login, which is exactly where pipx installs commands
like "vale" and "sphinx-lint", so stuff like that just worked for me
the instant i installed those two packages with pipx.

rday