Solved

C/C++ Automatic Manual Generation.

Posted on 1997-06-12
2
202 Views
Last Modified: 2006-11-17
Does there exist a tool for managing C/C++ software
development and C/C++ software documentation simultaneously?

I am especially thinking of maintaining the consistency
between a C/C++ API (Advanced Programming Interface) and
its UNIX-like manual (see UNIX man function) documentation.

Ideally, I would seek an automatic manual generator from
C/C++ to Word with the ability of managing software development and software documentation simultaneously,
invloving a documented C/C++ software standard.
0
Comment
Question by:tjfo
2 Comments
 
LVL 5

Accepted Solution

by:
yonat earned 200 total points
ID: 1163894
Check out c2man at:
http://www.idiom.com/free-compilers/TOOL/C-37.html

Also cxx2html at
ftp://aips2.cv.nrao.edu/pub/aips++/RELEASED/cxx2html

You may be able to get src2doc from the author
http://badger.parl.com/modsim/Src2Doc/Src2Doc.html

And if this is not what you had in mind, you may check out
commercial tools. I have good experience with Rational
(http://www.rational.com). Their Rose CASE tool supports round-
trip development, so the design diagrams are kept in sync with
the code. They also have a documentation tool called SoDA, but I
haven't used it.

0
 

Author Comment

by:tjfo
ID: 1163895
This answers my need. However, how would you see ASCII or
TeX to Word automatic translation?

Thanks very much,
Thierry.

0

Featured Post

3 Use Cases for Connected Systems

Our Dev teams are like yours. They’re continually cranking out code for new features/bugs fixes, testing, deploying, testing some more, responding to production monitoring events and more. It’s complex. So, we thought you’d like to see what’s working for us.

Question has a verified solution.

If you are experiencing a similar issue, please ask a related question

Suggested Solutions

Written by John Humphreys C++ Threading and the POSIX Library This article will cover the basic information that you need to know in order to make use of the POSIX threading library available for C and C++ on UNIX and most Linux systems.   [s…
This article shows you how to optimize memory allocations in C++ using placement new. Applicable especially to usecases dealing with creation of large number of objects. A brief on problem: Lets take example problem for simplicity: - I have a G…
The goal of the video will be to teach the user the concept of local variables and scope. An example of a locally defined variable will be given as well as an explanation of what scope is in C++. The local variable and concept of scope will be relat…
The viewer will learn how to use the return statement in functions in C++. The video will also teach the user how to pass data to a function and have the function return data back for further processing.

770 members asked questions and received personalized solutions in the past 7 days.

Join the community of 500,000 technology professionals and ask your questions.

Join & Ask a Question