# Document Future, at least a stub?

**URL:** <https://discourse.julialang.org/t/document-future-at-least-a-stub/23133>\
**Category:** Internals & Design\
**Tags:** question\
**Created:** [April 14, 2019, 8:26am UTC](https://discourse.julialang.org/t/document-future-at-least-a-stub/23133 "2019-04-14T08:26:52Z")\
**Posts on this page:** 3\
**Page:** 1

<div class="post-metadata">

**Author:** ![Tamas\_Papp](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/tamas_papp/32/25949_2.png) [@Tamas\_Papp](https://discourse.julialang.org/u/Tamas_Papp)\
**Post date:** [April 14, 2019, 8:26am UTC](https://discourse.julialang.org/t/document-future-at-least-a-stub/23133/1 "2019-04-14T08:26:52Z")

</div>

I could not find an issue about this, so I thought I would first ask here.

Various docstrings in `Base` and the standard libraries mention [Future](https://github.com/JuliaStdlibs/Future.jl/blob/b8a960ac8a7c6b366229a621612d68496fef59f6/src/Future.jl), which has no docs in the manual that I could find.

The module is documented as

> The `Future` module implements future behavior of already existing functions, which will replace the current version in a future release of Julia.

which I guess is sufficient, but wouldn’t it make sense to have at least a small page for it in the manual? Otherwise, encountering `Future` in docstrings is somewhat confusing.

---

<div class="post-metadata">

**Author:** ![fredrikekre](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/fredrikekre/32/1688_2.png) [@fredrikekre](https://discourse.julialang.org/u/fredrikekre)\
**Post date:** [April 14, 2019, 9:39am UTC](https://discourse.julialang.org/t/document-future-at-least-a-stub/23133/2 "2019-04-14T09:39:39Z")

</div>

Yes, probably just an oversight.

---

<div class="post-metadata">

**Author:** ![Tamas\_Papp](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/tamas_papp/32/25949_2.png) [@Tamas\_Papp](https://discourse.julialang.org/u/Tamas_Papp)\
**Post date:** [April 14, 2019, 11:50am UTC](https://discourse.julialang.org/t/document-future-at-least-a-stub/23133/3 "2019-04-14T11:50:56Z")

</div>

Thanks, made a PR:

[https://github.com/JuliaLang/julia/pull/31720](https://github.com/JuliaLang/julia/pull/31720)