.\" Man page generated from reStructuredText.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.TH "CTAGS-LANG-I18NRUBGEM" 7 "" "6.1.0" "Universal Ctags"
.SH NAME
ctags-lang-i18nrubgem \- Random notes about tagging input for I18n Ruby Gem with Universal Ctags
.SH SYNOPSIS
.nf
\fBctags\fP ... \-\-extras=+s \-\-languages=+I18nRubyGem ...
\fBctags\fP ... \-\-extras=+s \-\-language\-force=I18nRubyGem ...
\fBctags\fP ... \-\-extras=+s \-\-map\-I18nRubyGem=+.yaml ...
\fBctags\fP ... \-\-extras=+s \-\-map\-I18nRubyGem=+.yml ...
.fi
.sp
.SH DESCRIPTION
.sp
This man page gathers random notes about tagging input for I18n Ruby
Gem [RUBYI18N]\&. I18nRubyGem is a subparser running on Yaml parser. If a
top\-level scalar token of a given Yaml source input is a local name [ISOCODES],
I18nRubyGem activates itself. If not, I18nRubyGem does nothing.
.sp
\(dqinput.yaml\(dq
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
\-\-\-
ja:
  msg:
    error: エラー
    function: 関数
.ft P
.fi
.UNINDENT
.UNINDENT
.sp
\(dqoutput.tags\(dq
with \(dq\-\-options=NONE \-o \- \-\-fields=+E input.yaml\(dq
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
error   input.yaml      /^    error: エラー$/;\(dq    k       keyInMiddle:ja.msg      extras:subparser
function        input.yaml      /^    function: 関数$/;\(dq  k       keyInMiddle:ja.msg      extras:subparser
ja.msg.error    input.yaml      /^    error: エラー$/;\(dq    k       keyInMiddle:ja.msg      extras:subparser,localeful
ja.msg.function input.yaml      /^    function: 関数$/;\(dq  k       keyInMiddle:ja.msg      extras:subparser,localeful
msg.error       input.yaml      /^    error: エラー$/;\(dq    k       locale:ja       extras:subparser,localeless
msg.function    input.yaml      /^    function: 関数$/;\(dq  k       locale:ja       extras:subparser,localeless
.ft P
.fi
.UNINDENT
.UNINDENT
.sp
With the options, the parser emits three tag entries for a key:
\(dqerror\(dq, \(dqjs.msg.error\(dq, and \(dqmsg.error\(dq for the key \(dqerror\(dq, The
parser emits \(dqerror\(dq at the first line always.
.sp
To emit \(dqja.msg.error\(dq, a \fBlocaleful\fP extra tag, at the fifth line
always. If you specify \fB\-\-extra=+q\fP or \fB\-\-extra=+{qualified}\fP,
ctags emits the same tag twice: a \fBlocaleful\fP tag, and a \fBqualified\fP tag.
You can suppress the \fBlocaleful\fP extra tags., specify
\fB\-\-extras\-I18nRubyGem=\-{localeful}\fP\&.
.sp
To emit \(dqmsg.error\(dq, a \fBlocaleless\fP extra tag, at the fifth line
always. The parser creates a \fBlocaleless\fP extra tag by truncating
the first component (e.g. \(dqja.\(dq) from the associated full qualified
extra tag (e.g. \(dqja.msg.error\(dq).  \fBlocaleless\fP extra is enabled by
default. If you don\(aqt need \fBlocaleless\fP extra tags, specify
\fB\-\-extras\-I18nRubyGem=\-{localeless}\fP\&.
.sp
The parser doesn\(aqt make tag entries for top\-level and mid\-level components like
\fBja\fP and \fBmsg\fP by default. If you need them, specify
\fB\-\-kinds\-I18nRubyGem=+{locale}\fP and/or
\fB\-\-kinds\-I18nRubyGem=+{keyInMiddle}\fP\&.
.SH KNOWN BUGS
.sp
The mechanism activating I18nRubyGem subparser doesn\(aqt work well for YAML
source input containing multiple documents.
.SH SEE ALSO
.sp
ctags(1)
.SH REFERENCES
.IP [RUBYI18N] 5
Ruby I18n, \fI\%https://github.com/ruby\-i18n/i18n\fP
.IP [ISOCODES] 5
iso\-codes, \fI\%https://salsa.debian.org/iso\-codes\-team/iso\-codes\fP
.\" Generated by docutils manpage writer.
.