- port converted in new layout

- textproc added in category (like astyle)

Ccdoc is a tool for extracting comments from C++ source code and presenting it
in HTML format, very similar to Java's JavaDoc tool. The tagging used in ccdoc
is very similar to that of Javadoc, with adaptations for the C++ specifics, of
course. Ccdoc supports extracting comments from both header and implementation
files.

In contrast to most other C++ doc'ing applications, ccdoc analyses the code
before it has been run through the pre-processor, so things such as macros can
actually be included in the documentation.

It's usage is not quite as straight forward as JavaDoc's, but considering the
quality of the output, it is well worth the effort.

WWW: http://www.joelinoff.com/ccdoc/

PR:		22794
Submitted by:	lonewolf@flame.org

4 files changed, 102 insertions, 0 deletions

diff --git a/devel/ccdoc/files/patch-aa b/devel/ccdoc/files/patch-aa
new file mode 100644
index 000000000000..f7b459075cb3
--- /dev/null
+++ b/devel/ccdoc/files/patch-aa
@@ -0,0 +1,17 @@
+--- ccdoc_dev/tools/mkmk.pl	Thu Oct  5 16:51:43 2000
++++ ccdoc_dev/tools/mkmk.patched	Thu Oct  5 16:52:25 2000
+@@ -166,11 +166,11 @@
+     else {
+ 	# UNIXes.
+ 	print MK "CPP         = CC\n";
+-	print MK "CPPFLAGS1   = -pto -pta +w\n";
++	print MK "CPPFLAGS1   = \$(CFLAGS) \n";
+ 	print MK "CPPFLAGS2   = -DJDL_DEFINE_LOCAL_TYPES -DJDL_DEFINE_LOCAL_BOOLEAN\n";
+-	print MK "CPPFLAGS3   = -I. -I../..\n";
++	print MK "CPPFLAGS3   = -I. -I../.. -o \$\@\n";
+ 	print MK "CPPFLAGS4   = \$(MYCPPFLAGS)\n";
+-	print MK "CPPFLAGS    = \$(CPPFLAGS1) \$(CPPFLAGS2) \$(CPPFLAGS3) \$(CPPFLAGS4) -c -o \$\@\n";
++	print MK "CPPFLAGS    = \$(CPPFLAGS1) \$(CPPFLAGS2) \$(CPPFLAGS3) \$(CPPFLAGS4) -c\n";
+ 	if ( $type == 1 ) {
+ 	    print MK "LINK        = \$(CPP)\n";
+ 	    if( $arch eq "hpux" ) {
diff --git a/devel/ccdoc/files/patch-ab b/devel/ccdoc/files/patch-ab
new file mode 100644
index 000000000000..4735559efcd4
--- /dev/null
+++ b/devel/ccdoc/files/patch-ab
@@ -0,0 +1,11 @@
+--- ccdoc_dev/ccdoc/src/ccdocphase3.h	Thu Oct  5 16:53:10 2000
++++ ccdoc_dev/ccdoc/src/ccdocphase3.h.patched	Fri Oct  6 07:15:30 2000
+@@ -210,7 +210,7 @@
+ 	   const char* trailer,
+ 	   bool mcfFlag);
+ private:
+-  WriteTop();
++  // WriteTop();
+   const char* GetCurrTime();
+   const char* GetProgram();
+ private:
diff --git a/devel/ccdoc/files/patch-ac b/devel/ccdoc/files/patch-ac
new file mode 100644
index 000000000000..116b58b5c305
--- /dev/null
+++ b/devel/ccdoc/files/patch-ac
@@ -0,0 +1,20 @@
+--- doc/main.html	Tue Jun 15 19:12:06 1999
++++ doc/main.html.patched	Fri Oct  6 16:05:53 2000
+@@ -407,7 +407,7 @@
+         </tr>
+         <tr>
+             <td height="42">&nbsp;<a
+-            href="ccdoc_v07a_bin_taz.exe">ccdoc_v07a bin_taz.exe</a></td>
++            href="http://www.joelinoff.com/ccdoc/ccdoc_v07a_bin_taz.exe">ccdoc_v07a bin_taz.exe</a></td>
+             <td width="56%" height="42">The binary distribution
+             for Solaris 5.6, HP UX 10, and Windows 95/98/NT. It
+             is about 530K.</td>
+@@ -415,7 +415,7 @@
+         </tr>
+         <tr>
+             <td height="23">&nbsp;<a
+-            href="ccdoc_v07a_src_taz.exe">ccdoc_v07a src_taz.exe</a></td>
++            href="http://www.joelinoff.com/ccdoc/ccdoc_v07a_src_taz.exe">ccdoc_v07a src_taz.exe</a></td>
+             <td width="56%" height="23">The source code
+             distribution along with the binaries. It is about
+             834K.</td>
diff --git a/devel/ccdoc/files/patch-ad b/devel/ccdoc/files/patch-ad
new file mode 100644
index 000000000000..2a1c0e202d9d
--- /dev/null
+++ b/devel/ccdoc/files/patch-ad
@@ -0,0 +1,54 @@
+--- ccdoc_dev/ccdoc/src/ccdocphase2.cpp	Mon Oct  9 08:28:09 2000
++++ ccdoc_dev/ccdoc/src/ccdocphase2.cpp.patched	Mon Oct  9 08:29:50 2000
+@@ -53,10 +53,10 @@
+   // TODO: After all of the files are processed, run through
+   //       and "fix" the "scoped" records that have comments.
+   if(m_ScopedNodeList.GetNumItems()) {
+-    ::fprintf(stderr,"DEBUG: %d scoped nodes found with comments.\n",
+-	      m_ScopedNodeList.GetNumItems());
+-    ::fprintf(stderr,"DEBUG: %d scoped node refs found for comment analysis.\n",
+-	      m_ClassMap.GetNumItems());
++    //::fprintf(stderr,"DEBUG: %d scoped nodes found with comments.\n",
++	      //m_ScopedNodeList.GetNumItems());
++    //::fprintf(stderr,"DEBUG: %d scoped node refs found for comment analysis.\n",
++	      //m_ClassMap.GetNumItems());
+     {for(uint i=0;i<m_ScopedNodeList.GetNumItems();i++) {
+       CCcDocParserNode* node = m_ScopedNodeList.Get(i);
+       CCcDocParserNode* parent = node->GetParent();
+@@ -89,15 +89,15 @@
+ 	}
+       }}
+       if(class_name) {
+-	::fprintf(stderr,"DEBUG: %s::%s\n",class_name,node->GetName());
++	//::fprintf(stderr,"DEBUG: %s::%s\n",class_name,node->GetName());
+ 	if(m_ClassMap.Contains(class_name)) {
+-	  ::fprintf(stderr,"DEBUG: found %s\n",class_name);
++	  //::fprintf(stderr,"DEBUG: found %s\n",class_name);
+ 	  CJdlVector<CCcDocParserNode*>* list = 0;
+ 	  list = (CJdlVector<CCcDocParserNode*>*) m_ClassMap.Get(class_name);
+ 	  assert(list);
+ 	  {for(ulong j=0;j<list->GetNumItems();j++) {
+ 	    CCcDocParserNode* cls = list->Get(j);
+-	    ::fprintf(stderr,"DEBUG: checking node %d/%d\n",j+1,list->GetNumItems());
++	    //::fprintf(stderr,"DEBUG: checking node %d/%d\n",j+1,list->GetNumItems());
+ 
+ 	    // Get arg list matching stuff.
+ 	    ulong x2 = 0; // starting paren
+@@ -109,7 +109,7 @@
+ 
+ 	    // Find the method:
+ 	    {for(ulong k=0;k<cls->GetNumChildren();k++) {
+-	      ::fprintf(stderr,"DEBUG: checking children %d/%d\n",k+1,cls->GetNumChildren());
++	      //::fprintf(stderr,"DEBUG: checking children %d/%d\n",k+1,cls->GetNumChildren());
+ 	      CCcDocParserNode* nd = cls->GetChild(k);
+ 	      assert(nd);
+ 	      if(CCcDocParserNode::STMT_FUNCTION == nd->GetType()) {
+@@ -125,7 +125,7 @@
+ 		  }}
+ 		  ulong diff1 = nd->GetNumItems() - x1;
+ 		  bool matched = false;
+-		  ::fprintf(stderr,"DEBUG: diff1=%d, diff2=%d\n",diff1,diff2);
++		  //::fprintf(stderr,"DEBUG: diff1=%d, diff2=%d\n",diff1,diff2);
+ 		  if(diff1 == diff2) {
+ 		    matched = true;
+ 		    for(;x2<node->GetNumItems() && x1<nd->GetNumItems();x1++,x2++) {