Index of /www001/src/ports/textproc/yodl/work/yodl-1.31.18

      Name                    Last modified       Size  Description


[DIR] Parent Directory        20-Jan-2008 03:35      -  
[   ] ANNOUNCE-1.22           27-Jul-1998 05:34     4k  
[TXT] ANNOUNCE.txt            18-Nov-1999 06:02     6k  
[TXT] AUTHORS.txt             18-Nov-1999 06:02     1k  
[   ] CHANGES                 18-Nov-1999 03:06    11k  
[   ] COPYING                 27-Jul-1998 05:34    18k  
[   ] ChangeLog-1.22          27-Jul-1998 05:34    22k  
[DIR] Documentation/          20-Jan-2008 03:32      -  
[   ] GNUmakefile             17-Jan-2008 20:35     1k  
[TXT] INSTALL.txt             18-Nov-1999 06:02     3k  
[TXT] PATCHES.txt             18-Nov-1999 06:02     4k  
[   ] TODO                    17-Nov-1999 04:20     3k  
[   ] VERSION                 17-Nov-1999 13:09     1k  
[   ] aclocal.m4              20-Jan-2008 03:30     1k  
[DIR] autom4te.cache/         20-Jan-2008 03:30      -  
[DIR] bin/                    17-Jan-2008 20:34      -  
[   ] config.cache            17-Jan-2008 20:32     2k  
[   ] config.h                17-Jan-2008 20:32     3k  
[   ] config.h.in             17-Aug-1999 10:18     3k  
[   ] config.log              17-Jan-2008 20:32     2k  
[   ] config.make             20-Jan-2008 03:31     2k  
[   ] config.make.in          24-Aug-1999 17:10     2k  
[   ] config.status           17-Jan-2008 20:32    12k  
[   ] configure               20-Jan-2008 03:30   102k  
[   ] configure.in            17-Nov-1999 12:09     3k  
[DIR] debian/                 18-Nov-1999 06:03      -  
[DIR] hsearch/                17-Jan-2008 20:35      -  
[DIR] macros/                 17-Jan-2008 20:34      -  
[DIR] make/                   18-Nov-1999 06:02      -  
[DIR] out/                    17-Jan-2008 20:32      -  
[DIR] scripts/                17-Jan-2008 20:34      -  
[DIR] src/                    17-Jan-2008 20:32      -  
[DIR] stepmake/               17-Jan-2008 20:37      -  


                           README

This is the toplevel README to Yodl

Yodl is a package that implements a pre-document language
and tools to process it.  The idea of Yodl is that you write
up a document in a pre-language, then use the tools (e.g.
yodl2html) to convert it to some final document language.
Current converters are for HTML, ms, man, LaTeX SGML and
texinfo, plus a poor-man's text converter.  Main document
types are "article", "report", "book" and "manpage".  The
Yodl document language is designed to be easy to use and
extensible.

1: VERSIONING

if you have downloaded a

*.pre*

version, then this is version is *not* meant for producing
nice output (but to keep your patchsets up to date).  It
might not even compile.

2: REQUIREMENTS

For the compilation and running of Yodl you need some addi-
tional packages.  Please refer to the installation instruc-
tions.

NOTE: If you downloaded a binary (.rpm or a W95/NT .zip
file), then you don't have to compile Yodl.

3: INSTALLATION

For your convenience, a formatted copy of the INSTALL
instructions are in the toplevel directory, as INSTALL.txt

The process is fairly straightforward, but chances are that
you have to specify directories for TeX to configure
(--enable-tex-dir, --enable-mf-dir)

4: DOCUMENTATION

The real documentation is the directory Documentation/

To generate the pretty-printed docs, you have to run config-
ure first, and then do this:

make doc

You can also simply read the .yo sources.  They are ASCII
text.  The complete documentation is accessible in formatted
form at the website

http://www.cs.uu.nl/people/hanwen/yodl/

5: COMMENTS

Yodl is a long way from finished and polished.  We do appre-
ciate criticism, comments, bugreports, patches, etc.

Please send your e-mail to one of the MAILING LISTS

and not to us personally.  See Documentation/links.yo for
more info.

6: DOZE

If you have received this file as part of a DOS/Window32
distribution (yodl-*.zip), then it is advisable to also
download the source package, since it might contain more
documentation

ftp://ftp.lilypond.org/pub/yodl/ (Europe)

If you decide to build Yodl from source, please read the
INSTALL.txt document first, especially the Windows NT/95
section.

7: CDROM DISTRIBUTIONS

If you have received Yodl on a cdrom, chances are that
development has moved a some patchlevels up.  If possible,
please check the latest version of Yodl before reporting
bugs.