David Koontz <[email protected]> writes: > On Jan 11, 2012, at 12:16 AM, Martin Strubel wrote: > >> I've run some of the code through Doxygen, see Doxyfile at >> >> http://section5.ch/files/ghdl.Doxyfile.gz >> >> Just copy to ghdl source tree, gunzip, rename to Doxyfile, run "doxygen". >> There's some abuse going on by mapping .adb files to VHDL code, so far >> it does not seem to make doxygen choke, but I don't know if it's fully >> parsed, either. >> >> Probably some of the options can be tweaked to produce better results. I >> just used it to quickly get a cross reference. >> >> So the next job could be to do a git based fork and start the >> documentation project. Someone (with more GHDL experience) willing to >> take the hat or the seashell? > > I tried it out, even modifying your ghdl.Doxyfile a bit (e.g. adding .ads > files as Vhdl types) the results weren't good enough for someone to learn to > navigate throught ghdl source code. > > Does anyone have any experience with Adabrowse?
I did once; it works fairly well, but I don't know how current it is. I much prefer browsing Ada source using Emacs Ada mode, which relies on the cross-reference info output by the GNAT compiler. Which means the Ada code has to be compiled to browse, although there are some browsing functions that don't rely on the compiler output. I think Adabrowse also requires compilable code. GPS (GNAT Programming System - the editor distributed by AdaCore with GNAT) has even more browsing capability (also based on the compiler output), and has a more GUI look and feel than Emacs. I maintain Emacs Ada mode, and I did learn gcc internals once (several years ago). I don't use GHDL at all these days, mainly because it is slower than modelsim, and I only have the time/energy to maintain one tool. But I do miss the ability to fix the tool to do what I want! It would be nice to enhance GHDL to output VHDL cross-reference info comparable to that output by GNAT, so Emacs could use it (maybe it does already?). I might be able to help with porting GHDL to gcc 4.6.0, but I don't have much time, and my gcc knowledge is pretty out of date. I second the notion of learning Ada; it's an excellent language (I'm at least 4 times as productive in Ada as in C++ or Java). It does suffer from lack of bindings to popular stuff. -- -- Stephe _______________________________________________ Ghdl-discuss mailing list [email protected] https://mail.gna.org/listinfo/ghdl-discuss
