Jakie nowe funkcje są (lub będą) dodane do Scaladoc w Scali 2.10?

Question

Spośród wszystkich różnych niekompletnych list funkcji wchodzących w Scala 2.10, istnieją różne wzmianki o udoskonaleniach Scaladoc. Ale nie jest jasne, które z nich istnieją, a które faktycznie wchodzą - np. jedna z list ulepszeń mówi "poprawki do Scaladoc" z linkami do różnych żądań ściągania, z których niektóre zostały odrzucone.

Czy ktoś może podsumować, co właściwie zmieniło się między Scala 2.9 a 2.10 krokiem milowym 4 i może wskazać, co jeszcze zaplanowano dla wersji 2.10?

Czy są one również ostatecznie będzie naprawić problem braku możliwości połączenia z metodami? Na przykład. pełno w całym moim kodu mam rzeczy tak:

/** 
* Reverse the encoding computed using `encode_ngram`. 
*/ 
def decode_ngram(ngram: String): Iterable[String] = { 
    DistDocument.decode_ngram_for_counts_field(ngram) 
} 

gdzie chcę odnieść się do innej metody w tej samej klasie, ale AFAIK tam po prostu nie da się zrobić. IMO powinno być czymś oczywistym, na przykład: [[encode_ngram]] - tzn. Zdecydowanie nie powinienem podawać absolutnej klasy (co spowodowałoby, że wszystko się rozpadnie, gdy tylko wyciągnę klasę i wsadzę ją gdzieś indziej), i nie powinienem podać typy parametrów, jeśli sama nazwa metody jest jednoznaczna (tj. nie-polimorficzna).

Answer 1

Nadchodzi kilka nowych funkcji, a także wiele poprawek, ale nie ma jeszcze definitywnej listy wszystkich poprawek, które są dostępne. Spośród ważniejszych nowych funkcji:

• Pośrednio dodani członkowie będą teraz widoczne. Dobrym przykładem jest spojrzenie na scala.Array, gdzie metody takie jak map, które mogłeś założyć, że masz, są teraz widoczne w Scaladoc.
• Automatycznie generowane diagramy dziedziczenia SVG, dla widoku relacji między klasami/cechami/obiektami na poziomie pakietu, a następnie na poziomie poszczególnych klas itp. Na przykład, zobacz diagramy Scaladoc co noc zarówno package-level (kliknij "Hierarchia treści"), jak również na class-level.
• Łączenie metod w niektórych ograniczonej formie powinno być przejść do wersji 2.10 (nie w nocnej jeszcze). (W rzeczywistości nie jest to całkiem banalne, jak można to zauważyć).
• Ulepszone przypadki użycia Członek z przypadkiem użycia nie jest już podwójnie generowany, a oni teraz nieco jaśniejsze i prostsze niż wcześniej.
• (Mniej zauważalną) skróty klawiaturowe do nawigacji Scaladoc zostały dodane, są one wyjaśnione here i here

Dla bardziej wyczerpującej listy poprawek, to może być dobry pomysł, aby napisać do Scala -wewnętrzne-- jest spora szansa, że ​​ktoś sporządzi listę wszystkich poważnych poprawek w ubiegłym roku dla ciebie.