What should be in the {r2eng} dictionary?

[matt-dray]

What R symbols map to English translations? What are those translations? Please add comments with ideas to expand this list.

r	eng
<-	gets
->	into
=	is
%>%	then
%in%	matches
|	or
!	not
?	search help for
~	by
(	open parenthesis
)	close parenthesis
[	open square bracket
]	close square bracket
{	open curly brace
}	close curly brace

See gram.y file, cmd+F 'YYENGLISH 8'.

[mattkerlogue]

Suggest _ is translated as score rather than underscore to reduce length of snake case variable names. Maybe with an optional long or full argument to provide underscore if desired by the user.

[mattkerlogue]

Suggest common format for describing brackets/braces, and/or GB/US options.

r	common/GB	US
(	open round bracket	open paren(thesis)
)	close round bracket	close paren(thesis)
[	open square bracket	open square bracket
[	close square bracket	close square bracket
{	open curly bracket	open (curly) brace
}	close curly bracket	open (curly) brace

Parenthesis and (curly) brace might not be terms everyone is familiar with, especially those with English as a second language.

[mattkerlogue]

Is .: "dot", "period", "point", "decimal point".

[mattkerlogue]

Is !! "bang-bang" or "double exclamation". Or something else.

[mattkerlogue]

Is {{ "(open) curly-curly", "(open) curly hug" or "open double curly (brackets)". With }} being "close…".

[mattkerlogue]

As [[ is a special operator perhaps needs to not be "open double square brackets", could be "open list select".

[matt-dray]

:: and :::?

package::x is 'package exported function x'? package:::y is 'package unexported function y'?

[mattkerlogue]

Suggest x::y as "x package function y", x:::y "x package internal function y" … unless you're an r-dev you're less likely to need to know that functions are exported or internal.

[matt-dray]

Backticks, single and double quotes.

[matt-dray]

:= ('walrus') as in DT[, col := val] parsed as LEFT_ASSIGN. Prefer 'set'?

[matt-dray]

• token GT, text >, eng 'greater than'
• token LT, text <, eng 'less than'
• token GE, text >=, eng 'greater than or equal to'
• token LE, text <=, eng 'less than or equal to'

[matt-dray]

As per @mattkerlogue conversation, :: isn't always used for functions, of course. Could be package::object. It currently reads as 'x package function y' in {r2eng}. Maybe a case for looking ahead to see if it's a function or object before assigning :: its English translation.

[mattkerlogue]

As per @mattkerlogue conversation, :: isn't always used for functions, of course. Could be package::object. It currently reads as 'x package function y' in {r2eng}. Maybe a case for looking ahead to see if it's a function or object before assigning :: its English translation.

Should be relatively easy to look ahead see if it's any function by using a regex detect for \\(.*\\)$. Also applies to ::: (I have non function internal objects in a couple of packages).