Updated to use doxygen 1.2.5.

This commit is contained in:
johns 2001-03-13 16:44:22 +00:00
parent 8011f21dea
commit 5459b210ee
6 changed files with 34 additions and 314 deletions

View file

@ -63,7 +63,7 @@ runp::
else mv gmon.out gmon.sum; fi
doc::
doxygen doxygen-clone.cfg
doxygen contrib/doxygen-freecraft.cfg
doc++::
@$(MAKE) -C src doc
@ -78,20 +78,20 @@ etlib/getopt.o: etlib/getopt.c
etlib/prgname.o: etlib/prgname.c
# UNIX-TARGET
freecraft: src etlib/hash.o src/libclone.a
freecraft: src etlib/hash.o src/libclone.a
$(CC) -o freecraft src/libclone.a $(CLONELIBS) -I. $(CFLAGS)
# WIN32-TARGET
freecraft.exe: src etlib/prgname.o etlib/getopt.o etlib/hash.o \
src/freecraftrc.o src/libclone.a
src/freecraftrc.o src/libclone.a
$(CC) -o freecraft$(EXE) src/main.c src/libclone.a src/freecraftrc.o \
-lSDLmain $(CLONELIBS) -I. $(CFLAGS)
src/freecraftrc.o: src/freecraft.rc
windres --include-dir contrib -osrc/freecraftrc.o src/freecraft.rc
# -L. -lefence
# -Lccmalloc-0.2.3/src -lccmalloc -ldl
# -L. -lefence
# -Lccmalloc-0.2.3/src -lccmalloc -ldl
tools::
@$(MAKE) -C tools all
@ -112,13 +112,13 @@ distclean: clobber
ci::
@set -e; for i in $(MODULES) ; do $(MAKE) -C $$i ci ; done
ci -l Makefile Common.mk Rules.make .indent.pro \
doxygen-clone.cfg doxygen-0.4.diff \
contrib/doxygen-freecraft.cfg \
$(CCLS) $(DOCS)
lockver::
@set -e; for i in $(MODULES) ; do $(MAKE) -C $$i lockver ; done
$(LOCKVER) Makefile Common.mk Rules.make .indent.pro \
doxygen-clone.cfg doxygen-0.4.diff \
contrib/doxygen-freecraft.cfg \
$(CCLS) $(DOCS)
tags::
@ -150,8 +150,8 @@ CCLS = data/ccl/units.ccl data/ccl/missiles.ccl \
CONTRIB = contrib/cross.png contrib/health.png contrib/mana.png \
contrib/ore,stone,coal.png contrib/food.png contrib/score.png
MISC = Makefile Common.mk Rules.make.orig doxygen-clone.cfg \
doxygen-0.4.diff FreeCraft-beos.proj setup \
MISC = Makefile Common.mk Rules.make.orig FreeCraft-beos.proj setup \
contrib/doxygen-freecraft.cfg contrib/doxygen-header.html \
.indent.pro make/common.scc make/rules.scc make/makefile.scc \
make/README tools/udta.c tools/ugrd.c contrib/req.cm $(CONTRIB) \
etlib/hash.c etlib/getopt.c etlib/prgname.c etlib/prgname.h
@ -170,7 +170,7 @@ dist::
rm -rf $(distdir)
mkdir $(distdir)
chmod 777 $(distdir)
for i in `cat $(DISTLIST)`; do echo $$i; done | cpio -pdml --quiet $(distdir)
for i in `cat $(DISTLIST)`; do echo $$i; done | cpio -pdml --quiet $(distdir)
chmod -R a+r $(distdir)
tar chzf $(distdir).tar.gz $(distdir)
tar cjhf $(distdir).tar.bz2 $(distdir)
@ -190,7 +190,7 @@ small-dist::
rm -rf $(distdir)
mkdir $(distdir)
chmod 777 $(distdir)
for i in `cat $(DISTLIST)`; do echo $$i; done | cpio -pdml --quiet $(distdir)
for i in `cat $(DISTLIST)`; do echo $$i; done | cpio -pdml --quiet $(distdir)
chmod -R a+r $(distdir)
tar chzf $(distdir)-small.tar.gz $(distdir)
tar cjhf $(distdir)-small.tar.bz2 $(distdir)
@ -212,7 +212,7 @@ bin-dist:: all
rm -rf $(distdir)
mkdir $(distdir)
chmod 777 $(distdir)
for i in `cat $(DISTLIST)`; do echo $$i; done | cpio -pdml --quiet $(distdir)
for i in `cat $(DISTLIST)`; do echo $$i; done | cpio -pdml --quiet $(distdir)
chmod -R a+r $(distdir)
strip -s -R .comment $(distdir)/freecraft$(EXE)
strip -s -R .comment $(distdir)/tools/wartool$(EXE)
@ -237,7 +237,7 @@ win32-bin-dist2:: win32
@rm -rf $(distdir)
@mkdir $(distdir)
@chmod 777 $(distdir)
@for i in `cat $(DISTLIST)`; do echo $$i; done | cpio -pdml --quiet $(distdir)
@for i in `cat $(DISTLIST)`; do echo $$i; done | cpio -pdml --quiet $(distdir)
@cp tools/build.bat $(distdir)
@chmod -R a+r $(distdir)
@strip -s -R .comment $(distdir)/freecraft$(EXE)
@ -308,7 +308,7 @@ complete: linux-complete win32-complete
#----------------------------------------------------------------------------
difffile= freecraft-`date +%y%m%d`.diff
diff:
diff:
@$(RM) $(difffile)
@$(RM) $(DISTLIST)
$(MAKE) -C src distlist
@ -363,7 +363,7 @@ win32distclean:
$(MAKE) $(WIN32) distclean
##############################################################################
# INSTALL/UNINSTALL
# INSTALL/UNINSTALL
##############################################################################
install: all

