Provided by: biber_1.8-1_all bug

NAME

       Biber::Config - Configuration items which need to be saved across the
                       lifetime of a Biber object

         This class contains a static object and static methods to access
         configuration and state data. There are several classes of data in here
         which have separate accessors:

         * Biber options
         * Biblatex options
         * State information used by Biber as it processes entries
         * displaymode date

   _init
           Reset internal hashes to defaults.

   _initopts
           Initialise default options, optionally with config file as argument

   config_file
       Returns the full path of the Biber configuration file.  If returns the first file found
       among:

       •   "biber.conf" in the current directory

       •   "$HOME/.biber.conf"

       •   "$ENV{XDG_CONFIG_HOME}/biber/biber.conf"

       •   "$HOME/Library/biber/biber.conf" (Mac OSX only)

       •   "$ENV{APPDATA}/biber.conf" (Windows only)

       •   the output of "kpsewhich biber.conf" (if available on the system).

       If no file is found, it returns "undef".

   get_unul_done
           Return a boolean saying whether uniquenename+uniquelist processing is finished

   set_unul_changed
           Set a boolean saying whether uniquename+uniquelist has changed

   postprocess_biber_opts
           Place to postprocess biber options when they have been
           gathered from all the possible places that set them

   set_dm
           Sets the data model information object

   get_dm
           Gets the data model information object

   set_ctrlfile_path
           Stores the path to the control file

   get_ctrlfile_path
           Retrieved the path to the control file

   setoption
           Store a Biber config option

   getoption
           Get a Biber option

   setcmdlineoption
           Store a Biber command-line option

   setconfigfileoption
           Store a Biber config-file option

   iscmdlineoption
           Check if an option is explicitly set by user on the command
           line

   isconfigfileoption
           Check if an option is explicitly set by user in their
           config file

   isexplicitoption
           Check if an option is explicitly set by user on the command
           line or in the config file

   setblxoption
           Set a biblatex option on the appropriate scope

   getblxoption
           Get a biblatex option from the global or per entry-type scope

           getblxoption('option', ['entrytype'], ['citekey'])

           Returns the value of option. In order of decreasing preference, returns:
           1. Biblatex option defined for entry
           2. Biblatex option defined for entry type
           3. Biblatex option defined globally

   set_graph
          Record node and arc connection types for .dot output

   get_graph
           Return an inheritance graph data structure for an inheritance type

   set_set_pc
         Record a parent->child set relationship

   set_set_cp
         Record a child->parent set relationship

   get_set_pc
         Return a boolean saying if there is a parent->child set relationship

   get_set_cp
         Return a boolean saying if there is a child->parent set relationship

   get_set_children
         Return a list of children for a parent set

   get_set_parents
         Return a list of parents for a child of a set

   set_inheritance
           Record that $target inherited information from $source
           Can be used for crossrefs and xdata. This just records that an entry
           inherited from another entry, for loop detection.

   get_inheritance
           Check if $target directly inherited information from $source
           Can be used for crossrefs and xdata

   is_inheritance_path
         Checks for an inheritance path from entry $e1 to $e2
         Can be used for crossrefs and xdata

       [
                    {s => 'A',
                     t => 'B'},
                    {s => 'A',
                     t => 'E'},
                    {s => 'B',
                     t => 'C'},
                    {s => 'C',
                     t => 'D'} ];

labelalpha disambiguation

   incr_la_disambiguation
           Increment a counter to say we have seen this labelalpha

   get_la_disambiguation
           Get the disambiguation counter for this labelalpha.
           Return a 0 for undefs to avoid spurious errors.

keyorder

   set_keyorder
         Set some key order information

   get_keyorder
         Get some key order information

   get_keyorder_max
         Get maximum key order number for a section

   reset_keyorder
         Reset keyorder - for use in tests where we switch to allkeys

