In your example you try to nest headers. AFAIK it is not working in robodoc. (Anyone correct me please if I'm wrong)
If it is not possible to reorganise your source (make the query a separate header), you can assign multiple names for one header.
like:
/****f* MyFile/MyFunction, BigQuery
* FUNCTION
* Do something Spectacular
* SOURCE
*/
$x=$y;
$x++;
$sql = "SELECT 1";
/*****/
If you would like to refer to this comment somewhere else in this project, copy and paste the following link:
Is there anyway to have nested source objects?
For example:
/****f* MyFile/MyFunction
* FUNCTION
* Do something Spectacular
* SOURCE
*/
$x=$y;
$x++;
/****q* MyFunction/BigQuery
* NAME
* BigQuery
* SOURCE
*/
$sql = "SELECT 1";
/*****/
...
/*****/
Without this, I can't document my queries that are in functions..
In your example you try to nest headers. AFAIK it is not working in robodoc. (Anyone correct me please if I'm wrong)
If it is not possible to reorganise your source (make the query a separate header), you can assign multiple names for one header.
like:
/****f* MyFile/MyFunction, BigQuery
* FUNCTION
* Do something Spectacular
* SOURCE
*/
$x=$y;
$x++;
$sql = "SELECT 1";
/*****/