TechWhirl (TECHWR-L) is a resource for technical writing and technical communications professionals of all experience levels and in all industries to share their experiences and acquire information.
For two decades, technical communicators have turned to TechWhirl to ask and answer questions about the always-changing world of technical communications, such as tools, skills, career paths, methodologies, and emerging industries. The TechWhirl Archives and magazine, created for, by and about technical writers, offer a wealth of knowledge to everyone with an interest in any aspect of technical communications.
Has anyone used or heard of utilities to generate documentation for
functions from C/C++ code?
Currently, we manually cut, paste, and format text from commented C/C++
".c" and ".h" files. into the function reference section of our
programming guides. This gives the basic structure (function, syntax,
parameters, return values, and remarks) to the documentation for the
function. We then go back and edit it. The initial cutting, pasting, and
formatting seems a trite bit repetitive, leading some of the developers
to think that it can be automated. There is even rumour that one of the
developers might work on this.
Has this been tried before? Are there utilities out there already to do
this? If anyone has used this approach, what was it like? What were the
productivity gains, or losses?
BTW If you're interested in working for us, please submit a resume.
We're looking for a few more writers.
David Neufeld
=======================================================================
Technical Publications
dave_neufeld -at- spectrumsignal -dot- com
http:\\www.spectrumsignal.com
"no matter where you go..... there you are." -- Buckaroo Banzai
