g file calls the call-back function cb. If the
                    call-back returns false then the algorithm returns without considering
                    any further files.
                  </p>
                  <p>
                    The parameter <span class="emphasis"><em>files</em></span> can include wild card
                    characters '*' and '?', if the parameter <span class="emphasis"><em>recurse</em></span>
                    is true then searches sub-directories for matching file names