Deprecate old APIs in JSDoc

larsgw / citation.js

Citation.js converts formats like BibTeX, Wikidata JSON and ContentMine JSON to CSL-JSON to convert to other formats like APA, Vancouver and back to BibTeX.

https://citation.js.org/

MIT License

226 stars 30 forks source link

Deprecate old APIs in JSDoc #113

Closed larsgw closed 6 years ago

larsgw commented 6 years ago

I left some old APIs in the code (mainly in the parsing area) that could at least be marked @deprecated in the API docs.

larsgw commented 6 years ago

Deprecating the @borrows methods seems impossible:

https://github.com/larsgw/citation.js/blob/6852eb3b01bd289bc8153e3766e4e715434fe8da/src/parse/input/index.js#L5-L11
https://github.com/larsgw/citation.js/blob/6852eb3b01bd289bc8153e3766e4e715434fe8da/src/parse/input/async/index.js#L5

I could possibly try to deprecate the entire namespace.