ToME: the Tales of Maj'Eyal

-- ========================================================================
-- Addon authors:  To make your addon's added runes/infusions work with the
-- compare functionality implemented by this addon, have your inscription
-- talent definition include a method .info_cmp(self, t1, d1, t2, d2),
-- where:
--
--   - self is the Actor being used by Object:getDesc().
--   - t1 is the talent table for the inscription in inventory.
--   - d1 is the inscription data associated with t1, as generated by
--     ActorInscription:getInscriptionData().
--   - t2 is the talent table for the inscription inscribed on the body.
--   - d2 is the inscription data associated with t2, as generated by
--     ActorInscription:getInscriptionData().
--
-- If t2 and d2 are nil, you should return the same text as your .info()
-- method; otherwise, your returned text should show the difference between
-- the two talents, as shown by the examples below.  [You won't need to use
-- the frob() function shown below; we only need that because we're
-- altering the talents of the existing inscriptions.]  You can use the
-- utility method util.addon.compare.colorize(n, fmt, good) provided below
-- [you'll probably want to make a local alias to shorten the name, as
-- shown below]; the parameters are:
--
--   - n is the difference between the value for t1 and the value for t2.
--   - fmt is the printf-style format to use to format n; default is '%+d'.
--   - good controls color determination for the formatted n.  If good is
--     nil, the text will be green if n is positive and red if n is
--     negative; if good is a number, the text will be green if good*n is
--     positive and red if it is negative; if good is boolean, the text
--     will be green if good is true and red if it is false.
-- ========================================================================