· KLDP.org · KLDP.net · KLDP Wiki · KLDP BBS ·
Docbook Sgml/ROBO Doc-KLDP

You are not allowed to 'backlinks'


ROBODoc

ROBODoc

¾È³«È£

           
        

ROBODocÀº ´Ù¾çÇÑ ¾ð¾îÀÇ ÁÖ¼®À» ÀÌ¿ëÇÏ¿© ¹®¼­¸¦ Á¦ÀÛÇØÁÖ´Â ¸Å¿ì Æí¸®ÇÑ Documentation ToolÀÔ´Ï´Ù. ÀÌ ±ÛÀº ROBODoc¿¡ ´ëÇÑ °£´ÜÇÑ ¼Ò°³¿Í »ç¿ë¹ýÀ» ´ã°í ÀÖ½À´Ï´Ù.

고친 과정
고침 1.02003-04-17고친이 nako an
ÃÖÃÊ ÀÛ¼º

1. ¸Ó¸®±Û

1.1. ROBODoc ¼Ò°³

ROBODocÀº ´Ù¾çÇÑ ¾ð¾î¿¡¼­ »ç¿ëÇÒ ¼ö ÀÖ´Â Documentation ToolÀÌ´Ù. http://sourceforge.net/projects/robodoc¿¡¼­ ÇÁ·ÎÁ§Æ®°¡ ÁøÇàÁßÀ̸ç ÀÌ°÷¿¡¼­ ¼Ò½º¸¦ ¹ÞÀ» ¼ö ÀÖ´Ù. ÇÁ·ÎÁ§Æ®ÀÇ È¨ÆäÀÌÁö´Â http://www.xs4all.nl/~rfsber/Robo ÀÌ´Ù.±ÛÀ» ¾²°í ÀÖ´Â ÇöÀç ¹öÀüÀº 4.0.0ÀÌ´Ù.

ROBODocÀº ¸Å¿ì ¸¹Àº ¾ð¾î¸¦ Áö¿øÇÑ´Ù. ROBODocÀº °íÀ¯ÇÑ ÁÖ¼®ÇüŸ¦ °¡Áö°í Àֱ⠶§¹®¿¡ »ç¿ëÇÏ´Â ¾ð¾î°¡ ¹«¾ùÀΰ¡¿¡ Å©°Ô ¿µÇâ¹ÞÁö ¾Ê´Â´Ù. ROBODocÀÌ Áö¿øÇÑ´Ù°í ¸Þ´º¾ó¿¡¼­ ¹àÈù ¾ð¾î´Â ´ÙÀ½°ú °°´Ù.

C, C++, Java, Assembler, Basic, Fortran, LaTeX, Postscript, Tcl/Tk, LISP, Forth, Perl, Shell Scripts, Occam, COBOL, HTML¿Í ±âŸ ¾ð¾îµé.

ROBODocÀº ¹®¼­È­ ÀÛ¾÷À» À§ÇØ ¼Ò½º³»ÀÇ ÁÖ¼®À» »ç¿ëÇϱ⠶§¹®¿¡ °³¹ß°ú ¹®¼­È­ ÀÛ¾÷À» ÅëÇÕÇÒ ¼ö ÀÖ°í ¹®¼­ÀÇ ¾÷µ¥ÀÌÆ®¸¦ ¿ëÀÌÇÏ°Ô ÇÒ ¼ö ÀÖ´Ù. »Ó¸¸ ¾Æ´Ï¶ó HTML,LaTex,XML DocBook À» ºñ·ÔÇÑ ´Ù¾çÇÑ Çü½ÄÀÇ Ãâ·ÂÆ÷¸ËÀ» Áö¿øÇÏ°í ´ÙÁß ÆÄÀÏÇü½ÄÀ¸·Î Ãâ·ÂÇÒ °ÍÀÎÁö ´ÜÀÏ ÆÄÀÏ·Î Ãâ·ÂÇÒ °ÍÀÎÁö µîÀ» ÁöÁ¤ÇÒ ¼ö ÀÖ°Ô ÇÑ´Ù.

ROBODocÀº ¼³Ä¡¿Í »ç¿ë¹ýÀÌ ¸Å¿ì °£´ÜÇÏ´Ù. ¹èÆ÷µÇ´Â ¼Ò½ºÄÚµå´Â ROBODocÀ» »ç¿ëÇÏ¿© ÁÖ¼®Ã³¸® µÇ¾î ÀÖÀ¸¸ç, »ç¿ëÀÚµéÀÌ °£´ÜÈ÷ copy & paste·Î »ç¿ëÇÒ ¼ö ÀÖ´Â À¯¿ëÇÑ templateµµ ÇÔ²² Á¦°øÇÑ´Ù. ÁÖ¼®Ã³¸® ¹®¹ýÀº °èÃþ±¸Á¶¸¦ Áö¿øÇÏ¸ç ¾ÆÁÖ Á÷°üÀûÀ¸·Î ±¸¼ºµÇ¾î ÀÖ¾î, óÀ½º¸´Â »ç¶÷µµ ½±°Ô ÀÍÈú ¼ö ÀÖ°Ô µÇ¾î ÀÖ´Ù.

ÀÌ ¹®¼­¿¡¼­´Â ´Ù¾çÇÑ ¾ð¾î¿Í Ãâ·ÂÆ÷¸ËÀÇ Áö¿ø, ¼Õ½¬¿î ¼³Ä¡¿Í »ç¿ë¹æ¹ý, °³¹ßÀÛ¾÷°ú ¹®¼­ÀÛ¾÷ÀÇ ÅëÇÕ°ú °°Àº Ư¡À» Áö´Ñ ROBODocÀ» ÀÌ¿ëÇØ ¹®¼­È­ÀÛ¾÷À» ÁøÇàÇÏ´Â ¹æ¹ýÀ» »ìÆ캻´Ù.


1.2. ÀúÀÛ±Ç Á¤º¸

ÀÌ ¹®¼­´Â GNU Free Documentation License ¹öÀü 1.1 ȤÀº ÀÚÀ¯ ¼ÒÇÁÆ®¿þ¾î Àç´Ü¿¡¼­ ¹ßÇàÇÑ ÀÌÈÄ ÆÇÀÇ ±ÔÁ¤¿¡ µû¸£¸ç ÀúÀ۱ǿ¡ ´ëÇÑ º» »çÇ×ÀÌ ¸í½ÃµÇ´Â ÇÑ ¾î¶°ÇÑ Á¤º¸ ¸Åü¿¡ ÀÇÇÑ º»¹®ÀÇ ÀüÀ糪 ¹ßÃéµµ ¹«»óÀ¸·Î Çã¿ëµË´Ï´Ù.


1.3. Ã¥ÀÓÀÇ ÇÑ°è

º» ÀúÀÚ´Â ¹®¼­ÀÇ ³»¿ëÀÌ ¾ß±âÇÒ ¼ö ÀÖ´Â ¾î¶°ÇÑ °á°ú¿¡ ´ëÇؼ­µµ Ã¥ÀÓÀ» ÁöÁö ¾Ê½À´Ï´Ù. º» ¹®¼­¿¡¼­ ³»Æ÷ÇÏ°í ÀÖ´Â Á¤º¸µé ¹× ¿¹Á¦µéÀº ¿©·¯ºÐÀÌ ¾Ë¾Æ¼­ È°¿ëÇϽʽÿÀ. ºñ·Ï ÃÖ¼±À» ´ÙÇßÀ¸³ª ÀÌ ¹®¼­´Â Ʋ¸° Á¡À̳ª ¿À·ù°¡ ÀÖÀ» ¼öµµ ÀÖ½À´Ï´Ù. ¸¸¾à ¿©·¯ºÐÀÌ Æ²¸° Á¡À» ¹ß°ßÇß´Ù¸é ²À Àú¿¡°Ô ¾Ë·Á Áֽñ⠹ٶø´Ï´Ù.


1.4. Çǵå¹é

ÀÌ ¹®¼­¿¡ ´ëÇÑ ¹ßÀüÀûÀÎ Á¦¾ÈÀ̳ª ¼öÁ¤»çÇ×, ¹®Á¦Á¡ µî¿¡ ´ëÇÑ Çǵå¹éÀº ¾ðÁ¦µçÁö ȯ¿µÇÕ´Ï´Ù. ·Î ¸ÞÀÏÀ» º¸³» ÁֽʽÿÀ.


2. ROBODocÀÇ ¼³Ä¡

ROBODocÀÇ ¼³Ä¡¹æ¹ýÀº ´ÙÀ½°ú °°´Ù.

