Index: ChangeLog
from Niels Van Vliet <niels(a)lrde.epita.fr>
* NEWS: Correct English.
Index: NEWS
--- NEWS Thu, 15 Apr 2004 18:13:03 +0200 thivol_d (oln/0_NEWS 1.22 600)
+++ NEWS Thu, 15 Apr 2004 19:42:49 +0200 van-vl_n (oln/0_NEWS 1.22 600)
@@ -1,20 +1,18 @@
Olena 0.10 April 15, 2004
- * New documentaion system.
+ * New documentation system.
Now any comment should use doxygen style (i.e. /*! ... */).
- You can also put some code in comments to make them
- compile at documentation generation time. It is useful to
- illustrate some algorithm with concrete input and output. To
- use this feature the only thing to be done is to put the
- code into \code and \endcode tags. If you produce an image,
- you can include it in the comments with the \image command,
- using the same name you used to produce it, but with the png
- extension. To make sure your image will not overwrite
- another existing one, you should name it taking care of
+ You can also write some programs inside the comments. They are
+ compiled at documentation generation time. It is useful to
+ illustrate some algorithms with concrete input and output. To
+ use this feature the program has to be between \code and \endcode
+ tags. If you produce an image, you can include it in the comments
+ with the \image command, using the same name you used to produce
+ it, but with the png extension. To make sure your image will not
+ overwrite another existing one, you should name it taking care of
the namespace you are using: e.g. if you comment the function
- oln::boo::bar::fun, an image should be named oln_foo_bar_fun.ppm
- It can be added that two macros are provided to make abstraction
- of input and output directories, they are named IMG_IN and IMG_OUT.
+ oln::boo::bar::fun, the image should be named oln_foo_bar_fun.ppm.
+ The macros IMG_IN and IMG_OUT correspond to the path of the images.
* Border behavior can be controlled with the behavior hierarchy.
If an algorithm support it, you can choose the way the image
Index: ChangeLog
from Damien Thivolle <damien(a)lrde.epita.fr>
* configure.ac: Remove doxygen detection when ./configure is run
with `--without-doc'.
Index: configure.ac
--- configure.ac Tue, 13 Apr 2004 17:38:53 +0200 thivol_d (oln/3_configure. 1.47.1.1.1.1.1.4.1.15.1.16.1.4 600)
+++ configure.ac Wed, 14 Apr 2004 16:41:06 +0200 thivol_d (oln/3_configure. 1.47.1.1.1.1.1.4.1.15.1.16.1.4 600)
@@ -235,8 +235,12 @@
### The reference manual uses Doxygen
### FIXME: could be much better.
-AC_CHECK_PROG([DOXYGEN], [doxygen], [doxygen])
+ AC_ARG_WITH([doc],
+ [Doxygen is needed to build the doc],
+ [],
+ [AC_CHECK_PROG([DOXYGEN], [doxygen], [doxygen])
AC_CHECK_DOXYGEN_VERSION
+ ])
## if test -z "$DOXYGEN"; then
## AC_MSG_WARN([`doxygen' not found -- `doxygen' must be installed to generate the documentation])
--
Damien Thivolle
damien.thivolle(a)lrde.epita.fr