View file

@ -0,0 +1,17 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html><head><meta name="robots" content="noindex">
<meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1">
<title>$title</title>
<link href="doxygen.css" rel="stylesheet" type="text/css">
</head><body bgcolor="#ffffff"><PRE WIDTH=80>
___________ _________ _____ __
\_ _____/______ ____ ____ \_ ___ \____________ _/ ____\/ |_
| __) \_ __ \_/ __ \_/ __ \/ \ \/\_ __ \__ \\ __\\ __\
| \ | | \/\ ___/\ ___/\ \____| | \// __ \| | | |
\___ / |__| \___ >\___ >\______ /|__| (____ /__| |__|
\/ \/ \/ \/ \/
______________________ ______________________
T H E W A R B E G I N S
FreeCraft - A free fantasy real time strategy game engine
</PRE><B>(C) Copyright 2001 by The FreeCraft Project. Distributed under the
<A HREF="artistic-license.html">"Artistic License"</A></B><HR>

View file

@ -565,6 +565,7 @@
CCL.
<LI>Fixed bug: Wrong resources display, wrong format string.
<LI>Changed keyboard layout, all special keys must be pressed with ALT/CTRL.
<LI>Updated to use doxygen 1.2.5.
<LI>+++
<LI>TODO: Fixed bug: Unit didn't return to start point, if attacking.
</UL>

View file

@ -48,6 +48,7 @@ use them.<P>
You need one this programs to generate source code documentation.
<UL>
<LI><A HREF="http://www.stack.nl/~dimitri/doxygen/download.html">DoxyGen</A>
or <A HREF="http://www.doxygen.org">DoxyGen</A>
My patch doxgen-0.4.diff.gz should be obsolete.
<LI><A HREF="http://www.zib.de/Visual/software/doc++/index.html">DOC++</A>
</UL>

View file

@ -1,44 +0,0 @@
diff -U 2 -p -r -x *.o doxygen-0.4/src/scanner.l doxygen-0.4-johns/src/scanner.l
--- doxygen-0.4/src/scanner.l Thu Dec 3 15:09:32 1998
+++ doxygen-0.4-johns/src/scanner.l Thu Dec 17 02:45:46 1998
@@ -1061,8 +1061,8 @@ VAR [vV][aA][rR]
<DocScan>"\\b"{BN}+ { BEGIN( DocBold ); }
<DocScan>"\\c"{BN}+ { BEGIN( DocCode ); }
-<DocScan>"\\l"{BN}+
+<DocScan>"\\l"{BN}+
<DocScan>"\\include"{BN}+ { BEGIN( DocInclude ); }
<DocScan>"\\dontinclude"{BN}+ { BEGIN( DocDontInclude ); }
-<DocScan>"\\skip"{BN}+ { BEGIN( DocSkipKey ); }
+<DocScan>"\\skip"{BN}+ { BEGIN( DocSkipKey ); }
<DocScan>"\\skipline"{BN}+ { BEGIN( DocSkiplineKey ); firstLine=TRUE; }
<DocScan>"\\line"{BN}+ { BEGIN( DocLineKey ); firstLine=TRUE; }
@@ -1121,5 +1121,5 @@ VAR [vV][aA][rR]
BEGIN( DocScan );
}
-<DocScan>"<"{MULTICOL}{ATTR}">"
+<DocScan>"<"{MULTICOL}{ATTR}">"
<DocScan>"</"{MULTICOL}{ATTR}">"
<DocScan>"<"{STRONG}{ATTR}">" { outDoc->startBold(); }
@@ -1140,6 +1140,6 @@ VAR [vV][aA][rR]
<DocScan>"<"{FORM}{ATTR}">"
<DocScan>"</"{FORM}{ATTR}">"
-<DocScan>"<"{HEAD}{ATTR}">"
-<DocScan>"</"{HEAD}{ATTR}">"
+<DocScan>"<"{HEAD}{ATTR}">"
+<DocScan>"</"{HEAD}{ATTR}">"
<DocScan>"<"{BODY}{ATTR}">"
<DocScan>"</"{BODY}{ATTR}">"
@@ -2586,4 +2586,7 @@ VAR [vV][aA][rR]
}
<Doc>. { current->doc += *yytext; }
+<Doc>\n[ \t]*"*"+[ \t]+ { current->doc += '\n' ;
+ yyLineNr++ ;
+ }
<DefLineDoc,LineDoc>. { current->brief += *yytext; }
<Doc>\n { yyLineNr++; current->doc += *yytext; }
@@ -2602,4 +2605,5 @@ VAR [vV][aA][rR]
if (afterDocTerminator!=0)
unput(afterDocTerminator);
+ unput('\n');
BEGIN(lastAfterDocContext);
}

