if not modules then modules = { } end modules ['file-syn'] = {
    version   = 1.001,
    comment   = "companion to file-syn.mkvi",
    author    = "Hans Hagen, PRAGMA-ADE, Hasselt NL",
    copyright = "PRAGMA ADE / ConTeXt Development Team",
    license   = "see context related readme files"
}


environment.filesynonyms = environment.filesynonyms or { }
local filesynonyms       = environment.filesynonyms

local settings_to_array  = utilities.parsers.settings_to_array
local findfile           = resolvers.findfile

local implement          = interfaces.implement

local report_files       = logs.reporter("files")

storage.register("environment/filesynonyms", filesynonyms, "environment.filesynonyms")

local function truefilename(name)
    local realname = filesynonyms[name] or name
    if realname ~= name then
        return truefilename(realname)
    else
        return realname
    end
end

environment.truefilename = truefilename

function environment.definefilesynonym(name,realname)
    local names = settings_to_array(name)
    for i=1,#names do
        local name = names[i]
        local synonym = filesynonyms[name]
        if synonym then
            interfaces.showmessage("files",1,{ name or "?", realname or "?", synonym or "?" })
        end
        filesynonyms[name] = realname
    end
end

function environment.definefilefallback(name,alternatives)
    local names = settings_to_array(alternatives)
    for i=1,#names do
        local realname = findfile(names[i])
        if realname ~= "" then
            filesynonyms[name] = realname
            break
        end
    end
end

implement {
    name      = "truefilename",
    actions   = { truefilename, context },
    arguments = "string"
}

implement {
    name      = "definefilesynonym",
    actions   = environment.definefilesynonym,
    arguments = { "string", "string" }
}

implement {
    name      = "definefilefallback",
    actions   = environment,definefilefallback,
    arguments = { "string", "string" }
}
