Doxygen【特定注解转换成为说明文件】 1.7.5.1

oxygen是一个程式的文件产生工具，可将程式中的特定注解转换成为说明文件。 通常我们在写程式时，或多或少都会写上註解，但是对於其他人而言，要直接探索程式裡的註解，与打捞铁达尼号同样的辛苦。通常我们在写程式时，或多或少都会写上注解，但是对于其他人而言，要直接探索程式里的注解，与打捞铁达尼号同样的辛苦。 大部分有用的註解都是属於针对函式，类别等等的说明。大部分有用的注解都是属于针对函式，类别等等的说明。 所以，如果能依据程式本身的结构，将註解经过处理重新整理成為一个纯粹的参考手册，对於后面利用您的程式码的人而言将会减少许多的负担。所以，如果能依据程式本身的结构，将注解经过处理重新整理成为一个纯粹的参考手册，对于后面利用您的程式码的人而言将会减少许多的负担。 不过，反过来说，整理文件的工作对於您来说，就是沉重的负担。不过，反过来说，整理文件的工作对于您来说，就是沉重的负担。
一个好的程式设计师，在写程式时，都会在适当的地方加上合适的註解。一个好的程式设计师，在写程式时，都会在适当的地方加上合适的注解。 如果，能够在撰写註解时，稍微符合某种格式，接著就可以透过一个工具程式依据程式结构及您的註解產生出漂亮的文件。如果，能够在撰写注解时，稍微符合某种格式，接着就可以透过一个工具程式依据程式结构及您的注解产生出漂亮的文件。 这将令许多工作繁重的程式设计师有时间多喝几杯咖啡。这将令许多工作繁重的程式设计师有时间多喝几杯咖啡。
Doxygen 就是这样的一个工具。Doxygen就是这样的一个工具。 在您写註解时，稍微按照一些它所制订的规则。在您写注解时，稍微按照一些它所制订的规则。 接著，他就可以帮您產生出漂亮的文件了。接着，他就可以帮您产生出漂亮的文件了。 因此，Doxygen 的使用可分為两大部分。因此，Doxygen的使用可分为两大部分。 首先是特定格式的註解撰写，第二便是利用Doxygen的工具来產生文件。首先是特定格式的注解撰写，第二便是利用Doxygen的工具来产生文件。
目前Doxygen可处理的程式语言包含：目前Doxygen可处理的程式语言包含：
C/C++C/C++
JavaJava
IDL (Corba, Microsoft及KDE-DCOP类型)  IDL(Corba,Microsoft及KDE-DCOP类型)
而可產生出来的文件格式有：而可产生出来的文件格式有：
HTMLHTML
XMLXML
LaTeXLaTeX
RTFRTF
Unix Man PageUnixManPage
而其中还可衍生出不少其他格式。而其中还可衍生出不少其他格式。 如有了LaTeX 文件后，就可以透过一些工具產生出PS或是PDF档案。如有了LaTeX文件后，就可以透过一些工具产生出PS或是PDF档案