E D R , A S I H C RSS

프로그램내에서의주석




( , , ) ? --JuNe
..Refactoring .. 해하 . 해한 . ^^; --

Javadoc ; (IntelliJ 3.0 Source Folding Javadoc ) . , Pair 할 Class Diagram , . Class Diagram , Javadoc generation 한 .

, . 흐흐;

, , . 하, . --

, , 크하 , . command.Command.execute() information.InfoManager.writeXXX() , class package . class diagram , , ( .) 해 class diagram . 하 JavaDoc 편하 편하. --

IDE Source Folding comment . JavaDoc API Framework Library MSDN . --

, , 해하 ? abstract 한 클 , . ( Read , Swing tree . 해 Pair )

Server 해하 Class Diagram JavaDoc 편했. ( 해하 .). UML 함. Java Source 해하 편하 . ( ;) --
. . .. 휴 , " " UML ~cpp JavaDoc . 해하 , ~cpp JavaDoc . Sun msdn 해(?) ~cpp JavaDoc .

, "확 ~cpp JavaDoc 편하 편하." , ~cpp JavaDoc .( .) ~cpp JavaDoc , " 화" . jdk ~cpp JavaDoc , 해 library ? 한 표 . 히 표 ? 해한 . . 한 Report . Refactoring . . .. --

해한 ( .) 3000~4000 '' . CVS history , .

Comment JavaDoc . . comment, 해 interface JavaDoc . JavaDoc Class Diagram . (Class Diagram Conceptual Model )

, JDK Application . JDK JDK interface 해 하 JavaDoc . 하, Application implementation . 'Information' . 해 library 키텍 . , Server/Client Socket Connection , DB DB Connection . Application library .

comment, document, source code ( Reverse Engineering Tool ) 한 comment 화하 . DesignPatterns , . . . ( Documentation . Documentation 행하 . Doc Doc ;) --

DeleteMe) , , commit . 하..하..하 ... .

(comment) ~cpp JavaDoc . . , . (?).. object world " " . --
DeleteMe) : Eclipse . IntelliJ . Vi Java Syntax .




, . subset (code tells) . , , .

. . . .

(회 )


~cpp 
...
		//   ...
		CSmilNode* pChildNode = m_pFirstChild;
		while(pChildNode)
		{
			CSmilNode* pDelNode = pChildNode;
			pChildNode = pChildNode->m_pNext;
			pDelNode->deleteSafely(bRecursive);
			pDelNode = NULL;
		}

		// 형   ...
		if(m_pPrev)
			m_pPrev->m_pNext = m_pNext;
		if(m_pNext)
			m_pNext->m_pPrev = m_pPrev;

		//    ...
		if(m_pParent  &&  m_pParent->m_pFirstChild == this)
			m_pParent->m_pFirstChild = m_pNext;

		// .
		delete this;
...

.


~cpp 
...
// MODE_ADDBEFORE , newnode this  brother    .
// MODE_ADDAFTER , newnode this  brother     .
//  ,   ,    .
//  ,     , 형  .
//
// Default Parameter
//	nMode = MODE_ADDBEFORE
//	brother = NULL
// Constraint
//	brother  NULL this child node.
// 
//	addChild(newnode, MODE_ADDAFTER, brother);		//newnode brother   .
//	addChild(newnode, MODE_ADDBEFORE, brother);		//newnode brother   .
//	addChild(newnode, MODE_ADDAFTER);				//newnode first child .
//	addChild(newnode, /*MODE_ADDBEFORE*/);			//newnode last child .
//
CSmilNode* CSmilNode::addChild(CSmilNode* newnode, DCLADDMODE nMode, CSmilNode* brother)
//	this = ()
//	newnode = ()
//	brother = (this )형
...

. ( . . .) , ?

. , .

, .

--

See Also Seminar:CommentOrNot , NoSmok:DonaldKnuth 's comment on programs as works of literature
Valid XHTML 1.0! Valid CSS! powered by MoniWiki
last modified 2021-02-07 05:31:26
Processing time 0.0501 sec