2013-08-31 24 views
8

Sử dụng tài liệu roxygen2 với devtools document chức năng tự động tạo trường Collate: trong gói DESCRIPTION, bất kể có cần tải các tệp thư viện gói theo một thứ tự cụ thể hay không.Làm cách nào để chỉ ra thứ tự đối chiếu trong Roxygen2?

Tôi đang làm việc trên một gói với một loạt các phương pháp S4 và muốn chắc chắn các định nghĩa lớp được tải trước bất kỳ phương pháp hoặc các lớp khác sử dụng chúng, mà tôi hiểu tôi có thể làm với danh sách Collate, nhưng tôi ' m không chắc chắn làm thế nào để chỉ ra điều này trong định dạng tài liệu roxygen2.

roxygen2 manual làm cho một số tham chiếu đến thẻ @include nhưng có vẻ như thực sự chỉ bao gồm mã trong tài liệu, ví dụ: để thêm ví dụ bên ngoài thông qua cờ @examples. Điều này có thể được sử dụng để chỉ định thứ tự đối chiếu cho các phương thức không?

+0

Nếu đối chiếu trường đã có trong MÔ TẢ roxygen2 không tạo ra nó. Vì vậy, tôi muốn nói rằng bạn phải thực hiện theo thứ tự bạn muốn và cần được tôn trọng. (Tôi nghĩ vậy, vì vậy nhận xét so với câu trả lời). –

+0

nó sẽ là tốt đẹp để biết nếu giải thích @import của tôi là chính xác. Nó cũng chắc chắn sẽ là tốt đẹp để có một con số chức năng ra lệnh collate từ một danh sách các phụ thuộc tập tin hơn là phải làm việc nó ra bằng tay. Nhập khẩu – cboettig

+0

được sử dụng để nhập gói. Điều này tương tự như việc liệt kê một gói trong phần Phụ thuộc, ngoại trừ việc nó sạch hơn nhiều vì nó không gây ô nhiễm không gian tên của người dùng. – Dason

Trả lời

13

Thẻ bao gồm được sử dụng để nêu rõ rằng một tệp cần một tệp khác để hoạt động. (Tên bao gồm có thể không phải là lựa chọn tốt nhất, nhưng đó là cuộc sống). Nếu bạn muốn đảm bảo rằng tệp B được tải trước tệp A, thì hãy đảm bảo là @include B trong A. Roxygen sẽ xử lý việc sắp xếp trường đối chiếu để đáp ứng các hạn chế của bạn.

+0

rực rỡ, vì vậy hãy bao gồm những gì tôi cần! – cboettig

3

tôi chỉ ra rằng nếu bạn thêm các tuyên bố @include ở phía trên cùng của tập tin R của bạn, nó sẽ can thiệp với khối tài liệu roxygen2 tiếp theo trừ khi bạn làm theo nó với một NULL ví dụ

#' @include something.R 
NULL 

#' Documenting a function 
#' 
#" It does something... 
#' 
#' @param ... 
#' 
Các vấn đề liên quan