Skip to content

docs: correct native lib name in build comment - #3

Open
terbin wants to merge 1 commit into
2b2tplace:mainfrom
terbin:docs/readme-native-lib-name
Open

docs: correct native lib name in build comment#3
terbin wants to merge 1 commit into
2b2tplace:mainfrom
terbin:docs/readme-native-lib-name

Conversation

@terbin

@terbin terbin commented Jul 13, 2026

Copy link
Copy Markdown

Summary

Docs-only fix. The build-instructions comment in README.md wrote every native artifact with a lib prefix, but the Windows DLL has none. No code or build change.

Change

  • README.md: the build comment read:

    # executable should appear at ./build/libPlaceViewer-{arch}.{so/dylib/dll} (value of arch determined by `uname -m`)
    

    The lib... form distributes the prefix across all three extensions, implying libPlaceViewer-{arch}.dll on Windows. CMake does not prefix lib to a Windows DLL, so the real artifact is PlaceViewer-{arch}.dll, which is exactly the name the Java loader (PlaceViewerLibrary.java) looks up (PlaceViewer-<arch>.dll on Windows, libPlaceViewer-<arch>.{so,dylib} on Linux/macOS). Split the note per OS and note arch is x86_64/aarch64:

    # shared lib appears in ./build/ as libPlaceViewer-{arch}.so (Linux) / libPlaceViewer-{arch}.dylib (macOS) / PlaceViewer-{arch}.dll (Windows, no "lib" prefix)
    # arch is x86_64 or aarch64 (matches the Java loader); on Linux/macOS it follows `uname -m`
    

Verification

  • Documentation only, no build, no runtime impact.
  • Cross-checked the corrected names against PlaceViewerLibrary.java (libPlaceViewer-<arch>.so / PlaceViewer-<arch>.dll / libPlaceViewer-<arch>.dylib) and against the mv/zip lines already in this README, all consistent.

The build comment wrote every artifact with a "lib" prefix
(libPlaceViewer-{arch}.{so/dylib/dll}), but the Windows DLL has no
"lib" prefix: it is PlaceViewer-{arch}.dll, which is exactly what the
Java loader (PlaceViewerLibrary.java) looks up. Split the note per OS
and clarify arch is x86_64/aarch64.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant