... | ... | @@ -25,7 +25,7 @@ The short answer is: __there is no developers' manual__, sorry. A more detailed |
|
|
|
|
|
#### How to Report a Bug?
|
|
|
The preferred method, since MBDyn moved to Gitlab, is to open an [Issue](https://public.gitlab.polimi.it/DAER/mbdyn/issues). Doing so will provide for better bug tracking and task assignments. Please make sure your request for help or bug report is well formulated. See Simon Tatham's ["How to Report Bugs Effectively"](https://www.chiark.greenend.org.uk/~sgtatham/bugs.html) or R. Clint Whaley's ["Why are you such a jerk when answering user questions? AKA: how can I help you feel good about providing me with support?"](http://math-atlas.sourceforge.net/faq.html#utone) for effective discussion of how help requests and bug reports should and SHOULD NOT be formulated. Many thanks to Simon and Clint for spelling out so clearly what we believe often are every free software developer's contrasting feelings with users. In general, before you post a request for help or report a bug, you should first:
|
|
|
- read the most appropriate documentation, including the [FAQs](https://www.mbdyn.org/?Documentation___Official_Documentation___FAQ);
|
|
|
- read the most appropriate documentation, including the [FAQs](https://www.mbdyn.org/Documentation/FAQ.html);
|
|
|
- search the MBDyn users mailing list [archives](https://lists.mbdyn.org/pipermail/mbdyn-users/): someone might have already addressed the same issue, and the answer could be already there;
|
|
|
- post your request, following the previously mentioned indications.
|
|
|
|
... | ... | @@ -49,7 +49,7 @@ Several examples of user-defined drive callers, constitutive laws, and elements |
|
|
|
|
|
f you need something fancy, that cannot be directly obtained using the built-in library of entities, or you want to develop something that you don't want to share with other users (remember that the whole code is [GPL](https://public.gitlab.polimi.it/DAER/mbdyn/blob/master/LICENSE)), you should consider implementing it using a run-time loadable module.
|
|
|
|
|
|
Have a look at subfolders of the [`modules/`](https://public.gitlab.polimi.it/DAER/mbdyn/tree/master/modules) folder, starting from those that are closer to what you want to implement; try to understand how things work, and make sure that you follow [these instructions](https://www.mbdyn.org/?Documentation___Official_Documentation___FAQ#HOW_CAN_I_BUILD_RUN_TIME_LOADABLE_MODULES) when building MBDyn.
|
|
|
Have a look at subfolders of the [`modules/`](https://public.gitlab.polimi.it/DAER/mbdyn/tree/master/modules) folder, starting from those that are closer to what you want to implement; try to understand how things work, and make sure that you follow [these instructions](https://www.mbdyn.org/Documentation/FAQ.html#how-can-i-build-run-time-loadable-modules) when building MBDyn.
|
|
|
|
|
|
### Python Preprocessor
|
|
|
The documentation of the MBDyn Python Preprocessor can be found [here](PythonPreprocessor/MBDynLib) |