File: pd_get_relative_comment_associated_ids.Rd

package info (click to toggle)
r-cran-parsetools 0.1.3-3
  • links: PTS, VCS
  • area: main
  • in suites: bookworm
  • size: 780 kB
  • sloc: sh: 13; makefile: 2
file content (38 lines) | stat: -rw-r--r-- 1,129 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/pd_comments.R
\name{pd_get_relative_comment_associated_ids}
\alias{pd_get_relative_comment_associated_ids}
\title{Associate relative documentation comments}
\usage{
pd_get_relative_comment_associated_ids(id, pd, .check = TRUE)
}
\arguments{
\item{id}{id of the expression of interest}

\item{pd}{The \code{\link{parse-data}} information}

\item{.check}{Perform checks for input validation?}
}
\value{
Returns a vector of the same length as id.  Where the value is
either the id of the associated object or NA if it cannot be
associated.
}
\description{
Relative comment created with \code{\#\<} comment tags document something
designated by the location of the comment.
In general, the comment documents the previous symbol.
A comment will not be associated with any parse id that does not have
the same parent as the comment. For example,
}
\details{
\preformatted{function(x #< a valid comment
        )\{\}
}

would associate \code{a valid comment} with \code{x}, but\preformatted{function(x)\{ #< not a valid comment
           \}
}

would not.
}