[Home]

Summary:ASTERISK-24151: build_tools/get_documentation only picks up the first documentation block
Reporter:Corey Farrell (coreyfarrell)Labels:
Date Opened:2014-07-31 17:51:50Date Closed:2017-12-29 19:41:52.000-0600
Priority:MinorRegression?No
Status:Closed/CompleteComponents:Core/BuildSystem
Versions:SVN 1.8.29.0 11.11.0 12.4.0 13.18.4 Frequency of
Occurrence
Related
Issues:
Environment:Attachments:
Description:build_tools/get_documentation awk script exits after the first documentation block that is found.  The simple fix is for it to not exit early.
Comments:By: Joshua C. Colp (jcolp) 2017-12-18 09:44:17.128-0600

This was assigned to you - did anything come of it?

By: Corey Farrell (coreyfarrell) 2017-12-18 09:54:57.656-0600

If I remember correctly documentation blocks mixed into the source had a slightly different format for some entries which caused errors when not preprocessed by a python script.  I'll try to take another look soon.

By: Corey Farrell (coreyfarrell) 2017-12-29 19:41:52.648-0600

The documentation in additional blocks are not formatted exactly the same so {{make validate-docs}} fails if the additional blocks were picked up.