Tài liệu Inline Gói Pl/SQL

Question

Tôi đang cố gắng viết đầy đủ hơn các gói cơ sở dữ liệu của mình như một API. Những gì chúng tôi muốn là một cái gì đó giống như JavaDocs cho PL/SQL. Tôi đã thấy một vài công cụ hiện có (pldoc, plsqldoc) nhưng muốn biết từ những người sử dụng chúng như thế nào họ so sánh.

Answer 1

Tôi đã sử dụng PlDoc và thấy nó thực sự tốt. Tôi đã không sử dụng bất kỳ công cụ khác để không thể so sánh. Tôi thấy PlDoc đã làm rất tốt. Tôi muốn có một số tính năng nâng cao hơn vì vậy tôi đã xây dựng công cụ của riêng mình đã thêm phần mở rộng vào PlDoc cho nhiều thẻ hơn. Ngoài ra tôi không chỉ làm tài liệu với nó, tôi cũng tạo ra các tiêu đề gói của chúng tôi bằng cách sử dụng một số thẻ PlDoc (ví dụ: @private).

Tôi khuyên bạn nên thử PlDoc sau đó chỉnh sửa mọi thứ không đáp ứng nhu cầu của bạn. Nó không mất nhiều thời gian để thiết lập nên nó không phải là một đầu tư thời gian rất lớn để thử nó.

Answer 2

Tôi đã sử dụng NaturalDocs trong một vài năm và thấy dễ cài đặt và sử dụng. Nó khá giống JavaDocs và hỗ trợ nhiều ngôn ngữ mặc dù tôi chỉ sử dụng nó với PL/SQL. Rất cấu hình mặc dù tôi không tìm thấy nó cần thiết để fiddle với điều đó.