Save to:

## Miscellaneous Environmental Issues

### How can I generate HTML documentation for my classes? Does C++ have anything similar to javadoc?

Yes. Here are a few (listed alphabetically by tool name):

• ccdoc supports javadoc-like syntax with various extensions. It’s freely copiable and customizable.
• doc++ generates HTML or TeX. Supports javadoc-like syntax with various extensions. Open Source.
• doxygen generates HTML, LaTeX or RTF. Supports javadoc-like syntax with various extensions. Open Source.
• PERCEPS generates HTML, TeX, RTF, man page, plain text, and anything else you’d like (it lets you set up arbitrary output formats). It’s freely copiable.

Other documentation tools are listed at www.robertnz.net/cpp_site.html.

### Is there a TeX or LaTeX macro that fixes the spacing on “C++”?

Yes.

Here are two LaTeX macros for the word “C++”. They prevent line breaks between the “C” and “++”, and the first packs the two “+”s close to each other but the second does not. Try them both and see which one you like best.

\newcommand{\CC}{C\nolinebreak\hspace{-.05em}\raisebox{.4ex}{\tiny\bf +}\nolinebreak\hspace{-.10em}\raisebox{.4ex}{\tiny\bf +{rbrace}{rbrace}

\def\CC{lbrace}{lbrace}C\nolinebreak[4]\hspace{-.05em}\raisebox{.4ex}{\tiny\bf ++{rbrace}{rbrace}{rbrace}


Here are two more LaTeX macros for the word “C++”. They allow line breaks between the “C” and “++”, which may not be desirable, but they’re included here just in case.

\def\CC{C\raise.22ex\hbox{lbrace}{lbrace}\footnotesize +{rbrace}{rbrace}\raise.22ex\hbox{\footnotesize +{rbrace}{rbrace}

\def\CC{lbrace}{lbrace}C\hspace{-.05em}\raisebox{.4ex}{\tiny\bf ++{rbrace}{rbrace}{rbrace}


### Are there any pretty-printers that reformat C++ source code?

In alphabetical order:

Finally, you might consider lgrind which is another C++ to LaTeX translator (check for the closest mirror site of the ctan archive). The following is a grind definition for C++ (but this one doesn’t recognize some new keywords such as bool or wchar_t, and it doesn’t recognize a file ending with .cpp as C++):

C++|c++|CC:\
:pb=\p\d?$$:cf:np=$$\d?;:bb={:be=}:\
:cb=(SLASH)*:ce=*(SLASH):ab=(SLASH)(SLASH):ae=$:sb=":se=\e":lb=':\ :zb=@:ze=@:tb=%%:te=%%:mb=%\$:me=\\$%:vb=%\|:ve=\|%:\
:le=\e':tl:id=_~\::\
:kw=asm auto break case cdecl char continue default do double else\
enum extern far float for fortran goto huge if int interrupt long\
near pascal register return short signed sizeof static struct\
switch typedef union unsigned while void\
#define #else #endif #if #ifdef #ifndef #include #undef # define\
endif ifdef ifndef include undef defined #pragma\
class const delete friend inline new operator overload private\
protected public template this virtual:


### Is there a C++-mode for GNU emacs? If so, where can I get it?

Yes, there is a C++-mode for GNU emacs.

The latest and greatest version of C++-mode (and C-mode) is implemented in the file cc-mode.el. It is an extension of Detlef and Clamen’s version. A version is included with emacs. Newer version are available from the elisp archives.

### Where can I get OS-specific questions answered (e.g., BC++, Windows, etc)?

See one of the following:

The compiler attempts to save space in the executable by not including the float-to-string format conversion routines unless they are necessary, but sometimes it guesses wrong, and gives you the above error message. You can fix this by (1) using <iostream> instead of <cstdio>, or (2) by including the following function somewhere in your compilation (but don’t call it!):

static void dummyfloat(float *x) { float y; dummyfloat(&y); }


See the FAQ on stream I/O for more reasons to use <iostream> vs. <cstdio>.

### Why does my BC++ Windows app crash when I’m not running the BC45 IDE?

If you’re using BC++ for a Windows app, and it works okay as long as you have the BC45 IDE running, but when the BC45 IDE is shut down you get an exception during the creation of a window, then add the following line of code to the InitMainWindow() member function of your application (YourApp::InitMainWindow()):

EnableBWCC(TRUE);