Autodesk / Autodesk/AutomaticComponentToolkit
Clarify the meaning of "dynamic" for bindings
- Ngôn ngữ chính
- Go
- Star
- 53
- Fork
- 26
- Chỉ số merge pull request
- Không có pull request nào được merge trong 30 ngày
Mô tả
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.
Hướng dẫn đóng góp
Hướng nghiên cứu
Bắt đầu bằng cách tìm bảng “Feature Matrix: Bindings” và tutorial hoặc tài liệu binding được tham chiếu trong issue. Xác nhận cách các binding C, C++, C dynamic và C++ Dynamic được mô tả, sau đó làm rõ kiểu linking và hành vi dynamic ngầm định. Hoàn tất khi một người dùng lần đầu có thể phân biệt việc tải tĩnh và tải động chỉ dựa vào tài liệu.
Do mô hình lập chỉ mục viết ra từ nội dung của issue.
Đánh giá
- Công nghệ
- c, cpp, python
- Lĩnh vực
- documentation
- Loại issue
- Tài liệu
- Độ khó
- 2/5
- Thời gian dự kiến
- 1-3 giờ
- Mức độ hoạt động
- Đình trệ
- Độ rõ ràng
- Khá rõ ràng
- Mức phù hợp với người mới
- 45/100