Read structured file with doxygen

60 Views Asked by At

doxygen noob here, but I can't find answers anywhere.

My goal is to parse this file and extract (1) the parameter name found under Classes -> Attrs (in this case calParameterName_1), and (2) the description (in this case Description of ParameterName_1.). Also, I only want to do this for parameters found as Attrs -> Stereotypes -> _name = "Calibration" (there are other parameters defined as "RAM" which I want to exclude).

I am not able to modify the files to include commented code which can be read by doxygen. Instead, I'm looking for a way to read/parse this code directly and translate it to documentation. How do I accomplish this using doxygen?

My projects have .cls files built from rhapsody models, which contain "tuning parameters" (calibrations) in a common structured format, like this snippet below (note, I've taken out a lot of the attributes to shorten...)...

This file defines which parameters are RAM vs calibration type. The example above is a calibration (which you can see from the attribute definition).

I don't know how to read code into doxygen, only used it for reading the comments I put above my classes.

{ ISubsystem 
    - _name = "ParameterName_1";
    - Stereotypes = { IRPYRawContainer 
        - value = { IHandle 
            - _m2Class = "IStereotype";
            - _name = "SignalDefinition";
        }
    }
    - Classes = { IRPYRawContainer 
        - value = { IClass 
            - _name = "ParameterName_1";
            - _description = { IDescription 
                - _text = "Description of ParameterName_1.";
            }
        - Attrs = { IRPYRawContainer 
            - value = { IAttribute 
                - _name = "calParameterName_1";
                - Stereotypes = { IRPYRawContainer 
                    - value = { IHandle 
                        - _name = "Calibration";
                    }
                }
            }
        }
    }
}
0

There are 0 best solutions below