`Canonic_Classmap` implements the php script traversal, tokenization and map building process.

Usually it's run via the static `::update()` method. If run from the default [`Canonic_Autoloader`](wiki/Canonic_Autoloader) mechanism, it just cares about the directory tree it resides in.

It can however map multiple source repositories. For instance:

    Canonic_Classmap::update(

        array(__DIR__,
    );

Will read in the surrounding tree, but also the global path. An [identifier map](wiki/classmap) of both will be stored within the phar.

It's important to understand that only file references from the first directory will be converted into relative paths. The filenames will stay absolute.

If such a manual updating procedure is in place, automatic updating via `shared.phar` itself shouldn't be utilized further. It would still just default to handling only the directory tree it's contained in.


### More specific

You can also forgo the static `::update` approach, and handle the details yourself:

    $cm = new Canonic_Classmap;

And read in directories yourself:

    $cm->process_dir("./vendor");
    $cm->process_dir("../includes");


None of the mapped paths will be relative then.

You then have to write the results somewhere yourself in a format that `shared.phar` or its stub can use:

    $cm->write("./autoload.map.php");

Or update it also within the