tcl - Custom/Distributed documentation of changes with Doxygen -

-

i attempting following feature working doxygen.

is possible, , how best this?

we working existing tcl codebase came eda tool, lot of code gets 'sourced' , not organized in procedures. there numerous improvements/modifications have applied code base. example customization of form "allow feature x controlled new configuration variable y", , involves modifications made filea, fileb, , filec.

i have doxygen parsing entire code base. besides standard language documentation looking extract list of customizations have made, including files modified (and approx line number), changes made in each file, capture of modified code each files, , pointer file listing , line number modification made.

i expect require custom doxygen comments/tags in filea, fileb, , filec, , closest managed placing following @ each location modified in filea fileb , filec:

## # \page custom_mypage1 customization enabling control of x variable y #  # test comment 1 #

this allows collecting comments 3 locations, can't figure out how to:

  1. include portion of source code follows, and
  2. how have generated documentation include references file/line number of comment came from

using xrefitem instead of page provide link between summary page , source.

to include code snippet in page, snippet may help.

example:

/** \xrefitem customization1 "change 1" "changes customization1" description of change. \snippet currentsourcefile.cpp change1 */ //! [change1] modified code here... //! [change1]

Comments

Post a Comment

Popular posts from this blog

windows - Single EXE to Install Python Standalone Executable for Easy Distribution -

-
i used pyinstaller create standalone exe file pyqt project. did not use single file option because exe created single file option takes long open. therefore, pyinstaller created dist folder contains bunch of files including program.exe file. create setup.exe file place contents of dist folder in program directory , create shortcut in start menu , on desktop. want super simple user. maybe setup.exe files when download program cnet. found inno-setup, looks promising. however, not know if there special considerations because program standalone program create python/pyqt program. thanks! have experience task? there program using task not know about? inno-setup or nsis easiest use. tell them files include , put them , create nice installer you. wrote short tutorial on experiences using innosetup might find helpful: http://www.blog.pythonlibrary.org/2008/08/27/packaging-wxpymail-for-distribution/ note tutorial based around wxpython app wrote, concepts same.
Read more

c# - Access objects in UserControl from MainWindow in WPF -

-
i have simple xaml, how can change text property of textblock in usercontrol1 mainwindow ? <window x:class="refactorxaml.mainwindow" xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" xmlns:refactorxaml="clr-namespace:refactorxaml" title="mainwindow" height="350" width="525"> <grid> <grid.rowdefinitions> <rowdefinition height="100"></rowdefinition> <rowdefinition height="100"></rowdefinition> </grid.rowdefinitions> <grid> <refactorxaml:usercontrol1></refactorxaml:usercontrol1> </grid> <grid grid.row="1"> <button>change text</button> </grid> </grid> </window> <usercon...
Read more

javascript - How to name a jQuery function to make a browser's back button work? -

-
i'm trying write function ajaxyfy web site, works perfect, except function button. that's have now: function loading() { if (typeof history.pushstate !== "undefined") { var historycount = 0; $('.menu-item, .logo').on('click','a',function(e){ e.preventdefault(); $(this).data('clicked', true); if ($(this).is('.logo a')) { var homepage = $(this).attr('href'); function1(homepage); history.pushstate(null, null, homepage); } else if ($(this).is('.projects a')) { var projects = $(this).attr('href'); function2(projects); history.pushstate(null, null, projects); } else { var pages = $(this).attr('href'); function3(pages); history.pushstate(null, null, pages); ...
Read more