You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Describe the bug
When creating a new project using the "New C/C++ Project" quick action, it is unclear what any of the selectable options do.
To Reproduce
Steps to reproduce the behavior:
Install the latest version of the extension following the documentation here.
Click 'New C/C++ Project' from the extensions quick actions menu
Enter a project name
Scroll down to the 'Features', 'Stdio support', 'Code generation options', and 'Debugger' sections
Expected behavior
Each of these selectable options has a description available which describes what they are.
The reason you would want to choose any option is briefly explained. (IE: "Running the program from RAM rather than flash will foobar your dingbats more frumiously.")
Abbreviations are defined.
Any tradeoffs when selecting different combinations are explained. (IE: "By enabling the HW watchdog, you will have access to one less HW Timer.")
Whether or not you can change these options in the future is explained.
If they can be changed, how to do so is briefly explained. (IE: "These options can be changed later for this project by using the 'Change options...' menu item")
Actual Behavior
The user is presented with 15 binary choices (32k possible combinations)
The PDF documentation briefly explains the "Stdio support"
Platform (please complete the following information):
OS: MacOS
Architecture: arm/apple
Additional context
Please add this documentation inline to the extension itself. It should of course be added to the PDF documentation as well, but external documentation will quickly go out of date and the extension should be self-documenting.
I would offer to cut a PR to address this, but there doesn't actually seem to be any documentation of these options in the first place.
Unexplained options
(for future searching)
Features
SPI
I2C interface
UART
PIO interface
DMA support
HW interpolation
HW watchdog
HW timer
HW clocks
Stdio support
Console over UART
Console over USB (disables other USB use)
Code generation options
Run the program from RAM rather than flash
Use project name as entry point file name
Generate C++ code
Enable C++ RTTI (Uses more memory)
Enable C++ exceptions (Uses more memory)
The text was updated successfully, but these errors were encountered:
Describe the bug
When creating a new project using the "New C/C++ Project" quick action, it is unclear what any of the selectable options do.
To Reproduce
Steps to reproduce the behavior:
Expected behavior
Actual Behavior
Platform (please complete the following information):
Additional context
Please add this documentation inline to the extension itself. It should of course be added to the PDF documentation as well, but external documentation will quickly go out of date and the extension should be self-documenting.
I would offer to cut a PR to address this, but there doesn't actually seem to be any documentation of these options in the first place.
Unexplained options
(for future searching)
The text was updated successfully, but these errors were encountered: