fix: bazel manpage compilation

[luarss]

Summary

• src/OpenRoad.cc: Check BUILD_WORKSPACE_DIRECTORY in getDocsPath() for bazel run case
  (ifdef BAZEL_BUILD).
• packaging/BUILD.bazel: Add //docs:man_pages to install data deps.
• bazel/install.sh: Copy cat/ and html/ to $DEST_DIR/share/openroad/man/.

Type of Change

• Bug fix

Impact

[How does this change the tool's behavior?]

Verification

• I have verified that the local build succeeds (./etc/Build.sh).
• I have run the relevant tests and they pass.
• My code follows the repository's formatting guidelines.

• I have included tests to prevent regressions.
• I have signed my commits (DCO).

Related Issues

fixes #10640

[gemini-code-assist]

Code Review

This pull request adds support for installing and locating generated man pages in Bazel builds. Specifically, it updates bazel/install.sh and packaging/BUILD.bazel to copy man pages to the installation directory, and modifies src/OpenRoad.cc to look for them in bazel-bin/docs when running via Bazel. The review feedback suggests dereferencing symlinks using cp -rfL and cleaning up stale directories during installation, as well as using the non-throwing overload of std::filesystem::is_directory to prevent potential exceptions.

[gemini-code-assist]

std::filesystem::is_directory can throw a std::filesystem::filesystem_error exception if the path is inaccessible, contains a loop of symlinks, or encounters other OS-level errors. To ensure robust error handling and prevent potential crashes, use the non-throwing overload that accepts an std::error_code parameter.

    std::error_code ec;
    if (std::filesystem::is_directory(docs_path, ec)) {
      return docs_path;
    }