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

You are not allowed to 'info'


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


ID
Password
Join
Let him who takes the Plunge remember to return it by Tuesday.


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.0015 sec