generate function signature listing from markdown (stan-functions.txt)

[mitzimorris]

Summary:

Generate a listing of functions signatures from the documentation for use with RStan and Stan emacs mode via a python script (roughly) along the lines of existing build scripts add_redirects.py, link_to_latest.py.

Description:

The index of the functions reference pdf was used as the basis of the file stan-functions.txt; when moving to markdown, html comment tags were added which captured the equivalent information in the markdown files, e.g.:

> grep '<!-- ' src/functions-reference/covariance_matrix_distributions.Rmd 
<!-- real; wishart ~; -->
<!-- real; wishart_lpdf; (matrix W | real nu, matrix Sigma); -->
<!-- matrix; wishart_rng; (real nu, matrix Sigma); -->
<!-- real; inv_wishart ~; -->
<!-- real; inv_wishart_lpdf; (matrix W | real nu, matrix Sigma); -->
<!-- matrix; inv_wishart_rng; (real nu, matrix Sigma); -->

Additional Information:

Soliciting input as to most useful file format from community via Discourse.

Current Version:

v2.18.0

[mitzimorris]

@bgoodri - would prefer to do this instead of #128 - is this OK with you?

[bgoodri]

I think so

…

On Mon, Apr 27, 2020 at 5:19 PM Mitzi Morris ***@***.***> wrote: @bgoodri <https://github.com/bgoodri> - would prefer to do this instead of #128 <#128> - is this OK with you? — You are receiving this because you were mentioned. Reply to this email directly, view it on GitHub <#179 (comment)>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/AAZ2XKX4SEPPOUI6HS5AANLROXZHDANCNFSM4MSIVLWQ> .

[WardBrian]

This was resolved by #180