% Encoding: UTF-8

@entry{entrytype,
  name={entry type},
  description={an entry's identifying type, as specified by \atentryfmt{entry-type}.
  (Not to be confused with the glossary label, which is identified by 
  the \field{type} field.) When referenced in a resource option, the 
  leading \code{@} is typically omitted. The \emph{original} entry type
  refers to the entry type as specified in the \ext{bib} file. The
  \emph{actual} entry type may be different and will be the result 
  of a conversion via resource options such as \csopt{entry-type-aliases}.
  Although the \ext{bib} format is case-insensitive, references to the 
  entry type in resource options should typically be in \idx{lowercase}.}
}

@entry{primaryentry,
  name={primary entry},
  plural={primary entries},
  user1={idx.primary},
  description={The original entry created from a dual-\gls{entrytype}
   (such as \atentry{dualentry}) or the entry from 
   single-\glspl{entrytype} (such as \atentry{entry}) or \glspl{spawnedentry}.}
}

@entry{dualentry,
  name={dual entry},
  plural={dual entries},
  user1={idx.dual},
  description={The duplicate entry created from a dual-\gls{entrytype}
   (such as \atentry{dualentry}). This duplicate is based on the
   \gls{primaryentry} with modifications made according to various
   settings. With tertiary \glspl{entrytype}, the dual entry represents 
   two entries: the \glsdisp{secondaryentry}{secondary} and
   \glsdisp{tertiaryentry}{tertiary}.
   See \sectionref{sec:dualentry}.}
}

@entry{secondaryentry,
  name={secondary entry},
  plural={secondary entries},
  user1={idx.secondary},
  description={For the tertiary \glspl{entrytype}, such as
  \atentry{tertiaryindexabbreviationentry}, there are only actually
  two objects defined within \bibgls: the 
  \glsdisp{primaryentry}{primary} and the \glsdisp{dualentry}{dual},
  but the code that is written in the \ext{glstex} file for the 
  \gls{dualentry} actually defines two entries, which are the 
  secondary and tertiary entries.
  This should not be confused with the \gls{secondaryglossary}.
  See \sectionref{sec:tertiaryentry}.}
}

@entry{tertiaryentry,
  name={tertiary entry},
  plural={tertiary entries},
  user1={idx.tertiary},
  description={An entry that isn't defined as a separated object
  within \bibgls, but is defined within the \ext{glstex} file 
  as a by-product of the dual definition code for tertiary
  \glspl{entrytype}.}
}

@entry{mainentry,
  name={main entry},
  plural={main entries},
  description={The originating entry from which
   the \glspl{spawnedentry} are created. A main entry may 
   be a dual-\gls{entrytype}, consisting of a \gls{primaryentry}
   and \gls{dualentry}.
   (Not to be confused with the main glossary or the \gls{compmainlabel}
    of a \gls{compoundentry}.)}
}

@entry{progenitor,
  name={progenitor},
  user1={idx.progenitor},
  description={The \gls{mainentry} for the \atentry{progenitor}
  \gls{entrytype}.}
}

@entry{progeny,
  name={progeny},
  user1={idx.progeny},
  description={The \glspl{spawnedentry} for the \atentry{progenitor}
  \gls{entrytype}.}
}

@entry{multientrytype,
  name={multi-entry type},
  description={An \gls{entrytype} that can spawn multiple
   \glspl{primaryentry}. Some multi-\glspl{entrytype} can also spawn a
   \gls{dualentry}. See \sectionref{sec:multientry}. 
   For the \sty{glossaries-extra} \qt{multi (compound or combined) entries} 
   that are defined with \cs{multiglossaryentry} see \gls{compoundentry}.}
}

@entry{spawnedentry,
  name={spawned entry},
  plural={spawned entries},
  description={A duplicate entry created from a \gls{multientrytype}
   (such as \atentry{spawnentry}).}
}

