'Read the content from a local manpage file and store it in usable formats
on the class instance.'

def read(self):

    cmd = [config.MAN2HTML, urllib.urlencode({'local': os.path.abspath(self.path)})]
    logger.info('executing    %r', '    '.join(cmd))
    self._text = subprocess.check_output(cmd, stderr=devnull, env=ENV)
    try:
        self.synopsis = subprocess.check_output(['lexgrog', self.path], stderr=devnull).rstrip()
    except subprocess.CalledProcessError:
        logger.error('failed    to    extract    synopsis    for    %s', self.name)
