Có hệ thống tạo tài liệu tương tự như Javadoc, cho C++ không? Javadoc tạo ra kết quả tốt đẹp; Nó sẽ là tuyệt vời nếu bạn có thể sử dụng một cái gì đó giống như nó trong các ngôn ngữ khác.Tài liệu giống Javadoc cho C++
Có một số công cụ mà làm việc như javadoc cho C++ Công cụ phổ biến nhất có lẽ là Doxygen. Nó có thể xử lý các nhận xét giống như JavaDoc và cũng có một số ngôn ngữ (ví dụ: C++, C, Java, Mục tiêu-C, Python, PHP, C#). Nó có hỗ trợ khá tốt cho việc tinh chỉnh kiểu dáng của đầu ra HTML bằng cách sử dụng CSS (xem users list cho các tài liệu ví dụ).
Hai vấn đề quan trọng khi lựa chọn hệ thống tài liệu là để đảm bảo rằng nó cho phép bạn
Trải nghiệm của chúng tôi với doxygen là việc thiết lập và sử dụng khá dễ dàng và kết quả đầu ra khá dễ tinh chỉnh. Thật không may, doxygen không phải là hoàn hảo, vì vậy trong một số trường hợp nó là cần thiết để làm việc xung quanh quirks hoặc lỗi nơi phân tích cú pháp doxygen phá vỡ. Hãy chắc chắn kiểm tra tất cả các tài liệu được tạo của bạn một cách cẩn thận.
Có Doxygen
Ngoài ra còn có qdoc cho các dự án dựa trên C + QT. http://doc-snapshot.qt-project.org/qdoc
Tôi chỉ mới bắt đầu sử dụng Sphinx cho các dự án Python của mình. Trang chủ của nó nói "C/C++ cũng đã được hỗ trợ".
Nó sử dụng đánh dấu nhẹ được gọi là "reStructuredText".
Tôi vừa mới bắt đầu sử dụng nó cho các dự án Python của mình và giống như giao diện đầu ra rất nhiều.
Liên quan đến việc phân tích cú pháp, tôi đã tìm thấy các vấn đề của tôi dường như đã được khắc phục kể từ khi chuyển sang sử dụng nhận xét XML, nhưng sau đó lại không hỗ trợ nhiều trình soạn thảo và IDE. –