2015/04/16 Leave a comment
- Apart from the almost 150 markup tags Doxygen 1.1. supports (not to mention HTML tags that are supported also),
- the Doxygen config file in version 1.8.8 has over 260 settings, many with complex interrelations.
- To facilitate working with so many options, especially when testing. I reformatted the default config file for import into Excel,
- where I can more easily sort, search and filter,
- and export columns L-R whenever I need to update the doxygen.config file:
Below is a live, downloadable view:
Paper on use of “Speech recognition Tools for Oral Proficiency” training has appeared in this week’s FLTMag.com
2015/04/06 Leave a comment
- Since I have been asked to advertise this:
- These Speech recognition tools, while an invaluable partial evaluation automation or AI tool, come free with MS-Windows (7 Enterprise/Ultimate, 8 all distributions) – crucial for often resource-strapped language learning environments.
- The tools do not come with pre-built exercises – a blessing in disguise since this makes them easier to integrate them with your existing textbook-based syllabus. I provide some ideas how you can easily derive speech recognition exercises from your syllabus/textbooks.
- I recommend having a look at the entire new issue of FLTMag, the magazine on technology integration in the world language classroom, which
- examines other software that supports second language learning with video conferencing, support for writing and vocabulary learning (on tablets versus print materials) ,
- reviews a book on “Ideas for integrating technology in the classroom”
- and advertises upcoming conferences. Hope to see you there.
2015/04/02 Leave a comment
2015/03/15 Leave a comment
2015/03/02 Leave a comment
- Using Eclipse Luna CDT, with C/C++ spelling engine, to document C and C++ code in Doxygen (Eclox plugin),
- Spell check works for inline Doxygen documentation. My API-level code comments in *.[ch](pp)* files gets spell-checked alright (Well…:
- I had to download a decent dictionary to avoid recommendation like this one: . I am using the aspell dictionaries from here and here. This is before a restart/recheck:
- I still do not know how to teach the C++ spell check engine that a newline does not start a new sentence:
- The oft-referred to menu: Edit / Spell check does not show up for me:
- However, spell check ignores my standalone *.dox files with high-level documentation.
- What I have tried:
- Terrible, but since a similar question is still open on stackoverflow): If you can (*.dox requires all comments to be within c-style comments anyway), rename your *.dox files to *.dox.cpp. Terrible, but works:
- A bit less terrible if you mange to store your standalone *.dox files as *.dox.cpp permanently do this if you get your Doxygen to handle these extensions.
- What is nice to see is that the spell-checker recognizes Doxygen’s built-in reserved words (as opposed to my custom-defined Doxygen-commands).
- Other things to try:
Bringing method documentation back into synch by using Textpad command line to jump to GrepWin matched line in file
2015/02/14 Leave a comment
- Objective: is checking, in one simple result window, multi-line matches of method signatures and their Doxygen comments from a multi-module, multi-directory C++ codebase, in order to spot inconsistencies, i.e. where code and documentation are out f synch:
- All this short of having to write a Parser or buying a tool like Atomineer Pro Documentation (which does look like it is “right on the money”, but, as it turned out to my surprise, also far short of getting this to work in Eclipse or on a Bash command line with Grep and Perl, ack (doesn’t do multi-line matches!), ag, or what-not. grepWin is free, has an easy-to-use, versatile interface, and proves, once again, to be a powerful little tool.
- A a sample (in reality not cut off, of course), 2 methods with their comments showing here:
- And I am only a click away from correcting errors I spot in my preferred editor that grepWin can link in “Settings””C:\Program Files (x86)\TextPad 7\TextPad.exe” %path%(%line%,0)
- Some grepWin quirk I do not understand: