This project is currently not maintained for an indeterminate period. Since the mayor improvements at the "C/C++" extension, it will probably stay archived.
Cfold is a visual studio code extension that provides advanced folding capabilities with function, class, struct, preprocessor, documentation- & comment blocks particular designed for C & C++ based on the stack principle.
I have created this extension for myself because there wasn't anything to control folding on a good specific way.
So, here it is. Cfold.
However i'm not an everyday type-/javascript developer, if you find something fishy in the code,
please open an issue or pullrequest.
These commands can be used & mapped with shortcuts:
| Command | Description |
|---|---|
| cfold.foldAll | Fold all provided fold controls |
| cfold.foldDocComments | Fold all comments & documentation blocks |
| cfold.foldAroundCursor | Fold all controls around cursor |
| cfold.foldFunction | Fold all functions |
| cfold.foldFunctionClassStructEnum | Fold all functions, classes, structs & enums |
| cfold.toggleLog | Toggle log |
These confiugrations can be set in the common vscode settings menu:
| Config | Default | Description |
|---|---|---|
| cfold.caseLabel.enable | false | Enable fold controls for case labels within a switch |
| cfold.caseLabel.minLines | 0 | Minimum lines for providing fold controls for case labels within a switch |
| cfold.class.enable | false | Enable fold controls for class |
| cfold.commentQuote.enable | true | Enable fold controls for quoted comment block |
| cfold.documentationQuote.enable | true | Enable fold controls for quoted documentation block |
| cfold.enum.enable | false | Enable fold controls for enum |
| cfold.function.enable | true | Enable fold controls for function |
| cfold.namespace.enable | false | Enable fold controls for namespace |
| cfold.preprocessor.enable | true | Enable fold controls for preprocessor directives |
| cfold.preprocessor.ignoreGuard | true | Disable fold controls for header guards |
| cfold.preprocessor.minLines | 0 | Minimum lines for providing fold controls for preprocessor directives |
| cfold.preprocessor.recursiveDepth | 1 | Sets the recurse level for providing fold controls for preprocessor directives |
| cfold.struct.enable | false | Enable fold controls for struct |
| cfold.withinFunction.enable | false | Enable fold controls within functions |
| cfold.withinFunction.minLines | 0 | Minimum lines for providing fold controls within functions |
| cfold.language.c | true | Enable Cfold for c language |
| cfold.language.cpp | true | Enable Cfold for c++ language |
Configurations which start with 'cfold.xxxxxxxx.enable' only enables folding controls on the left sidebar.
That means if command 'cfold.foldAll' is executed, it will just folds the provided controls.
With this behavior it can be further customized.
If you encounter a problem with a file, you may open an issue with the file content
or chat with me privately on https://gitter.im/reapler/ with your github account.
If the folding doesn't seem to change at all, you may need to investigate your other extensions
for possible folding range overriding. Often it can be disabled.
Please keep in mind that uncommon code styles will likely not be supported.
Thanks to @daiyam (https://github.com/zokugun/vscode-explicit-folding) for providing a good foundation for Cfold.