Elixir 1.3.0: Brak dokumentacji String.strip/1 i String.strip/2 API.

Question

Wydaje się, że Elixir 1.3.0 nie pokazuje już dokumentację String.strip/1 i String.strip/2:

iex(1)> h String.strip 
No documentation for String.strip was found 

ich brakuje również w obecnej dokumentacji online (v1.3, Mistrzu, stabilna), ale funkcje są nadal uznawane przez kompilator:

iex(2)> String.strip(" Hallo, World! ") 
"Hallo, World!" 

Więc zastanawiam się, czy jest to po prostu błąd w dokumentacji String, czy funkcje te staną się przestarzałe. Nie mogę znaleźć lepszego wyszukiwania informacji.

Answer 1

Te funkcje zostały uznane za przestarzałe. Oznacza to, że zostały oznaczone jako @doc false. Obecnie plan jest deprecate with warnings by 1.5.

https://github.com/elixir-lang/elixir/blob/v1.3/CHANGELOG.md#3-soft-deprecations-no-warnings-emitted

[String] mylące String.strip/2 String.lstrip/2 String.rstrip/2 API została lekko zastąpiona String.trim/2 String.trim_leading/2 i String.trim_trailing/2