orphan_libs(test, trgt)

Identify directories which are or are not referenced (orphans) from any .m file in a given directory

%% FUNCTION ORPHAN_LIBS describes .m file linkage between directories.
%
% Operation: looks at every .m file in every directory in 'test', and
% checks whether it is cited anywhere in the directory 'trgt'. By which
% means we can check all directories if they are referenced or 'orphaned'
%
%
% SYNTAX
% [libgraf, lib_orf] = orphan_libs(test, trgt)
%
% INPUT
% test - (string) path to the directory to test
% trgt - (string) path to the directory to find references
%
% OUTPUT
% libgraf - (struct array) each element refers to a directory with 4 fields:
% - 'path' (string) is the directory path
% - 'mnum' (integer) number of .m files found in 'path'
% - 'refs' (cell array) holds 'mnum' struct arrays.
% The ith struct array element holds the .m filename and lines
% of code referring to the ith .m file found under 'path'
% - 'name' (cell array) holds 'mnum' strings. The ith string is
% the name of the ith .m file found under 'path'