File: README

package info (click to toggle)
robodoc 4.0.18-1
  • links: PTS
  • area: main
  • in suites: etch, etch-m68k, sarge
  • size: 924 kB
  • ctags: 669
  • sloc: ansic: 8,386; xml: 953; sh: 335; makefile: 144; perl: 68
file content (53 lines) | stat: -rw-r--r-- 2,151 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
$d: README,v 1.5 2003/01/16 06:26:43 gumpu Exp $

ROBODoc Version 4.0.18 January 2004.

ROBODoc is program documentation tool. The idea is to include for
every function or procedure a standard header containing all
sorts of information about the procedure or function.  ROBODoc
extracts these headers from the source file and puts them in a
separate autodocs-file.  ROBODoc thus allows you to include the
program documentation in the source code and avoid having to
maintain two separate documents.  Or as Petteri puts it: "robodoc
is very useful - especially for programmers who don't like
writing documents with Word or some other strange tool."

ROBODoc can format the headers in a number of different formats:
HTML, RTF, LaTeX, or XML DocBook. In HTML mode it can
generate cross links between headers. You can even include parts
of your source code.

ROBODoc works with many programming languages: For instance C,
Pascal, Shell Scripts, Assembler, COBOL, Occam, Postscript,
Forth, Tcl/Tk, C++, Java -- basically any program in which you
can use remarks/comments.

  o For information on how to use ROBODoc see 
    /usr/share/doc/robodoc/manual.html 
  o Blank headers for various languages can be found in 
    /usr/share/doc/robodoc/Headers
  o For an example on how ROBODoc can be used see
    the ROBODoc source code. Get it from http://www.xs4all.nl/~rfsber/Robo/
    or run "apt-get source robodoc"
  o For licence information see /usr/share/doc/robodoc/copyright
  o For a change log see /usr/share/doc/robodoc/changelog.gz
 
Many people contributed to ROBODoc, to name a few:

o Petteri Kettunen <petterik@iki.fi>   
  Bug fixes, FOLD, C features.
o Bernd Koesling <KOESSI@CHESSY.aworld.de> 
  Bug fixes, functional improvements, code cleanup.
o Anthon Pang  <apang@mindlink.net>
  RTF support, Bug fixes.
o Thomas Aglassinger <agi@sbox.tu-graz.ac.at>
  Fixes and cleanup of HTML-output
o Stefan Kost kost@imn.htwk-leipzig.de
  Idea of the master index file and different header types.

Questions, found a bug or a typo; send an email to [rfsber -a-t- xs4all.nl]

(c) 1994-2003  Frans Slothouber, Petteri Kettunen, and Jacco van Weert