Wie kann ich die Sortierreihenfolge in Roxygen2 angeben?

8

Die roxygen2-Dokumentation mit devtools verwenden document function generiert automatisch ein Collate: -Feld im Paket DESCRIPTION, unabhängig davon, ob die Paketbibliotheksdateien in einer bestimmten Reihenfolge geladen werden müssen oder nicht.

Ich arbeite an einem Paket mit einer Reihe von S4-Methoden und möchte sicher sein, dass die Klassendefinitionen geladen sind, bevor irgendwelche Methoden oder andere Klassen sie benutzen, was ich mit der Collate -Liste machen kann, aber ich bin mir nicht sicher, wie ich dies im roxygen2-Dokumentationsformat angeben soll.

Das roxygen2-Handbuch macht einen Verweis auf ein @include -Tag, das aber aussieht wie es könnte eigentlich nur Code in der Dokumentation enthalten, zum Beispiel externe Beispiele durch eine @examples -Flag hinzufügen. Kann dies zur Festlegung der Sortierreihenfolge für Methoden verwendet werden?

    
cboettig 31.08.2013, 02:53
quelle

2 Antworten

13

Das include-Tag wird verwendet, um anzugeben, dass eine Datei eine andere benötigt, um zu funktionieren. (Der Name include war vielleicht nicht die beste Wahl, aber so ist das Leben). Wenn Sie sicherstellen möchten, dass Datei B vor Datei A geladen wird, stellen Sie sicher, dass @include B in A angegeben ist. Roxygen wird darauf achten, dass das Sortierfeld Ihren Einschränkungen entspricht.

    
hadley 03.09.2013, 14:07
quelle
3

Ich habe gerade herausgefunden, dass wenn du die @ include-Anweisung oben in deiner R-Datei hinzufügst, sie den nächsten roxygen2-Dokumentationsblock stört, wenn du sie nicht mit einem NULL befolgst, zB

%Vor%     
THK 26.02.2014 18:56
quelle