Fink

Package robodoc-4.99.41-1

SystemCVS/rsync Source DistributionsDebian Binary Distributions
stable RSS feed stableunstable RSS feed unstablestableunstable
10.9/x86_64
 
 
10.8/x86_64
 
 
10.7/x86_64
 
 
 
10.6/x86_64
 
 
 
10.6/i386
 
 
 
10.5/i386 *
4.99.41-1
 
 
10.5/powerpc *
 
 
10.4/i386 *
 
 
10.4/powerpc *
 
 
10.3/powerpc *
 
 
10.2-gcc3.3/powerpc *
 
 
 
 
10.2/powerpc *
 
 
 
 
10.1/powerpc *
 
 
 
 
Description:   Source code documentation tool (4.99.41-1)
It is difficult to keep documentation in sync with source code. One of the reasons is that documentation and source code are stored in separate files that usually also require different editors to edit them. ROBODoc solves this problem. Specially formatted documentation headers are extracted from source files, reformatted in HTML, XML DocBook, TROFF, ASCII, LaTeX, PDF, or RTF, and stored in a different file. This way ROBODoc allows you to include your documentation in the source code. You can edit the source code as well as the documentation in a single file with your favourite editor. This makes it easier to keep your documentation in sync with your source code. ROBODoc can be used to document functions, methods, classes, variables, makefile entries, system tests, and anything else you can think of. ROBODoc works with C, C++, Fortran, Perl, shell scripts, Assembler, DCL, DB/C, Tcl/Tk, Forth, Lisp, COBOL, Occam, Basic, HTML, and any other language that supports remarks/comments.
Usage Hints:   
* First read the doc at /sw/share/doc/robodoc/ * The rtf format created works with AbiWord, just import the file created by robodoc and create a table of contents with Abiword. It also works probably with OpenOffice, but not with TextEdit, unless saved beforehand with AbiWord. * For generating pdf document from DocBook xml files, use xsltproc with the fo xslt stylesheet and fop: xsltproc --output api.fo pathtofo/docbook.xsl api.xml fop -fo api.fo -pdf api.pdf You may have to customize the stylesheet to get right toc numbering. * For generating html document from DocBook xml files, just give the right path to docbook.xsl: xsltproc --output api.html pathtohtml/docbook.xsl api.xml * Other formats from /sw/share/doc/robodoc/Examples work right out of the box. * Apart the binaries robodoc and robohdrs in /sw/bin, there are two files in /sw/share/doc/robodoc/Contributions: robodoc.kaptn to create robodoc.rc file with Kaptain; and robodoc2pod.pl to create perldoc. * You may have to install tetex and the desired dvi, ps, pdf viewers, Docbook bundle, and eventually Kaptain. * More information is available on the author's blog: http://docuwala.blogspot.com
Section:   10.5-EOL/devel
Maintainer:   Andreas Gockel <fink-robodocATunixforgeDOTde>
Website:   http://www.xs4all.nl/~rfsber/Robo/robodoc.html
License:   GPL
Info-File:   dists/10.4/stable/main/finkinfo/10.5-EOL/devel/robodoc.info
CVS log, Last Changed: Sun, 07 Jul 2013 17:06:52 (UTC)

Section list - Flat package list - Search packages

(*) = Unsupported distribution.