Àû´çÇÑ µð·ºÅ丮¿¡ robodoc-4.0.0.tar.gzÆÄÀÏÀ» °®´Ù ³õ´Â´Ù.

#tar zxvf robodoc-4.0.0.tar.gz

#cd robodoc-4.0.0

#./configure

#make

#make install

ÀÌ°ÍÀ¸·Î ¼³Ä¡´Â ¸ðµÎ ³¡³µ´Ù. ÀÌÁ¦ ¾Æ¹«°÷¿¡¼­³ª robodocÀ» ÀÌ¿ëÇÒ ¼ö ÀÖ´Ù.


3. Code ³»¿¡ header ÀÛ¼ºÇϱâ

¼Ò½º ÄÚµå ³»¿¡ header¸¦ ÀÛ¼ºÇÏ´Â °ÍÀ¸·Î ¹®¼­È­¸¦ À§ÇÑ Áغñ´Â ¸ðµÎ ³¡³­´Ù.ROBODocÀÇ header´Â ¸Å¿ì °£´ÜÇϸ鼭µµ ü°èÀûÀ¸·Î ±¸¼ºµÇ¾î ÀÖ´Ù.


3.1. Çü½Ä

DocumentationÀ» À§ÇØ ¼Ò½ºÄÚµå ³»¿¡ »ðÀԵǴ ¿ä¼Ò´Â Header¶ó°í ÇÑ´Ù. Header´Â begin marker¿Í end marker, itemÀ¸·Î ±¸¼ºµÇ¾î ¹®¼­È­ ÀÛ¾÷ÀÇ ÇÑ ºí·ÏÀ» ÀÌ·é´Ù. ´ÙÀ½ÀÇ ¿¹Á¦¸¦ º¸ÀÚ.

/****f* module-1/killhim
 * NAME
 *   killhim
 * SYNOPSYS
 *   int killhim(char *name, char *method, int count)
 * FUNCTION
 *   ´ë»ó°ú ¼ö´Ü, Ƚ¼ö¸¦ °ñ¶ó ¹æ¹ýÇÏ´Â ÇÔ¼ö´Ù.
 * INPUT
 *   name -- ´ë»ó
 *   method -- ¼ö´Ü
 *   count -- Ƚ¼ö
 * RESULT
 *   0 for success, else an error code return
 ******
 * ¿©±â¿¡ ¾²´Â ÁÖ¼®Àº ¹®¼­È­ µÇÁö ¾Ê´Â´Ù.
 */

 int killhim(char *name,char *method, int count){
     if((strcmp(name,"bush"))==0)
         count *= 100;
     while(count-- > 0)
         hithim(name,method);
     return 0;
 }

À§ÀÇ ¿¹Á¦´Â ÇϳªÀÇ header¸¦ ÀÌ·ç°í ÀÖ´Ù. ÀÌ header´Â ¾Æ·¡ÀÇ killhim¿¡ ´ëÇÑ ÁÖ¼®ÀÌÀÚ ¹®¼­°¡ µÇ´Â °ÍÀÌ´Ù.

****f* module-1/killhim

ÀÌ ºÎºÐÀÌ begin markerÀÌ´Ù. Çì´õ°¡ ½ÃÀÛµÊÀ» Ç¥½ÃÇÑ´Ù. Ç÷¡±×¿Í µÚÀÇ °èÃþ¿¡ ´ëÇؼ­´Â µÚ¿¡¼­ ¼³¸íÇÏ°Ú´Ù.

 * NAME
 *   killhim
 * SYNOPSYS
 *   int killhim(char *name, char *method, int count)

item ºÎºÐÀÌ´Ù. itemµéÀº Á¤ÀǵǾî ÀÖÀ¸¸ç »ç¿ëÀÚ Á¤ÀǸ¦ Ãß°¡ÇÒ ¼öµµ ÀÖ´Ù.

 ******

end marker´Ù. ÀÌ Ç¥½Ã¸¦ ±âÁØÀ¸·Î header´Â ³¡³­´Ù. ÀÌÈÄ¿¡ À̾îÁö´Â ÁÖ¼®Àº robodoc¿¡ ¿µÇâÀ» ÁÖÁö ¸øÇÑ´Ù.

