[asdf-install-devel] Opinions regarding some more cleanup...

[Dan Muller]

I'd like to suggest the following small changes to further cleanup and
simplify configuration of asdf-install. Comments are relative to the
unstable repository.

- Document *shell-search-paths*. It's used only to find the tar
  executable and (on Windows) to find cygpath. I haven't looked to see
  how other things (gpg, and ...?)  are located. Perhaps the native
  shell is just expected to find them.
  
- Remove undocumented *cygwin-bin-directory*. *shell-search-paths*
  should suffice, really.

- Replace undocumented *tar-extractors* with *tar-extractor* (and
  document it). This is really the most versatile "escape hatch" for
  getting tar extraction to work under any circumstances. But I don't
  see why a list is needed rather than a singular funcallable value --
  you either get this right for your environment, or not.

- Document default Cygwin-assuming behavior on Windows.

Guess I'll have to learn cl-markdown to fix the documentation bits.

Any strong opinions about any of these?

There are lots of other exported symbols that I believe are
undocumented:

  *shell-path*
  asdf-install-dirs
  private-asdf-install-dirs
  *temporary-directory*
  add-locations
  add-registry-location
  asdf-install-version
  signature-error
  gpg-error
  gpg-shell-error
  installation-abort
  install-anyways
  asdf-isntall-customize

I'm not suggesting that they all ought to be documented. Perhaps some
of them are provisional and not trusted to live long; I haven't dug
through the repository history to see. Just taking note of them.

-- 
Dan Muller