Tính năng mới nào (hoặc sẽ được) thêm vào Scaladoc trong Scala 2.10?

Question

Trong số tất cả các danh sách tính năng không đầy đủ khác nhau đi vào Scala 2.10, có nhiều đề cập về cải tiến đối với Scaladoc. Nhưng không rõ ai đang ở đó, và cái nào đang thực sự đi vào - ví dụ một trong những danh sách các cải tiến cho biết "sửa chữa Scaladoc" với các liên kết đến các yêu cầu kéo khác nhau, một số trong số đó đã bị từ chối.

Bất cứ ai có thể tóm tắt những gì thực sự thay đổi giữa Scala 2.9 và 2.10 mốc 4, và có thể chỉ ra những gì khác được lên kế hoạch cho 2,10 chính nó?

Ngoài ra, họ có cuối cùng là sẽ khắc phục sự cố không thể liên kết với phương pháp không? Ví dụ. rải rác khắp mã của tôi tôi có những thứ như thế này:

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

nơi mà tôi muốn đề cập đến một phương pháp khác trong cùng một lớp, nhưng AFAIK không chỉ đơn giản là không có cách nào để làm điều đó. IMO nó phải là một cái gì đó rõ ràng như [[encode_ngram]] - tức là tôi chắc chắn không cần phải cung cấp cho một lớp tuyệt đối (mà sẽ làm cho tất cả mọi thứ phá vỡ ngay khi tôi kéo ra một lớp và dính nó ở một nơi khác), và tôi không cần phải cung cấp các kiểu tham số nếu tên của phương thức đó không rõ ràng (nghĩa là không đa hình).

Answer 1

Một số tính năng mới, cũng như nhiều sửa lỗi đang đến, nhưng không có danh sách dứt khoát của tất cả các bản sửa lỗi đang được nêu ra. Trong số các tính năng mới đáng chú ý hơn:

• thành viên Mặc nhiên thêm giờ sẽ hiển thị. Một ví dụ tốt là xem scala.Array, nơi các phương pháp như map mà bạn có thể đã giả định rằng bạn hiện có thể nhìn thấy trong Scaladoc.
• Biểu đồ kế thừa SVG được tạo tự động, để xem mắt các mối quan hệ giữa các lớp/đặc điểm/đối tượng ở cấp gói và sau đó ở cấp độ riêng lẻ. Ví dụ: xem sơ đồ Scaladoc hàng đêm cả hai số package-level (nhấp vào "Phân cấp nội dung") cũng như tại số class-level.
• Liên kết phương pháp ở một số hình thức giới hạn nên chuyển thành 2.10 (không phải trong đêm). (Nó thực sự không hoàn toàn tầm thường để thực hiện dưới hình thức hoàn chỉnh của nó, do những thứ thực tế như quá tải, như bạn đã lưu ý.)
• Trường hợp sử dụng được cải thiện Thành viên có trường hợp sử dụng không được tạo ra gấp đôi nữa, và bây giờ hơi rõ ràng và đơn giản hơn trước.
• (Ít-đáng chú ý) Phím tắt để điều hướng Scaladoc đã được thêm vào, họ đang giải thích here và here

Đối với một danh sách đầy đủ hơn về sửa lỗi, nó có thể là một ý tưởng tốt để viết thư cho scala -internals-- có một cơ hội tốt để ai đó biên dịch danh sách tất cả các sửa lỗi lớn trong năm qua cho bạn ở đó.