@entry{principallocation,
  name={principal (or primary) location},
  text={principal location},
  description={A special \gls{location} (\gls{record}) which indicates the principal 
   or primary place in the document where the entry is mentioned
   or discussed. The \gls{location} is identified by the principal or
   primary format (\csopt{principal-location-formats}).}
}

@entry{mainglossary,
  name={main glossary},
  description={The default glossary in the document identified by
   \cs{glsdefaulttype} (which will have the label \code{main} unless
   \styopt{nomain} is used). If \styopt{nomain} is used then 
   \cs{glsdefaulttype} will be set to the label of the first glossary 
   to be defined.}
}

@entry{mainlist,
  name={main (or primary) list},
  text={main list},
  description={The \bibgls\ list of \glspl{primaryentry}, which is sorted
  according to the \csopt{sort} resource option. The entries may or
  may not be assigned to the same glossary, and the list may only be
  a subset of entries. If \csopt[combine]{dual-sort} is used, then
  the main list will also contain all the \glspl{dualentry}.}
}

@entry{duallist,
  name={dual list},
  description={The \bibgls\ list of \glspl{dualentry}, which is sorted
  according to the \csopt{dual-sort} resource option. The entries may or
  may not be assigned to the same glossary, and the list may only be
  a subset of entries. If \csopt[combine]{dual-sort} is used then
  all entries will be in the \gls{mainlist} and there won't be a dual
  list.}
}

@entry{primaryglossary,
  name={primary (or principal) glossary},
  text={primary glossary},
  plural={primary glossaries},
  description={A glossary that contains entries that have the \field{type}
   field set to that glossary's label. Note that a primary glossary
   may contain both \glsdisp{primaryentry}{primary} and
   \glspl{dualentry}.}
}

@entry{secondaryglossary,
  name={secondary glossary},
  plural={secondary glossaries},
  description={A secondary glossary is one that contains labels of
   entries that have been defined for another glossary. The actual
   entry's \field{type} field will be set to the 
   \gls{primaryglossary}.}
}

@entry{record,
  name={record},
  description={Recording is \bibgls's equivalent of indexing. 
  When the \styopt{record} package option is set, each
  time an entry is indexed in the document (using commands like
  \cs{gls} or \cs{glstext}) a record is added to the \ext{aux}
  file that makes a note of the entry label, the location, the
  counter that was used to obtain the \gls{location}, and (optionally)
  hyperlink information. A record may be \glsdisp{ignoredrecord}{ignored} 
  or \glsdisp{discardedrecord}{discarded} but, regardless of this, 
  if an entry has at least one record it will be considered for selection 
  for any of the \qt{recorded} selection options.}
}

@entry{location,
 name={location},
 description={The value of the indexing counter when an entry is
 \glsdisp{record}{recorded}. By default, this is the \counter{page}
 counter. Each location has an associated format or \idx{encap},
 which is the name of a formatting command that should be used to
 encapsulate the location's value in the \gls{locationlist}.
 The default is \encap{glsnumberformat}.}
}

@entry{ignoredrecord,
  name={ignored record},
  user1={idx.ignoredrecord},
  description={A record with the format \encap{glsignore} or
  \encap{glstriggerrecordformat}. This record indicates that the 
  entry should be considered for selection
  with any of the \qt{recorded} selection options, but the record
  should not be added to the \gls{locationlist}.}
}

@entry{discardedrecord,
  name={discarded record},
  description={A record that is discarded because either it is
  identical to another record or it conflicts with another record.}
}

@entry{supplementalrecord,
  name={supplemental record},
  description={A record obtained from another document.
  See \sectionref{sec:supplementalopts}.}
}

@entry{supplementaldocument,
  name={supplemental (or supplementary) document},
  text={supplemental document},
  description={A related document from which
  \glspl{supplementalrecord} are obtained.}
}