°¢°¢ÀÇ ¸¶Å© ¾Õ¿¡´Â »ç¿ëÇÏ´Â ¾ð¾îÀÇ ÁÖ¼®ÀÌ ºÙ°Ô µÈ´Ù. ´ÙÀ½Àº °¢ ¾ð¾îº°·Î markÇÏ´Â ¹æ½ÄÀÌ´Ù.

/****       C, C++
 *
 ***

//****      C++
//
//***

(****       Pascal, Modula-2
 *
 ***
*)

{****       Pascal
 *
 ***
*}

;****       M68K assembler
;
;***

****        M68K assembler
*
***

C     ****  Fortran
C     
C     ***


REM ****    BASIC
REM *
REM ***

%****       LaTeX, TeX, Postscript
%
%***

#****       Tcl/Tk
#
#***

****  COBOL
*
***

--****      Occam
--
--***

|****       GNU Assembler
|
|***

!!****      FORTRAN 90
!!
!!***


3.2. Header Type

header typeÀº ÇöÀç ÀÛ¼ºÁßÀÎ Çì´õ°¡ ¹«¾ù¿¡ ´ëÇÑ Çì´õÀÎÁö¸¦ ¾Ë·ÁÁØ´Ù. Áï, ÇÔ¼ö¿¡ ´ëÇÑ Çì´õÀÎÁö ¸ðµâ¿¡ ´ëÇÑ Çì´õÀÎÁö¿¡ ´ëÇÑ Ç¥½ÃÀÎ °ÍÀÌ´Ù. Çì´õ¸¦ Ç¥½ÃÇÔÀ¸·Î½á Àε¦½Ì°ú Á¤·ÄÀ» È¿°úÀûÀ¸·Î ÇÒ¼ö ÀÖ°Ô µÈ´Ù.

¾ÕÀÇ begin marker ****f¿¡¼­ "f"°¡ ¹Ù·Î Çì´õ ŸÀÔÀÌ´Ù. Áö¿øÇÏ´Â Çì´õ ŸÀÔÀº ¾Æ·¡¿Í °°´Ù.

 h -- ¸ðµâ(module in project)
 f -- ÇÔ¼ö(function)
 s -- ±¸Á¶Ã¼(structure)
 c -- Ŭ·¡½º(class)
 m -- ¸Þ¼Òµå(method)
 v -- º¯¼ö(variable)
 d -- »ó¼ö(constant)
 * -- ÀϹÝ(generic header)


3.3. item

ROBODoc¿¡ Á¤ÀÇµÈ itemÀº ´ÙÀ½°ú °°À¸¸ç, robodoc.rcÆÄÀÏÀ» ÀÌ¿ëÇØ Ãß°¡ÇÒ ¼ö ÀÖ´Ù.

  • NAME -- Item name plus a short description.

  • SYNOPSIS, USAGE -- How to use it.

  • FUNCTION, DESCRIPTION, PURPOSE -- What does it do.

  • AUTHOR -- Who wrote it.

  • CREATION DATE -- When did the work start.

  • MODIFICATION HISTORY, HISTORY -- Who has done which changes and when.

  • INPUTS, ARGUMENTS, OPTIONS, PARAMETERS, SWITCHES -- What can we feed into it.

  • OUTPUT, SIDE EFFECTS -- What output is made.

  • RESULT, RETURN VALUE -- What do we get returned.

  • EXAMPLE -- A clear example of the items use.

  • NOTES -- Any annotations

  • DIAGNOSTICS --Diagnostic output

  • WARNINGS, ERRORS -- Warning and error-messages.

  • BUGS -- Known bugs.

  • TODO, IDEAS -- What to implement next and ideas.

  • PORTABILITY -- Where does it come from, where will it work.

  • SEE ALSO -- References to other functions, man pages, other documentation.

  • METHODS, NEW METHODS -- OOP methods.

  • ATTRIBUTES, NEW ATTRIBUTES -- OOP attributes

  • TAGS -- Tag-item description.

  • COMMANDS -- Command description.

  • DERIVED FROM -- OOP super class.

  • DERIVED BY -- OOP sub class.

  • USES, CHILDREN -- What modules are used by this one.

  • USED BY, PARENTS -- Which modules do use this one.

  • SOURCE -- Source code inclusion.


3.4. section

/****f* module-1/killhim ¿¡¼­ module-1/killhim¿¡ ÇØ´çÇÏ´Â ºÎºÐÀÌ sectionÀÌ´Ù. sectionÀº ¹®¼­ÀÇ °èÃþÈ­¸¦ À§Çؼ­ Á¸ÀçÇÑ´Ù. ÇÁ·ÎÁ§Æ®/¸ðµâ/(ÇÔ¼ö ¶Ç´Â º¯¼ö³ª class µî)À¸·Î °èÃþÀ» ³ª´©¾î sectionÀ» È°¿ëÇÏ¸é ¹®¼­·Î º¯È¯ÇÒ ¶§ ROBODocÀº À̸¦ ÀνÄÇÏ°í À妽ÌÇØÁØ´Ù. ¿¹¸¦ µé¾î ´ÙÀ½°ú °°Àº ±¸Á¶ÀÇ ÇÁ·ÎÁ§Æ®°¡ ÀÖ´Ù°í ÇÏÀÚ.

-ProjectA -- module1 -- function1
                     -- variable1
	  -- module2 -- function2
	             -- function3

ÀÌ °æ¿ì °¢°¢ÀÇ Çì´õ´Â ´ÙÀ½°ú °°ÀÌ sectionÀ¸·Î ³ª´­ ¼ö ÀÖ´Ù.

/****h* ProjectA/module1
...
/****h* ProjectA/module2
...
/****f* module1/function1
...
/****v* module1/variable1
...
/****f* module2/function2
...
/****f* module2/function3
...

ÀÌ·¸°Ô sectionÀ» ÁöÁ¤ÇÑ ÈÄ ROBODocÀ» ÀÌ¿ëÇØ HTMLº¯È¯À» ÇÏ¸é ´ÙÀ½°ú °°ÀÌ indexing µÈ´Ù.

1 ProjectA/module1
1.1 module1/function1
1.2 module1/variable1
2 ProjectA/module2
2.1 module2/function2
2.2 moudle2/function3
..


4. ROBODocÀ¸·Î ¹®¼­ »ý¼ºÇϱâ

ROBODocÀº ¹®¼­¸¦ Á÷Á¢ »ý¼ºÇÑ´Ù. ÀϺΠDocumentation Tooló·³ Áß°£°úÁ¤¿¡¼­ ÆÄÀÏÀ» »ý¼ºÇÏ°í ´Ù½Ã ±× ÆÄÀÏÀ» ´Ù¸¥ ¹®¼­Çü½ÄÀ¸·Î º¯È¯ÇÏ´Â ¹æ½ÄÀÌ ¾Æ´Ï¶ó HTMLÀ̵ç LaTexµç »ó°ü ¾øÀÌ ¼Ò½ºÄڵ忡¼­ ¹Ù·Î ¹®¼­¸¦ »ý¼ºÇØÁØ´Ù.


4.1. ¼¼°¡Áö ¸ðµå

ROBODoc ¹®¼­È­¿¡´Â ¼¼°¡Áö ¸ðµå°¡ ÀÖ´Ù.

singledoc ¸ðµå´Â Ãâ·ÂµÇ´Â ¹®¼­¸¦ ÇϳªÀÇ ÆÄÀÏ·Î ÀúÀåÇÑ´Ù. ¹Ý¸é multidocÀº ¹®¼­¸¦ ¿©·¯°³ÀÇ ÀÛÀº Á¶°¢À¸·Î ³ª´©¾î ÁØ´Ù. ÀÌ ¸ðµå´Â browser·Î º¸¾Æ¾ß ÇÏ´Â HTMLÇü½ÄÀÇ ¹®¼­¸¦ Ãâ·ÂÇÒ ¶§ ¸Å¿ì ÁÁ´Ù. singlefile ¸ðµå´Â µð¹ö±ë ¸ñÀûÀ¸·Î Á¸ÀçÇÑ´Ù°í Çϴµ¥ Á¤È®È÷ ¹«½¼ ¶æÀÎÁö´Â Àß ¸ð¸£°Ú´Ù.


4.2. Ãâ·Â Æ÷¸Ë

´ÙÀ½ 4°¡ÁöÀÇ Ãâ·Â Æ÷¸ËÀ» Áö¿øÇÑ´Ù. ¿·¿¡´Â °¢°¢ÀÇ Ãâ·ÂÆ÷¸Ë¿¡ µû¸¥ ¿É¼ÇÀ» Àû¾î³õ¾Ò´Ù.

RTF, --rtf
HTML, --html
LaTeX, --latex
XML DocBook, --dbxml


4.3. option

ROBODoc¿¡ »ç¿ëµÇ´Â ¸î°¡Áö Áß¿äÇÑ ¿É¼ÇµéÀÌ´Ù.

--doc
  ¹®¼­°¡ Ãâ·ÂµÉ path¸¦ ÁöÁ¤ÇÑ´Ù. 

--index
  master index ÆÄÀÏÀ» »ý¼ºÇØÁØ´Ù. ½ÇÁ¦·Î Çغ¸¸é multidoc ¸ðµå¿Í ÇÔ²² ¾²¿©Áú ¶§¿¡¸¸ 
  »ý¼ºµÈ´Ù. html ÆÄÀÏÀ» »ý¼ºÇÒ °æ¿ì masterindex.htmlÆÄÀÏÀÌ »ý¼ºµÈ´Ù.

--multidoc
  ÇϳªÀÇ ¼Ò½º´ç ÇϳªÀÇ ¹®¼­¸¦ »ý¼ºÇÑ´Ù. µð·ºÅ丮 ±¸Á¶¸¦ °èÃþ±¸Á¶·Î »ç¿ëÇÑ´Ù.

--nodesc
  subdirectory ¸¦ Á¦¿ÜÇÏ°í top directory¿¡ ´ëÇؼ­¸¸ ¹®¼­È­¸¦ ÇÑ´Ù.

--src
source ÆÄÀÏ°ú µð·ºÅ丮¸¦ ÁöÁ¤ÇÑ´Ù.

¾Õ¼­ ¼­¼úÇÑ ¸ðµå,Ãâ·ÂÆ÷¸ËÀº À̸§ ±×´ë·Î ¿É¼ÇÀ¸·Î »ç¿ëÇÑ´Ù. ¿¹¸¦ µé¾î multidoc¸ðµå´Â --multidoc ¿É¼ÇÀ¸·Î ³Ö¾îÁØ´Ù.


4.4. robodoc.rcÆÄÀÏ

robodoc.rcÆÄÀÏÀº robodoc»ç¿ëÀ» ÃÖÀûÈ­ Çϱâ À§ÇÑ ¼³Á¤ ÆÄÀÏÀÌ´Ù. robodoc.rcÆÄÀÏ¿¡´Â itemÀÇ Ãß°¡, º¯È¯ ¿É¼ÇÀÇ ÁöÁ¤µîÀÌ °¡´ÉÇÏ´Ù. ´ÙÀ½Àº manual¿¡ ³ª¿Â robodoc.rcÆÄÀÏÀÇ ¿¹ÀÌ´Ù.

robodoc.rc

items:
    NAME
    SYNOPSIS
    INPUTS
    OUTPUTS
    HISTORY
ignore items:
    HISTORY
    BUGS
options:
    --src
    ./source
    --doc
    ./doc
    --html
    --multidoc
    --index
extensions:
    .bak
    ~

ÀÌ ÆÄÀÏÀ» ¼öÁ¤ÇØ ÇöÀç ÀÛ¾÷ µð·ºÅ丮¿¡ ³Ö¾îµÎ°í robodocÀ» ½ÇÇà½ÃÅ°¸é µÈ´Ù.


4.5. »ç¿ë¿¹

ÀÌÁ¦ ¸¸µé¾îÁø header¸¦ ÀÌ¿ëÇÏ¿© ½ÇÁ¦ ¹®¼­¸¦ »ý¼ºÇÏ´Â ¿¹¸¦ º¸µµ·Ï ÇÏ°Ú´Ù. ¾Æ·¡ÀÇ ¿¹Á¦¿¡¼­´Â source µð·ºÅ丮ÀÇ »óÀ§µð·ºÅ丮¿¡¼­ ½ÇÇàÇÑ °ÍÀÌ´Ù. sourceÀÇ top directory¸¦ %source%¶ó ÇÏ°Ú´Ù.

HTML·Î Ãâ·Â½Ã

#robodoc --src ./%source% --doc ./docs --multidoc --index --html

%source% ¿¡ ÀÖ´Â ¼Ò½º¸¦ ÀÌ¿ëÇÏ¿© ./docs µð·ºÅ丮¿¡ ¹®¼­¸¦ »ý¼ºÇÏ°Ô µÈ´Ù. htmlÇü½ÄÀ¸·Î Ãâ·ÂÇÏ°í multidoc ¸ðµåÀ̹ǷΠÆÄÀÏÀ» ³ª´©°Ô µÈ´Ù. --index ¿É¼Ç¿¡ ÀÇÇØ masterindex.htmlÆÄÀÏÀ» »ý¼ºÇÑ´Ù. ÁÖÀÇÇÒ °ÍÀº --src³ª --doc ¿É¼Ç ´ÙÀ½¿¡ µð·ºÅ丮°¡ ¿Ã °æ¿ì ¹Ýµå½Ã ./ ³ª / ·Î ½ÃÀÛÇØ¾ß ÇÑ´Ù´Â °ÍÀÌ´Ù. À̸¦ ÁöÅ°Áö ¾ÊÀ¸¸é ¿¡·¯ ¸Þ¼¼Áö¸¦ º¸°Ô µÈ´Ù.

RTF·Î Ãâ·Â½Ã

#robodoc --src ./%source% --doc docu --singledoc --rtf --sections

rtf´Â browse ÇÒ ¼ö ÀÖ´Â ÆÄÀÏÀÌ ¾Æ´Ï¹Ç·Î --singledoc ¿É¼ÇÀ¸·Î º¯È¯ÇÑ´Ù. À§ ¸í·ÉÀÇ °á°ú·Î docu.rtf ÆÄÀÏÀÌ »ý¼ºµÈ´Ù.

LaTex·Î Ãâ·Â½Ã

#robodoc --src ./%source% --doc docu --singledoc --latex --sections

°á°ú·Î docu.texÆÄÀÏÀÌ »ý¼ºµÈ´Ù. »ý¼ºµÈ texÆÄÀÏÀ» ps,dviµîÀ¸·Î º¯È¯ÇÏ´Â °ÍÀº ´Ù¸¥ ¹®¼­¸¦ Âü°íÇ϶ó. ¾ÆÁ÷ Çѱ۷δ ½ÇÇèÇغ¸Áö ¾Ê¾Ò±â ¶§¹®¿¡ ÇѱÛÀÌ Àß Ãâ·ÂµÇ´ÂÁö´Â Àå´ãÇÒ ¼ö°¡ ¾ø´Ù.


5. ±âŸ

ROBODocÀÇ »ç¿ë¹ý¿¡ ´ëÇؼ­ »ìÆ캸¾Ò´Ù. ÀÌ ¹®¼­´Â ¼Ò½º¿Í ÇÔ°Ô Á¦°øÇÏ´Â manualÆäÀÌÁö¸¦ ´ëºÎºÐ Âü°íÇÏ¿© ÀÛ¼ºÇÏ¿´´Ù. ÀÌ ¹®¼­¿¡¼­ ´Ù·çÁö ¾ÊÀº ³»¿ëÀ̳ª ºÒÃæºÐÇÑ ³»¿ëÀº Docs/manual.html¿¡¼­ ãÀ» ¼ö ÀÖ´Ù.

dzºÎÇÑ ¿¹Á¦¸¦ ¿øÇÑ´Ù¸é ROBODoc ¼Ò½º ÀÚü¸¦ »ìÆ캸¸é µÈ´Ù. ¹èÆ÷µÇ´Â ROBODoc¼Ò½º´Â ROBODocÀ» ÀÌ¿ëÇÒ ¼ö ÀÖµµ·Ï Çì´õ°¡ »ðÀԵǾî ÀÖ´Ù.

¼Ò½ºÀÇ Headers/ µð·ºÅ丮¿¡´Â ¹Ù·Î °¡Á®´Ù ¾µ¼ö ÀÖ°Ô Çì´õµéÀ» ¸ð¾Æ³õ¾Ò´Ù. ÀÚ½ÅÀÌ »ç¿ëÇÏ´Â ¾ð¾î¿Í °ü·ÃµÈ ÆÄÀÏÀ» ¿­°í °¡Á®´Ù ¾²¸é Æí¸®ÇÏ´Ù.




sponsored by andamiro
sponsored by cdnetworks
sponsored by HP

Valid XHTML 1.0! Valid CSS! powered by MoniWiki
last modified 2003-08-10 11:52:29
Processing time 0.0013 sec