Re: scheme-only doc snarfer useful w/ (ice-9 documentation)

[Rob Browning]

thi <address@hidden> writes:

>   $ guile-config --script doc-snarf -o guile-procedures.txt *
>   $ guile-config --script doc-snarf my-*.scm > my-docs.txt

Hmm, this is an interesting idea, and would definitely save some
bindir bloat, though it's kinda non-standard.  I worry that you could
make the same argument for all kinds of programs in /usr/bin.  It
seems to me that unix has just decreed a shared global namespace for
executables, and we probably just need to choose our names
accordingly.

>   $ guile-config --type-p doc-snarf
>   /usr/local/share/guile/1.4.1/scripts/doc-snarf

Why not just use

  echo $(guile-config info bindir)/doc-snarf

>   $ guile-config --source doc-snarf
>   ;;; This program reads in Scheme source files and extracts docstrings
>   ;;; [etc]

Hmm, I'd probably just leave this one off since it's easily
accomplished via:

  cat $(guile-config --script-location doc-snarf)

and probably won't be needed very often.

-- 
Rob Browning <address@hidden> PGP=E80E0D04F521A094 532B97F5D64E3930