seenkey

   get_seenkey
           Get the count of a key

   incr_seenkey
           Increment the seen count of a key

   get_seenwork
           Get the count of occurences of a labelname or labeltitle

   incr_seenwork
           Increment the count of occurences of a labelname or labeltitle

   reset_seen_extra
           Reset the counters for extra*

   incr_seen_extrayear
           Increment and return the counter for extrayear

   incr_seen_extratitle
           Increment and return the counter for extratitle

   incr_seen_extratitleyear
           Increment and return the counter for extratitleyear

   incr_seen_extraalpha
           Increment and return the counter for extraalpha

   get_seen_nameyear
           Get the count of an labelname/labelyear combination for tracking
           extrayear. It uses labelyear plus name as we need to disambiguate
           entries with different labelyear (like differentiating 1984--1986 from
           just 1984)

   incr_seen_nameyear
           Increment the count of an labelname/labelyear combination for extrayear

           We pass in the name and year strings separately as we have to
           be careful and only increment this counter beyond 1 if there is
           a name component. Otherwise, extrayear gets defined for all
           entries with no name but the same year etc.

   get_seen_nametitle
           Get the count of an labelname/labeltitle combination for tracking
           extratitle.

   incr_seen_nametitle
           Increment the count of an labelname/labeltitle combination for extratitle

           We pass in the name and year strings seperately as we have to
           be careful and only increment this counter beyond 1 if there is
           a title component. Otherwise, extratitle gets defined for all
           entries with no title.

   get_seen_titleyear
           Get the count of an labeltitle/labelyear combination for tracking
           extratitleyear

   incr_seen_titleyear
           Increment the count of an labeltitle/labelyear combination for extratitleyear

           We pass in the title and year strings seperately as we have to
           be careful and only increment this counter beyond 1 if there is
           a title component. Otherwise, extratitleyear gets defined for all
           entries with no title.

uniquelistcount

   get_uniquelistcount
           Get the number of uniquelist entries for a (possibly partial) list

   add_uniquelistcount
           Incremenent the count for a list part to the data for a name

   add_uniquelistcount_final
           Incremenent the count for a complete list to the data for a name

   add_uniquelistcount_minyear
           Incremenent the count for a list and year to the data for a name
           Used to track uniquelist = minyear

   get_uniquelistcount_minyear
           Get the count for a list and year to the data for a name
           Used to track uniquelist = minyear

   get_uniquelistcount_final
           Get the number of uniquelist entries for a full list

   reset_uniquelistcount
           Reset the count for list parts and complete lists

   list_differs_nth
           Returns true if some other list differs at passed nth place
           and is at least as long

           list_differs_nth([a, b, c, d, e], 3) = 1

           if there is another list like any of these:

           [a, b, d, e, f]
           [a, b, e, z, z, y]

   list_differs_last
           Returns true if some list differs from passed list in its last place

           list_differs_last([a, b, c]) = 1

           if there is another list like any of these:

           [a, b, d]
           [a, b, d, e]

   list_differs_superset
           Returns true if some list differs from passed list by being
           identical to the list up to the end of the list but also
           by having extra elements after this

           list_differs_superset([a, b, c]) = 1

           if there is another list like any of these:

           [a, b, c, d]
           [a, b, c, d, e]

uniquenamecount

   get_numofuniquenames
           Get the number of uniquenames entries for a visible name

   get_numofuniquenames_all
           Get the number of uniquenames entries for a name

   add_uniquenamecount
           Add a name to the list of name contexts which have the name in it
           (only called for visible names)

   add_uniquenamecount_all
           Add a name to the list of name contexts which have the name in it
           (called for all names)

   reset_uniquenamecount
           Reset the list of names which have the name part in it

   _get_uniquename
           Get the list of name contexts which contain a name
           Mainly for use in tests

crossrefkeys

   get_crossrefkeys
           Return ref to array of keys which are crossref targets

   get_crossrefkey
           Return an integer representing the number of times a
           crossref target key has been ref'ed

   del_crossrefkey
           Remove a crossref target key from the crossrefkeys state

   incr_crossrefkey
           Increment the crossreferences count for a target crossref key

   set_displaymode
           Set the display mode for a field.
           setdisplaymode(['entrytype'], ['field'], ['citekey'], $value)

           This sets the desired displaymode to use for some data in the bib.
           Of course, this is entirey separate semantically from the
           displaymodes *defined* in the bib which just tell you what to return
           for a particular displaymode request for some data.

   get_displaymode
           Get the display mode for a field.
           getdisplaymode(['entrytype'], ['field'], ['citekey'])

           Returns the displaymode. In order of decreasing preference, returns:
           1. Mode defined for a specific field in a specific citekey
           2. Mode defined for a citekey
           3. Mode defined for a fieldtype (any citekey)
           4. Mode defined for an entrytype (any citekey)
           5. Mode defined globally (any citekey)

   dump
           Dump config information (for debugging)

AUTHORS

       Francois Charette, "<firmicus at ankabut.net>" Philip Kime "<philip at kime.org.uk>"

BUGS

       Please report any bugs or feature requests on our sourceforge tracker at
       <https://sourceforge.net/tracker2/?func=browse&group_id=228270>.

COPYRIGHT & LICENSE

       Copyright 2009-2013 Francois Charette and Philip Kime, all rights reserved.

       This module is free software.  You can redistribute it and/or modify it under the terms of
       the Artistic License 2.0.

       This program is distributed in the hope that it will be useful, but without any warranty;
       without even the implied warranty of merchantability or fitness for a particular purpose.