emscripten-core/emscripten

dlopen() documentation is wrong, and related issue should not be closed

Open

#15,795 opened on Dec 16, 2021

View on GitHub
 (8 comments) (0 reactions) (0 assignees)C++ (3,519 forks)batch import
docsgood first bughelp wanted

Repository metrics

Stars
 (27,361 stars)
PR merge metrics
 (Avg merge 19d 10h) (147 merged PRs in 30d)

Description

In particular, from https://emscripten.org/docs/compiling/Dynamic-Linking.html?highlight=dlopen:

Runtime dynamic linking can be performed by the calling the dlopen() function ... That’s basically it - you can then use dlopen(), dlsym(), etc. normally. (emphasis mine)

The second part of that statement is 100% false

Issue #11753 still exists.

Could the documentation please be corrected, and issue #11753 re-opened until a solution has been put into place?

Contributor guide

Research direction
Locate the documentation file for dynamic linking in Emscripten and correct the statement about dlopen being usable normally. Verify by testing and refer to issue #11753 for context.
Tech stack
javascriptwasm
Domain
backenddocumentation
Issue type
Documentation
DifficultyEstimated implementation difficulty for a new contributor, from 1 for very small changes to 5 for expert-level work.
1
Estimated timeA rough time range for an experienced contributor to investigate, implement, test, and prepare a pull request.
Under 1 hour
Activity statusHow available the issue appears right now: fresh, active, stale, blocked, or waiting on maintainer input.
Active
ClarityHow clearly the issue explains the expected change, acceptance criteria, and next step.
Clear
Prerequisites
GitBasic understanding of dynamic linking
Newbie friendlinessA 1-100 score estimating how approachable this issue is for first-time contributors.
75