NAME
of - private open-file helper for Developer Dashboard
SYNOPSIS
dashboard of [--print] [--line N] [--editor CMD] <file|scope> [pattern...]DESCRIPTION
This private helper is staged under ~/.developer-dashboard/cli/dd/ so the main dashboard command can keep file-opening behaviour available without installing a generic executable into the user's global PATH.
PURPOSE
This staged helper exposes dashboard of, the short name for the dashboard open-file command. It is the shell-facing entrypoint for direct file opens, scoped regex search, Perl module lookup, Java dotted class lookup, and the print-vs-editor decision that happens after resolution.
WHY IT EXISTS
It exists because file lookup is a frequent interactive task and should stay fast to type, but the public switchboard still needs to stay thin. The helper lets users type dashboard of ... while the heavy search and ranking rules stay in Developer::Dashboard::CLI::OpenFile.
WHEN TO USE
Use this file when changing the short-form CLI contract for open-file behavior, the staged-helper handoff, or the exact examples contributors see when they look up how dashboard of behaves.
HOW TO USE
Users run dashboard of [--print] [--line N] [--editor CMD] <file|scope> [pattern ...]. Direct paths and file:line arguments resolve immediately. In scoped mode the first positional argument is the search root or saved alias, and every extra positional argument is a case-insensitive regex that must match the candidate path. One hit opens or prints that file; multiple hits are listed. Perl module names such as Developer::Dashboard::CLI::Paths resolve through @INC, and Java class names such as javax.jws.WebService resolve through source trees, source archives, or cached Maven source jars.
WHAT USES IT
It is used by developers jumping to source files from the shell, by open-file regression tests, and by docs that explain scoped regex lookup, Perl module resolution, Java source lookup, and print-vs-editor behavior.
EXAMPLES
dashboard of lib 'OpenFile\.pm$'
dashboard of . "Ok\.js$"
dashboard of Developer::Dashboard::CLI::Paths
dashboard of javax.jws.WebService
dashboard of --print bookmarks api-dashboard