@entry{maindocument,
  name={main document},
  description={The principal document that has its own glossary but
  the \glspl{locationlist} may also contain external
  \glspl{location} obtained from a \gls{supplementaldocument}.}
}

@entry{recordcount,
  name={record count},
  description={An entry's record count is the total number of records 
   (including \glsdisp{discardedrecord}{discarded} and
   \glsdisp{ignoredrecord}{ignored}) written to the \ext{aux} file
   that are associated with the entry. It's also possible to have 
   sub-totals for each record counter.}
}

@entry{recordedentry,
  name={recorded entry},
  plural={recorded entries},
  description={An entry that has one or more \glspl{record}.}
}

@entry{unrecordedentry,
  name={unrecorded entry},
  plural={unrecorded entries},
  description={An entry that doesn't have any \glspl{record}.}
}

@entry{locationlist,
  name={location list},
  user1={idx.locationlist},
  description={Formatted list of \glspl{location} obtained from an entry's
  \glspl{record}. This won't include \glsdisp{ignoredrecord}{ignored}
  or \glsdisp{discardedrecord}{discarded} records, and a run of
  \glspl{location} may be compressed into a range. See
  \sectionref{sec:locationopts} and \sectionref{sec:loclistdefs}.}
}

@entry{parententry,
  name={parent entry},
  plural={parent entries},
  user1={idx.hierarchical-entry},
  description={An entry in a \gls{hierarchicalglossary}
   that is linked to, but one level up from, its associated
   \gls{childentry}. See \sectionref{sec:hierarchicalopts}.}
}

@entry{childentry,
  name={child entry},
  plural={child entries},
  user1={idx.hierarchical-entry},
  description={An entry in a \gls{hierarchicalglossary}
   that is linked to, but one level down from, its associated
   \gls{parententry}. See \sectionref{sec:hierarchicalopts}.}
}

@entry{sub-entry,
  name={sub-entry},
  plural={sub-entries},
  user1={idx.hierarchical-entry},
  description={A \gls{childentry}. More specifically, when
  contrasted with sub-sub-entry etc, this may refer to level~1 entries 
  (which have a \glsdisp{parententry}{parent} that is a
  \gls{top-levelentry}). See \sectionref{sec:hierarchicalopts}.}
}

@entry{hierarchicalglossary,
  name={hierarchical glossary},
  plural={hierarchical glossaries},
  user1={idx.hierarchical-entry},
  description={A glossary where the entries are ranked according to 
   some classification. Level~0 indicates \glspl{top-levelentry},
   level~1 indicates \glspl{childentry} that have a
   level~0 \glsdisp{parententry}{parent}, level~2 indicates 
   \glspl{childentry} that have a
   level~1 \glsdisp{parententry}{parent}, and so on. See \sectionref{sec:hierarchicalopts}.}
}

@entry{flatglossary,
 name={flat glossary},
 description={A glossary that has no \glsdisp{hierarchicalglossary}{hierarchy}.
 That is, there are no \glspl{childentry}. See \sectionref{sec:hierarchicalopts}.}
}

@entry{sibling,
  name={sibling entry},
  text={sibling},
  description={Two or more \glspl{childentry} are siblings if
   they all share the same \gls{parententry}.
   See \sectionref{sec:hierarchicalopts}.}
}

@entry{lonelychildentry,
  name={lonely child entry},
  plural={lonely child entries},
  user1={idx.hierarchical-entry},
  description={A \gls{childentry} that has no selected \glspl{sibling}.
  See \sectionref{sec:hierarchicalopts}.}
}

@entry{ancestor,
  name={ancestor},
  user1={idx.hierarchical-entry},
  description={An entry's \glsdisp{parententry}{parent} or an ancestor of 
  the \glsdisp{parententry}{parent}.  See \sectionref{sec:hierarchicalopts}.}
}

@entry{top-levelentry,
  name={top-level entry},
  plural={top-level entries},
  user1={idx.hierarchical-entry},
  description={An entry that doesn't have a \gls{parententry}.
  This entry is the hierarchical root for all its descendents.
  See \sectionref{sec:hierarchicalopts}.}
}

@entry{masterdocument,
  name={master document},
  description={A main or principal document that contains a glossary
   with entries referenced by smaller documents that don't have their own
   glossary. See \sectionref{sec:master}.}
}

@entry{primarycollatorstrength,
  name={primary collator strength},
  description={A collator strength value that indicates only primary
   differences are considered significant during comparison.
   This is locale dependant, but typically different base letters
   are considered a primary difference.}
}

@entry{secondarycollatorstrength,
  name={secondary collator strength},
  description={A collator strength value that indicates only primary
  and secondary differences are considered significant during comparison.
  This is locale dependant. For example, in some languages different
  accented forms of the same base letter may be considered a
  secondary difference.}
}

@entry{tertiarycollatorstrength,
  name={tertiary collator strength},
  description={A collator strength value that indicates only
  primary, secondary and tertiary differences are considered
  significant during comparison. This is locale dependant. For
  example, different cases of the same base letter may be considered a
  tertiary difference.}
}

@entry{identicalcollatorstrength,
  name={identical collator strength},
  description={A collator strength value that indicates that all
  differences are considered significant during comparison.}
}

@entry{definitionindex,
  name={definition index},
  description={An index (starting from 0) that's incremented
  every time a new entry object is created within \bibgls.
  This relates to the order of definitions within the \ext{bib}
  files. Each \gls{dualentry} and \gls{spawnedentry} will increment
  the underlying counter but only when they are created, which
  may not happen until after all \ext{bib} files for the \gls{resourceset} have
  been parsed.}
}

@entry{orderofuseindex,
  name={order of use index},
  description={The \gls{record} index is a value (starting from 0) that's incremented
  every time a \gls{record} is created while parsing the \ext{aux} file.
  The first time a non-\gls{ignoredrecord} is added to a given entry, the 
  \gls{record} index is assigned to that entry's order of use index. So the 
  index provides a relative order of use. So if entry1 is the first entry
  to be indexed, it will have order of use index~0. If entry1 is
  then indexed twice more and then entry2 is indexed, then entry2's
  order of use index will be~3.}
}

@entry{resourceset,
  name={resource set},
  user1={idx.resourceset},
  description={The set of options and entries associated with a
   \gls{resourcecommand}. See \sectionref{sec:resourcesets}.}
}

@entry{resourcecommand,
  name={resource command},
  description={\gls{glsxtrresourcefile} or \gls{GlsXtrLoadResources}.}
}

@entry{resource-locale,
  name = {resource locale},
  user1={idx.locale-resource},
  description={the default locale for the given \gls{resourceset}.
  This can be set with the \csopt{locale} resource option. If not
  explicitly set, then the default will be the document language, if
  it has been detected by \sty{tracklang} or identified with
  \commonlongarg{locale}, or the \idx{JRE} locale otherwise.}
}

@entry{document-locale,
  name = {document locale},
  user1={idx.locale-doc},
  description={the locale associated with the document
  language (or by \commonlongarg{locale}, if no document language has been
  detected). In the case of a multi-lingual document, this
  is the locale of the last language resource file to be loaded through
  \isty{tracklang}'s interface. It's best to explicitly set the locale
  for multi-lingual documents to avoid confusion (either with
  the \csopt{locale} or as a language tag in options such as
  \csopt{sort}).}
}

@entry{Java-locale,
  name = {Java locale},
  user1={idx.locale-Java},
  description={the default locale for the \idx{JRE}, which usually
  matches the operating system's locale.}
}

@entry{crossresourceref,
  name={cross-resource reference},
  user1={idx.crossresourceref},
  description={A reference from a \gls{recordedentry} provided in
  one \gls{resourceset} to an \gls{unrecordedentry} in another
  \gls{resourceset}. See \sectionref{sec:resourcesets}.}
}

@entry{cross-referencefield,
 name={cross-reference field},
 description={A field used for cross-referencing another entry:
 \field{see}, \field{seealso} and \field{alias}.
 Other fields can be identified as a list of dependent entry labels
 with \csopt{dependency-fields}.}
}

@entry{ignoredglossary,
  name={ignored glossary},
  plural={ignored glossaries},
  user1={idx.ignoredglossary},
  description={A glossary defined with commands like
  \cs{newignoredglossary}. An ignored glossary doesn't have an
associated title (so if one is required it needs to be explicitly
set), and isn't picked up by iterative commands such as 
  \cs{printunsrtglossaries}. See \sectionref{sec:newglossary}.}
}

@entry{homograph,
  name={homograph},
  user1={idx.homograph},
  description={Each word in a set of words that all have the same
   spelling but different meanings. For example, lead (to guide
   someone) and lead (metallic element) are homographs.}
}

@entry{encoding,
  name={encoding},
  user1={idx.encoding},
  description={A text format that maps a byte or sequence of bytes
  to a character. See \sectionref{sec:bibencoding} and \csopt{charset}
  for the \ext{bib} file encoding, \longarg{tex-encoding} for the
  \ext{aux} and \ext{glstex} file encoding, and 
  \sectionref{sec:defencoding} for the default encoding.  See also the blog article
\href{https://dickimaw-books.com/blog/binary-files-text-files-and-file-encodings/}{Binary
Files, Text Files and File Encodings} for further information about
  file encodings in general.}
}

@entry{compoundentry,
   name={compound (combined or multi) entry},
   text={compound entry},
   plural={compound entries},
   description={A compound entry corresponds to the \ics{multiglossaryentry} 
   command. This defines a label that represents a set of entries that have 
   already been defined. This label can then be used in commands like \ics{mgls}
   as a shortcut for using \cs{gls} for each element in the set.
   The \gls{compmainlabel} is the main element in the set.
   The \qt{\glspl{compotherlabel}} are all the other (not-main) elements.
   See \sectionref{sec:compoundsetentry}.}
}

@entry{compmainlabel,
  name = {main label or element (compound entry)},
  text = {main label},
  description = {The main element in the set that defines a 
  \gls{compoundentry}.}
}

@entry{compotherlabel,
  name = {other label or element (compound entry)},
  text = {other label},
  description = {The non-\glslink{compmainlabel}{main} elements in the 
  set that defines a \gls{compoundentry}.}
}

@entry{regular-expression,
  name = {regular expression},
  user1={idx.regex},
  description={A pattern that specifies how to match text. Unless
  indicated otherwise, resource options that use regular expressions
  are \gls{anchored}. See
  \href{http://docs.oracle.com/javase/8/docs/api/java/util/regex/Pattern.html}{Java's
  Pattern class API}~\cite{pattern} for details of the regular
  expression syntax.}
}

@entry{anchored,
  name = {anchored (regular expression)},
  text={anchored},
  description={An anchored \gls{regular-expression} must match the entire
  string, not a sub-string. For example, \code{l\idx{regex.question}op} matches \qt{lop}
  and \qt{op} but doesn't match \qt{clop} or \qt{cop}.}
}

@entry{concatenation,
  name={concatenation},
  user1={idx.stringconcatenation},
  description={This is where multiple fragments or substrings are
  joined together to form a single value. The concatenation operator
  is \idx{stringconcat} for \ext{bib} files (see
  \sectionref{sec:bibstringconcat}) and \idx{concat-plus} for
  resource option string concatenation (\sectionref{sec:optstringconcat}).}
}

@entry{field-reference,
  name={field reference},
  user1={idx.field-reference},
  description={used in complex string concatenations (see
\sectionref{sec:optstringcont}) to reference field values}
}
