taf.roxygenise: Process a TAF repo with the taf roclet

View source: R/taf.roxygenise.R

taf.roxygeniseR Documentation

Process a TAF repo with the taf roclet

Description

This function builds documentation for a TAF repository using roxygen syntax headers. It depends on the roxygen2 package adding some extra functionality to produce citation entries for data sources

Usage

taf.roxygenise(path = ".", files)

Arguments

path

location of taf repository top level directory. Default is working directory.

files

a vector of file names to parse for documentation.

Examples

## Not run: 

# Create boot folder
mkdir("boot")

# Create boot script, boot/mydata.R
draft.data.script(name="mydata", title="Title", description="Description",
                  format="txt", originator="Me", year="2022",
                  period=c(2000,2020), access="Public",
                  content='write(pi, file="pi.txt")')

# Create metadata, boot/DATA.bib
taf.roxygenise(files="mydata.R")

# Run boot script, creating boot/data/mydata/pi.txt
taf.boot()

## End(Not run)


ices-tools-prod/icesTAF documentation built on March 23, 2023, 3:20 p.m.