xnomo3.py: Internal maintenance specification

# - - -   T x n y . a b b r T o T e x   - - -

    def abbrToTeX ( self, abbr ):
        """Return self's English name marked up for TeX.
        """

Because the abbr argument may be lowercase or short, we standardize it first with Section 11.6, “fixAbbr(): Standardize a bird code”.

        #-- 1 --
        # [ if abbr, standardized, is a key in self.__abbrEng ->
        #     rawEng  :=  the related value
        #   else -> raise KeyError ]
        rawEng = self.abbrToRawEng(abbr)

We also normalize the English name (from the inverted form) using Section 11.5, “engDeComma(): Normalize an English name”. Translating to T_EX notation is done by Section 10.9, “texify(): Mark up text for T_EX”.

        #-- 2 --
        # [ return rawEng, normalized, in TeX notation ]
        return texify(abbrMod.engDeComma(rawEng))