Autodesk / Autodesk/AutomaticComponentToolkit

Clarify the meaning of "dynamic" for bindings

Aperta
#213 1 commento 2 reazioni 0 assegnatari Vedi su GitHub
Lingua principale
Go
Stelle
53
Fork
26
Metriche di merge delle PR
Nessuna PR unita negli ultimi 30g

Descrizione

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.

Guida per i contributori

Apri la guida per i contributori

Direzione di ricerca

Inizia individuando la tabella «Feature Matrix: Bindings» e il tutorial o la documentazione dei binding a cui fa riferimento l’issue. Verifica come vengono descritti i binding C, C++, C dynamic e C++ Dynamic, quindi rendi espliciti il tipo di linking e il comportamento dinamico implicito. Il lavoro è completato quando un utente alle prime armi può distinguere il caricamento statico da quello dinamico basandosi solo sulla documentazione.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Valutazione

Stack tecnologico
c, cpp, python
Ambito
documentation
Tipo di issue
Documentazione
Difficoltà
2/5
Tempo stimato
1-3 ore
Stato di attività
Ferma
Chiarezza
Abbastanza chiara
Idoneità per principianti
45/100

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.