Autodesk / Autodesk/AutomaticComponentToolkit

Clarify the meaning of "dynamic" for bindings

Abierto
#213 1 comentario 2 reacciones 0 asignados Ver en GitHub
Lenguaje dominante
Go
Estrellas
53
Forks
26
Métricas de merge de PR
Sin PR fusionados en 30 d

Descripción

Just my experiences as a first time user of this library while I'm digging through the library itself, the tutorial, etc:

Currently, it is not obvious what the difference between `C++` and `C++ Dynamic` bindings is (Same for `C` and `C dynamic`).
My first idea was that it could be related to the internal usage of `dynamic_cast` or something like that, but it seems like this is not the case.

Am I correct assuming that `dynamic` refers to the way the library is loaded (dynamically or statically linked)? The `C++ dynamic` bindings will have all the `dlsym` bits in it, whereas the normal `C++` binding assumes static linking?

If that is correct, I propose the following changes:
- Add a new `Linking type` column in the `Feature Matrix: Bindings` table that (either `dynamic` or `static`)
- Clarify that most of the bindings are implicitly `dynamic` - I think it's a bit confusing that C and C++ have variants without the suffix (static linking) and with the `dynamic` suffix (dynamic linking), whereas the other language like Python or Pascal are just implicitly dynamic without the suffix.

If you're not using the library for the first time this may seem obvious, however to me as a first time library user it was not.

Guía de contribución

Abrir la guía de contribución

Línea de trabajo

Comienza localizando la tabla «Feature Matrix: Bindings» y el tutorial o la documentación de bindings mencionados en el issue. Confirma cómo se describen los bindings C, C++, C dynamic y C++ Dynamic, y haz explícitos el tipo de linking y el comportamiento dinámico implícito. El trabajo estará terminado cuando un usuario nuevo pueda distinguir entre la carga estática y dinámica basándose únicamente en la documentación.

Escrito por el modelo de indexación a partir del texto del issue.

Evaluación

Stack tecnológico
c, cpp, python
Área
documentation
Tipo de issue
Documentación
Dificultad
2/5
Tiempo estimado
1-3 horas
Estado de actividad
Estancado
Claridad
Bastante claro
Aptitud para principiantes
45/100

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.