Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

document frontmatter in help page #41

Merged
merged 1 commit into from Oct 25, 2017
Merged

Conversation

@eddelbuettel
Copy link
Owner

@eddelbuettel eddelbuettel commented Oct 25, 2017

In linl we added documentation for the frontmatter in the Rd which seems like a good idea. So ditto here.

Minor cleanup to skeleton.Rd as well.

#' options, or any of the following options (which are shown in alphabetical order) in the
#' document metadata:
#'
#' \describe{

This comment has been minimized.

@coatless

coatless Oct 25, 2017
Collaborator

Have you tried roxygen2 with Markdown enabled yet?

https://cran.r-project.org/web/packages/roxygen2/vignettes/markdown.html#lists

Support exists for both enumerate and itemize lists. I manually recreate the describe list format by modifying the itemize list to mimic it using embedded segments. e.g.

#' - `code`
#'     - description

This comment has been minimized.

@eddelbuettel

eddelbuettel Oct 25, 2017
Author Owner

I happen to dislike what it requires in DESCRIPTION.

This comment has been minimized.

@coatless

coatless Oct 25, 2017
Collaborator

Aye, 'tis not a pretty sight; but, we can manually enable it on a per-chunk basis via:

#' @md

This comment has been minimized.

@coatless

coatless Oct 25, 2017
Collaborator

With that being said, I'm fine with using the traditional latex markup.

@eddelbuettel eddelbuettel merged commit fb942ec into master Oct 25, 2017
2 checks passed
2 checks passed
continuous-integration/travis-ci/pr The Travis CI build passed
Details
continuous-integration/travis-ci/push The Travis CI build passed
Details
@eddelbuettel eddelbuettel deleted the feature/document_options branch Nov 6, 2017
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Linked issues

Successfully merging this pull request may close these issues.

None yet

2 participants
You can’t perform that action at this time.