forked from reconquest/shdoc
-
Notifications
You must be signed in to change notification settings - Fork 1
Open
Labels
enhancementNew feature or requestNew feature or request
Description
It should be possible to nest sections.
For this, the level of the section header and function_nesting should instead be calculated:
section_nestingstarting at 0- when
@sectionis encountered dosection_nesting += 1function_nesting = section_nesting + 1
- on
@endsectionsection_nesting -= 1function_nesting = section_nesting + 1
render_docblockwhen called from withinprocess_sectionshould passsection_nesting
This is a behaviour change.
Currently, anytime @section is encountered, the nesting levels are hard-set to section: 2, functions: 3.
This means, that @endsection isn't required to remain on the same nesting level, any new section will start fresh.
When this change is implemented, @endsection is basically required to achieve the same because shdoc alone can not determine if further nesting of @section is desired or not.
Not using @endsection would continue to increase nesting levels when encountering @section until a depth is achieved for which shdoc does not have code templates anymore.
Reactions are currently unavailable
Metadata
Metadata
Assignees
Labels
enhancementNew feature or requestNew feature or request