Created attachment 180686 [details]
@mscfile workaround

This does not work as indicated in the Doxygen Manual. However, I did find a way to make it work so that you don't need to put the mscgen code inside the header file.

@msc 
@latexonly \input{mscgen_callflows/msc_callflow_sample.txt} @endlatexonly
@endmsc 

Also, the mscgen source file, should not include the msc {} for this to work, example:

  hscale="0.7";

  CS,WS,Init;

  CS->CS [ label = "cs()" ] ;
  CS->Init [ label = "Init(TRUE)", ID="1"];
  Init=>CS [ label = "process(1)" ];
  Init=>CS [ label = "process(2)" ];
  CS box Init [label="Sample box"];
  ...;
  Init=>Init [ label = "process(n)" ];
  Init=>Init [ label = "process(END)" ];
  CS rbox WS [ label = "Round box with blue border", linecolour="#0000ff"];
  CS<<=Init [ label = "callback()"];
  ---  [ label = "If more to run", ID="*" ];
  WS->WS [ label = "next()"];
  WS->Init [ label = "ac1()\nac2()"];
  Init<-WS [ label = "Init(TRUE)"];
  WS abox Init [ label = "Angular box with red text", textcolour="red" ];
  Init->Init [ label = "stalled(...)"];
  WS<-Init [ label = "ws() = FALSE"];

If you want to include a figure caption that will show up in the toc,you can also add the following LaTeX code in your header file just below.

@msc 
@latexonly \input{mscgen_callflows/msc_callflow_sample.txt} @endlatexonly
@endmsc 

@latexonly
  \begin{figure}[H]
  \centering
  \renewcommand{\thefigure}{\thechapter-\arabic{figure}}
  \caption{Sample Call Flow}
  \label{fig:Sample Call Flow}
\end{figure}
@endlatexonly