View file

@ -1,255 +0,0 @@
# This file describes the settings to be used by doxygen for a project
#
# All text after a hash (#) is considered a comment and will be ignored
# The format is:
# TAG = value [value, ...]
# Values that contain spaces should be placed between quotes (" ")
#---------------------------------------------------------------------------
# General configuration options
#---------------------------------------------------------------------------
# The PROJECT_NAME tag is a single word (or a sequence of word surrounded
# by quotes) that should identify the project.
PROJECT_NAME = "FreeCraft"
# The PROJECT_NUMBER tag can be used to enter a project or revision number.
# This could be handy for archiving the generated documentation or
# if some version control system is used.
PROJECT_NUMBER = "1.17"
# The OUTPUT_DIRECTORY tag is used to specify the (relative or absolute)
# base path where the generated documentation will be put.
# If a relative path is entered, it will be relative to the location
# where doxygen was started. If left blank the current directory will be used.
OUTPUT_DIRECTORY = "./srcdoc"
# The HTML_OUTPUT tag is used to specify where the HTML docs will be put.
# If a relative path is entered the value of OUTPUT_DIRECTORY will be
# put in front of it. If left blank `html' will be used as the default path.
HTML_OUTPUT =
# The LATEX_OUTPUT tag is used to specify where the LaTeX docs will be put.
# If a relative path is entered the value of OUTPUT_DIRECTORY will be
# put in front of it. If left blank `latex' will be used as the default path.
LATEX_OUTPUT =
# The HTML_HEADER tag can be used to specify a personal HTML header for
# each generated HTML page. If it is left blank doxygen will generate a
# standard header.
HTML_HEADER =
# The HTML_FOOTER tag can be used to specify a personal HTML footer for
# each generated HTML page. If it is left blank doxygen will generate a
# standard footer.
HTML_FOOTER =
# The QUIET tag can be used to turn on/off the messages that are generated
# by doxygen. Possible values are YES and NO. If left blank NO is used.
QUIET = YES
# The WARNINGS tag can be used to turn on/off the warning messages that are
# generated by doxygen. Possible values are YES and NO. If left blank
# NO is used.
WARNINGS = YES
# The DISABLE_INDEX tag can be used to turn on/off the condensed index at
# top of each page. A value of NO (the default) enables the index and the
# value YES disables it.
DISABLE_INDEX = YES
# If the EXTRACT_ALL tag is set to YES all classes and functions will be
# included in the documentation, even if no documentation was available.
EXTRACT_ALL = YES
# If the EXTRACT_PRIVATE tag is set to YES all private members of a class
# will be included in the documentation.
EXTRACT_PRIVATE = NO
# If the HIDE_UNDOC_MEMBERS tag is set to YES, Doxygen will hide all
# undocumented members inside documented classes or files.
HIDE_UNDOC_MEMBERS = NO
# If the GENERATE_LATEX tag is set to YES (the default) Doxygen will
# generate Latex output.
GENERATE_LATEX = NO
# If the GENERATE_HTML tag is set to YES (the default) Doxygen will
# generate HTML output
GENERATE_HTML = YES
# If the BRIEF_MEMBER_DESC tag is set to YES (the default) Doxygen will
# include brief member descriptions after the members that are listed in
# the file and class documentation (similar to JavaDoc).
# Set to NO to disable this.
BRIEF_MEMBER_DESC = NO
# If the FULL_PATH_NAMES tag is set to YES Doxygen will prepend the full
# path before files name in the file list and in the header files. If set
# to NO the shortest path that makes the file name unique will be used
FULL_PATH_NAMES = NO
#---------------------------------------------------------------------------
# configuration options related to the input files
#---------------------------------------------------------------------------
# The INPUT tag is used to specify the files and/or directories that contain
# documented source files. You may enter file names like "myfile.cpp" or
# directories like "/usr/src/myproject". Separate the files or directories
# with spaces.
INPUT = "./src"
# If the value of the INPUT tag contains directories, you can use the
# FILE_PATTERNS tag to specify one or more wildcard patterns (like *.cpp
# and *.h) to filter out the source-files in the directories. If left
# blank all files are included.
FILE_PATTERNS = *.h *.c
# The EXAMPLE_PATH tag can be used to specify one or more files or
# directories that contain example code fragments that are included (see
# the \include command).
EXAMPLE_PATH =
# The RECURSIVE tag can be used to turn specify whether or not subdirectories
# should be searched for input files as well. Possible values are YES and NO.
# If left blank NO is used.
RECURSIVE = YES
# The INPUT_FILTER tag can be used to specify a program that doxygen should
# invoke to filter for each input file. Doxygen will invoke the filter program
# by executing (via popen()) the command <filter> <input-file>, where <filter>
# is the value of the INPUT_FILTER tag, and <input-file> is the name of an
# input file. Doxygen will then use the output that the filter program writes
# to standard output.
INPUT_FILTER = "sed -e 's:^[ ]*///://\!:' -e 's:///://\!<:' -e s:///://\!: -e 's:/\*\*:/\*\!:' -e 's:@name:\\file':"
#---------------------------------------------------------------------------
# Configuration options related to the preprocessor
#---------------------------------------------------------------------------
# If the ENABLE_PREPROCESSING tag is set to YES (the default) Doxygen will
# evaluate all C-preprocessor directives found in the sources and include
# files.
ENABLE_PREPROCESSING = YES
# If the MACRO_EXPANSION tag is set to YES Doxygen will expand all macro
# names in the source code. If set to NO (the default) only conditional
# compilation will be performed.
MACRO_EXPANSION = NO
# If the SEARCH_INCLUDES tag is set to YES (the default) the includes files
# in the INCLUDE_PATH (see below) will be search if a #include is found.
SEARCH_INCLUDES = YES
# The INCLUDE_PATH tag can be used to specify one or more directories that
# contain include files that are not input files but should be processed by
# the preprocessor.
INCLUDE_PATH =
# The PREDEFINED tag can be used to specify one or more macro names that
# are defined before the preprocessor is started (similar to the -D option of
# gcc). The argument of the tag is a list of macros of the form: name
# or name=definition (no spaces). In the former case 1 is used as the
# definition.
PREDEFINED =
# If the EXPAND_ONLY_PREDEF and MACRO_EXPANSION tags are both set to YES
# then the macro expansion is limited to the macros specified with the
# PREDEFINED tag.
EXPAND_ONLY_PREDEF = NO
#---------------------------------------------------------------------------
# Configuration options related to external references
#---------------------------------------------------------------------------
# The TAGFILES tag can be used to specify one or more tagfiles.
TAGFILES =
# When a file name is specified after GENERATE_TAGFILE, doxygen will create
# a tag file that is based on the input files it reads.
GENERATE_TAGFILE =
# If the ALLEXTERNALS tag is set to YES all external classes will be listed
# in the class index. If set to NO only the inherited external classes
# will be listed.
ALLEXTERNALS = NO
# The PERL_PATH should be the absolute path and name of the perl script
# interpreter (i.e. the result of `which perl').
PERL_PATH = /usr/local/bin/perl
#---------------------------------------------------------------------------
# Configuration options related to the search engine
#---------------------------------------------------------------------------
# The SEARCHENGINE tag specifies whether or not a search engine should be
# used. If set to NO the values of all tags below this one will be ignored.
SEARCHENGINE = NO
# The CGI_NAME tag should be the name of the CGI script that
# starts the search engine (doxysearch) with the correct parameters.
# A script with this name will be generated by doxygen.
CGI_NAME = search.cgi
# The CGI_URL tag should be the absolute URL to the directory where the
# cgi binaries are located. See the documentation of your http daemon for
# details.
CGI_URL =
# The DOC_URL tag should be the absolute URL to the directory where the
# documentation is located. If left blank the absolute path to the
# documentation, with file:// prepended to it, will be used.
DOC_URL =
# The DOC_ABSPATH tag should be the absolute path to the directory where the
# documentation is located. If left blank the directory on the local machine
# will be used.
DOC_ABSPATH =
# The BIN_ABSPATH tag must point to the directory where the doxysearch binary
# is installed.
BIN_ABSPATH = /usr/local/bin/
# The EXT_DOC_PATHS tag can be used to specify one or more paths to
# documentation generated for other projects. This allows doxysearch to search
# the documentation for these projects as well.
EXT_DOC_PATHS =