pasdoc/ 0000700 0001750 0001750 00000000000 13237145537 012473 5 ustar michalis michalis pasdoc/pasdoc-fpc.cfg 0000700 0001750 0001750 00000002407 13034465544 015177 0 ustar michalis michalis # -*- mode: shell-script -*-
# These are FPC-specific options for compiling pasdoc.
# Path options (-Fu, -Fi) are not specified here -- they are specified only
# in the Makefile (to avoid duplication, of course).
#
# What are the reasons for maintaining this cfg file
# (as opposed to dropping this cfg file and specifying all compilation options
# in the Makefile) ?
#
# 1. This looks a little clearer than typing these options in the Makefile ?
#
# 2. Using #IFDEF AMIGA below. Although Amiga is not actually supported
# target now.
#
# In the future, this file may be removed and everything will be handled
# only inside the Makefile.
# Syntax settings: objfpc mode, ansistrings
-S2
-Sh
# Io checking
-Ci
# Show warnings and notes
-vwn
#IFDEF RELEASE
#ifdef AMIGA
-Ct
#endif
# Optimize, for faster code
-OG
-O2
#ELSE
# Range, overflow, stack checking, verify object method call validity
-Cr
-Co
-Ct
-CR
# Include assertions
-Sa
# Generate debug info for gdb, include lineinfo
-g
-gl
# On Mac OS X > 10.4 debug information is needed in dwarf format.
# Seems that it works also in Mac OS X 10.4.11, so we just activate dwarf always.
# See http://lazarus.freepascal.org/index.php?topic=10972.0
#ifdef DARWIN
-gw
#endif
# Uncomment to check for memory leaks.
#-gh
#ENDIF
pasdoc/README.md 0000600 0001750 0001750 00000000542 13034465544 013753 0 ustar michalis michalis # PasDoc
PasDoc is a documentation tool for Pascal and Object Pascal source code.
Documentation is generated from comments found in the source code
or from external files. Many formatting @-tags are supported.
Many output formats are supported, including HTML and LaTeX.
See the documentation on http://pasdoc.sourceforge.net/ .
# License
GNU GPL 2.
pasdoc/.gitattributes 0000600 0001750 0001750 00000000037 13034465544 015366 0 ustar michalis michalis *.inc linguist-language=Pascal
pasdoc/tests/ 0000700 0001750 0001750 00000000000 13237142323 013623 5 ustar michalis michalis pasdoc/tests/run_all_tests.sh 0000755 0001750 0001750 00000002513 13237136021 017051 0 ustar michalis michalis #!/bin/bash
set -eu
# Run all PasDoc tests.
make clean
# fpcunit tests --------------------------------------------------------------
cd fpcunit/
make
cd ../
# run on testcases, compare with correct output ------------------------------
ALL_OUTPUT_FORMATS='html htmlhelp latex latex2rtf simplexml'
cd scripts/
./download_correct_tests_output.sh $ALL_OUTPUT_FORMATS
cd ../
for OUTPUT_FORMAT in $ALL_OUTPUT_FORMATS; do
cd testcases/
../scripts/mk_tests.sh $OUTPUT_FORMAT
cd ../
diff -wur correct_output/$OUTPUT_FORMAT current_output/$OUTPUT_FORMAT
done
# If you detect any *valid* differences, i.e. the new version is more correct,
# run this:
# cd scripts/ && ./upload_correct_tests_output.sh $SOURCEFORGE_USERNAME $ALL_OUTPUT_FORMATS && cd ../
# validation -----------------------------------------------------------------
# Validate current_output/html, requires onsgmls installed
# This is unfortunately not working for HTML 5 now.
# scripts/validate_html.sh
# Validate current_output/simplexml, requires xmllint installed
scripts/validate_simplexml.sh
# cache tests ----------------------------------------------------------------
cd scripts/
for OUTPUT_FORMAT in $ALL_OUTPUT_FORMATS; do
./check_cache.sh $OUTPUT_FORMAT
done
./check_cache_format_independent.sh html latex
./check_cache_format_independent.sh latex2rtf htmlhelp
pasdoc/tests/fpcunit/ 0000700 0001750 0001750 00000000000 13237143041 015271 5 ustar michalis michalis pasdoc/tests/fpcunit/testpasdoc_utils.pas 0000600 0001750 0001750 00000003761 13237143041 021400 0 ustar michalis michalis {
Copyright 2016-2016 PasDoc developers.
This file is part of "PasDoc".
"PasDoc" is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.
"PasDoc" is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with "PasDoc"; if not, write to the Free Software
Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA
----------------------------------------------------------------------------
}
{ Test PasDoc_Utils. }
unit TestPasdoc_Utils;
interface
uses
Classes, SysUtils, FpcUnit, TestUtils, TestRegistry;
type
TTestPasDocUtils = class(TTestCase)
published
procedure TestRemoveIndentation;
end;
implementation
uses PasDoc_Utils;
procedure TTestPasDocUtils.TestRemoveIndentation;
begin
AssertEquals(
' ' + LineEnding + // whitespace line will be completely ignored
' foo' + LineEnding +
'bar' + LineEnding +
' xyz',
RemoveIndentation(
' ' + LineEnding + // whitespace line will be completely ignored
' foo' + LineEnding +
' bar' + LineEnding +
' xyz'));
AssertEquals(
' '#9' ' + LineEnding + // whitespace line will be completely ignored
#9' foo' + LineEnding +
'bar' + LineEnding +
' xyz',
RemoveIndentation(
' '#9' ' + LineEnding + // whitespace line will be completely ignored
' '#9#9' foo' + LineEnding +
' '#9'bar' + LineEnding +
' '#9' xyz'));
AssertEquals('begin Writeln(''Hello world''); end; { This works ! }',
RemoveIndentation(' begin Writeln(''Hello world''); end; { This works ! } '));
end;
initialization
RegisterTest(TTestPasDocUtils);
end.
pasdoc/tests/fpcunit/test_pasdoc.lpr 0000600 0001750 0001750 00000002362 13034465544 020337 0 ustar michalis michalis {
Copyright 2016-2016 PasDoc developers.
This file is part of "PasDoc".
"PasDoc" is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.
"PasDoc" is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with "PasDoc"; if not, write to the Free Software
Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA
----------------------------------------------------------------------------
}
{ Automatic test runner. }
uses
SysUtils, ConsoleTestRunner,
{ specify TestXxx units below. }
TestPasDoc_Utils,
TestPasdoc_GenHtml;
var
Application: TTestRunner;
begin
Application := TTestRunner.Create(nil);
try
Application.Title := 'PasDoc - Test runner (using fpcunit)';
DefaultFormat := fPlain;
Application.Initialize;
Application.Run;
finally FreeAndNil(Application) end;
end.
pasdoc/tests/fpcunit/testpasdoc_genhtml.pas 0000600 0001750 0001750 00000006013 13237143041 021667 0 ustar michalis michalis {
Copyright 2016-2016 PasDoc developers.
This file is part of "PasDoc".
"PasDoc" is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.
"PasDoc" is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with "PasDoc"; if not, write to the Free Software
Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA
----------------------------------------------------------------------------
}
{ Test PasDoc_GenHtml. }
unit TestPasdoc_GenHtml;
interface
uses
Classes, SysUtils, FpcUnit, TestUtils, TestRegistry;
type
TTestPasDocGenHtml = class(TTestCase)
published
procedure TestFormatPascalCode;
end;
implementation
uses PasDoc_GenHtml;
type
{ Descendant of THTMLDocGenerator,
to access here some protected methods of THTMLDocGenerator. }
TMyHTMLDocGenerator = class(THTMLDocGenerator)
end;
procedure TTestPasDocGenHtml.TestFormatPascalCode;
var
Gen: TMyHTMLDocGenerator;
begin
Gen := TMyHTMLDocGenerator.Create(nil);
try
AssertEquals('' + LineEnding +
LineEnding +
'
begin Writeln(''Hello world''); end; { This works ! }
' + LineEnding +
LineEnding +
'
', Gen.FormatPascalCode('begin Writeln(''Hello world''); end; { This works ! } '));
{ should work the same as before (there was a bug at some point where
the lack of space right after comment was confusing the code) }
AssertEquals('
' + LineEnding +
LineEnding +
'
begin Writeln(''Hello world''); end; { This works ! }
' + LineEnding +
LineEnding +
'
', Gen.FormatPascalCode('begin Writeln(''Hello world''); end; { This works ! }'));
AssertEquals('
', Gen.FormatPascalCode('// unterminated '));
finally FreeAndNil(Gen) end;
end;
initialization
RegisterTest(TTestPasDocGenHtml);
end.
pasdoc/tests/fpcunit/Makefile 0000600 0001750 0001750 00000000057 13034465544 016747 0 ustar michalis michalis .PHONY: default
default:
make -C ../../ tests
pasdoc/tests/README.md 0000600 0001750 0001750 00000027257 13237137561 015131 0 ustar michalis michalis # Tests for PasDoc
Run all the tests simply by `run_all_tests.sh`.
This runs all relevant tests described below.
It requires a Unix shell (on Windows, you should install Cygwin or MSys).
# Testcases
The subdirectory `testcases` contains
some short and difficult Pasdoc sources. Some of these are taken
from bugreports, to make sure we don't reintroduce an old bug again.
Some of these are written to test new features.
To add a new testcase,
1. first of all just add the file here
(follow the naming conventions below, usually just ok_xxx.pas).
2. add an appropriate line at the end of scripts/mk_tests.sh.
3. after you make sure it works, you may upload new
version of "correct tests", see below. Or just notify Michalis about it :)
Using these tests fully requires having some standard Unix tools
installed and available on $PATH. You need GNU `make`, bash, diff.
Also wget is used for downloading correct tests for comparison.
And tar, scp are used for uploading correct tests by developers.
Of course, you also need the `pasdoc` binary available on $PATH.
## Naming of Pascal unit files in this directory
- `ok_*`
Means that this unit should be parsed by pasdoc without any warnings.
- `warning_*`
Means that this unit should be parsed by pasdoc (i.e. some documentation
for it should be generated), but some warnings should be reported
by pasdoc.
- `error_*`
Means that pasdoc should not be able to parse this unit,
documentation for this unit shouldn't be possible to generate.
pasdoc should generate proper error message for this case.
Note that pasdoc may report errors as warnings,
e.g. "Warning[2]: Error EPasDoc: error_line_number.pas(26):
could not open include file not_existing.inc ..."
Pasdoc calls this a warning, since, after all, it can continue
it's work by simply skipping to the next unit.
But for the sake of this distinction, this is an *error*,
not merely a *warning*.
The precise difference between an error and a warning is:
"error makes impossible to generate documentation for this unit".
Units are divided into these 3 groups because:
- These groups are precisely defined, so there shouldn't be any concern
about "where this test unit belongs".
- We should be eventually able to use output messages and exit status
of pasdoc to automate testing as much as we can.
Notes:
- Please keep prefixes "ok_", "warning_", "error_" lowercase so that
e.g. the file-mask `ok_*` works as expected on case-sensitive file-systems.
Try to follow the convention
"prefix_description_of_test_lowercase_with_underscores.pas".
- Most of these units will have empty implementation.
They are not supposed to be ever compiled by anything.
- There is no requirement here that the interface of units
placed here must be correct Pascal code.
Pasdoc should be able to handle even incorrect units.
Usually it should break with some parsing error on such units,
but it doesn't have to (after all, pasdoc is not meant to
exactly reimplement some part of a compiler that carefully checks
syntax and everything), it may try to generate some docs.
But even with incorrect units, it obviously shouldn't fail with some
miserable error (like sigsegv :) or do anything that it shouldn't,
like removing some files or so.
- If you want to test unit with a special pasdoc's command-line,
you must add appropriate line at the end of ./mk_tests.sh script.
## Possible tests to be done
First of all, you can just run `run_all_tests.sh` that runs all
relevant tests described below.
- Generate output like this:
```
cd testcases/
../scripts/mk_tests.sh html
```
Tests are created in `current_output/html` subdirectory.
Some of our other scripts will use it.
You can just manually look at units'
sources and comments there to know what generated documentation should
look like (in case of `ok_*` and `warning_*` files) and what
warnings/errors should be reported (in case of `warning_*` and `error_*` files).
Of course, even briefly checking that all `ok_*` units generate no warnings,
all `warning_*` units generate some warnings (and produce some docs)
and all `error_*` units generate errors (and no docs)
is still a better test than nothing...
Note that pasdoc messages (printed on stdout) will not be shown
when you will make tests using mentioned `make ...' commands.
Instead they will be saved to files named PASDOC-OUTPUT
in appropriate subdirectories of tests output.
This way we treat messages printed by pasdoc as important part
of pasdoc's output, they are included in "correct tests output"
(see below) so comparing with "correct tests output" also checks
that pasdoc messages are correct (warnings are as they should be
and where they should be etc.)
- "Correct tests output" give an automated way to verify `current_output/html`.
We maintain on [http://pasdoc.sourceforge.net/correct_tests_output/]
something that we call "correct output of tests".
Everyone can download them simply by:
```
cd scripts/
./download_correct_tests_output.sh html
```
Then whenever you want you can compare current documentation generated
by pasdoc to downloaded "correct output" e.g. using
```
diff -ur correct_output/html/ current_output/html/
```
Note that *failure* of comparison does not necessarily mean that
current pasdoc *has* a bug, since it's possible that current output of
pasdoc is different (because e.g. we improved and changed something)
but still correct.
Also *success* of comparison does not mean that current pasdoc does
*not* have a bug, because this "current output" was just
accepted at some point by human as "correct".
So, this is unfortunately no ultimate test.
But in practice it often works great, and allows us to quickly
check that nothing is broken :) When no output changes are expected,
or the changes are very local, then looking at "diff" output is a great
and simple way to test.
If pasdoc's developer sees at any point that "current output" differs
from "correct output" and also he carefully checked that "current
output" is still correct, than he should upload his "current output"
as new "correct output" by entering scripts/ directory and executing
```
./upload_correct_tests_output.sh username html
```
See documentation inside scripts/upload_correct_tests_output.sh
for more detailed docs. Note that before uploading you should
be relatively sure that you compared against most recent version
of "correct output", to save yourself trouble of unnecessary
uploading.
Beware that script `upload_correct_tests_output.sh'
will upload everything that you will have inside subdirectory
of given format. This is painful in case of output like LaTeX,
where you can accidentally upload files like docs.pdf or docs.dvi
(that shouldn't be uploaded).
In this case you can do something like `make clean latex' before
uploading to be sure that you upload only "docs.tex" file.
- `scripts/validate_html.sh`
This is an automatic test that makes html docs for all test units
and validates them using sgml validator.
onsgmls program must be installed for this to work.
Links how to install onsgmls may be found here
[https://github.com/pasdoc/pasdoc/wiki/HtmlOutput].
- `scripts/validate_simplexml.sh`
This is an automatic test that makes simplexml docs for all test units
and validates them using xmllint.
xmllint must be installed for this to work.
We do not have any DTD, so it doesn't check that our XML files
conform to anything. But at least it checks that they are well-formed
(all open elements are closed and such).
- Cache tests:
```
cd scripts/
./check_cache.sh html
./check_cache.sh latex
```
$1 arg for this script is required and is any valid pasdoc format
(as for pasdoc's --format option).
Rest of args are just passed to pasdoc as they are.
This runs pasdoc twice using the cache,
1st time the cache directory is empty and pasdoc writes the cache,
2nd time pasdoc should read everything from the cache.
The script then checks that pasdoc's output was identical each time
(comparing them with `diff -u', so you get diff on output if something
does not match).
This somehow checks that writing the cache and reading the cache
and writing documentation basing on information obtained from the cache
(instead of from parsing units) works OK.
Everything is read/written to a temporary directory scripts/check_cache_tmp/,
that is removed at the beginning and at the end of the script.
(It's removed at the beginning, and also by `make clean`, just to
make sure that no garbage is left there, in case script failed
for whatever reason.)
So this script is mostly independent from the rest of the tests
here -- it just happens to use the same test units.
In case comparison between two outputs failed both outputs
and left in scripts/check_cache_tmp/, so developer can inspect
them closer.
- Test cache is format-independent:
```
cd scripts/
./check_cache_format_independent.sh html latex
./check_cache_format_independent.sh latex html
```
Requires two arguments, two names of pasdoc output format.
These two formats should be different for this test to be really sensible
(and better than check_cache.sh), but they can also be equal and
test should pass anyway.
This is similar to ./check_cache.sh test, but it checks
that cache format is independent of pasdoc's output format.
1st it generates output with format 1, without using any cache.
2nd it generates output with format 2, writing the cache.
3rd it generates output with format 1, this time reading the cache.
Then it checks that 1st and 3rd output are equal.
This way it checks that cache generated while doing format 2
may be reused while making format 1. So it tests that cache
format is really independent from pasdoc's chosen output format.
## Various notes
`make clean` will clean this directory.
Note that make used must be GNU make.
Under Linux this is standard, under FreeBSD this is called `gmake`,
under Win32 you can get this with e.g. FPC, MinGW or Cygwin.
scripts/ subdirectory contains some helpful things for running tests.
These should be scripts that perform some additional tests
on test units available here (like check_cache.sh),
but also some helper scripts/files for Makefile in this directory.
## Subdirectory testcases/todo/
It contains units that are known to
be incorrectly handled by pasdoc by now. "Incorrectly handled"
may mean that generated documentation is incorrect, or that pasdoc
fails with some error on correct input, but "incorrectly handled"
may also mean that pasdoc fails to write a proper warning/error
in case when input (unit's sources) is obviously wrong.
Files inside todo/ should follow exactly the same naming convention
as units in this directory (`ok_*`, `warning_*`, `error_*`).
In this case, unit's name tells what pasdoc *should* do with such unit,
even if it doesn't do it for now.
The idea is that when developer fixes a problem with some unit
in tests/todo/ directory, he can simply move this unit to tests/.
These files are in separate todo/ subdirectory, because otherwise
every time we would like to check our tests we would have to
remember "oh, such-and-such test fails but it's a known problem,
so I can ignore it". This would be troublesome,
because *usually* we will want to test whether we did not break
anything that previously worked, and we will not care that there
are still some unresolved problems in pasdoc.
---
And that's all for now.
Comments are most welcome.
pasdoc/tests/scripts/ 0000700 0001750 0001750 00000000000 13237142210 015305 5 ustar michalis michalis pasdoc/tests/scripts/validate_simplexml.sh 0000700 0001750 0001750 00000000542 13237126412 021536 0 ustar michalis michalis #!/bin/bash
set -eu
# This scripts runs xmllint to check every *.xml file in simplexml/
# subdirectory, recursively.
# It's meant to be run using `make validate_simplexml' in parent directory.
#
# See ../README for comments.
find current_output/simplexml/ -iname '*.xml' \
-exec sh -c 'echo ---- Validating {}' ';' \
-exec xmllint --noout '{}' ';'
pasdoc/tests/scripts/download_correct_tests_output.sh 0000700 0001750 0001750 00000001710 13034465544 024052 0 ustar michalis michalis #!/bin/bash
set -eu
# Always run this script with current directory set to
# directory where this script is,
# i.e. tests/scripts/ inside pasdoc sources.
#
# $1 is pasdoc's format name, like for pasdoc's --format option.
#
# This script
# - cleans ../correct_output/$1/
# - downloads [http://pasdoc.sourceforge.net/correct_tests_output/$1.tar.gz]
# - and unpacks it to ../correct_output/$1/
#
# Requisites: downloading is done using `wget'.
download_one_format ()
{
# Parse options
FORMAT="$1"
shift 1
ARCHIVE_FILENAME_NONDIR="$FORMAT".tar.gz
rm -Rf ../correct_output/"$FORMAT"/ ../correct_output/"$ARCHIVE_FILENAME_NONDIR"
mkdir -p ../correct_output/
cd ../correct_output/
echo "Downloading $ARCHIVE_FILENAME_NONDIR ..."
wget http://pasdoc.sourceforge.net/correct_tests_output/"$ARCHIVE_FILENAME_NONDIR"
echo "Unpacking $ARCHIVE_FILENAME_NONDIR ..."
tar xzf "$ARCHIVE_FILENAME_NONDIR"
}
for FORMAT; do
download_one_format "$FORMAT"
done pasdoc/tests/scripts/ssh_chmod_writeable_by_pasdoc.sh 0000700 0001750 0001750 00000001605 13034465544 023713 0 ustar michalis michalis #!/bin/bash
set -eu
# $1 is your username on sourceforge,
# $2 is directory on sourcefore (usually you will start this with
# /home/project-web/pasdoc/...).
#
# This script logs to sourceforge using given username
# (you will be asked for password unless you set up ssh keys)
# and executes
# chgrp -R pasdoc *
# chmod -R g+w *
# This means that every file in given directory is made writeable
# by pasdoc group, which means pasdoc developers.
#
# Later note: chgrp -R pasdoc is not supported on SF anymore.
# Group is always "apache", and for security I would not like to have
# files writeable by apache on a shared host.
echo 'ssh_chmod_writeable_by_pasdoc: Not changing permissions, as it is no longer possible on SourceForge.'
# SF_USERNAME="$1"
# SF_PATH="$2"
# shift 2
# ssh -l "$SF_USERNAME" shell.sourceforge.net < scripts/check_cache_tmp/pasdoc_output.txt
}
pasdoc_call ()
{
echo 'Running pasdoc:'
run_echo pasdoc \
--format="$OUTPUT_FORMAT" -S - \
--exclude-generator \
--cache-dir=scripts/check_cache_tmp/cache/ \
"$@"
}
# ------------------------------------------------------------
OUTPUT_FORMAT="$1"
shift 1
rm -Rf check_cache_tmp/
mkdir -p check_cache_tmp/cache/ check_cache_tmp/1/ check_cache_tmp/2/
cd ..
echo "Checking cache for format ${OUTPUT_FORMAT}"
pasdoc_call --output=scripts/check_cache_tmp/1/
pasdoc_call --output=scripts/check_cache_tmp/2/
echo 'Comparing two outputs:'
diff -u scripts/check_cache_tmp/1/ scripts/check_cache_tmp/2/
echo 'OK, test passed.'
rm -Rf scripts/check_cache_tmp/
pasdoc/tests/scripts/upload_correct_tests_output.sh 0000700 0001750 0001750 00000010756 13237135442 023535 0 ustar michalis michalis #!/bin/bash
set -eu
# Always run this script with current directory set to
# directory where this script is,
# i.e. tests/scripts/ inside pasdoc sources.
#
# This script uploads to
# [http://pasdoc.sourceforge.net/correct_tests_output/]
# current output of tests generated in ../ .
# This means that you're accepting current output of tests
# (for some output formats) as "correct".
#
# Options "$2" and following are the names of output formats
# (as for pasdoc's --format option), these say which subdirectory
# of ../tests/ should be uploaded.
#
# Option "$1" is your username on sourceforge.
# Note that you will be asked (more than once) for your password
# unless you configured your ssh keys, which is recommended.
#
# After uploading it calls ./download_correct_tests_output.sh
# for every uploaded output.
# This way it checks that files were correctly uploaded
# and also sets your local version of ../correct_output/ directory
# to the correct state.
# So after calling this script successfully, directories
# ../$2/ and ../correct_output/$2/ are always equal.
# (and ../$3/ and ../correct_output/$3/, and so on).
#
# Precisely what files are uploaded for each format $FORMAT:
# - $FORMAT.tar.gz -- archived contents of ../$FORMAT/
# Easily downloadable, e.g. by download_correct_tests_output.
# - $FORMAT directory -- copy of ../$FORMAT/
# Easy to browse, so we can e.g. make links from pasdoc's wiki
# page ProjectsUsingPasDoc to this.
# - $FORMAT.timestamp -- current date/time, your username (taken from $1)
# to make this information easy available.
# (to be able to always answer the question "who and when uploaded this ?")
#
# Note: after uploading, it sets group of uploaded files
# to `pasdoc' and makes them writeable by the group.
# This is done in order to allow other pasdoc developers
# to also execute this script, overriding files uploaded by you.
#
# Requisites: `scp' command, `ssh' command.
# Parse options
SF_USERNAME="$1"
shift 1
upload_one_format ()
{
# Parse options
FORMAT="$1"
shift 1
# Prepare clean TEMP_PATH
TEMP_PATH=upload_correct_tests_output_tmp/
rm -Rf "$TEMP_PATH"
mkdir "$TEMP_PATH"
# Prepare tar.gz archive
ARCHIVE_FILENAME_NONDIR="$FORMAT.tar.gz"
ARCHIVE_FILENAME="$TEMP_PATH""$ARCHIVE_FILENAME_NONDIR"
echo "Creating $ARCHIVE_FILENAME_NONDIR ..."
# Note: We temporary jump to ../current_output/, this way we can pack files using
# "$FORMAT".
cd ../current_output/
tar czf ../scripts/"$ARCHIVE_FILENAME" "$FORMAT"/
cd ../scripts/
# Prepare timestamp file
TIMESTAMP_FILENAME_NONDIR="$FORMAT.timestamp"
TIMESTAMP_FILENAME="$TEMP_PATH""$TIMESTAMP_FILENAME_NONDIR"
echo "Creating $TIMESTAMP_FILENAME_NONDIR ..."
date --rfc-2822 > "$TIMESTAMP_FILENAME"
echo "$SF_USERNAME" >> "$TIMESTAMP_FILENAME"
# Do the actual uploading to the server
echo "Uploading ..."
SF_PATH=/home/project-web/pasdoc/htdocs/correct_tests_output/
SF_CONNECT="$SF_USERNAME",pasdoc@web.sourceforge.net:"$SF_PATH"
scp "$ARCHIVE_FILENAME" "$TIMESTAMP_FILENAME" "$SF_CONNECT"
# I could do here simple
# scp -r ../"$FORMAT"/ "$SF_CONNECT"
# but this requires uploading all files unpacked.
# It's much quickier to just log to server and untar there uploaded archive.
#
# Old notes:
#
# After uploading, I changed permission of uploaded and unpacked
# files so that they are writeable by pasdoc group
# (which means pasdoc developers).
# Note that I don't do here simple
# ./ssh_chmod_writeable_by_pasdoc.sh "$SF_USERNAME" "$SF_PATH"
# because I can chmod only the files that "$SF_USERNAME" owns
# (so I chmod only the files that I uploaded).
#
# Later note: This needed anymore: since new SF username is like
# "kambi,pasdoc" (not just "kambi"), so I'm logged with default
# group "pasdoc" already.
#
# Later note: This is not possible anymore.
# Group is forced to be Apache, it seems.
# So for security we don't want to make these files writeable.
ssh "$SF_USERNAME",pasdoc@shell.sourceforge.net <' "$OUTPUT_FILENAME"
# Temporary set +e, to ignore exit status from pasdoc
set +e
"$@" > "$OUTPUT_FILENAME"
set -e
}
# Run pasdoc with given command-line parameters.
# First parameter is the name of subdirectory where we place test results
# (including PASDOC-OUTPUT file), this is always inside "$FORMAT" subdirectory.
mk_test ()
{
OUTPUT_PATH=../current_output/"$FORMAT"/"$1"/
shift 1
mkdir -p "$OUTPUT_PATH"
PASDOC_OUTPUT_FILENAME="$OUTPUT_PATH"PASDOC-OUTPUT
run_echo "$PASDOC_OUTPUT_FILENAME" \
pasdoc --format "$FORMAT" --exclude-generator \
--output="$OUTPUT_PATH" "$@"
}
# parse params ----------------------------------------
FORMAT="$1"
shift 1
# Run tests ----------------------------------------
# Make a test of many units with normal pasdoc command-line.
#
# Note: most new tests should not be added here.
# It was the 1st approach to just call something like `pasdoc *.pas' here
# to test everything. But this was not good, because
# 1. obviously you can't do tests with specialized pasdoc command-line options
# 2. in case of output formats that create some "index" pages
# (like AllClasses.html in HTML / HtmlHelp output) small
# changes and additions have too global impact on many parts of
# documentation, so output from `diff -wur correct_output/html html/'
# is harder to grok for humans.
#
# Instead, usually you should add new test units as new calls to
# `mk_test ...' lower in this script.
#
mk_test large_test "$SORT_OLD" \
error_line_number.pas \
ok_cdecl_external.pas \
ok_complicated_record.pas \
ok_deprecated_tag.pas \
ok_directive_as_identifier.pas \
ok_expanding_descriptions.pas \
ok_hint_directives.pas \
ok_line_break.pas \
ok_link_class_unit_level.pas \
ok_link_explicite_name.pas \
ok_links_2.pas \
ok_links.pas \
ok_nodescription_printing.pas \
ok_paragraph_in_single_line_comment.pas \
ok_tag_name_case.pas \
ok_tag_params_no_parens.pas \
ok_value_member_tags.pas \
warning_abstract_termination.pas \
warning_abstract_twice.pas \
warning_not_existing_tags.pas \
warning_tags_no_parameters.pas \
warning_value_member_tags.pas
# Make a specialized test of some units that need special
# command-line. This is also useful if you want to just make
# some units in a separate subdirectories, to separate them
# from the rest of tests (e.g. because you want to test AllXxx.html pages).
# This is also useful if you want to test the same unit more than once,
# with different command-line options (e.g. like ok_sorting.pas).
#
# Try to place each entry below on separate line,
# so that it's easy to temporary switch some test on/off by
# simply commenting / uncommenting that line.
#
mk_test ok_const_1st_comment_missing --marker=: "$SORT_OLD" ok_const_1st_comment_missing.pas
mk_test ok_link_1_char --visible-members 'private,public,published' "$SORT_OLD" ok_link_1_char.pas
mk_test ok_auto_abstract --auto-abstract "$SORT_OLD" ok_auto_abstract.pas
mk_test warning_incorrect_tag_nesting "$SORT_OLD" warning_incorrect_tag_nesting.pas
mk_test ok_param_raises_returns_proctype "$SORT_OLD" ok_param_raises_returns_proctype.pas
mk_test ok_no_sort '--sort=functions,non-record-fields,methods,properties' ok_no_sort.pas
mk_test ok_sorting_all "$SORT_ALL" ok_sorting.pas
mk_test ok_sorting_none --sort= ok_sorting.pas
mk_test ok_introduction_conclusion ok_introduction_conclusion.pas --introduction=ok_introduction.txt --conclusion=ok_conclusion.txt
mk_test ok_property_decl ok_property_decl.pas
mk_test ok_multiple_vars ok_multiple_vars.pas
mk_test ok_class_function ok_class_function.pas
mk_test ok_latex_head --latex-head=ok_latex_head.tex ok_latex_head.pas
mk_test ok_longcode_underscores ok_longcode_underscores.pas
mk_test ok_longcode_comment ok_longcode_comment.pas
mk_test ok_longcode_dash ok_longcode_dash.pas
mk_test ok_longcode_special_chars ok_longcode_special_chars.pas
mk_test error_introduction_twice_anchors_unit --introduction=error_introduction_twice_anchors.txt error_introduction_twice_anchors_unit.pas
mk_test ok_longcode_float_hex ok_longcode_float_hex.pas
mk_test ok_see_also ok_see_also.pas
mk_test ok_implicit_visibility_public ok_implicit_visibility.pas
mk_test ok_implicit_visibility_published --implicit-visibility=published ok_implicit_visibility.pas
mk_test ok_implicit_visibility_implicit_yes --implicit-visibility=implicit --visible-members=public,implicit ok_implicit_visibility.pas
mk_test ok_implicit_visibility_implicit_no --implicit-visibility=implicit --visible-members=public ok_implicit_visibility.pas
mk_test ok_bold_italic ok_bold_italic.pas
mk_test warning_inherited_test warning_inherited_test.pas
mk_test ok_preformatted_test ok_preformatted_test.pas
mk_test ok_dashes ok_dashes.pas
mk_test ok_lists ok_lists.pas
mk_test warning_lists warning_lists.pas
mk_test ok_table ok_table.pas
mk_test ok_table_nonlatex ok_table_nonlatex.pas
mk_test warning_table warning_table.pas
mk_test ok_macros ok_macros.pas
mk_test error_macros error_macros.pas
mk_test error_macros_recursive error_macros_recursive.pas
mk_test ok_macros_off --no-macro ok_macros_off.pas
mk_test ok_item_set_number ok_item_set_number.pas
mk_test error_unexpected_eof error_unexpected_eof.pas
mk_test error_unexpected_eof_2 error_unexpected_eof_2.pas
mk_test error_expected_semicolon error_expected_semicolon.pas
mk_test ok_record_case_parsing ok_record_case_parsing.pas
mk_test ok_record_with_case ok_record_with_case.pas
mk_test ok_multiple_fields ok_multiple_fields.pas
mk_test ok_back_comment ok_back_comment.pas
mk_test warning_back_comment warning_back_comment.pas
mk_test ok_auto_link --auto-link ok_auto_link.pas
mk_test ok_introduction_pre_link ok_introduction_pre_link_unit.pas --introduction=ok_introduction_pre_link.txt
mk_test ok_table_of_contents ok_table_of_contents_unit.pas --introduction=ok_table_of_contents.txt
mk_test warning_link_in_seealso warning_link_in_seealso.pas
mk_test ok_caret_character ok_caret_character.pas
mk_test ok_unit_uses_filename --write-uses-list ok_unit_uses_filename.pas
mk_test ok_enum_explicit_assign ok_enum_explicit_assign.pas
mk_test ok_if_directive ok_if_directive.pas
mk_test ok_include_environment ok_include_environment.pas
mk_test ok_enum_explicit_values ok_enum_explicit_values.pas
mk_test ok_description_test --description ok_description_test.txt ok_description_test.pas
mk_test ok_program --write-uses-list ok_program.pas
mk_test ok_operator_test ok_operator_test.pas
mk_test error_line_number_2 error_line_number_2.pas
mk_test ok_dispid_method ok_dispid_method.pas
mk_test ok_longcode_highlight ok_longcode_highlight.pas
mk_test ok_non_matching_paren ok_non_matching_paren.pas
mk_test ok_image ok_image.pas
mk_test ok_include --introduction=ok_include_intro.txt ok_include.pas
mk_test ok_class_var ok_class_var.pas
mk_test error_line_number_3 error_line_number_3.pas
mk_test ok_not_defined_omit ok_not_defined_omit.pas
mk_test ok_abstract_sealed ok_abstract_sealed.pas
mk_test ok_library ok_library.dpr
mk_test ok_static_member ok_static_member.pas
mk_test ok_strict_visibilities --visible-members protected,public,strictprotected,strictprivate ok_strict_visibilities.pas
mk_test ok_weird_record ok_weird_record.dpr
mk_test ok_include_quoted ok_include_quoted.pas
mk_test ok_relative_include test_subdir/ok_relative_include_1.pas test_subdir/another_test_subdir/ok_relative_include_2.pas
mk_test ok_list_item_set_number ok_list_item_set_number.pas
mk_test ok_enum_field_var ok_enum_field_var.pas
mk_test ok_back_comment_private ok_back_comment_private.pas
mk_test ok_back_comment_class ok_back_comment_class.pas
mk_test ok_excluded_unit ok_excluded_unit.pas
mk_test ok_comment_over_uses_clause ok_comment_over_uses_clause.pas warning_back_comment_over_uses_clause.pas
mk_test ok_interface_implicit ok_interface_implicit.pas --implicit-visibility=implicit
mk_test ok_dot_unitname ok_dot_unitname.pas --write-uses-list
mk_test ok_longcode_end_semicolon ok_longcode_end_semicolon.pas
mk_test warning_desc_end warning_desc_end.pas
mk_test ok_different_image_same_filename ok_different_image_same_filename_dir1/unit1.pas ok_different_image_same_filename_dir2/unit2.pas
mk_test ok_enumeration_auto_abstract ok_enumeration_auto_abstract.pas --auto-abstract
mk_test ok_ignore_leading ok_ignore_leading.pas --ignore-leading=*
mk_test ok_ignore_leading_star ok_ignore_leading_star.pas --ignore-leading=* --staronly
mk_test ok_ignore_leading_hash ok_ignore_leading_hash.pas --ignore-leading=#
mk_test ok_ignore_leading_length2 ok_ignore_leading_length2.pas --ignore-leading=#?
mk_test ok_packed_class_object ok_packed_class_object.pas
mk_test ok_vorbisfile ok_vorbisfile.pas
mk_test ok_procedural_const ok_procedural_const.pas
mk_test ok_deprecated_const_string ok_deprecated_const_string.pas
mk_test ok_external_class_hierarchy ok_external_class_hierarchy.pas --external-class-hierarchy=ok_external_class_hierarchy.txt
mk_test ok_anonymous_methods ok_anonymous_methods.pas
mk_test ok_class_record_helpers ok_class_record_helpers.pas
mk_test utf_bom_test ok_bom.pas error_bom_utf16_be.pas error_bom_utf16_le.pas error_bom_utf32_be.pas
mk_test ok_cvar ok_cvar.pas
mk_test ok_nested_types ok_nested_types.pas
mk_test ok_generic ok_generic.pas
mk_test ok_helpinsight_comments ok_helpinsight_comments.pas
mk_test ok_attributes ok_attributes.pas
mk_test ok_final ok_final.pas
mk_test ok_at_character_in_verbatim ok_at_character_in_verbatim.pas
mk_test ok_deprecated_directive_note ok_deprecated_directive_note.pas
mk_test ok_enum_links ok_enum_links.pas
mk_test ok_no_link_inside_class ok_no_link_inside_class.pas
pasdoc/tests/scripts/check_cache_format_independent.sh 0000700 0001750 0001750 00000003247 13237136366 024016 0 ustar michalis michalis #!/bin/bash
set -eu
# When running this script, the current directory
# must be the directory of the script, i.e. tests/scripts/
# in pasdoc's sources.
#
# See ../README.md file for docs for this script.
# functions ------------------------------------------------------------
run_echo ()
{
echo "$@"
scripts/find_all_tests_for_check_cache.sh | "$@" \
> scripts/check_cache_format_independent_tmp/pasdoc_output.txt
}
pasdoc_call ()
{
echo 'Running pasdoc:'
run_echo pasdoc -S - --exclude-generator "$@"
}
# ------------------------------------------------------------
OUTPUT_FORMAT_1="$1"
OUTPUT_FORMAT_2="$2"
shift 2
rm -Rf check_cache_format_independent_tmp/
mkdir -p \
check_cache_format_independent_tmp/cache/ \
check_cache_format_independent_tmp/1/ \
check_cache_format_independent_tmp/2/ \
check_cache_format_independent_tmp/3/
cd ..
echo "Checking cache-independent between formats ${OUTPUT_FORMAT_1} and ${OUTPUT_FORMAT_2}"
# No cache, format 1
pasdoc_call \
--output=scripts/check_cache_format_independent_tmp/1/ \
--format="$OUTPUT_FORMAT_1"
# Make cache while making format 2
pasdoc_call \
--output=scripts/check_cache_format_independent_tmp/2/ \
--format="$OUTPUT_FORMAT_2" \
--cache-dir=scripts/check_cache_format_independent_tmp/cache/
# Use cache with format 1
pasdoc_call \
--output=scripts/check_cache_format_independent_tmp/3/ \
--format="$OUTPUT_FORMAT_1" \
--cache-dir=scripts/check_cache_format_independent_tmp/cache/
echo 'Comparing two outputs:'
diff -ur \
scripts/check_cache_format_independent_tmp/1/ \
scripts/check_cache_format_independent_tmp/3/
echo 'OK, test passed.'
rm -Rf scripts/check_cache_format_independent_tmp/
pasdoc/tests/testcases/ 0000755 0001750 0001750 00000000000 13237143042 015632 5 ustar michalis michalis pasdoc/tests/testcases/ok_hint_directives.pas 0000600 0001750 0001750 00000012763 13237143041 022213 0 ustar michalis michalis { @abstract(Test parsing "platform", "library" and "deprecated"
directives (called collectively "hint directives") by pasdoc.)
Related tracker bug: [ 1196073 ] "some modifiers are not parsed".
We want to support all situations where these directives are allowed
in modern FPC (>= 2.5.1) and Delphi. Their placement in unfortunately
not consistent, thanks go to Borland.
Quoting Delphi help (from Kylix 3):
"Hint directives can be applied to type declarations, variable declarations,
class and structure declarations, field declarations within classes or
records, procedure, function and method declarations, and unit declarations."
Summary:
@orderedList(
@item(
Between "unit UnitName" and hints you @italic(mustn't) put any semicolon,
and you @italic(mustn't) put any semicolons between hints. @br
Same thing for CIOs (Classes / Interfaces / Objects / Records). @br
Same thing for CIOs fields. @br
Same thing for variables. @br
Same thing for constants.)
@item(
Between "procedure/function Name (...)" and hints you @italic(must)
put a semicolon, and semicolons between hints are allowed but
not required. It seems that you can't specify "library" directive
for procedures/functions -- why? Probably because "library"
is a keyword and Borland was unable to correctly modify it's compiler
to parse such thing. But pasdoc parses library directive correctly.)
@item(
Between method and hints you @italic(must) put a semicolon,
and semicolon between hints is @italic(required).
You can specify "library" directive for methods.)
)
I'm unable to figure out how to specify these hints for normal
(non-structural) types. If anyone can
@unorderedList(
@itemSpacing compact
@item tell me how to specify hint directives for non-structural types or
@item(explain why parsing these directives is so weird and inconsistent
in Delphi or)
@item(point me to some precise documentation by Borland specifying grammar
rules with these directives)
)
... then please send email about this to pasdoc-main mailing list
(or directly to me, Michalis Kamburelis, ,
if your comments about this do not really concern pasdoc).
I will be grateful.
Contrary to most units in tests/, this unit @italic(is) kept at compileable
by Delphi/Kylix and FPC. That's because this unit is also a test whether we
really specify here hint directives in the way parseable by Delphi/Kylix.
}
{$ifdef FPC}
{$mode DELPHI}
{$endif}
unit ok_hint_directives platform library deprecated;
interface
{ }
procedure TestProcPlatform; platform;
{procedure TestProcLibrary; library;}
{ }
procedure TestProcDeprecated; deprecated;
{ }
procedure TestProcCombined(SomeParams: Integer);
{library } deprecated platform;
{ }
function TestFuncPlatform: Integer; platform;
{function TestFuncLibrary: Integer; library;}
{ }
function TestFuncDeprecated: Integer; deprecated;
{ }
function TestFuncCombined(SomeParams: Integer): Integer;
{library }
deprecated; { <- this semicolon is allowed but is optional }
platform;
type
{TTestTypePlatform = Integer platform;}
{TTestTypeLibrary = Integer library;}
{TTestTypeDeprecated = Integer deprecated;}
{TTestTypeCombined = Integer platform deprecated library;}
{ }
TTestClassDeprecated = class
TestFieldPlatform: Integer platform;
TestFieldLibrary: Integer library;
TestFieldDeprecated: Integer deprecated;
TestFieldCombined: Integer library deprecated platform;
{ Testing on Delphi 7 / Kylix 3:
Hint directives for properties are not allowed.
Nowhere in Delphi help do they say that hint directives
are supported for properties, and indeed it doesn't seem
to be supported.
property SomeProperty: Integer
read TestFieldPlatform write TestFieldPlatform; platform;}
{ Testing on FPC 2.6.0:
Hint directives for properties are allowed Ok.
I don't know if this is Delphi-compatible or FPC extension,
anyway PasDoc supports it too. }
property TestPropertyCombined: Integer; library deprecated platform;
property TestPropertyCombined2: Integer; library; deprecated; platform;
{ }
procedure TestMethodLibrary; library;
procedure TestMethodPlatform; platform;
procedure TestMethodDeprecated; deprecated;
procedure TestMethodCombined; library; deprecated; platform;
end deprecated library;
TTestRecordDeprecated = record
TestFieldPlatform: Integer platform;
end deprecated;
var
TestVarPlatform: Integer platform;
TestVarLibrary: Integer library;
TestVarDeprecated: Integer deprecated;
TestVarCombined: Integer library deprecated platform;
const
TestConstPlatform = 1 platform;
TestConstLibrary = 2 library;
TestConstDeprecated = 3 deprecated;
TestConstCombined = 4 deprecated library platform;
implementation
procedure TestProcPlatform;
begin
end;
procedure TestProcLibrary;
begin
end;
procedure TestProcDeprecated;
begin
end;
procedure TestProcCombined(SomeParams: Integer);
begin
end;
function TestFuncPlatform: Integer;
begin
end;
function TestFuncLibrary: Integer;
begin
end;
function TestFuncDeprecated: Integer;
begin
end;
function TestFuncCombined(SomeParams: Integer): Integer;
begin
end;
procedure TTestClassDeprecated.TestMethodLibrary;
begin
end;
procedure TTestClassDeprecated.TestMethodPlatform;
begin
end;
procedure TTestClassDeprecated.TestMethodDeprecated;
begin
end;
procedure TTestClassDeprecated.TestMethodCombined;
begin
end;
end. pasdoc/tests/testcases/warning_value_member_tags.pas 0000600 0001750 0001750 00000001736 13237143041 023543 0 ustar michalis michalis unit warning_value_member_tags;
interface
type
{ @member MyField1 First description of MyField1.
@member MyField2 First description of MyField2.
@member MyField2 Second description of MyField2.
@member NotExistsingMember Description of NotExistsingMember.
This should cause 3 warnings:
MyField1 has two descriptions,
MyField2 has two descriptions,
and NotExistsingMember does not exist. }
TMyClass = class
{ @abstract(Second description of MyField1.) }
MyField1: Integer;
MyField2: Integer;
end;
{ @value meOne First description of meOne.
@value meOne Second description of meOne.
@value meTwo First description of meTwo.
@value meNotExisting Description of meNotExisting.
This should cause 3 warnings:
meOne has two descriptions,
meTwo has two descriptions,
and meNotExisting does not exist. }
TMyEnum = (
meOne,
{ Second description of meTwo. }
meTwo);
implementation
end. pasdoc/tests/testcases/ok_final.pas 0000600 0001750 0001750 00000000203 13237143041 020103 0 ustar michalis michalis unit ok_final;
interface
type
TMyObject = class
public
procedure MyFinalMethod; virtual; final;
end;
implementation
end.
pasdoc/tests/testcases/error_introduction_twice_anchors.txt 0000600 0001750 0001750 00000000167 13034465544 025242 0 ustar michalis michalis Sections with the same internal anchor-names are bad:
@section(1 SecName 1st section)
@section(1 SecName 2nd section)
pasdoc/tests/testcases/error_back_comments.pas 0000600 0001750 0001750 00000000354 13237143041 022346 0 ustar michalis michalis unit test;
interface
type
MyEnum = (
me1, //!#lFrm/K~`QUt hMX
bNVA4R`[Ѡ~l&'ҐfM ze7hH䪒%G;Ei`,!Ċo & !1aAQq ?!w[ } ˡ}=?سFݹ}> v=9r8Eg2Fi״@mg#&`ݜ>4T#/Ym%Inn v, ⩊:*0R\
fQaϿB&oW7hIS V!h>F.VeQ/m .)TYN>s4SRYw\> ~a*w0Ne~'媰#zNT=u \|T, b_~q 0k!Ocehv9
\+Y/*KAI >os5(0 !1A ?Nc [e[ț+Aoo \+;.q#ُ # !Q1Aaq ?V
mnY1!B>8"
.SM=o` w,̡+3XCB;'sU!]<}\^\yw@;1 $ !1A Qaq ?\nnPMqJQ[ $ rtLtOF3-S8J&st ,4'X0xkZEe4&Z>-შ5Y<^7бCfF13)}j1&6I]I5X4+z9uxAToRsݑ7Y$fFL6Uci:z˸b +t?߀(,mSv_L7T#8Ɣ' [Cj~~aEX R2F N R dإ/
۰.?|jBX 2,9"dT|96VZQ0bk:xlT" &E8!_R dw@QE)<Ly9?N0I$ 3E &?ZۢXFE_xA-$_>q&8bޗ\ :*HnnD4B|q";XMU2c5
%fZ /9MAfP ``=@3,gT@W~? pasdoc/tests/testcases/ok_introduction_pre_link.txt 0000600 0001750 0001750 00000000447 13034465544 023476 0 ustar michalis michalis Link to my section before defining it : @link(MySection)
@section(1 MySection My section)
Link to my section after defining it : @link(MySection)
Link to my anchor before defining it : @link(MyAnchor)
@anchor(MyAnchor) Here's my anchor.
Link to my anchor after defining it : @link(MyAnchor) pasdoc/tests/testcases/ok_back_comment_class.pas 0000600 0001750 0001750 00000001207 13237143041 022626 0 ustar michalis michalis unit ok_back_comment_class;
{ This should report a warning that @@exclude is used twice for
TfmHardwareControlSetup identifier.
But (before fixing):
@orderedList(
@item(An @@exclude was assigned to the whole unit)
@item(Even worse, it caused dummy output
@preformatted(
Info[1]: Starting Source File Parsing ...
Info[2]: Now parsing file ok_back_comment_class.pas...
Info[2]: ... 1 Source File(s) parsed
Fatal Error: At least one unit must have been successfully parsed to write docs.
)))
}
interface
type
{ @exclude one }
TfmHardwareControlSetup = class(TForm) //< @exclude two
end;
implementation
end.
pasdoc/tests/testcases/ok_image_picture.eps 0000600 0001750 0001750 00000036303 13034465544 021657 0 ustar michalis michalis %!PS-Adobe-3.0 EPSF-3.0
%%Creator: GIMP PostScript file plugin V 1,17 by Peter Kirchgessner
%%Title: ok_image_picture.eps
%%CreationDate: Sun Feb 19 00:35:59 2006
%%DocumentData: Clean7Bit
%%LanguageLevel: 2
%%Pages: 1
%%BoundingBox: 14 14 67 86
%%EndComments
%%BeginProlog
% Use own dictionary to avoid conflicts
10 dict begin
%%EndProlog
%%Page: 1 1
% Translate for offset
14.173228346456694 14.173228346456694 translate
% Translate to begin of first scanline
0 70.98279830405815 translate
51.987401574803151 -70.98279830405815 scale
% Image geometry
52 71 8
% Transformation matrix
[ 52 0 0 71 0 0 ]
% Strings to hold RGB-samples per scanline
/rstr 52 string def
/gstr 52 string def
/bstr 52 string def
{currentfile /ASCII85Decode filter /RunLengthDecode filter rstr readstring pop}
{currentfile /ASCII85Decode filter /RunLengthDecode filter gstr readstring pop}
{currentfile /ASCII85Decode filter /RunLengthDecode filter bstr readstring pop}
true 3
%%BeginData: 14525 ASCII Bytes
colorimage
s82ojrVZZuS#!<[^]"0Un+l_Jp[nIbqZ$Qjl1OuEs8VWh]qqZl`rH)9s8Muss7(U~>
s8NZ&qY^*brr8:ZZ_,,7s7ZBYrVulp)=m\)s7lWonb`4Js0nYrOi%.ur;6?gs8VV>~>
!rMrmrr3T+le5]RBNBK#fD#==s82Qjrql^+nb`1Qs8V6BK3ht]K?N!8rr<#s!:PF~>
0DtVFs7cQ,VOq9u?"@W=`;BT7naZ;Gqtg0hs8)N`n*pASs8S-s@U3nUT9@.krVlfsqLA~>
'`\%0rpfuqSsitc?Y=2I_tF!.p\k*k(]!b%rV?Hmr:U*`rVqaf>ZPWASWUhdqu6TqqLA~>
0E(_Hs7?#[H=Ifu$lC*lPNVuGp\Fjfs8Mrrs8N#roC)YVs6X>G&e60$@UZ,)rr2irpj`~>
!qH9err4QlA6j"kAnk=M>lOcpq>'gRppO<^Du]Oqq"asip1&)JEH#2^H"LI!s8W&tr."~>
!qlTkrr4Qg?s%,]AnkCO>l4QmrVuolrO,ZUC&Rl!s82irnm607CMHmDF_"jps8W)urI=~>
1\h"Eo]k6l)$C9S":t\L+OK98rr<#lpT@7BD?'V+rV$$XfebAh',1TS2CTu+f'iG3pj`~>
1]74Ms.spX?tjLj9Lhir?[p)qs7l2rD@dF+'Pt;Vq#C)o@<#@e86.fuBN7]B`;fl9r."~>
*WQ-;s.jdR?"Rh^8OQ6g?$sTjs8)K(E"EL!$tm-Mrt=t-?Yr_U5ts4W?r9L4`rH)
s8N5nk]f'+q>^X='/u'>rr3P@@K6B?$#@6Sq"E[*/hRGFrW!6J(CC-UHfY%upj`~>
0`Lb;s0,^E8TA
0`Lh>s0,[B7;Q@CCNX3)Bj59Nrq3j+&0Nhq&dpb*rr<"eA6rVM@UVZ?>Y/m;YP%npJ,~>
#64DYhfK21quA)V#8@dN*om5!b>J
1\1SGYb#61KPtsUAUA;uAl`B)s/7=_&7qQ#9GS%3]Dhh@1Mp-'Ed)DAB5_U-Tu?p0s*t~>
0_#,BY+8m)IV&e(M?rUQorLbAN%q_Jt7M,o%]))D80kX3^@VT=`>@CrRS&>7*J,~>
#Q+PgKj4i_%fHA.%g2e2(Ct6VY:9PQ,[Fb&!!#<^h9Qo<&HE:T$N:&*#R(W6V"FHYJ,~>
1]R7MQ@3^\:1\X@G'JXWD+A?5\h,KCBT\:IOA6Z+(
1]@(JPBgqJ6s"&_B5)Hs@mXdoYTkD#Bp4OJN_'os'$"cu:h*m3
"on8^C,m12!##Yq$k*jN!<=-]VBd)\-U0If
1]@@RQ?$\VCNsO*UMtI"C1;Q\1`@WTP+If#R?^5W*&_qU>]Fn<=0S]>E-OuTBp\l"rdX~>
0`(eKPAXo@?>*B>O^Dd6?s7\8.1[A1Oe@r'RZg&O)(fZ9[oQS=-ER_J,~>
1]R@=BJ'r*!Y>?64U28q!=q@6'`\4`5!:JY:08,/!"M@>!"TYe!)>i\!tkS<07
rr4[;@;0RoE)q$YIYVc[9hQrP,=7W`T9,2'O.9Ps'J"?5D/4TU;JUSiIWfFEQiI*bJ,~>
0`D"NP$DI+?=60-5&>CKAOA^)%3%ElS>2F:SWK@J(().!?:2"!3?BbBgJ,~>
'*%jqB,hNk!XJc:!#Q[U'+uJirW!s(3Ai0;5=/Bl!!!0d&e"aK)#t-e#Tjot0REBdpOE~>
1]%.FX`HpKCNXlLK<'0-DI,UD4eAO@OcGQoRZa;.O=:PY;KR;VR\#.QDKB>^:Rq.UrdX~>
1\^n@Wbt%4@:j.eELCE>@8f#j17"W(Pa%T2TU)77N#r$27r3@7P)jTh=^P#c5a_?Es*t~>
+9)/pIk1R(!!`lG*Cg\A)`8oA"BA5Y.4-T.5XA4;:]:>*)C$"E,;^\c(`!8T$%;45pOE~>
1]RIN]P9ZNCLMFcV5%m3BeC)MA!N7FQ^j2&MN*OTSrl5V%;ffhC7LZ5F&.$kC<$5Ps*t~>
0`CkC\S"!?@omH7QBYcO>U'S#>*+i6R\Q7@P*1icRZ'07!+B;CBU"Nf@R"R+?c)gBJ,~>
#64MZNZnH+rW"B+4$aJ^-P6=Y+[.P600D3^4[;.o;cOJ2!&k_p!%BQ;)?:NQ*MrE'qLA~>
0`V(Ns-mP3C34T)@rQ!u,9/(QR@K\>R"T4.OI_f0PEhFW&humkDK]H&:2sZYG4kk7J,~>
0`CnKr0Lc"A8Q*[-DY3r.J,~>
"onDcelWCY!<3`Z-ia5S5u9^"4#\uA8Q]A":IIcX"98rB%06_7$ih%F&22]2qYG^~>
s8OhBs/BaDBkq1.C3=MM(d_esOJ%u'Q#S]F/L!N8R&5e59G\+;A6!DM@8Bs,T`>&jr."~>
1]IF@s.s:5@q8eg?u'C$&OC)nNguArQZbJY1*f/=Q`#h25mdWg@T7,I>Y.agRK*
1]RF0j)lRR!rr<:#p_&%!#7:f5s[Cb6So2p'EA_477fOY0*)%n(]XpD#QP2DC[Lunpj`~>
1\:YHq>^J$C1M9Q6
1\:YHoDS\h@U*S13`7%.5a7S/Q]d;uQ72qI&HO>'S!'>(S2pm)5\je%;,Unis8W)urI=~>
1\:M;j5JT0)@I2Y!#5J6(/@4n76
/H>P=s7ZKmHtIY;7Q)GNOI^iZTUhFC>UBLP!rrj&M4]ctNfQpD'0^58@;5W=!;_3~>
0E:h;rpB[_DH^pa4Y@X.O/n>+UR.(6>:B[T"98j!M5?N5PE&08#rcR"?tT<7r;Q]rqLA~>
1]$b3qrmS49.DhE"98E=@7_Fn9M%cX,7FSi,7k)"5sm(`5@?M['J2p(.Qub^q>:-hpj`~>
"9/2tqYgFEU6\S1,#>%rMk$#oR#IDH&I&4B!=1QTQ]mSuRZ9N8/MW^os8N&urr<#gJ,~>
"98
0DP;ArVucel@!@e!!"'g=th`j4\A.E2ujF53?JP4;E?9P1/qa8"YVBVhrsP(rVlZom=5~>
1\CV@qu-Hms0l&Z-X)J)Pa%r"R%'>7E#JcZ!=8lmNgl?*SscC@A-N#iVtKfQr;$Bmqg\~>
)#=40rr;rss0PZM+B*o]MislmQ^O&5EZ4iU'gS"TQC=2&Ruh%^!^aKus8)cns8W"I~>
1\1MEs8M]]n"i2Q!$+[E:d7H'6r-Wj5lq6=1+<8*1,gU--o4Oj2?O4
s8)firVJ.Q?n!a)Mkl>7CMJ?<>%V)/*#f\B"ZgmpR$aJ9Q(=_:?7-L^W:TcSrqQ0dJ,~>
s8N)qrVnFZ@jim$L7Nrl@Ujb%=Ctl.*#K/,!&o:sS!TS/MNjd"@PT9=]`8$0s8)HhJ,~>
!VlWms"=*7UJ_a5)b*t"&K_rI-ljum)ZUO%6PLq&1b^F2-6=[%:e<8a>dO;'nb2G>pj`~>
1]%%Im/6^T=W/MjLnpP[3B9`>84#*J4Dd8K,]c>3P*1rpU8FKHMiLgQ!&(>Hq>9ses*t~>
rr4\?s8T$*+!k.=/Ccjm(DF0DPR?s;5Tph+'Qt.?B4LY:irV-?lJ,~>
1\1GCqu?GS5l^m67orJ=!!!Z)SrV6!]qg\~>
0E(hJr;ODn-oP.hTU:UL7@BR0FupNV'/aK=P*_>pSrenfO.;`,QB@,0%0/Vrr;HYG~>
s8W)t.D\A)4C"5LRYY?7Nff??1Ck$.1hpfhR$
!V#sbs!bN."q2\M;aro"%q&m^<@.nQ!#7gb?11E0W?r;V9~>
1]R=LrjP$5,(GH:QB@>J9Qc\D3@c$X+;Z).R$rW$LPq=\OHGWdQ%>?V9+h4YRK*<`pj`~>
1]RFMrO+p;.u9@^SsGRR6u.fs0-Lo3)A=-%S"GG3O-uf=R[')#RZ=A2
0CSK3s1C/i!(TCE4#f_i+@g9K,p*Zu$ig8P9LU@'4AK!R6U=1<=$C).8LPQW[Jp1+rI=~>
1]R"CO#8F.B9ngFOHc8P89[Qp/eAd92JFU0QCa5)P_P!RNffZsQC+2*NH-ET1p-9HrdX~>
1]R(DN\rF8E1rqpR@9[Y5&NSK,6nYj0OuM"R\H+9R[9P;SX>n
0^\$&Q89BY/Q+nl/ilij,>fjE*<69L,#A@I7R8dr<+B]M=CPu\@p3)@CiMWf;SiA4J,~>
1]@?23$^D;NfB9fQBRSB6<#KV+t>!%G@a*TNg-)oJOUt0.Q:L]PF%,^QBH&@$oOC=q1&~>
s8Og02^LMHQ^FD9SXGaG2bYM4)C-LbEa:b
1[4Lf2&-j%7Q`[d1HA)`+ZC&A%h8ja>Z*"8;FF&>90=^<(+)ObDIQ+$>BORC+AB!=s*t~>
1]NUu+Z+2+NKfcmQBdY93Ai]7/MK\XOIR_:OdD5sBJ'c/*>^>DPa7B#R>R,N.0:lWm=5~>
1]NY!+ZOY=QCFM5S!B(2/hAUg,qD?ENKYGsO-l3#Da,Ns0dJc$R\,tFUQCdd/I=2$pOE~>
1[TfL'c0,53BK2S2*4AX(`ah2(_.R#DMf?3AlM5n4#JN4,o\@;FD=l[>[Vei//^pWs*t~>
1Uo/!5EM+mOd(lsQCsUc4Y\-3.3;;QD`BLO6X_W]=!/@u(`!ZqOI;&pT8&c(FYXRLXag~>
1V5J(6'Rh+R$a&,Q(*nJ0ddnb+rX6DD)*P76")Nb@5BSi.OH3XR@]G-U5>M=JO(M3]mp~>
1T2HI.:Q1;0fLgO3Cce+)&j;9(]Ycn7j]]U.PCcG/MBFT2C8l-C3F<3G@#3,>=:>1b('~>
1R][OP(/XfOIqf8OD7X'DBLS_.OJVCND1s1?\!*M>;6Nf)](D3OH6,qSsG[rNG9dYR=G~>
1S$!XQ%G@"QCj;4LgibN?5=k2+sC?3Mao-t?A!E\BLat1T7/jSX+1~>
1Q32#G"G1j/3c*d2%]g76k(Ro+:C4qA2bZ18ldoA1-.*?5:\TPDL%7dJT,=#DgY5=[=A~>
1UJbl8YCC(OIhf'[s3IIG=*;m/1iKEP*f$kPF7/bLbBGX"qaChN/!LLR@0>+M)YqnVLS~>
1Uo2"9r*37OI;/bVe9mUA2k8@,q(=7P*SmkQ_KS1RR\t_)^\^\PCnaAQ^aSARSG(j\ps~>
1T;TH/86Y(/3Z0U=W&Y>6o#`1/Ku!WDLFHSFDXlS?7-sO+
1]'`g00l7lSuS6]YI(gPF?29E1a"1lU7I=7NJ!OdOErrC/8KT\BoedGPF7Mc9I_Q,m!o~>
1]L5u1.%dqR@fA*R\$+C>V.Ne/K,lYURm[EQ]\/KVNOkM6%FoMCl4L6Nh)W$>sCZ's*t~>
1\AKR@QZ@T6oRAn!PY3cTIj@>'VeG^+@Z
1\\:V00_n'T;&s5^U(tSs,*o/L5,7oRH~>
1]P6n0gA!tP`hoH\Wj+`;_C9e3FaB\2iXJpVlQ8MTW"TRQDL0#5'XJeSXPs94Z7f(s*t~>
1\.hL,974s77C9]>rGS[.4.M91gD%;,%YOe?"6r9A7oe.K8bpN94aB"IW0d9=$V;Ms*t~>
1[k"P
1]79m=#M]sN1coWV6H,N6RsTMRpn3+0f>W#Ts`%a^:V1HUl^jR0n5:_M3ggj2d+?(s*t~>
1[F_R<[SCc93G/!5t3S&'I5.[JPIL:+UhgZ9PK
1\^S1]2q'\>dqVR]Xl;*IR-+JOM3V74&MNPXf.bBKoqOKPZh1MPFS53S2;u;;6K-YqLA~>
s8OhH]2C@?8>)rES
1\:D?a&XJu'3nNf.jR2F-n$qX@?_T^/i%6_D0UDGEboK"LLt:_Jokd
1\CJ>p:+Br5B3p@a1B+%JjCtSMoTBb/P1GpV5LP<9hgA&?7UU`R?Wu';`$@*WV?2cr."~>
rr4PBZW&n<>a_@fR%0IL1G)+Zc"A[\:QE?-_8qL@=c\tc22XJeQ'I\92EY6UrVqB~>
1[t;As11uK"X?`05UnNO,pjiQ;3=*p.P4A,??_]U;*f/F;Da=ZIW]^Q5XSRf_>j
0_kPArqs013]`"pZa7N]ImPYpOi),_5Y.!Q^oNK"1co&oN/WBCN/r`n4Xk[NpAFphJ,~>
/cG_Ks890*1G3m
1\U\Ds8&cc('Hlu83B*r)C6Rl?%tj$:+T=YCj:GR?
rr4SCs8BN;6T0>%ZG4AK1bD=aa$EcdAtc]>L2Jt*4$#2mMi`d[Mde4gG,kH9rr2qJ~>
rr4JBs8KT94tU]LS#3*Qu"N5Ha3JJJ,~>
rr"G@qtRHO;VIp7:BeB?>j@lC0EttG]n1bO`j>jNk,,`rVlhI~>
!WW,ss!mfV;b9)j[aEp:?8YZS\rK*ZQ,h45>t-+t/i?*QPE2o)8i&5.q"ajcrr2qJ~>
!WN&rs!RQP:.$aEUV"F9=Z9
!WW,ts""'=XZ.I,-spn2>
0E:eHs8Mcjr4bft=a[a$b^tsHRETS76"QY*=%4i"3]o&H3B;Y[AhZ5GHMdC(r;HYG~>
0E1YErr)Thr4PNe:2Ql9]n)J>R*'2'3F\W">>$b03^#2R6:R*;F?DrtJH,K;rr)kI~>
!WVros"!pAoWTkk+Z="QH:r*&H)!nW+tmGj3&`Zk?sH/_4Z%AH@lR(rOT5@Oq>L
rr4PFrr2fpX,VU&4a,3#_9J.b^VO'FAsUAUH"C\q??.`2IueVK8oTWSqu$HmrVqB~>
/,]DGq#:TDAM;~>
rr2utrVn+=IUjc74HG2+E(,J0Jg"YI;ijC?4]>HuKKO+'P''o,I@7#4rrE#rs*t~>
0DtkMp&=serg\A-=@c(ncdKPL]@Y3>d(dcN]tLhbZbN((U@a6u:el_&T(W$\o_nf?~>
0DGGEo`"jds.4Y2
"9&9"qYgFASTg2_.4-s5E)(%QIs,RSD1@b"F`NJ5_5mU=rfTNO>*,#Hr;ZfirVqB~>
!<2ut/,oA>r1T(XG>C\-=gubrb08)[`6ZT=`l5sip[%P=oOgin:OTO1R/?g\q>L>D~>
!VuZmr[.I.`A/d*g:oa4&ANcI(,
!<)co-`E*4DEp!?/oG]>A7T.a>]Ot,H#%cQm-X]Es*8![?AZ:[SGrQgr;HYG~>
rVnDCr;?,NO1KFbF?ruG_TK[@_o^'p%n[ds*t~>
*WGs8s7cQnpR7>^H\Zo9>A_:&`mi)Ud`9V^cdK].rsNXX<.UK`\rW3Xq>:*iJ,~>
0)bYHs8DutrLT@iFF\6e5X0a=>\-f3>@;AnCgh#
r;Zfp-MrmhY^_]*Kh5L4c,IK=`l?'6a2u<6q#'XOBLYO9l%a5aPdp_lqu;0~>
q>V4tS@OHBresNPNm5\bc-FY[`m5s8N#rs*t~>
s8)corVn14T"'K;p4P_)E/emH?WC3BB5D?mFm/ksoQ+,ANrPMn[?IuprVQVF~>
r;S8Gr;3[jXDER^UNp'FFN;hLaMc6@aLJn"s8)D"92fs#pjdOORY^b
q>V2;WO6o1s/^ZN;0'e0bgXnedF?1\ci3qSHs^B9qYu=tR%K<5s76$bs*t~>
s7cZlqu-No-FKeZFc6-pH<*
r;Zfr-2`ag\T*B"p\]8=:PZO"cb7*(ah5d$p\B&+6u2J]q1X%&PF2:Es*t~>
q>US]SA0B2rr4'_=&+^ic.pUibM:M$_>jOl?WDIQp&Bnr\sAc_s8W)ss*t~>
s7e)?qtp?js,ib`GDuS#qeSM=9R(Si9NP.t;JKpplZQ*!HN4!EOF4NuPPG"SJ,~>
qu?]q,c%0FCPVc\r;Ub[F-"5hk31ONk1AMgGuIOZX7>uXMJg\,V#'rfJ,~>
q>V_=VS-u/s8DutE-HJhcK>!%n*g2?n,J,Q@=l)hs8%apc'kL*qYu'~>
s8)`lrr"+?V7^`)rqlZh?<9d-Jol3aCh8'OW7kua=*h@Ss8A'ubE\aqqYu'~>
q>Vh-R^6jir;?QopLRoGL;)^.bMD"#q0Y\&EqfA)p&9GaZFPhls7QBis*t~>
q>USaS@*9prr3T0oOMTIO3m_$k5+f/s+jTSJc>ZUqu;.hZ+#Mgs7ZBjJ,~>
s8W)srr3+eS$['orVmo8?s6
q>Vh4Zc[cSqZ$Tgrq^;RA<#'djl4DWIWJ\:o&fcDr;VM"[&&][s8N#rs*t~>
s8Moq)Oe"RIu4%%rq$-cBmX]flKeKMjSt*eB7g*OrVm%VI'TN(rVHPE~>
q>VD'ZcR]Tr;Zfrs8QqZ:/ZU`Is?7pJ9>7Qs6opcp]Q.mZ_icYs*t~>
q>Vh4YI&>'s8Vomn,3'-?=8u+k0(VhD0BTlo_JC^n,J)a]SrBRp\smbs*t~>
q>M7uXfl\qrr2ZkoDei
q>Vh3Yd8D)s8Vroo)J`D?q+XMQ>LqbGBn#7s8VuijR[_9\W
s8Moq"cBb'H?T2bs8W!8qsB,D?Z+?IIWojOqYC$_nc&RdLjc/4ScAN_s*t~>
rVlco#)Tb$G]
q>VgtZ+bX4rVuinqu-QnO]=k
/,T)?qZ$Tks+HiOJ;!t#rVufpr:0T9C3G?#EHmQEs8Mlds8DfoJT8;[LA_)OrW)nI~>
1]R@PqYg?`re@#VIt.@hqZ$Qps7ZJQGD;?XGB\rCqtg*\s8W#sJon_aKDYQEs8Drss*t~>
"98B!qYgF0H&oCfPQ1@JrV?0`r;VCR=^c>J@taaYrt4GZmI0q"A$(KEs8Vrls8W&jJ,~>
*rG^'s8VNes,4.nEJ"#ds82HgrquT&K5ul^J;jO'rVmH'qu?%qFe$a>s8VinqYpBgJ,~>
s8NW's8;*Yrf=P'Ee3o`s8)KhruV-RMKt:uJ;F6mrVQToq>C9\Bm6/pO8]%Ms7lQkrdX~>
1]$b2qu?Bis+./]G)>ePhrX"mq#CB-Jn]O.Ao$JZnbrLXj6ZF&@VV"HOT5@EpAb0hn:1~>
s84VOnc,UMAr"C4FD6u%Ngt&T6T8d<;_hKrClOdQO^_Zp:e5b1<.Cj\IZKf.nbrIcrdX~>
rr4\>r1c)XLW?cFCm^NQTlNCa3,:BL0j&O9OIDi,@U;f(7
1ZR]km/O(B?\QV4F]W0C4C:];68E77QbEX9n97SDKL&qiW&rUp4*~>
!W2Zks"9?A#XGT1GB$Mp>?5)E#o3UF";:f8C3i\E(Ws0qtU0[rI=~>
1]R@Ps8I`W"$Wm'G&p`)@pECS"qq";!"K!0>\.P\CH*(>!!<3'>C!]^GZ\@cs82fds*t~>
&aJTOp@s1=!'dj8HX.^'!!X_I!!rf@,mcji,nU+\q>^q&I^u(J*?pL0s8VQ\J,~>
0`V%Mqu$+U8;.**"!
1\p\Cp&CH\!'%KJGW'&ABP;*a)$9m>!<<*&?=@2hAoUoW!<
s8NZ&gZF:l!&M0WM*4HH#8J6mr;Zg%rW!-_-k6Xc#n$Y3%LrJ(CRCbI+s;6`s8W&mJ,~>
s8OhPeG[Q;7#[q<=@*WsCLUsmQV0M2(b?gL-qdB2
1\LP=eG@3.5`)83<]ppgC0tOfQ:Enu'.=n@/66+fD/X2l3&;=1B76kK>%huOWk.9ks*t~>
s8Oh'N2_4*)etG+=#p',_o='Gpfi7pC^[+tYs)PdffPqLA~>
s8OgnnGD_Ljj8!W
1\q!hp]('flI'ce=F+@i@V&ogoDeUcp%ldB@;B[g>[:?UaQ`EblLW\XDHL(\=]1[_s*t~>
1]Qr\Bie&PK82NG.7kp;*[),)Iu],>LSTo%;c["';F`?,IZKVHMkcb@;FjSr;bNAFqLA~>
1].3lnc&%IqO1i,B2`khCiR`"r;$Bcs2].rC1UUE9iG'"f\4^.e^@>c4$bh\5YIUGr."~>
1[tFfr;Zfms.!S:CfYXlASK6br:p%;%V/KA6Y]+s*t~>
1\fd)82MeoKLd:>.1\$Y*>Dt]4@c?r3!\p4*~>
s8Ogqq=F:PGA1]*AR]7eERO^]s8Dfo_eO7)DcL^F:/nmPbgatTep0YI5Vb)D5Y[IArdX~>
!qlT=rr4SGG@Y6!An,F`Ct&:Zs8Moq]jbbdDH_<`?uXuqpAb'Xs.3h0AR&\MC1!A.s*t~>
1\90o:+eP>'.Q()/0>oU&PHPIF_,KUD`_96FC9Gj7Q-'WE+WNjR:oW=J9#O1>XsA:p4*~>
s8Ogjq"=JtH"pl.?#Xt+anbu:r:p$2G]IS5?>E\S?dcpH`lc`YCc=L31-.9N4'p)/k^W~>
!r`/=rr3==F(ATn>]4_!`r5o:&,Q%ADeNTi?#F%iFnYG,q#::%RUB]0?"dkgBlqc&m!o~>
1\fTt>"2To-T!kM-8$Y[
s8Ogto_*ftb7K0f)*L5VXoN5.BkWrdX~>
1].3tq"\lE=BKQKCh%%prr)ikq#AHT@:="b?>=:cg]%6Es7Yo`@:O7`E+*-kCX)MOs*t~>
1]6-EDeoCm+!s9'1a
s8N8>m=&\bF8fo&A8e[Js8Voor76[+EG8ipDdRG,kL.c"aLPG,4u,&^.Q'^TWn-+nrdX~>
+8c)Tm<`;PBk:skA8JCCs8W&ts4N0,Ch6mcEFF%@rVca,m>G=iA8-'f@sDe?m-F3AJ,~>
1]?N^M%g1@2D-R3*ZIRgDf9B5LOrAbAn#"Q>WFTbIpQ>^Ef3acCLLmt>$ti%Q`IC
%fcFBH#.P4G&_D&FiF1Vrr"#6aaI]@@;8tWChW,-n(Ph0`.'Bn3@m-M/4_>7cHcFanpg~>
1]I-_FCf8nD/=&mG/a=XrVuonb^'4$Iq<.eXpj`~>
1]?X)3ZfUf1,:Bf(fbm&Bl89PF\GJB?Z]^`7hg?"FC.sZG@a*VK5u0Q:KAI"L5X()hLG~>
)#F8q?>j_!AS>dla8br7qXaZrEaE9k@:0"K([(;fnBKCrTg1_'-p0.=83Ej/`8LChrdX~>
0_ta0>A.SY?=[\cbl@P>q"=["FCAg#An5dqDXR9!r9jRNc>IB5UG%oJ+lM(;XJ,~>
1\^N\/i#%6.OQ2E
1]RBBCL;'pBP_,#r:L$ds7k-&>]=FOA8=o(bOb`2r9iF>90Fdi1+G=E6c[^/dbM;/rdX~>
s8O(0CftFV?"[]ps7cQgs7t6)@!6QiD08sPd.[M9rr3SODIcjhAR01iF8#S2nF=Kts*t~>
1]?ZX0I8qM5;*INH>%/&Ee8O*/m;mhEbmdGI#EJeCk%V!6r-[!BOG74-\d%sG)11gjF@~>
1]I$9>$u,XB4\15q"=[ep<-oYCftL]>ZtpLlM1;Wo@U-J77Ka*4$#Vic.LFihr;?KqLA~>
1]R0A?=%2L?t?J6rqHHko?CoaEaa'*AnQ>%o)&=ap?0>3?"7JRARf@`oDJ.CoC0m%s*t~>
1]?N].lU+":cN3TOGT!RLj::-:.f5;B3%r_VlH>LK8>"P:gRX4>?t2eWgJHqS=tesk(!~>
%0$%tZ(\CnR#:^%C6SYs$aQt?Z*:F:Z)l%3rr2p0rVj9tX/DkY?!;?DIdQt!r;Q]qJ,~>
&HDV*[AC1$R>q01Cm=u!s1/-?rOW-?dI[88%Df$PZEp6@BnNUJqu?Kis*t~>
1]R.9Um@pHOaQ517;Uc0gm=P)VlR#-Z`1[kjQ#.JfAig!Ycb7&BkDaaEnK@&k324)pj`~>
!qcKirqd&g[=l5FOL+ZYqtp:*bpAFa\rp?JEKsQBGp&+ads*t~>
!;??j$1YWa_M"&Wp%\CZrrMroqu7-(qu?Zks6leLLUDfRqYU;C~>
&G?)'rr<#c[tVPGN3;^DpA4X\([gkgp\"4RqY0a_qY'mUUm-V>J\_!XrVcbH~>
s8E#irqlutZAYf?YjhYl!;cWgs8)]lrr2in$i9f#o9P'AL9L1Gq>L>D~>
s8N)nrVm,4OKj\Jn,E=Nrs8:bL;8_Sp](6ks*t~>
s8N)mrr3<'[#D,@XR#`[qt^'aq>pBgrr!6%rVc;PK=luDoDSOas*t~>
s8EQ$r;?*^Ne"]uRK*
s8NN$s8VclP_Hl2S,`Nbq#CBl!<)lr&H)M%q>^KfpA]l(_MZ,.s8MusJ,~>
s8O\Ds8V`iOFb$!QM^RRqtp6eqYU-dqY'UVqYU-dp\OOTrVc9XrI]j=L:dE]qu-PF~>
&H2M*rqu]kQ%6T*NrT+YqYpKks8!-!qu6QkqYU6krqHEhr!/XI]7-^Vrr)fqJ,~>
s8Dlq#b-OcMidu;rqZHk$NC#(s8Dilrr<#oqYp\iO2-CMqYu'~>
!WDrpru1j&J\Qqtqt^-^qtp(!fpA4^mRZ"h.WVuenrVqB~>
&c__,r:'U\VN%p>Xo88!qu6Nirr2rtr;ZfsrW<#dp&=jo[=GiAOS\tOrVqB~>
&-)M+rq-6jXHL)PYQ"M"qXsmgr;?Qqo_SRe#J,W(M3\,@qYgGE~>
*rl*:rU^$eW/e6?WqlJfpAOsirVuirrVuirrVZNlrVZcdpAY!q[Xl&EOo,+OrVqB~>
s8W,us839"QA2Vn]))4%r;Z`orr;otqYpEm&H2V)r;QWlp\;%B\qu^OrqZNmJ,~>
qu7''S;Xe+]_hO)qu?]prr;otqY^
qu7?+R"qqo\+]Ikq>^Horr;utrVZWlrt,//qu-QnrV-)mICkB&s8Vros*t~>
%%EndData
showpage
%%Trailer
end
%%EOF
pasdoc/tests/testcases/ok_auto_abstract.pas 0000600 0001750 0001750 00000002603 13237143041 021653 0 ustar michalis michalis {$ifdef FPC} {$mode objfpc} {$endif}
{ This is the 1st sentence, it will be turned into
@@abstact description of this item. This is the 2nd sentence of the
description.
}
unit ok_auto_abstract;
interface
type
{ This is the 1st sentence of description.
This is the 2nd sentence of description.
@abstract(This is the explicit abstract section) }
TTest1 = class
end;
{ In this case there is no period char '.' that is followed by whitespace
in this comment, so the whole comment will be treated as abstract
description }
TTest2 = class
end;
{ Of course, 1st sentence may contain other tags,
like this: @link(TTest1) and like this:
@code Some code. Not really Pascal code, but oh well...
and I'm still in the 1st sentence, here the
@@abstract part ends. This is the 2nd sentence.
Note that in this example the '.' char inside @@code tag
did not confuse pasdoc -- it was not treated as the end of
1st sentence, because it was part of parameters of @@code tag.
Even though @@code tag in the example above used special
syntax TagsParametersWithoutParenthesis. }
TTest3 = class
end;
{ First sentence, auto-abstracted, and the 1st paragraph at the same time.
Notice that html output will add
to DetailedDescription, but not
to AbstractDescription. This is second paragraph. }
TTest4 = class
end;
implementation
end. pasdoc/tests/testcases/ok_table_of_contents_unit.pas 0000600 0001750 0001750 00000000100 13237143041 023535 0 ustar michalis michalis unit ok_table_of_contents_unit;
interface
implementation
end. pasdoc/tests/testcases/ok_tag_name_case.pas 0000600 0001750 0001750 00000000231 13237143041 021561 0 ustar michalis michalis { Trivial unit to test that tag case does not matter.
@code(Foo)
@CODE(Foo)
@CoDe(Foo)
}
unit ok_tag_name_case;
interface
implementation
end. pasdoc/tests/testcases/ok_dashes.pas 0000600 0001750 0001750 00000001667 13237143041 020300 0 ustar michalis michalis { @abstract(Test of various dashes.)
Triple dash produces em-dash, for separating parts of sentence and such,
like "I know a secret --- but I won't tell".
Double dash produces en-dash, intended to use for numbers ranges,
like "10--20".
Normal single dash is a short dash, for compound words,
like "variable-width font".
You can write @@@- in cases where you really want to write
just 2 or more consecutive short dashes. E.g. @--long-option-name
(here I escaped only the 1st "-", this means that the rest
of dashes is also treated as a short dash),
or -@-long-option-name (here I escaped only the 2nd dash),
or @-@-long-option-name (here I escaped two first dashes,
which wasn't really necessary, it's sufficient to escape
either 1st or the 2nd dash), @-@-long@-option@-name
(here I escaped all dashes; this looks unnecessary ugly
in source code, but it's correct).
}
unit ok_dashes;
interface
implementation
end. pasdoc/tests/testcases/ok_operator_test.pas 0000600 0001750 0001750 00000006620 13237143041 021715 0 ustar michalis michalis {$mode objfpc}
// Operator overloads Delphi and FPC
unit ok_operator_test;
interface
type
{ @abstract(Operator overloads declared within a record (Delphi 2006+)) }
TDelphiRec = record
{ Addition of two operands of type TDelphiRec }
class operator Add(a, b: TDelphiRec): TDelphiRec;
{ Subtraction of type TDelphiRec }
class operator Subtract(a, b: TDelphiRec): TDelphiRec;
{ Implicit conversion of an Integer to type TDelphiRec }
class operator Implicit(a: Integer): TDelphiRec;
{ Implicit conversion of TDelphiRec to Integer }
class operator Implicit(a: TDelphiRec): Integer;
{ Explicit conversion of a Double to TDelphiRec }
class operator Explicit(a: Double): TDelphiRec;
end;
{ @abstract(In this case, "Operator" is used as a normal Delphi identifier) }
TMyClass = class
private
FOperator: string;
public
{ In this case, "Operator" is used as a normal Delphi identifier,
not as an ObjFpc keyword. PasDoc should tolerate this,
for compatibility with Delphi and with FPC in $mode delphi. }
property Operator: string read FOperator write FOperator;
end;
TMyType = record end;
TMyType2 = record end;
{ In cases below, "operator" indicates FPC operator overloading
feature. PasDoc should handle it correctly. }
{ Assignment operators,
see [http://www.freepascal.org/docs-html/ref/refse57.html] }
{ }
Operator := (C : TMyType2) z : TMyType;
{ Arithmetic operators,
see [http://www.freepascal.org/docs-html/ref/refse58.html] }
{ }
Operator + (c: TMyType; c1: TMyType) c2: TMyType;
Operator - (c: TMyType; c1: TMyType) c2: TMyType;
Operator * (c: TMyType; i: integer) c2: TMyType;
Operator / (A, B: TMyType): TMyType;
Operator ** (A, B: TMyType): TMyType;
{ Comparison operators,
see [http://www.freepascal.org/docs-html/ref/refse59.html] }
{ }
operator = (const c, d: TMyType) : boolean;
operator < (const c, d: TMyType) : boolean;
operator > (const c, d: TMyType) : boolean;
operator <= (const c, d: TMyType) : boolean;
operator >= (const c, d: TMyType) : boolean;
{ Boolean operators overloading. Seem to be undocumented,
but they are used e.g. by FPimage unit in FPC sources. }
{ }
operator or (const c,d:TMyType) : TMyType;
operator and (const c,d:TMyType) : TMyType;
operator xor (const c,d:TMyType) : TMyType;
implementation
class operator TDelphiRec.Add(a, b: TDelphiRec): TDelphiRec; begin end;
class operator TDelphiRec.Explicit(a: Double): TDelphiRec; begin end;
class operator TDelphiRec.Implicit(a: Integer): TDelphiRec; begin end;
class operator TDelphiRec.Implicit(a: TDelphiRec): Integer; begin end;
class operator TDelphiRec.Subtract(a, b: TDelphiRec): TDelphiRec; begin end;
Operator := (C : TMyType2) z : TMyType; begin end;
Operator + (c: TMyType; c1: TMyType) c2: TMyType; begin end;
Operator - (c: TMyType; c1: TMyType) c2: TMyType; begin end;
Operator * (c: TMyType; i: integer) c2: TMyType; begin end;
Operator / (A, B: TMyType): TMyType; begin end;
Operator ** (A, B: TMyType): TMyType; begin end;
operator = (const c, d: TMyType) : boolean; begin end;
operator < (const c, d: TMyType) : boolean; begin end;
operator > (const c, d: TMyType) : boolean; begin end;
operator <= (const c, d: TMyType) : boolean; begin end;
operator >= (const c, d: TMyType) : boolean; begin end;
operator or (const c,d:TMyType) : TMyType; begin end;
operator and (const c,d:TMyType) : TMyType; begin end;
operator xor (const c,d:TMyType) : TMyType; begin end;
end.
pasdoc/tests/testcases/ok_conclusion.txt 0000600 0001750 0001750 00000000025 13034465544 021236 0 ustar michalis michalis Some conclusion text. pasdoc/tests/testcases/ok_link_class_unit_level.pas 0000600 0001750 0001750 00000001624 13237143041 023372 0 ustar michalis michalis { This is a link from unit's description to an identifier
inside the same unit: some procedure @link(Foo),
some class @link(TBar). }
unit ok_link_class_unit_level;
interface
procedure Foo;
procedure Xyz;
type
{ These are links from class' description to an identifiers
inside the same class. Note that @@links here first check
*inside* the class, then outside (i.e. in the whole unit).
That's why link to Foo below is a link to a method Foo
inside this class, not to a global procedure Foo.
Links inside the class: @link(Foo), @link(Sthg).
Links outside of the class: @link(ok_link_class_unit_level.Foo),
@link(Xyz). Note that I has to qualify Foo with unit's name
and write "ok_link_class_unit_level.Foo" to get a link to
procedure in the unit. Just like I would do in a Pascal code. }
TBar = class
procedure Foo;
procedure Sthg;
end;
implementation
end. pasdoc/tests/testcases/ok_back_comment.pas 0000600 0001750 0001750 00000001750 13237143041 021444 0 ustar michalis michalis {$ifdef FPC} {$mode objfpc} {$endif}
unit ok_back_comment;
{< Description of unit ok_back_comment. }
interface
uses SysUtils;
type
TMyType = Integer; {< Description of TMyType }
TMyClass = class
MyField: Integer; //< Description of MyField
procedure MyProc; //< Description of MyProc
property MyProp: Integer read MyField write MyField; //< Description of MyProp
end; {< Description of TMyClass }
TMyException1 = class(Exception); //< Description of TMyException1
TMyException2 = class(Exception); //< Description of TMyException2
TMyEnum = (
{< Description of TMyEnum }
meOne, //< Description of meOne
{ Description of meTwo }
meTwo,
meThree (*< Description of meThree*)
);
procedure Foo;
{< Description of Foo, (@name) }
var
V: Integer; //< Description of V
V1, V2: Integer; //< Description of V1 and V2
const
MyConst = 2; //< Description of MyConst
implementation
procedure TMyClass.MyProc; begin end;
procedure Foo; begin end;
end.
pasdoc/tests/testcases/ok_see_also.pas 0000700 0001750 0001750 00000000677 13237143041 020624 0 ustar michalis michalis { This is a testing unit for @@seealso tag.
@seealso(Foo)
@seealso(TSomeClass )
}
unit ok_see_also;
interface
{ @abstract(Abstract of Foo.) Further description of Foo.
@seealso TSomeClass }
procedure Foo;
type
{ @abstract(Abstract of TSomeClass.) Further description of TSomeClass.
@seealso Foo
@seealso ok_see_also ok_see_also unit }
TSomeClass = class
end;
implementation
end. pasdoc/tests/testcases/ok_description_test.txt 0000600 0001750 0001750 00000000537 13034465544 022454 0 ustar michalis michalis #TMyClass
Description of TMyClass from external file is here.
Another paragraph of TMyClass description.
#TMyClass.Foo
Description of @name from external file is here.
Some ordered list, just to test that everything works OK:
@orderedList(
@item One
@item Two
@item Three
)
#TMyClass
Another description of TMyClass from external file is here. pasdoc/tests/testcases/warning_back_comment.pas 0000600 0001750 0001750 00000000763 13237143041 022503 0 ustar michalis michalis //< Back comment without anything before --- should produce a warning.
{ First descr of unit warning_back_comment }
unit warning_back_comment;
{< Descr of unit warning_back_comment }
interface
type
TMyEnum = (
{< Descr of TMyEnum }
{ First descr of meOne } meOne //< Descr of meOne
);
var
{ First descr of V1 }
V1,
{ First descr of V2 }
V2: Integer; //< descr of V1 and V2
//)
@HTML(
http://docwiki.embarcadero.com/RADStudio/en/Nested_Type_Declarations
http://wiki.freepascal.org/class_extensions_examples
) }
unit ok_nested_types;
interface
type
{ @abstract(@name contains nested classes, records, types and constants.) }
TOuterClass = class(TObject)
private
{ Description of @name }
FOuterPrivateField: Integer;
type
{ @abstract(@name contains one nested class, type and constant.) }
TInnerPrivateClass = class(TObject)
public
type
{ Description of @name }
TInnerPublicInteger = type Integer;
{ @abstract(Description of @name) }
TInnerInnerPublicClass = class(TObject)
private
{ Description of @name }
FInnerInnerPrivateField: string;
{ Description of @name }
function InnerInnerPrivateFunc(AValue: Integer): string;
public
{ Description of @name }
property InnerInnerPublicProp: string read FInnerInnerPrivateField
write FInnerInnerPrivateField;
end;
private
const
{ Description of @name }
InnerPrivateConst = 1;
var
{ Description of @name }
FInnerPrivateField: Integer;
{ Description of @name }
class procedure InnerPrivateClassProc(const AValue: Integer); static;
public
{ Description of @name }
FInnerPublicField: Integer;
{ Description of @name }
procedure InnerPublicProc;
end;
{ Description of @name }
TOuterPrivateInteger = Integer;
{ @abstract(Description of @name) }
TInnerPrivateClassDescendant = class(TInnerPrivateClass)
private
FField: Integer;
end;
public
const
{ Description of @name }
OuterConst1 = 'Blah1';
{ Description of @name }
OuterConst2 = 'Blah2';
{ Description of @name }
procedure OuterPublicProc;
type
{ @name is a nested record }
TInnerImplicitRecord = record
public
{ Description of @name }
FInnerPublicRecField: Integer;
{ Description of @name }
procedure InnerPublicRecProc;
end;
end;
const
{ Description of @name }
GlobalConst = 123456;
implementation
{ TOuterClass }
procedure TOuterClass.OuterPublicProc;
begin
end;
{ TOuterClass.TInnerPrivateClass }
class procedure TOuterClass.TInnerPrivateClass.InnerPrivateClassProc(
const AValue: Integer);
begin
end;
procedure TOuterClass.TInnerPrivateClass.InnerPublicProc;
begin
end;
{ TOuterClass.TInnerPrivateClass.TInnerInnerPublicClass }
function TOuterClass.TInnerPrivateClass.TInnerInnerPublicClass.InnerInnerPrivateFunc(
AValue: Integer): string;
begin
end;
{ TOuterClass.TInnerImplicitRecord }
procedure TOuterClass.TInnerImplicitRecord.InnerPublicRecProc;
begin
end;
end.
pasdoc/tests/testcases/ok_enum_links.pas 0000600 0001750 0001750 00000001574 13237143042 021173 0 ustar michalis michalis unit ok_enum_links;
interface
type
{ My enumerated type description. }
TMyEnum = (
{ My enumerated value 1 description. }
me1,
{ My enumerated value 2 description. }
me2,
{ My enumerated value 3 description. }
me3
);
{$scopedenums on}
{ My enumerated type description. }
TMyScopedEnum = (
{ My enumerated value 1 description. }
mse1,
{ My enumerated value 2 description. }
mse2,
{ My enumerated value 3 description. }
mse3
);
{ Test of links.
@link(TMyEnum), @link(me1), @link(me2), @link(me3).
@link(TMyScopedEnum),
@link(TMyScopedEnum.mse1),
@link(TMyScopedEnum.mse2),
@link(TMyScopedEnum.mse3).
@link(TMyScopedEnum),
TODO: these should NOT work (scoped enum members namespace is tighter),
but for now they are linked too:
@link(mse1),
@link(mse2),
@link(mse3). }
procedure Foo;
implementation
end. pasdoc/tests/testcases/ok_multiple_vars.pas 0000600 0001750 0001750 00000000463 13237143042 021711 0 ustar michalis michalis unit ok_multiple_vars;
interface
type
TMyClass = class
{ Docs for A and B }
A, B: Integer;
{ Docs for C and D }
C, D: function(A: Integer): boolean;
end;
var
{ Docs for A and B }
A, B: Integer;
{ Docs for C and D }
C, D: function(A: Integer): boolean;
implementation
end. pasdoc/tests/testcases/ok_comment_over_uses_clause.pas 0000600 0001750 0001750 00000000231 13237143042 024104 0 ustar michalis michalis unit ok_comment_over_uses_clause;
interface
{ This comment shouldn't be assigned to anything. }
uses Unit2, Unit3;
procedure A;
implementation
end. pasdoc/tests/testcases/ok_record_with_case.pas 0000600 0001750 0001750 00000002657 13237143042 022336 0 ustar michalis michalis { @abstract(Testing of parsing and making docs for records with case parts.)
It does not pass properly yet:
@orderedList(
@item(Types for fields in record case are not printed
(because parser does not set their FullDeclaration properties).)
@item(Also, CaseTwoB field has no description (but it should have
"Description of CaseTwoA and CaseTwoB"))
)
Update 2005-10-17: now this test passes OK, both problems above
are solved.
}
unit ok_record_with_case;
interface
type
TMyRecord1 = record
{ Description of NormalField }
NormalField: Integer;
{ Description of CaseDecision }
case CaseDecision: boolean of
false: (
{ Description of CaseOneSingle }
CaseOneSingle: Single);
true: (
{ Description of CaseTwoSingle }
CaseTwoSingle: Single;
{ Description of CaseTwoInt }
CaseTwoInt: Integer;
{ Description of CaseTwoA and CaseTwoB }
CaseTwoA, CaseTwoB: Integer);
end;
TMyRecord2 = record
{ Description of NormalField }
NormalField: Integer;
case boolean of
false: (
{ Description of CaseOneSingle }
CaseOneSingle: Single);
true: (
{ Description of CaseTwoSingle }
CaseTwoSingle: Single;
{ Description of CaseTwoInt }
CaseTwoInt: Integer;
{ Description of CaseTwoA and CaseTwoB }
CaseTwoA, CaseTwoB: Integer);
end;
implementation
end. pasdoc/tests/testcases/error_macros.pas 0000600 0001750 0001750 00000000422 13237143042 021022 0 ustar michalis michalis { @abstract(This is a test what will happen when parsing error
will occur within a macro.)
pasdoc should print error message that clearly indicates
where an error occured --- when expanding macro FOO.
}
unit error_macros;
{$define FOO := record implementation}
FOO pasdoc/tests/testcases/ok_non_matching_paren.pas 0000700 0001750 0001750 00000001023 13237143042 022646 0 ustar michalis michalis { @abstract(Test of @@( and @@) constructs.)
@bold(This is bold, followed by two "at" chars and two parens. @@@@( ) )
No longer bold.
@italic(This is italic, followed by one "at" char and one opening paren. @@@( )
No longer italic.
@bold(This is bold, followed by two parens. ( ) )
No longer bold.
@italic(This is italic, followed by one closing paren. @) )
No longer italic.
@italic(This is bold, followed by "at" char. @@)
No longer italic.
}
unit ok_non_matching_paren;
interface
implementation
end. pasdoc/tests/testcases/error_unexpected_eof.pas 0000600 0001750 0001750 00000000106 13237143042 022532 0 ustar michalis michalis unit error_unexpected_eof;
interface
type
TRec = record
case ( pasdoc/tests/testcases/ok_external_class_hierarchy.txt 0000600 0001750 0001750 00000000024 13034465544 024126 0 ustar michalis michalis TMyClass2=TMyClass1
pasdoc/tests/testcases/ok_deprecated_directive_note.pas 0000600 0001750 0001750 00000002551 13237143042 024206 0 ustar michalis michalis { -*- compile-command: "fpc -vw ok_deprecated_directive_note.pas" -*- }
{$ifdef FPC}{$mode objfpc}{$H+}{$endif}
{ @abstract(Test deprecated directive with and without note.) }
unit ok_deprecated_directive_note deprecated 'Deprecation note for unit';
interface
procedure MyProc1; deprecated 'Deprecation note for procedure with some apostrophe: '' here you go:)';
procedure MyProc2; deprecated;
procedure MyProc3; deprecated #72#$65'llo'; //< Deprecated note should say 'Hello'. Handled Ok, we convert and sum string tokens correctly.
type
TTestClass = class
TestFieldDeprecated1: Integer deprecated 'Deprecation note for field';
TestFieldDeprecated2: Integer deprecated;
procedure MyMethod1; deprecated 'Deprecation note for procedure';
procedure MyMethod2; deprecated;
property TestProperty1: Integer; deprecated 'Deprecation note for property';
property TestProperty2: Integer; deprecated;
end;
TTestClassDeprecated1 = class
end deprecated 'Deprecation note for class';
TTestClassDeprecated2 = class
end deprecated;
const
TestConstDeprecated1 = 1 deprecated 'Deprecation note for constant';
TestConstDeprecated2 = 1 deprecated;
implementation
procedure MyProc1; begin end;
procedure MyProc2; begin MyProc3; end;
procedure MyProc3; begin end;
procedure TTestClass.MyMethod1; begin end;
procedure TTestClass.MyMethod2; begin end;
end.
pasdoc/tests/testcases/ok_anonymous_methods.pas 0000600 0001750 0001750 00000000432 13237143042 022572 0 ustar michalis michalis // Test case for Delphi anonymous methods
unit ok_anonymous_methods;
interface
type
// description of @name
TSimpleProcedure = reference to procedure;
// description of @name
TSimpleFunction = reference to function(x: string): Integer;
implementation
end.
pasdoc/tests/testcases/ok_preformatted_test.pas 0000600 0001750 0001750 00000001052 13237143042 022551 0 ustar michalis michalis (* @abstract(Test of @@preformatted tag.)
@preformatted(
Line one ?
1111 222 ?
IIII WWW ?
Some long space
Some long space
Three empty lines below (*not* converted into paragraph):
-------- end of three empty lines.
Some html and LaTeX special chars, to make sure that ConvertString is
called when it should be: < > & \ { }
Note that @-tags inside are not expanded: @name, and consequently
you don't have to double @ char. Just like within @html and @latex
tags.)
*)
unit ok_preformatted_test;
interface
implementation
end. pasdoc/tests/testcases/warning_not_existing_tags.pas 0000600 0001750 0001750 00000000363 13237143042 023606 0 ustar michalis michalis unit warning_not_existing_tags;
interface
{ pasdoc should complain (display warnings) about
wrong tags : @firstwarning(blah blah),
@code(Wrong tag inside a @@code: @secondwarning(ble ble)). }
procedure TestWarnings;
implementation
end. pasdoc/tests/testcases/ok_description_test.pas 0000600 0001750 0001750 00000000243 13237143042 022401 0 ustar michalis michalis unit ok_description_test;
interface
type
{ TMyClass description from source file. }
TMyClass = class
public
procedure Foo;
end;
implementation
end. pasdoc/tests/testcases/test_description.txt 0000600 0001750 0001750 00000000050 13034465544 021751 0 ustar michalis michalis This is description called @bold(main).
pasdoc/tests/testcases/ok_not_defined_omit.pas 0000600 0001750 0001750 00000000640 13237143042 022326 0 ustar michalis michalis unit ok_not_defined_omit;
interface
{$ifdef NOT_DEFINED}
{ Pasdoc should omit "blah blah blah" below, because "NOT_DEFINED"
is not defined. But previous bug caused pasdoc into
missing "$ifdef GLWINDOW_GTK_2", and "$ifdef NOT_DEFINED"
was closed by earlier "$endif"...
Fixed now. }
({$ifdef GLWINDOW_GTK_2} 0 {$else} #0 {$endif}
blah blah blah
{$endif read_implementation}
implementation
pasdoc/tests/testcases/ok_utf8_failchar.pas 0000600 0001750 0001750 00000025302 13237143042 021541 0 ustar michalis michalis { UTF-8 file with BOM ($EF, $BB, $BF).
This comment contains three code points that fail to translate to UCS2, they are
in the Vietnamese (nôm) translation near the bottom of this page and should not
trigger an error with Unicode Delphi but being replaced by the default fail char "?".
Text below is borrowed from the webpage @HTML(UTF-8 SAMPLER )
I Can Eat Glass@br
Sanskrit: काचं शक्नोम्यत्तुम् । नोपहिनस्ति माम् ॥@br
Sanskrit (standard transcription): kācaṃ śaknomyattum; nopahinasti mām.@br
Classical Greek: ὕαλον ϕαγεῖν δύναμαι· τοῦτο οὔ με βλάπτει.@br
Greek (monotonic): Μπορώ να φάω σπασμένα γυαλιά χωρίς να πάθω τίποτα.@br
Greek (polytonic): Μπορῶ νὰ φάω σπασμένα γυαλιὰ χωρὶς νὰ πάθω τίποτα.@br
Etruscan: (NEEDED)@br
Latin: Vitrum edere possum; mihi non nocet.@br
Old French: Je puis mangier del voirre. Ne me nuit.@br
French: Je peux manger du verre, ça ne me fait pas mal.@br
Provençal / Occitan: Pòdi manjar de veire, me nafrariá pas.@br
Québécois: J'peux manger d'la vitre, ça m'fa pas mal.@br
Walloon: Dji pou magnî do vêre, çoula m' freut nén må.@br
Champenois: (NEEDED)@br
Lorrain: (NEEDED)@br
Picard: Ch'peux mingi du verre, cha m'foé mie n'ma.@br
Corsican/Corsu: (NEEDED)@br
Jèrriais: (NEEDED)@br
Kreyòl Ayisyen (Haitï): Mwen kap manje vè, li pa blese'm.@br
Basque: Kristala jan dezaket, ez dit minik ematen.@br
Catalan / Català: Puc menjar vidre, que no em fa mal.@br
Spanish: Puedo comer vidrio, no me hace daño.@br
Aragones: Puedo minchar beire, no me'n fa mal .@br
Mallorquín: (NEEDED)@br
Galician: Eu podo xantar cristais e non cortarme.@br
European Portuguese: Posso comer vidro, não me faz mal.@br
Brazilian Portuguese (8): Posso comer vidro, não me machuca.@br
Caboverdiano/Kabuverdianu (Cape Verde): M' podê cumê vidru, ca ta maguâ-m'.@br
Papiamentu: Ami por kome glas anto e no ta hasimi daño.@br
Italian: Posso mangiare il vetro e non mi fa male.@br
Milanese: Sôn bôn de magnà el véder, el me fa minga mal.@br
Roman: Me posso magna' er vetro, e nun me fa male.@br
Napoletano: M' pozz magna' o'vetr, e nun m' fa mal.@br
Venetian: Mi posso magnare el vetro, no'l me fa mae.@br
Zeneise (Genovese): Pòsso mangiâ o veddro e o no me fà mâ.@br
Sicilian: Puotsu mangiari u vitru, nun mi fa mali.@br
Campinadese (Sardinia): (NEEDED)@br
Lugudorese (Sardinia): (NEEDED)@br
Romansch (Grischun): Jau sai mangiar vaider, senza che quai fa donn a mai.@br
Romany / Tsigane: (NEEDED)@br
Romanian: Pot să mănânc sticlă și ea nu mă rănește.@br
Esperanto: Mi povas manĝi vitron, ĝi ne damaĝas min.@br
Pictish: (NEEDED)@br
Breton: (NEEDED)@br
Cornish: Mý a yl dybry gwéder hag éf ny wra ow ankenya.@br
Welsh: Dw i'n gallu bwyta gwydr, 'dyw e ddim yn gwneud dolur i mi.@br
Manx Gaelic: Foddym gee glonney agh cha jean eh gortaghey mee.@br
Old Irish (Latin): Con·iccim ithi nglano. Ním·géna.@br
Irish: Is féidir liom gloinne a ithe. Ní dhéanann sí dochar ar bith dom.@br
Ulster Gaelic: Ithim-sa gloine agus ní miste damh é.@br
Scottish Gaelic: S urrainn dhomh gloinne ithe; cha ghoirtich i mi.@br
Old Norse (Latin): Ek get etið gler án þess að verða sár.@br
Norsk / Norwegian (Nynorsk): Eg kan eta glas utan å skada meg.@br
Norsk / Norwegian (Bokmål): Jeg kan spise glass uten å skade meg.@br
Føroyskt / Faroese: Eg kann eta glas, skaðaleysur.@br
Íslenska / Icelandic: Ég get etið gler án þess að meiða mig.@br
Svenska / Swedish: Jag kan äta glas utan att skada mig.@br
Dansk / Danish: Jeg kan spise glas, det gør ikke ondt på mig.@br
Sønderjysk: Æ ka æe glass uhen at det go mæ naue.@br
Frysk / Frisian: Ik kin glês ite, it docht me net sear.@br
Nederlands / Dutch: Ik kan glas eten, het doet mij geen kwaad.@br
Kirchröadsj/Bôchesserplat: Iech ken glaas èèse, mer 't deet miech jing pieng.@br
Afrikaans: Ek kan glas eet, maar dit doen my nie skade nie.@br
Lëtzebuergescht / Luxemburgish: Ech kan Glas iessen, daat deet mir nët wei.@br
Deutsch / German: Ich kann Glas essen, ohne mir zu schaden.@br
Ruhrdeutsch: Ich kann Glas verkasematuckeln, ohne dattet mich wat jucken tut.@br
Langenfelder Platt: Isch kann Jlaas kimmeln, uuhne datt mich datt weh dääd.@br
Lausitzer Mundart ("Lusatian"): Ich koann Gloos assn und doas dudd merr ni wii.@br
Odenwälderisch: Iech konn glaasch voschbachteln ohne dass es mir ebbs daun doun dud.@br
Sächsisch / Saxon: 'sch kann Glos essn, ohne dass'sch mer wehtue.@br
Pfälzisch: Isch konn Glass fresse ohne dasses mer ebbes ausmache dud.@br
Schwäbisch / Swabian: I kå Glas frässa, ond des macht mr nix!@br
Bayrisch / Bavarian: I koh Glos esa, und es duard ma ned wei.@br
Allemannisch: I kaun Gloos essen, es tuat ma ned weh.@br
Schwyzerdütsch (Zürich): Ich chan Glaas ässe, das schadt mir nöd.@br
Schwyzerdütsch (Luzern): Ech cha Glâs ässe, das schadt mer ned.@br
Plautdietsch: (NEEDED)@br
Hungarian: Meg tudom enni az üveget, nem lesz tőle bajom.@br
Suomi / Finnish: Voin syödä lasia, se ei vahingoita minua.@br
Sami (Northern): Sáhtán borrat lása, dat ii leat bávččas.@br
Erzian: Мон ярсан суликадо, ды зыян эйстэнзэ а ули.@br
Northern Karelian: Mie voin syvvä lasie ta minla ei ole kipie.@br
Southern Karelian: Minä voin syvvä st'oklua dai minule ei ole kibie.@br
Vepsian: (NEEDED)@br
Votian: (NEEDED)@br
Livonian: (NEEDED)@br
Estonian: Ma võin klaasi süüa, see ei tee mulle midagi.@br
Latvian: Es varu ēst stiklu, tas man nekaitē.@br
Lithuanian: Aš galiu valgyti stiklą ir jis manęs nežeidžia@br
Old Prussian: (NEEDED)@br
Sorbian (Wendish): (NEEDED)@br
Czech: Mohu jíst sklo, neublíží mi.@br
Slovak: Môžem jesť sklo. Nezraní ma.
Polska / Polish: Mogę jeść szkło i mi nie szkodzi.@br
Slovenian: Lahko jem steklo, ne da bi mi škodovalo.@br
Croatian: Ja mogu jesti staklo i ne boli me.@br
Serbian (Latin): Ja mogu da jedem staklo.@br
Serbian (Cyrillic): Ја могу да једем стакло.@br
Macedonian: Можам да јадам стакло, а не ме штета.@br
Russian: Я могу есть стекло, оно мне не вредит.@br
Belarusian (Cyrillic): Я магу есці шкло, яно мне не шкодзіць.@br
Belarusian (Lacinka): Ja mahu jeści škło, jano mne ne škodzić.@br
Ukrainian: Я можу їсти скло, і воно мені не зашкодить.@br
Bulgarian: Мога да ям стъкло, то не ми вреди.@br
Georgian: მინას ვჭამ და არა მტკივა.@br
Armenian: Կրնամ ապակի ուտել և ինծի անհանգիստ չըներ։@br
Albanian: Unë mund të ha qelq dhe nuk më gjen gjë.@br
Turkish: Cam yiyebilirim, bana zararı dokunmaz.@br
Turkish (Ottoman): جام ييه بلورم بڭا ضررى طوقونمز@br
Bangla / Bengali: আমি কাঁচ খেতে পারি, তাতে আমার কোনো ক্ষতি হয় না।@br
Marathi: मी काच खाऊ शकतो, मला ते दुखत नाही.@br
Kannada (ಕನ್ನಡ): ಎಲ್ಲಾದರೂ ಇರು, ಎಂತಾದರು ಇರು, ಎಂದೆಂದಿಗೂ ನೀ ಕನ್ನಡವಾಗಿರು, ಕನ್ನಡವೇ ಸತ್ಯ.. ಕನ್ನಡವೇ ನಿತ್ಯ..@br
Hindi: मैं काँच खा सकता हूँ और मुझे उससे कोई चोट नहीं पहुंचती.@br
Tamil: நான் கண்ணாடி சாப்பிடுவேன், அதனால் எனக்கு ஒரு கேடும் வராது.@br
Telugu: నేను గాజు తినగలను మరియు అలా చేసినా నాకు ఏమి ఇబ్బంది లేదు@br
Urdu(3): میں کانچ کھا سکتا ہوں اور مجھے تکلیف نہیں ہوتی ۔@br
Pashto(3): زه شيشه خوړلې شم، هغه ما نه خوږوي@br
Farsi / Persian(3): .من می توانم بدونِ احساس درد شيشه بخورم@br
Arabic(3): أنا قادر على أكل الزجاج و هذا لا يؤلمني.@br
Aramaic: (NEEDED)@br
Maltese: Nista' niekol il-ħġieġ u ma jagħmilli xejn.@br
Hebrew(3): אני יכול לאכול זכוכית וזה לא מזיק לי.@br
Yiddish(3): איך קען עסן גלאָז און עס טוט מיר נישט װײ.@br
Judeo-Arabic: (NEEDED)@br
Ladino: (NEEDED)@br
Gǝʼǝz: (NEEDED)@br
Amharic: (NEEDED)@br
Twi: Metumi awe tumpan, ɜnyɜ me hwee.@br
Hausa (Latin): Inā iya taunar gilāshi kuma in gamā lāfiyā.@br
Hausa (Ajami) (2): إِنا إِىَ تَونَر غِلَاشِ كُمَ إِن غَمَا لَافِىَا@br
Yoruba(4): Mo lè je̩ dígí, kò ní pa mí lára.@br
Lingala: Nakokí kolíya biténi bya milungi, ekosála ngáí mabé tɛ́.@br
(Ki)Swahili: Naweza kula bilauri na sikunyui.@br
Malay: Saya boleh makan kaca dan ia tidak mencederakan saya.@br
Tagalog: Kaya kong kumain nang bubog at hindi ako masaktan.@br
Chamorro: Siña yo' chumocho krestat, ti ha na'lalamen yo'.@br
Javanese: Aku isa mangan beling tanpa lara.@br
Vietnamese (quốc ngữ): Tôi có thể ăn thủy tinh mà không hại gì.@br
Vietnamese (nôm) (4): 些 𣎏 世 咹 水 晶 𦓡 空 𣎏 害 咦@br
Thai: ฉันกินกระจกได้ แต่มันไม่ทำให้ฉันเจ็บ@br
Mongolian (Cyrillic): Би шил идэй чадна, надад хортой биш@br
Chinese: 我能吞下玻璃而不伤身体。@br
Chinese (Traditional): 我能吞下玻璃而不傷身體。@br
Taiwanese(6): Góa ē-tàng chia̍h po-lê, mā bē tio̍h-siong.@br
Japanese: 私はガラスを食べられます。それは私を傷つけません。@br
Korean: 나는 유리를 먹을 수 있어요. 그래도 아프지 않아요@br
Bislama: Mi save kakae glas, hemi no save katem mi.@br
Hawaiian: Hiki iaʻu ke ʻai i ke aniani; ʻaʻole nō lā au e ʻeha.@br
Marquesan: E koʻana e kai i te karahi, mea ʻā, ʻaʻe hauhau.@br
Chinook Jargon: Naika məkmək kakshət labutay, pi weyk ukuk munk-sik nay.@br
Navajo: Tsésǫʼ yishą́ągo bííníshghah dóó doo shił neezgai da.@br
Cherokee (and Cree, Chickasaw, Cree, Micmac, Ojibwa, Lakota, Inuktitut, Náhuatl, Quechua, Aymara, and other American languages): (NEEDED)@br
Garifuna: (NEEDED)@br
Gullah: (NEEDED)@br
Lojban: mi kakne le nu citka le blaci .iku'i le se go'i na xrani mi@br
Nórdicg: Ljœr ye caudran créneþ ý jor cẃran.@br
}
unit ok_utf8_failchar;
interface
implementation
end.
pasdoc/tests/testcases/ok_cdecl_external.pas 0000600 0001750 0001750 00000001035 13237143042 021773 0 ustar michalis michalis { Bug:
Parsing of this unit fails with
Warning[2]: Error EPasDoc: todo/ok_cdecl_external.pas(5): Unexpected keyword external. parsing unit ok_cdecl_external.pas, continuing...
Bar and Xyz added as additional tests.
Update: it's fixed now, pasdoc parses it correctly.
}
unit ok_cdecl_external;
interface
procedure Foo; cdecl; external 'whatever';
procedure Bar; cdecl; external 'bar_library_name' name 'bar_name_in_library';
procedure Xyz; external 'xyz_library_name' name 'xyz_name_in_library'; cdecl;
implementation
end. pasdoc/tests/testcases/ok_image.pas 0000600 0001750 0001750 00000001234 13237143042 020102 0 ustar michalis michalis { @abstract(This is @@image tag test.)
Note that for dvi, eps image will be chosen (for pdf and html, jpg):
@image(ok_image_picture.eps
ok_image_picture.jpg)
Note that using the same image for the 2nd time will cause the same
image to be included in the output (i.e. in the output we have
@italic(one) copy of ok_image_picture.jpg, not @italic(two)).
@image(ok_image_picture.eps
ok_image_picture.jpg)
Now note that pdf format will choose pdf version of the image:
@image(ok_image_picture.eps
ok_image_picture.pdf
ok_image_picture.jpg)
}
unit ok_image;
interface
const
Unimportant = 0;
implementation
end. pasdoc/tests/testcases/ok_helpinsight_comments.pas 0000600 0001750 0001750 00000001557 13237143042 023253 0 ustar michalis michalis { Test of handling help insight comments, in the form "/// ... ".
See http://delphi.wikia.com/wiki/Help_insight,
example snippet with @link(Parse) function is straight from there.
See https://sourceforge.net/tracker/?func=detail&atid=304213&aid=3485263&group_id=4213. }
unit ok_helpinsight_comments;
interface
/// parses the commandline
/// is a string giving the commandline.
/// NOTE: Do not pass System.CmdLine since it contains the
/// program's name as the first "parameter".
/// If you want to parse the commandline as passed by
/// windows, call the overloaded Parse method without
/// parameters. It handles this.
procedure Parse(const _CmdLine: string);
implementation
end. pasdoc/tests/testcases/ok_line_break.pas 0000600 0001750 0001750 00000000357 13237143042 021120 0 ustar michalis michalis { Test @@br tag. }
unit ok_line_break;
interface
{ 1st paragraph. @br Second line of 1st paragraph.
2nd paragraph. Blah blah blah.
3rd paragraph. @br
Second line of 3rd paragraph. }
procedure TestLineBreak;
implementation
end. pasdoc/tests/testcases/ok_list_item_set_number.pas 0000600 0001750 0001750 00000000401 13237143042 023227 0 ustar michalis michalis { @abstract(Testcase for
[https://sourceforge.net/tracker/?func=detail&atid=104213&aid=1533017&group_id=4213])
@orderedList(
@itemSetNumber(0)
@itemSpacing(Compact)
@item(foo)
@item(bar)
)
}
unit ok_list_item_set_number;
interface
implementation
end. pasdoc/tests/testcases/ok_link_1_char.pas 0000600 0001750 0001750 00000001234 13237143042 021172 0 ustar michalis michalis unit ok_link_1_char;
interface
uses Classes;
type
{@abstract(@name is used to specify the
real-world coordinates of a pixel in a
bitmap.)}
TMeasurementPointItem = class(TCollectionItem)
private
// @name: double;
// See @link(X).
FX: double;
// @name: double;
// See @link(Y).
FY: double;
// See @link(X).
procedure SetX(const Value: double);
// See @link(Y).
procedure SetY(const Value: double);
published
// @name is the X real-world coordinate.
property X: double read FX write SetX;
// @name is the Y real-world coordinate.
property Y: double read FY write SetY;
end;
implementation
end.
pasdoc/tests/testcases/warning_abstract_twice.pas 0000600 0001750 0001750 00000000341 13237143042 023050 0 ustar michalis michalis { @abstract(First abstract)
@abstract(Second abstract)
pasdoc should warn "You used @@abstract twice in description of item ..."
or something like that. }
unit warning_abstract_twice;
interface
implementation
end. pasdoc/tests/testcases/warning_inherited_test.pas 0000600 0001750 0001750 00000002003 13237143042 023061 0 ustar michalis michalis unit warning_inherited_test;
interface
type
{ This is a class without ancestor name specified.
Inherited is @inherited.
Inherited class is @inheritedClass. }
TMyClass0 = class
{ Inherited is @inherited.
Inherited class is @inheritedClass. }
procedure Clear;
end;
{ This is a class with specified ancestor name, but ancestor (TStringList)
is not parsed by PasDoc.
Inherited is @inherited.
Inherited class is @inheritedClass. }
TMyClass1 = class(TStringList)
{ Inherited is @inherited.
Inherited class is @inheritedClass. }
procedure Clear;
end;
{ This is a class with specified ancestor name, and ancestor (TMyClass1)
is parsed by PasDoc.
Inherited is @inherited.
Inherited class is @inheritedClass. }
TMyClass2 = class(TMyClass1)
{ Inherited is @inherited.
Inherited class is @inheritedClass. }
procedure Clear;
end;
{ Inherited is @inherited.
Inherited class is @inheritedClass. }
procedure Test;
implementation
end. pasdoc/tests/testcases/ok_value_member_tags.pas 0000600 0001750 0001750 00000001540 13237143042 022501 0 ustar michalis michalis unit ok_value_member_tags;
interface
type
{ @member MyField Description of MyField here.
@member(MyMethod Description of MyMethod here, using parenthesis.
@param(A Description of param A.)
@returns(Some boolean value.) )
@member(MyProperty Description of MyProperty here,
with some recursive tags inside:
@code(Some code with a link to @link(TMyRecord)).) }
TMyClass = class
MyField: Integer;
function MyMethod(A: Integer): boolean;
property MyProperty: Integer read MyField write MyField;
end;
{ @member MyField Description of MyField in TMyRecord here. }
TMyRecord = record
MyField: Integer;
end;
{ @value meOne Description of meOne follows.
@value meThree Description of meThree, with some link: @link(TMyClass.MyField). }
TMyEnum = (meOne, meTwo, meThree);
implementation
end.
pasdoc/tests/testcases/ok_no_sort.pas 0000600 0001750 0001750 00000000473 13237143042 020507 0 ustar michalis michalis unit ok_no_sort;
interface
type
{ Enum values are not sorted }
TMyEnum = (meZZZ, meAAA);
{ Record fields are not sorted }
TMyRecord = record
ZZZ: Integer;
AAA: Integer;
end;
{ Class fields are sorted }
TMyClass = class
ZZZ: Integer;
AAA: Integer;
end;
implementation
end. pasdoc/tests/testcases/ok_links_2.pas 0000600 0001750 0001750 00000000367 13237143042 020367 0 ustar michalis michalis { Helper unit for test in ok_links. }
unit ok_links_2;
interface
procedure MyProc;
procedure MyOtherProc;
type
TSomeClass = class
procedure MyMethod;
end;
TSomeOtherClass = class
procedure MyMethod;
end;
implementation
end. pasdoc/tests/testcases/ok_longcode_underscores.pas 0000600 0001750 0001750 00000000704 13237143042 023227 0 ustar michalis michalis { 2005-06-07: Latex version of docs for this unit are wrong,
because ConvertString is not called to convert _ char.
So _ is not escaped and latex fails.
Also, HTML version is bad, because "With" is formatted in bold,
because it's treated like keyword.
Fixed by adding _ to AlphaNumeric in PasDoc_Gen in FormatPascalCode.
@longcode(#
Identifier_With_Underscores;
#)
}
unit ok_longcode_underscores;
interface
implementation
end. pasdoc/tests/testcases/ok_class_record_helpers.pas 0000600 0001750 0001750 00000001277 13237143042 023214 0 ustar michalis michalis // Test case for Delphi class and record helpers
unit ok_class_record_helpers;
interface
type
TForwardClass = class;
// description of @name
TSimpleRecord = record
// description of @name
SimpleField: Integer;
end;
// description of @name
TMyRecordHelper = record helper for TSimpleRecord
protected
// description of @name
procedure HelloWorld;
end;
// description of @name
TAncestorClassHelper = class helper for TApplication end;
// description of @name
TDescendantClassHelper = class helper(TAncestorClassHelper) for TApplication
// description of @name
procedure HelloWorld;
end;
implementation
end.
pasdoc/tests/testcases/ok_class_var.pas 0000600 0001750 0001750 00000000713 13237143042 020776 0 ustar michalis michalis { See bug [https://sourceforge.net/tracker/?func=detail&atid=104213&aid=1489442&group_id=4213] }
unit ok_class_var;
interface
type
TPluginManager = class
private
FLoadedPlugins : TPluginCollection;
FAfterPluginLoad : TAfterPluginLoadEvent;
class var FInstance : TPluginManager;
public
LoadedPlugins : TPluginCollection;
AfterPluginLoad : TAfterPluginLoadEvent;
class var Instance : TPluginManager;
end;
implementation
end. pasdoc/tests/testcases/ok_latex_head.pas 0000600 0001750 0001750 00000000500 13237143042 021111 0 ustar michalis michalis { Unit testing --latex-head option. Very long word:
unitfortestingoflatexheadoptionveryveryveryveryverylongword.
Another very long word, this time it should be broken because of \hyphenation:
anotherverylongwordthistimeitshouldbebrokenbecauseofhyphenation.
}
unit ok_latex_head;
interface
implementation
end. pasdoc/tests/testcases/ok_ignore_leading.pas 0000600 0001750 0001750 00000000635 13237143042 021772 0 ustar michalis michalis unit ok_ignore_leading;
interface
const
{*
* Test
*}
A = 1;
{****************************
* Test2
****************************}
B = 1;
{*
* count of preceding whitespace does not matter
* count of preceding whitespace does not matter
**** consecutive characters are ignored too
as in Javadoc not all lines have to start with the character
paragraph works.
*}
C = 1;
implementation
end.
pasdoc/tests/testcases/ok_expanding_descriptions.pas 0000600 0001750 0001750 00000011112 13237143042 023557 0 ustar michalis michalis { @abstract(This is a test of tags expanded by TPasItem handlers.
Of course with @@abstract tag using some recursive tag:
See also @link(TestPasMethodTags))
This whole unit is actually a big test of many things
related to pasdoc's @@-tags.
@author(Michalis )
@created(2005-03-30)
@cvs($Author: kambi $)
@lastmod(2005-03-30)
See also @link(TMyClass) for other test of @@cvs tag (with $Date,
as an alternative specification of @@lastmod)
}
unit ok_expanding_descriptions;
interface
{ Write two at chars, like this @@@@, to get one @@ in output.
E.g. @@ link(TSomeClass).
E.g. @@link(TSomeClass).
E.g. @@html foobar.
E.g. @@link . }
procedure TwoAt;
{ aa aaaaa aa aaa
@code(SHGetSpecialFolderPath(0, @@Path, CSIDL_APPDATA, true))
aaaa aaaaaa aaaaaa aaaaaaaaa aaaa
At some point, this test caused the bug:
final tag was inserted in converted form (processed with
ConvertString) into html output.
In effect, there was an opening tag but there was
no closing tag. }
procedure RecursiveTwoAt;
(* Note that inside @@longcode below I should be able to write
singe @@ char to get it in the output, no need to double it
(like @@@@). No tags are expanded inside longcode.
Also note that paragraphs are not expanded inside longcode
(no
inside
...
in html output).
Of course html characters are still correctly escaped
(< changes to < etc.).
@longcode(#
procedure Foo;
begin
if A < B then Bar; { @link(No, this is not really pasdoc tag) }
end;
procedure Bar(X: Integer);
begin
CompareMem(@X, @Y);
end;
#)
*)
procedure TestLongCode;
(*
@html(
This is some dummy html code, just to show that inside
@html tag of pasdoc (note that I used single @ char in this sentence)
nothing is expanded by pasdoc.
No paragraphs are created by pasdoc. (This text is still in the 1st,
not in the 2nd, paragraph in html output)
You must explicitly write <p> to get paragraph.
No tags work, e.g. @link(TestLongCode).
)
@latex(
This is some {\bf dummy} \LaTeX code, just to show that inside
@latex tag of pasdoc (note that I used single @ char in this sentence)
nothing is expanded by pasdoc.
No paragraphs are created by pasdoc. Although, in case of LaTeX output,
LaTeX rules for making paragraphs are the same as the pasdoc's rules
(one empty lines marks paragraph), so you will not notice.
This is brutal line-break: \\
I'm still in the same paragraph, after line-break.
I'm 2nd paragraph.
No tags work, e.g. @link(TestLongCode).
)
Note that text inside @@html / @@latex tags is absolutely not touched by pasdoc.
Characters are not escaped (< is *not* changed to < in the html case),
@@tags are not expanded, @@ needs not to be doubled, paragraphs
(
in the html case) are not inserted.
*)
procedure TestHtmlAndLatexTags;
type
EFoo = class(Exception) end;
EBar = class(Exception) end;
EXyz = class(Exception) end;
{ @@code and @@returns (and some others) tags are recursive,
you can freely put other tags inside.
@code(This is link to @link(TestHtmlAndLatexTags).)
@raises(EFoo in case @link(TestHtmlAndLatexTags)
returns value >= 4 (actually, this is just a test text).)
}
procedure TestRecursiveTag;
{ This is a test of tags expanded by TPasMethod handlers.
Note that all three tags are expanded recursively.
@param(A means sthg about @link(TestRecursiveTag))
@param(B also means sthg. @code(Code inside.))
@returns(You can make tags recursion any level deep :
@code(This is a code with a link to @link(TestRecursiveTag)))
@raises(EFoo when you do sthg nasty, like call @link(TestRecursiveTag)
when you're not supposed to)
@raises(EBar when code @code(if 1 = 0 then DoSomething;) will work as expected.)
}
function TestPasMethodTags(A, B: Integer): string;
type
TMyClassAncestor = class
private
MyField: boolean;
public
//@abstract(This comment should be inherited.)
property inheritable: boolean read MyField;
end;
{ These are some tags that are not allowed to have parameters:
name @name, inherited @inherited, nil @nil, true @true, false @false,
classname @classname. Some of them are valid only within a class,
but this is not important for this test.
@cvs($Date: 2010-04-26 04:04:35 +0200 (pon) $) }
TMyClass = class(TMyClassAncestor)
published
//This is the detailed description.
property inheritable;
end;
{ And a test of @exclude.
This should not be seen in final output! }
procedure TestExclude;
implementation
end.
pasdoc/tests/testcases/ok_caret_character.pas 0000600 0001750 0001750 00000001221 13237143042 022126 0 ustar michalis michalis { @abstract(Test of parsing "^char" constants,
see [http://www.freepascal.org/docs-html/ref/refsu7.html].)
Note that while FPC docs say that only ^A .. ^Z are allowed,
actually both FPC 2.0.0 and Kylix 3 accept other characters
after the caret, e.g. "^\" is accepted.
See also bug report "[ 1358911 ] Invalid character in input stream".
}
unit ok_caret_character;
interface
const
C2 = ^A;
C3 = ^B;
C4 = ^Z;
// SUBstitute
SUB = ^Z;
// ESCape
ESC = ^[;
// File Separator
FS = ^\;
// Group Separator
GS = ^];
// Record Separator
RS = ^^;
// Unit Separator
US = ^_;
implementation
end. pasdoc/tests/testcases/ok_longcode_special_chars.pas 0000600 0001750 0001750 00000000335 13237143042 023473 0 ustar michalis michalis (*
@abstract(Yet another test of @@longcode.)
@longcode(#
begin
Writeln('Some special HTML (<, >, &) and LaTeX ({, }, \) chars.');
end;
#)
*)
unit ok_longcode_special_chars;
interface
implementation
end. pasdoc/tests/testcases/error_expected_semicolon.pas 0000600 0001750 0001750 00000000137 13237143042 023412 0 ustar michalis michalis unit error_expected_semicolon;
interface
type
TMyType = (A, B) record
implementation
end. pasdoc/tests/testcases/ok_macro_include.inc 0000600 0001750 0001750 00000000201 13237143042 021603 0 ustar michalis michalis {$DEFINE CLASS_CONSTRUCTOR:=Constructor Init;
Overload}
{$DEFINE SPAWNABLE_CONSTRUCTOR:=Constructor Init(Param:String);
Overload} pasdoc/tests/testcases/warning_desc_end.pas 0000600 0001750 0001750 00000000101 13237143042 021610 0 ustar michalis michalis { @code(}
unit warning_desc_end;
interface
implementation
end. pasdoc/tests/testcases/ok_tag_params_no_parens.pas 0000600 0001750 0001750 00000003221 13237143042 023200 0 ustar michalis michalis { @abstract This is a demo unit using tags without enclosing them in ()
Parsing logic is simple: if a tag requires some parameters
but you don't put open paren '(' char right after it,
then tag parameters are understood to span to the end of line
(or to the end of comment).
This doesn't break compatibility with documentation that enclosed
parameters in (), because tags that have parameters were
*required* to have '(' char after them. So they will still be
correctly seen and parsed to the matching closing paren.
See @link(SomeProc) for more examples and comments.
@author Michalis
@created 2005-05-04
@lastmod 2005-05-04
@cvs $Author: kambi $ }
unit ok_tag_params_no_parens;
interface
type
EFoo = class(Exception);
(*
Note that this rule allows you to not specify () for *any* tag
that has parameters. Even for @@link tag:
@link ok_tag_params_no_parens
This rule doesn't create any problems for tags without parameters,
like the @@name tag: here it is: @name. Such tags never have parameters,
and on the above line you *don't* have @@name tag with
parameters "tag. Such tags never have parameters,".
Instead, you just specified @name tag and
"tag. Such tags never have parameters," is just a normal text.
Check out this longcode:
@longcode# begin Writeln('Hello world'); end; { This works ! } #
See also @@html and @@latex tags:
@html I'm red
@latex {\bf I'm bold.}
And here is some code: @code begin X := Y + 1; end;
@raises EFoo when it's in bad mood
@param A means something
@returns Some integer *)
function SomeProc(A: Integer): Integer;
implementation
end. pasdoc/tests/testcases/ok_macros.pas 0000600 0001750 0001750 00000003364 13237143042 020312 0 ustar michalis michalis {$macro on}
{$mode objfpc}
{$define UNIT_DECL := unit ok_macros; interface}
{ @abstract(Test of FPC macros handling.)
Parts based on
[http://sourceforge.net/tracker/index.php?func=detail&aid=861356&group_id=4213&atid=354213]
}
UNIT_DECL
{$INCLUDE ok_macro_include.inc}
type
TAncestor = class end;
TMyClass = class(TAncestor)
public
CLASS_CONSTRUCTOR;
end;
{ Below is an example of a very bad and confusing (but valid)
macro usage. Just to test pasdoc. }
{$define FOO := a:Integer); (* This is very stupid way to declare
a procedure *) procedure MyProc2(}
procedure MyProc1(FOO b: Integer);
{$undef FOO}
function Foo(c: string): Integer;
procedure MyProc3(
{$define FOO:=1} X: Integer = FOO;
{$define FOO:=2} Y: Integer = FOO);
{$ifdef FOO}
procedure ThisShouldBeIncluded;
{$define FOO_WAS_DEFINED:=true}
{$else}
procedure ThisShouldNotBeIncluded;
{$define FOO_WAS_DEFINED:=false}
{$endif}
const
ThisShouldBeTrue = FOO_WAS_DEFINED;
{$undef FOO}
{$ifndef FOO}
procedure ThisShouldBeIncluded2;
{$else}
procedure ThisShouldNotBeIncluded2;
{$endif}
{ Test of recursive macro expansion. }
{$define ONE:=1}
{$define TWO:=ONE + ONE}
{$define FOUR := (TWO) * (TWO)}
const
FourConst = FOUR;
{ Test that symbol that is not a macro is something different than
a macro that expands to nothing. }
{$define NOT_NOTHING := + 1}
{$define NOTHING :=}
const
OneAndNotNothing = 1 NOT_NOTHING;
OnlyOne = 1 NOTHING;
implementation
constructor TMyClass.Init; begin end;
procedure MyProc1(a: Integer); begin end;
procedure MyProc2(b: Integer); begin end;
procedure MyProc3(X: Integer; Y: Integer); begin end;
function Foo(c: string): Integer; begin end;
procedure ThisShouldBeIncluded; begin end;
procedure ThisShouldBeIncluded2; begin end;
end.
pasdoc/tests/testcases/ok_include.pas 0000600 0001750 0001750 00000000730 13237143042 020443 0 ustar michalis michalis { @abstract(This is a test of @@include tag.)
Behold included file ok_include_1.txt:
@include(ok_include_1.txt)
Behold file ok_include_1.txt that is included for the 2nd time here:
@include(ok_include_1.txt)
Behold file ok_include_1.txt that is included for the 3rd time
here, and this time it's inside @@bold:
@bold @include(ok_include_1.txt)
Take a look at @link(ok_include_intro Introduction) too.
}
unit ok_include;
interface
implementation
end. pasdoc/tests/testcases/ok_deprecated_const_string.pas 0000600 0001750 0001750 00000000240 13237143042 023710 0 ustar michalis michalis unit ok_deprecated_const_string;
interface
procedure Foo; deprecated 'Since D2010 a const string may follow';
implementation
procedure Foo;
begin
end;
end. pasdoc/tests/testcases/ok_longcode_end_semicolon.pas 0000600 0001750 0001750 00000000302 13237143042 023503 0 ustar michalis michalis { Before 2008-01-17, ending semicolon was missing in the output:
@longCode(# Progress.UserInterface := ProgressGLInterface;#)
}
unit ok_longcode_end_semicolon;
interface
implementation
end. pasdoc/tests/testcases/ok_ignore_leading_hash.pas 0000600 0001750 0001750 00000000467 13237143042 023000 0 ustar michalis michalis unit ok_ignore_leading_hash;
interface
const
{###############################
# @--ignore-leading=#
###############################}
A = 1;
{###############################
# @--ignore-leading=#
###############################
(should produce the same result) }
B = 1;
implementation
end.
pasdoc/tests/testcases/ok_strict_visibilities.pas 0000600 0001750 0001750 00000000554 13237143042 023113 0 ustar michalis michalis {$ifdef FPC} {$mode objfpc} {$endif}
unit ok_strict_visibilities;
interface
Type
TStrictVisibility = class(TObject)
strict private
// the visibility of @name is "strict private."
StrictPrivateInteger: integer;
strict protected
// the visibility of @name is "strict protected."
StrictProtectedInteger: integer;
end;
implementation
end.
pasdoc/tests/testcases/ok_record_case_parsing.pas 0000600 0001750 0001750 00000001435 13237143042 023017 0 ustar michalis michalis unit ok_record_case_parsing;
interface
type
TRec1 = record
case boolean of
false: (A: Integer);
true: (B: Integer);
end;
TRec2 = record
case Field1: boolean of
false: (A: Integer);
true: (B: Integer;);
end;
{ @member C Description of C }
TRec3 = record
case Integer of
0: (
{ Descr of A }
A: Integer;
{ Descr of B }
B: ShortString;);
1: (
C: Integer);
2: (
{ Descr of D, E, F }
D, E, F: Integer;
G: ShortString;);
3: (
{ Descr of H }
H: Integer);
end;
TRec4 = record
case boolean of
false: (
case Integer of
0: (A: Integer);
1: (B: Integer) );
true: (C: Integer);
end;
implementation
end. pasdoc/tests/testcases/ok_complicated_record.pas 0000600 0001750 0001750 00000003167 13237143042 022651 0 ustar michalis michalis // Submitted in thread "Pasdoc tests" on pasdoc-main on 2005-04-11
// by Richard B Winston.
// pasdoc passes it, but the test checks many important things
// (line glueing single-line comments by pasdoc, record with case etc.)
// so it's worth adding it to test cases.
//
// @abstract( This unit is used for converting to and from the BigEndian format.
// See http://community.borland.com/article/0,1410,28964,00.html.)
unit ok_complicated_record;
interface
type
//enumeration used in variant record
BytePos = (EndVal, ByteVal);
// @name is a pointer to a @link(TDoubleEndianCnvRec).
PDoubleEndianCnvRec = ^TDoubleEndianCnvRec;
{ @abstract(@name is used in @link(ConvertDouble) to convert
a double to or from the BigEndian format.)
@longcode(#
TDoubleEndianCnvRec = packed record
case BytePos of
EndVal: (EndianVal: double);
ByteVal: (Bytes: array[0..SizeOf(double) - 1] of byte);
end;
#)
}
TDoubleEndianCnvRec = packed record
case BytePos of
//The value we are trying to convert
EndVal: (EndianVal: double);
//Overlapping bytes of the double
ByteVal: (Bytes: array[0..SizeOf(double) - 1] of byte);
end;
// @abstract(@name copies @link(TDoubleEndianCnvRec.Bytes)
// in reverse order from Source^ to Dest^.)
// @name is used in @link(ConvertDouble).
procedure SwapDoubleBytes(Dest, Source: PDoubleEndianCnvRec);
// @abstract(@name converts Value to or from the BigEndian format.)
// @param(Value is the value to be converted.)
// @returns(Value after being converted to or from the BigEndian format.)
function ConvertDouble(const Value: double): double;
implementation
end.
pasdoc/tests/testcases/ok_const_1st_comment_missing.pas 0000600 0001750 0001750 00000000456 13237143042 024215 0 ustar michalis michalis {:
See bug [ 1198381 ] "Comment on 1st const does'nt work"
}
unit ok_const_1st_comment_missing;
interface
const
//Range 600: bla bla
//: bla bla copy.
ec_COPY = 600;
//: bla bla cut.
ec_CUT = 601;
//: bla bla paste.
ec_PASTE = 602;
implementation
end. pasdoc/tests/testcases/ok_directive_as_identifier.pas 0000600 0001750 0001750 00000001513 13237143042 023663 0 ustar michalis michalis { All calling-convention specifiers must *not* be made links in docs.
But "Register" procedure name must be made a link.
Yes, the difficulty is here that "register" is once a
calling-convention specifier and once a procedure name.
This is related to bug submitted to pasdoc-main list
[http://sourceforge.net/mailarchive/message.php?msg_id=11397611].
}
unit ok_directive_as_identifier;
interface
procedure Register; register;
procedure Cdecl; register;
procedure Foo; register;
procedure Bar; cdecl;
type
TMyClass = class
end;
{ Some other test for
THTMLDocGenerator.WriteCodeWithLinks, while I'm at it:
Note that link to TMyClass should be correctly made.
'register' should be displayed as a string, of course, and not linked. }
procedure Foo1(const S: string = 'register'; MyClass: TMyClass);
implementation
end. pasdoc/tests/testcases/ok_no_link_inside_class.pas 0000600 0001750 0001750 00000001023 13237143042 023165 0 ustar michalis michalis unit ok_no_link_inside_class;
interface
type
TMyClass = class
procedure MyMethod;
{ This should be linked: @link(MyMethod).
This should be linked: @link(TMyClass.MyMethod).
This should be linked: @link(MyGlobalProcedure). }
procedure MyOtherMethod;
end;
{ This should NOT be linked: @link(MyMethod).
This should be linked: @link(TMyClass.MyMethod).
This should be linked: @link(MyOtherGlobalProcedure). }
procedure MyGlobalProcedure;
procedure MyOtherGlobalProcedure;
implementation
end.
pasdoc/tests/testcases/error_macros_recursive.pas 0000600 0001750 0001750 00000000512 13237143042 023111 0 ustar michalis michalis { @abstract(This is a test what will happen when you try to recursively
expand a macro.)
pasdoc should exit with appropriate error message. Not something
ugly, like out of memory (or hanging your system and eating
all mem it can).
}
unit error_macros_recursive;
interface
{$define FOO:=FOO}
FOO
implementation
end. pasdoc/tests/testcases/ok_links.pas 0000600 0001750 0001750 00000002300 13237143042 020133 0 ustar michalis michalis { @abstract(Test various things with links.)
Link to proc inside this unit : @link(MyProc),
and a qualified link to the same thing : @link(ok_links.MyProc).
Link to proc inside other unit: @link(ok_links_2.MyOtherProc),
link to proc inside other unit that has the same name as proc in this unit:
@link(ok_links_2.MyProc).
Link to method in class in this unit:
@link(TSomeClass.MyMethod),
and a more qualified link to the same thing :
@link(ok_links.TSomeClass.MyMethod).
Link to method in class in second unit: @link(TSomeOtherClass.MyMethod),
link to method in class in second unit
that has the same name as class in this unit:
@link(ok_links_2.TSomeClass.MyMethod).
Link to this unit : @link(ok_links), to other unit : @link(ok_links_2).
}
unit ok_links;
interface
uses ok_links_2;
{ Link to self : @link(MyProc), and a second one: @link(ok_links.MyProc),
link to MyProc in other unit: @link(ok_links_2.MyProc). }
procedure MyProc;
type
TSomeClass = class
{ Two links to @code(MyOtherMethod) :
qualified @link(TSomeClass.MyOtherMethod),
not qualified @link(MyOtherMethod) }
procedure MyMethod;
procedure MyOtherMethod;
end;
implementation
end.
pasdoc/tests/testcases/ok_dot_unitname.pas 0000600 0001750 0001750 00000000134 13237143042 021504 0 ustar michalis michalis unit ok.dot.unitname;
interface
uses
dot.inside.unitname;
implementation
end. pasdoc/tests/testcases/error_line_number_3.pas 0000600 0001750 0001750 00000002042 13237143042 022257 0 ustar michalis michalis { Of course this unit is invalid, definition of InvalidConstant
is suddenly truncated. So pasdoc should raise an error.
But it's important on what line error is raisen.
A previous bug caused the line to be "error_line_number_3.pas(13)",
i.e. line number was not affected by dummy
"function gtk_check_menu_item_get_active(" lines. }
unit error_line_number_3;
interface
{$ifdef NOT_DEFINED}
function gtk_check_menu_item_get_active(
function gtk_check_menu_item_get_active(
function gtk_check_menu_item_get_active(
function gtk_check_menu_item_get_active(
function gtk_check_menu_item_get_active(
function gtk_check_menu_item_get_active(
function gtk_check_menu_item_get_active(
function gtk_check_menu_item_get_active(
function gtk_check_menu_item_get_active(
function gtk_check_menu_item_get_active(
function gtk_check_menu_item_get_active(
function gtk_check_menu_item_get_active(
function gtk_check_menu_item_get_active(
function gtk_check_menu_item_get_active(
function gtk_check_menu_item_get_active(
{$endif}
const
InvalidConstant:
end. pasdoc/tests/testcases/ok_item_set_number.pas 0000600 0001750 0001750 00000000742 13237143042 022204 0 ustar michalis michalis { @abstract(Test of of @@itemSetNumber tag.)
@orderedList(
@item Foo
@item Foo
@item Foo
@item Foo
@item Foo
@itemSetNumber 144
@item Foo
@item Foo
@item Foo
@item(
@orderedList(
@item Bar
@item Bar
@item Bar
@itemSetNumber 20
@item Bar
@item Bar
@item Bar
)
)
@item Foo
@item Foo
@item Foo
)
}
unit ok_item_set_number;
interface
implementation
end. pasdoc/tests/testcases/ok_table.pas 0000600 0001750 0001750 00000003403 13237143042 020107 0 ustar michalis michalis (* @abstract(Test of @@table-related features.)
Example from @@table doc page in wiki:
@table(
@rowHead( @cell(Value1) @cell(Value2) @cell(Result) )
@row( @cell(@false) @cell(@false) @cell(@false) )
@row( @cell(@false) @cell(@true) @cell(@true) )
@row( @cell(@true) @cell(@false) @cell(@true) )
@row( @cell(@true) @cell(@true) @cell(@false) )
)
Small tables tests:
@table( @row( @cell(One-cell table is OK) ) )
@table( @rowHead( @cell(One-cell head table is OK) ) )
@table( @rowHead( @cell(A) @cell( @bold(Foo) ) ) )
Test that everything within @@cell tag is OK.
Actually, test below is a stripped down (to be accepted
by LaTeX) version of a more advanced test in
ok_table_nonlatex.pas file.
@table(
@rowHead(
@cell(Dashes: ---, --, -, @--)
@cell(URLs: http://pasdoc.sourceforge.net/)
)
@row( @cell(C) @cell(D) )
)
Now nested table and other nicies are within a normal row,
instead of heading row.
@table(
@rowHead( @cell(C) @cell(D) )
@row(
@cell(Within a cell many things are are accepted)
@cell(including paragraphs:
This is new paragraph.)
)
@row(
@cell(Dashes: ---, --, -, @--.)
@cell(URLs: http://pasdoc.sourceforge.net/)
)
@row(
@cell(And, last but not least, nested table:
@table(
@rowHead( @cell(1) @cell(2) )
@rowHead( @cell(3) @cell(4) )
))
@cell(B)
)
)
Some 2-row table tests:
@table(
@rowHead( @cell(A) @cell(B) )
@rowHead( @cell(C) @cell(D) )
)
@table(
@row( @cell(A) @cell(B) )
@row( @cell(C) @cell(D) )
)
@table(
@row( @cell(A) @cell(B) )
@rowHead( @cell(C) @cell(D) )
)
*)
unit ok_table;
interface
implementation
end.
pasdoc/tests/testcases/ok_different_image_same_filename_dir2/ 0000700 0001750 0001750 00000000000 13237143042 025206 5 ustar michalis michalis pasdoc/tests/testcases/ok_different_image_same_filename_dir2/test_description.txt 0000600 0001750 0001750 00000000051 13034465544 031340 0 ustar michalis michalis This is description called @bold(dir_2).
pasdoc/tests/testcases/ok_different_image_same_filename_dir2/image.png 0000600 0001750 0001750 00000000517 13034465544 027014 0 ustar michalis michalis PNG
IHDR 2 # PLTE ٟ pHYs tIME4UU tEXtComment Created with The GIMPd%n IDAT8c 0ʌ! CxeU"d>ȣ"xQddcy47>=>1 This is a closing paren @) and open @( and "at" char @@ inside HTML.)
@longCode(#
// This is a closing paren @) and open @( and "at" char @@ inside longcode.
#)
*)
unit ok_at_character_in_verbatim;
interface
implementation
end. pasdoc/tests/testcases/ok_longcode_indentation.pas 0000600 0001750 0001750 00000001566 13237143042 023216 0 ustar michalis michalis unit ok_longcode_indentation;
interface
{ Should cut nothing:
@longCode(#one
two
three
#) }
procedure Foo1;
{ Should cut 4 spaces:
@longCode(#
one
two
three
#) }
procedure Foo2;
{ Should cut 2 spaces:
@longCode(#
one
two
three
#) }
procedure Foo3;
{ Should cut nothing (there's a tab here):
@longCode(#
one
two
three
#) }
procedure Foo4;
{ Should cut tab + 2 spaces:
@longCode(#
one
two
three
#) }
procedure Foo5;
{ Should cut 4 spaces (there's trailing whitespace in 1st lines here, that should be ignored):
@longCode(#
one
#) }
procedure Foo6;
{ Should cut 4 spaces (empty line doesn't shorten IndentationPrefix):
@longCode(#
if something then
begin
// empty line below
end;
#) }
procedure Foo7;
implementation pasdoc/tests/testcases/ok_program.pas 0000600 0001750 0001750 00000000143 13237143042 020465 0 ustar michalis michalis program ok_program;
uses foo, bar;
procedure my_proc;
var my_var: Integer;
begin
end;
begin
end. pasdoc/tests/testcases/ok_library.dpr 0000600 0001750 0001750 00000001376 13237143042 020475 0 ustar michalis michalis library LibraryTest;
{ Important note about DLL memory management: ShareMem must be the
first unit in your library's USES clause AND your project's (select
Project-View Source) USES clause if your DLL exports any procedures or
functions that pass strings as parameters or function results. This
applies to all strings passed to and from your DLL--even those that
are nested in records and classes. ShareMem is the interface unit to
the BORLNDMM.DLL shared memory manager, which must be deployed along
with your DLL. To avoid using BORLNDMM.DLL, pass string information
using PChar or ShortString parameters. }
uses
SysUtils,
Classes,
WeirdRecord in 'WeirdRecord.pas',
StrictVisibilities in 'StrictVisibilities.pas';
{$R *.res}
begin
end.
pasdoc/tests/testcases/ok_property_decl.pas 0000600 0001750 0001750 00000000332 13237143042 021671 0 ustar michalis michalis unit ok_property_decl;
interface
type
TMyClass = class
private
function GetMyProperty(S: string): Integer;
public
property MyProperty[S: string]: Integer read GetMyProperty;
end;
implementation
end. pasdoc/tests/testcases/test_subdir/ 0000700 0001750 0001750 00000000000 13237143042 020147 5 ustar michalis michalis pasdoc/tests/testcases/test_subdir/ok_relative_include_conf.inc 0000600 0001750 0001750 00000000016 13237143042 025655 0 ustar michalis michalis {$mode objfpc} pasdoc/tests/testcases/test_subdir/another_test_subdir/ 0000700 0001750 0001750 00000000000 13237143042 024216 5 ustar michalis michalis pasdoc/tests/testcases/test_subdir/another_test_subdir/ok_relative_include_2.pas 0000600 0001750 0001750 00000001006 13237143042 031152 0 ustar michalis michalis { This is another test unit that includes
ok_relative_include_conf.inc file two times.
This time note that the ok_relative_include_conf.inc file is already
in the parent directory of this unit file, so once again
@bold(no matter what is current dir
when running pasdoc) --- you should not need to add any -I
option to pasdoc to find ok_relative_include_conf.inc. }
unit ok_relative_include_2;
{$I '../ok_relative_include_conf.inc'}
{$I ../ok_relative_include_conf.inc}
interface
implementation
end.
pasdoc/tests/testcases/test_subdir/ok_relative_include_1.pas 0000600 0001750 0001750 00000000722 13237143042 025106 0 ustar michalis michalis { This is a test unit that includes ok_relative_include_conf.inc file two times.
Note that the ok_relative_include_conf.inc file is in the same
directory as this unit, so @bold(no matter what is current dir
when running pasdoc) --- you should not need to add any -I
option to pasdoc to find ok_relative_include_conf.inc. }
unit ok_relative_include_1;
{$I 'ok_relative_include_conf.inc'}
{$I ok_relative_include_conf.inc}
interface
implementation
end.
pasdoc/tests/testcases/ok_generic.pas 0000600 0001750 0001750 00000004016 13237143042 020435 0 ustar michalis michalis { Tests of generics, both FPC and Delphi style. }
unit ok_generic;
interface
{ Units to include for Generics }
uses Generics.Collections, FGL;
type
{ FPC generics tests ------------------------------------------------------- }
generic TMyList = class(TFPSList)
private
type PT = ^T;
public
function Blah: PT;
end;
{ }
TGeometryAttrib = class
Name: string;
AType: TGeometryAttribType;
Offset: Integer;
end;
TGeometryAttribsList2 = specialize TMyList;
{ You can also specialize and make a descendant at the same time. }
TGeometryAttribsList = class(specialize TMyList)
public
function Find(const Name: string): TGeometryAttrib;
end;
{ Delphi generics tests ---------------------------------------------------- }
{ A simple Test-Object }
TMyObject = class(TObject);
TMyGenericList = class(TObjectList)
public
// To Something here
end;
TMyNewGeneric = class
private
type PT = ^T1;
public
function Blah: PT;
end;
{ Sample for a generic with more than one type. TPair is a Key-Value-Relation }
TAnotherGenericType = class(TDictionary);
{ All standard Generics: }
TArray = class end;
TEnumerator = class abstract end;
TEnumerable = class abstract end;
TList = class(TEnumerable) end;
TQueue = class(TEnumerable) end;
TStack = class(TEnumerable) end;
TPair = record end;
TDictionary = class(TEnumerable>) end;
TObjectList = class(TList) end;
TObjectQueue = class(TQueue) end;
TObjectStack = class(TStack) end;
TObjectDictionary = class(TDictionary) end;
implementation
uses Classes;
procedure SampleProc();
var
TestList: TMyGenericList;
TestList2: TObjectList; // also allowed for vars
begin
TestList:=TMyGenericList.Create();
TestList2:=TObjectList.Create();
TestList.Free;
TestList2.Free;
end;
end.
pasdoc/tests/testcases/ok_attributes.pas 0000600 0001750 0001750 00000001137 13237143042 021210 0 ustar michalis michalis { Simple Delphi attributes test, from http://www.malcolmgroves.com/blog/?p=530 }
unit ok_attributes;
interface
type
TPerson = class
private
FName: String;
FAge: Integer;
public
[NonEmptyString('Must provide a Name')]
property Name : String read FName write FName;
[MinimumInteger(18, 'Must be at least 18 years old')]
[MaximumInteger(65, 'Must be no older than 65 years')]
property Age : Integer read FAge write FAge;
end;
// Test that GUIDs are handled gracefully
IUIContainer = interface
['{0F0BA87D-95C3-4520-B9F9-CDF30015FDB3}']
end;
implementation
end.
pasdoc/tests/testcases/ok_paragraph_in_single_line_comment.pas 0000600 0001750 0001750 00000000677 13237143042 025557 0 ustar michalis michalis // This is the 1st paragraph.
//
// This is the 2nd paragraph.
//
// This is the 3rd paragraph.
//
// pasdoc should create paragraphs when glueing single-line comments to
// a description, but it doesn't for now. Update: now it does.
unit ok_paragraph_in_single_line_comment;
interface
{ This is the 1st paragraph.
This is the 2nd paragraph.
This is the 3rd paragraph.
Here paragraphs are correct. }
procedure Foo;
implementation
end. pasdoc/tests/testcases/ok_longcode_dash.pas 0000600 0001750 0001750 00000000310 13237143042 021603 0 ustar michalis michalis {
See thread "Patch for Latex Longcode" on pasdoc-main mailing list on
2005-06-09.
@longcode(#
P2DRealPoint = ^T2DRealPoint;
#)
}
unit ok_longcode_dash;
interface
implementation
end. pasdoc/tests/testcases/ok_procedural_const.pas 0000600 0001750 0001750 00000000276 13237143042 022373 0 ustar michalis michalis unit ok_procedural_const.pas;
interface
const
FnTest1 = function(const Foo: Integer): Integer; cdecl = nil;
FnTest2 = procedure(const Foo: Integer); stdcall = nil;
implementation
end. pasdoc/tests/testcases/ok_vorbisfile.pas 0000600 0001750 0001750 00000006124 13237143042 021167 0 ustar michalis michalis { This is a minimized version of vorbisfile.pas from
http://vrmlengine.sourceforge.net/, just to test pasdoc2 macros/include
file handling. }
{ API of vorbisfile library. Usually libvorbisfile.so under Unixes
or vorbisfile.dll under Windows. This is just a quick translation
of /usr/include/vorbis/vorbisfile.h header. }
unit ok_vorbisfile;
{$packrecords C}
{$I ok_vorbisfile_conf.inc}
interface
uses CTypes, VorbisCodec, KambiOgg;
const
NOTOPEN = 0;
PARTOPEN = 1;
OPENED = 2;
STREAMSET = 3;
INITSET = 4;
type
TSizeT = LongWord;
TVorbisFileReadFunc = function (ptr: Pointer; Size: TSizeT; nmemb: TSizeT; DataSource: Pointer): TSizeT; libvorbisfile_decl;
TVorbisFileSeekFunc = function (DataSource: Pointer; offset: Int64; whence: CInt): CInt; libvorbisfile_decl;
TVorbisFileCloseFunc = function (DataSource: Pointer): CInt; libvorbisfile_decl;
TVorbisFileTellFunc = function (DataSource: Pointer): CLong; libvorbisfile_decl;
Tov_callbacks = record
read_func: TVorbisFileReadFunc;
seek_func: TVorbisFileSeekFunc;
close_func: TVorbisFileCloseFunc;
tell_func: TVorbisFileTellFunc;
end;
Pov_callbacks = ^Tov_callbacks;
TOggVorbis_File = record
datasource: Pointer; {* Pointer to a FILE *, etc. *}
seekable: Cint;
offset: Int64;
_end: Int64;
oy: Togg_sync_state;
links: Cint;
offsets: PInt64;
dataoffsets: PInt64;
serialnos: PCLong;
pcmlengths: PInt64; {* overloaded to maintain binary
compatability; x2 size, stores both
beginning and end values *}
vi: Pvorbis_info;
vc: Pvorbis_comment;
{* Decoding working state local storage *}
pcm_offset: Int64;
ready_state: CInt;
current_serialno: Clong;
current_link: CInt;
bittrack: double;
samptrack: double;
os: Togg_stream_state; {* take physical pages, weld into a logical
stream of packets *}
vd: Tvorbis_dsp_state; {* central working state for the packet->PCM decoder *}
vb: Tvorbis_block; {* local working space for packet->PCM decode *}
callbacks: Tov_callbacks;
end;
POggVorbis_File = ^TOggVorbis_File;
var
ov_clear: function (Vf: POggVorbis_File): CInt; libvorbisfile_decl;
VorbisFileInited: boolean;
implementation
uses SysUtils, KambiUtils, KambiDynLib;
var
VorbisFileLibrary: TDynLib;
initialization
VorbisFileLibrary :=
{$ifdef UNIX}
{$ifdef DARWIN}
TDynLib.Load('libvorbisfile.3.dylib', false);
if VorbisFileLibrary = nil then
VorbisFileLibrary := TDynLib.Load('libvorbisfile.dylib', false);
{$else}
TDynLib.Load('libvorbisfile.so.3', false);
if VorbisFileLibrary = nil then
VorbisFileLibrary := TDynLib.Load('libvorbisfile.so', false);
{$endif}
{$endif}
{$ifdef MSWINDOWS}
TDynLib.Load('vorbisfile.dll', false);
{$endif}
VorbisFileInited := VorbisFileLibrary <> nil;
if VorbisFileInited then
begin
Pointer(ov_clear) := VorbisFileLibrary.Symbol('ov_clear');
end;
finalization
VorbisFileInited := false;
FreeAndNil(VorbisFileLibrary);
end. pasdoc/tests/testcases/ok_lists.pas 0000600 0001750 0001750 00000003503 13237143042 020157 0 ustar michalis michalis { @abstract(Test of lists tags.)
Normal lists:
@orderedList( @item(One) @item(Two) @item(Three) )
@unorderedList( @item(One) @item(Two) @item(Three) )
Empty list is accceptable:
@orderedList( )
@unorderedList( )
Whitespace inside lists is acceptable (and empty line
that is not inside any @@item is @italic(not) a paragraph):
@orderedList(
@item One
@item Two
@item(
Other tags inside the items are allowed,
e.g. @link(ok_lists link to self), @true,
@longcode(# begin X := Y; end; #),
@bold(something bold), URLs: http://pasdoc.sf.net/, paragraphs:
2nd paragraph, dashes: em dash ---, en dash --, short one -,
two consecutive short dashes @--.
)
)
Nested lists are also freely allowed:
@orderedList(
@item(
1st nested unordered list:
@unorderedList( @item(One) @item(Two) @item(Three) )
)
@item(
2nd nested unordered list:
@unorderedList( @item(One) @item(Two) @item(Three) )
)
@item(
And a couple of single-item ordered lists nested:
@orderedList( @item( @orderedList( @item( ))))
(Source code of this example begins to look like LISP :)
)
)
Definition lists tests:
@definitionList(
@item 1st item
@item 2nd item
)
@definitionList(
@itemLabel 1st item label
@item 1st item
@itemLabel 2nd item label
@item 2nd item
)
@definitionList(
@itemLabel 1st item label
@itemLabel 2nd item label
)
Item spacing tests:
@definitionList(
@itemLabel 1st item label
@item 1st item
@itemLabel 2nd item label
@item 2nd item
@itemSpacing(Paragraph)
@itemSpacing(Compact)
)
@orderedList(
@itemSpacing Compact
@item One
@item Two
@item Three
)
}
unit ok_lists;
interface
implementation
end. pasdoc/tests/testcases/ok_link_explicite_name.pas 0000600 0001750 0001750 00000000472 13237143042 023026 0 ustar michalis michalis unit ok_link_explicite_name;
interface
type
{ I'm a testing class, oh !
And @link(MyMethod don't forget to look at my method !) }
TTestingClass = class
procedure MyMethod;
end;
{ Some testing proc.
@link TTestingClass.MyMethod Have you seen my method ? }
procedure MyProc;
implementation
end. pasdoc/tests/testcases/ok_table_of_contents.txt 0000600 0001750 0001750 00000000770 13034465544 022561 0 ustar michalis michalis Full table of contents:
@tableOfContents
Table of contents to level 0 (should be empty):
@tableOfContents 0
Table of contents to level 1 (only top-level sections):
@tableOfContents 1
Table of contents to level 2:
@tableOfContents 2
Table of contents to level 3 (should be equivalent to full toc):
@tableOfContents 3
@section(1 Sec1 Section 1)
@section(1 Sec2 Section 2)
@section(2 Sec21 Section 2.1)
@section(2 Sec22 Section 2.2)
@section(3 Sec221 Section 2.2.1)
@section(1 Sec3 Section 3) pasdoc/tests/testcases/warning_back_comment_over_uses_clause.pas 0000600 0001750 0001750 00000000225 13237143042 026123 0 ustar michalis michalis unit warning_back_comment_over_uses_clause;
interface
uses Unit2, Unit3; {< This comment shouldn't be assigned to anything. }
implementation
end. pasdoc/tests/testcases/ok_class_function.pas 0000600 0001750 0001750 00000001025 13237143042 022030 0 ustar michalis michalis // Test for handling class functions in PasDoc
unit ok_class_function;
interface
type
// @abstract(This class is designed to see if PasDoc can
// parse class functions correctly.)
TDummy = class(TObject)
public
// Test To see if PasDoc can handle this.
Class Function MyFunction: integer;
// Test To see if PasDoc can handle this.
class procedure MyProcedure;
end;
implementation
{ TDummy }
class function TDummy.MyFunction: integer;
begin
end;
class procedure TDummy.MyProcedure;
begin
end;
end.
pasdoc/tests/testcases/ok_include_1.txt 0000600 0001750 0001750 00000000120 13034465544 020721 0 ustar michalis michalis Blah blah blah.
This is file @code(ok_include_1.txt).
@include(ok_include_2.txt) pasdoc/tests/testcases/ok_vorbisfile_conf.inc 0000600 0001750 0001750 00000000143 13237143042 022155 0 ustar michalis michalis { Yes, under both Linux and Windows we want cdecl. Tested. }
{$define libvorbisfile_decl := cdecl}
pasdoc/tests/testcases/ok_table_nonlatex.pas 0000600 0001750 0001750 00000002515 13237143042 022022 0 ustar michalis michalis (*
@abstract(Test of @@table-related features that do not work in
LaTeX, only in HTML.)
Test that everything within @@cell tag is OK:
@table(
@rowHead(
@cell(
Anything within a cell is OK, including lists:
@orderedList(
@item One
@item Two
@item Three
), paragraphs:
This is new paragraph.
Dashes: ---, --, -, @--. URLs: http://pasdoc.sourceforge.net/
And, last but not least, nested table:
@table(
@rowHead( @cell(1) @cell(2) )
@rowHead( @cell(3) @cell(4) )
)
) @cell(B) )
@row( @cell(C) @cell(D) )
)
Now the same example table as before, but now nested table
and other nicies are within a normal row, instead of heading row.
@table(
@rowHead( @cell(C) @cell(D) )
@row(
@cell(
Anything within a cell is OK, including lists:
@orderedList(
@item One
@item Two
@item Three
), paragraphs:
This is new paragraph.
Dashes: ---, --, -, @--. URLs: http://pasdoc.sourceforge.net/
And, last but not least, nested table:
@table(
@rowHead( @cell(1) @cell(2) )
@rowHead( @cell(3) @cell(4) )
)
) @cell(B) )
)
*)
unit ok_table_nonlatex;
interface
implementation
end.
pasdoc/tests/testcases/ok_back_comment_private.pas 0000600 0001750 0001750 00000001011 13237143042 023165 0 ustar michalis michalis { Testcase for
[https://sourceforge.net/tracker/index.php?func=detail&aid=1596563&group_id=4213&atid=104213].
The comment "This should be ether omitted..." should not be included
anywhere (if private members are omitted, and this is the default).
}
unit ok_back_comment_private;
interface
const
ActionDescription = 'blah';
type
EPingError = class(Exception)
private
FErrorType: TPingErrorType;
//< This should be ether omitted or put for FErrorType: TPingErrorType;
end;
implementation
end. pasdoc/tests/testcases/ok_sorting.pas 0000600 0001750 0001750 00000001076 13237143042 020511 0 ustar michalis michalis { Test unit to test various @--sort settings. }
unit ok_sorting;
interface
uses ZZZ, AAA;
type
TMyClass = class
ZZZField: Integer;
AAAField: Integer;
procedure ZZZMethod;
procedure AAAMethod;
property ZZZProp;
property AAAProp;
end;
TMyRecord = record
ZZZField: Integer;
AAAField: Integer;
end;
ZZZClass = class end;
AAAClass = class end;
ZZZType = Integer;
AAAType = Integer;
const
ZZZConst = 1;
AAAConst = 2;
var
ZZZVar: Integer;
AAAVar: Integer;
procedure ZZZProc;
procedure AAAProc;
implementation
end. pasdoc/tests/testcases/ok_static_member.pas 0000600 0001750 0001750 00000000716 13237143042 021642 0 ustar michalis michalis unit StaticMember;
interface
type
TMyClass = class
// All methods are static unless they are virtual or dynamic.
// but @name is declared static. Even if 'static' did not
// appear after the declaration, @name would still be static.
// @name is also a Class procedure but that is a separate story.
Class Procedure StaticProcedure; static;
end;
implementation
{ TMyClass }
class procedure TMyClass.StaticProcedure;
begin
end;
end.
pasdoc/tests/testcases/ok_excluded_unit.pas 0000600 0001750 0001750 00000000353 13237143042 021655 0 ustar michalis michalis { @exclude
This is unit is not errorneous on itself.
However, pasdoc should refuse (with proper error message)
to generate documentation if only this unit is specified. }
unit error_excluded_unit;
interface
implementation
end. pasdoc/tests/testcases/ok_param_raises_returns_proctype.pas 0000600 0001750 0001750 00000000635 13237143042 025201 0 ustar michalis michalis unit ok_param_raises_returns_proctype;
interface
type
EFoo = class(Exception);
{ @param(A Description of param A)
@raises(EFoo Description when EFoo is raised) }
TMyProcedure = procedure(A: integer);
{ @param(A Description of param A)
@returns(@true or @false)
@raises(EFoo Description when EFoo is raised) }
TMyMethod = function(A: integer): boolean of object;
implementation
end. pasdoc/tests/testcases/ok_include_intro_include.txt 0000600 0001750 0001750 00000000142 13034465544 023423 0 ustar michalis michalis @section(1 Sec2 Second section in ok_include_intro_include.txt file)
Second section dummy text.
pasdoc/tests/testcases/todo/ 0000700 0001750 0001750 00000000000 13237143042 016565 5 ustar michalis michalis pasdoc/tests/testcases/todo/ok_record_in_record.pas 0000600 0001750 0001750 00000000775 13237143042 023300 0 ustar michalis michalis { Bug:
Parsing of this fails with
Warning[2]: Error EPasDoc: todo/ok_record_in_record.pas(8): Unexpected keyword end. parsing unit ok_record_in_record.pas, continuing...
Update 2005-05-28: now parsing is OK,
but type of field InsideRecord is still not correctly displayed
(there is just a word "record"). This is duplicated problem of test
ok_record_descr.pas.
}
unit ok_record_in_record;
interface
var
Foo: record
InsideRecord: record Bar: Integer; end;
end;
implementation
end. pasdoc/tests/testcases/todo/warning_no_params.pas 0000600 0001750 0001750 00000001136 13237143042 023001 0 ustar michalis michalis unit warning_no_params;
interface
{ Parens are missing here, generated docs will not be as expected.
PasDoc should warn about this.
@returns
something }
function Foo1(A: Integer): Integer;
{ Parens are missing here, generated docs will not be as expected.
PasDoc should warn about this.
@param
A means something }
function Foo2(A: Integer): Integer;
type
EFoo = class(Exception);
{ Parens are missing here, generated docs will not be as expected.
PasDoc should warn about this.
@raises
EFoo when something is bad }
function Foo3(A: Integer): Integer;
implementation
end. pasdoc/tests/testcases/todo/ok_record_descr.pas 0000600 0001750 0001750 00000000745 13237143042 022431 0 ustar michalis michalis { Bug:
Docs for this unit generate ok, but there is no documentation
what type TMyRecord fields have.
Update 2005-05-28: now type of field B is displayed OK,
but type of field A is still not correctly displayed
(there is just a word "record", but there should be full record
declaration, i.e. "record A: Integer; end;").
}
unit ok_record_descr;
interface
type
TMyRecord = record
InsideRecord: record A: Integer; end;
B: Integer;
end;
implementation
end. pasdoc/tests/testcases/todo/ok_accidental_exclude.pas 0000600 0001750 0001750 00000000413 13237143042 023563 0 ustar michalis michalis unit ok_accidental_exclude;
interface
{ @@exclude.
This test shows that simplistic testing for @@exclude tag in pasdoc
is not good -- since it excludes this item from documentation,
but it shouldn't. }
procedure I_Dont_Wanna_Be_Excluded;
implementation
end. pasdoc/tests/testcases/todo/ok_comment_for_hidden_field.pas 0000600 0001750 0001750 00000002043 13237143042 024752 0 ustar michalis michalis { @abstract(This is test that comments "stick" to the items, even if the items
are hidden because of @--visible-members value.)
In the example below, note that @italic(MyField description)
and @italic(MyField2 description) should @bold(not) be shown anywhere.
In other words, @italic(MyField description) should not be accidentaly
assigned to TBlah or TMyClass items. It should be assigned
to MyField item --- and so, because MyField is private and thus hidden,
@italic(MyField description) should also be hidden.
As of 2005-12-25: This test doesn't pass.
@italic(MyField2 description) is correctly just skipped,
but @italic(MyField description) is incorrectly assigned to TBlah.
}
unit ok_comment_for_hidden_field;
interface
type
TBlah = Integer;
TMyClass = class
private
MyField: Integer; //< MyField description.
public
MyNextField: Integer;
end;
TBlah2 = Integer;
TMyClass2 = class
private
// MyField2 description.
MyField2: Integer;
public
MyNextField2: Integer;
end;
implementation
pasdoc/tests/testcases/ok_longcode_float_hex.pas 0000600 0001750 0001750 00000000310 13237143042 022635 0 ustar michalis michalis { @abstract(Test of FormatFloat, FormatNumeric and FormatHex in TDocGenerator)
@longcode(# begin X := 1.1; Y := 1; Z := $FF; end; #)
}
unit ok_longcode_float_hex;
interface
implementation
end. pasdoc/tests/testcases/warning_link_in_seealso.pas 0000600 0001750 0001750 00000000357 13237143042 023217 0 ustar michalis michalis unit warning_link_in_seealso;
interface
const
{ @Seealso(@link(rsSetValueOfEnclosedNodes)))
This should cause a warning (but not a crash). }
rsSetValueOfEnclosedElements = 'Set values of enclosed elements';
implementation
end. pasdoc/tests/testcases/ok_image_picture.pdf 0000600 0001750 0001750 00000005311 13034465544 021634 0 ustar michalis michalis %PDF-1.3
%쏢
5 0 obj
<>
stream
x+T03T0 A(˥ d^U`jhgan77 , ̍
LA)DK>W Kendstream
endobj
6 0 obj
68
endobj
4 0 obj
<>
/Contents 5 0 R
>>
endobj
3 0 obj
<< /Type /Pages /Kids [
4 0 R
] /Count 1
>>
endobj
1 0 obj
<>
endobj
7 0 obj
<>endobj
9 0 obj
<>
endobj
10 0 obj
<>
endobj
8 0 obj
<>stream
Adobe d C
$, !$4.763.22:ASF:=N>22HbINVX]^]8EfmeZlS[]Y C**Y;2;YYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYY G 4"
} !1AQa"q2#BR$3br
%&'()*456789:CDEFGHIJSTUVWXYZcdefghijstuvwxyz
w !1AQaq"2B #3Rbr
$4%&'()*56789:CDEFGHIJSTUVWXYZcdefghijstuvwxyz ? |Wa
Al%dp=*)Eʬm]wyK9Li]b7
sWe73Ha?#K 7R/A}P^])քsYy$ǒ}1t9,UYT/nY \?h:M_w@; Jӵ6 Ӹ~] $ }+2M"C4Y{2y Z]ޯ2
+')s"zllD/u 3h4XbHWqxmm#i`/|1zYY\Kq5oTA%iW}̅P9\5%ݼrZof%y$7& w=V.Ҟ-c9k Ʒʋ$K&V륶ӭEFusI+D⿴I,n|3tg_7Ns I4l<5ywuTU2' ԛjw7\ȲD ;if̌@ 8(!]=5琑OK)3&1WW-ANە9MY[AL{hgVFdVoOHHP( 5uDS3ɧ؎Brc5r+A f;ӥr^j(m "l)ce}ozbK. *ն^_7}4,I#_x7#FHޢ((ڈӤ6z
߯r/\mvD^\@*|gj/N
}AXBMg'ͱ_W`
endstream
endobj
2 0 obj
<>endobj
xref
0 11
0000000000 65535 f
0000000383 00000 n
0000002211 00000 n
0000000324 00000 n
0000000171 00000 n
0000000015 00000 n
0000000153 00000 n
0000000431 00000 n
0000000531 00000 n
0000000472 00000 n
0000000501 00000 n
trailer
<< /Size 11 /Root 1 0 R /Info 2 0 R
/ID [(H\(!f ^ )(H\(!f ^ )]
>>
startxref
2418
%%EOF
pasdoc/tests/testcases/ok_if_directive.pas 0000600 0001750 0001750 00000003273 13237143042 021461 0 ustar michalis michalis { @abstract(PasDoc fails to parse this,
it seems that $if is not understood at all.)
Bug spotted by Michalis on 2005-12-04 when
trying `make htmldocs' on fpc compiler sources, in file globals.pas.
Update 2005-12-05: $if is sorta handled now, and so is $ifend.
This testcase is parsed now. There is still work remaining to be done
with regards to $if and $elseif, this is documented on
[https://github.com/pasdoc/pasdoc/wiki/ToDo].
}
unit ok_if_directive;
interface
const
{$if defined(CPUARM) and defined(FPUFPA)}
MathQNaN : tdoublearray = (0,0,252,255,0,0,0,0);
MathInf : tdoublearray = (0,0,240,127,0,0,0,0);
MathNegInf : tdoublearray = (0,0,240,255,0,0,0,0);
MathPi : tdoublearray = (251,33,9,64,24,45,68,84);
{$else}
{$ifdef FPC_LITTLE_ENDIAN}
MathQNaN : tdoublearray = (0,0,0,0,0,0,252,255);
MathInf : tdoublearray = (0,0,0,0,0,0,240,127);
MathNegInf : tdoublearray = (0,0,0,0,0,0,240,255);
MathPi : tdoublearray = (24,45,68,84,251,33,9,64);
MathPiExtended : textendedarray = (53,194,104,33,162,218,15,201,0,64);
{$else FPC_LITTLE_ENDIAN}
MathQNaN : tdoublearray = (255,252,0,0,0,0,0,0);
MathInf : tdoublearray = (127,240,0,0,0,0,0,0);
MathNegInf : tdoublearray = (255,240,0,0,0,0,0,0);
MathPi : tdoublearray = (64,9,33,251,84,68,45,24);
MathPiExtended : textendedarray = (64,0,201,15,218,162,33,104,194,53);
{$endif FPC_LITTLE_ENDIAN}
{$endif}
{$if defined(CPUARM) and defined(FPUFPA)}
Included = 1;
{$else}
NotIncluded = 1;
{$ifdef FPC_LITTLE_ENDIAN}
NotIncluded = 1;
{$else FPC_LITTLE_ENDIAN}
NotIncluded = 1;
{$endif FPC_LITTLE_ENDIAN}
{$ifend}
implementation
end. pasdoc/tests/testcases/ok_interface_implicit.pas 0000600 0001750 0001750 00000000525 13237143042 022654 0 ustar michalis michalis unit ok_interface_implicit;
interface
type
IMyInterface = interface
procedure PublicMethod;
end;
TMyRecord = record
PublicField: Integer;
end;
TMyPackedRecord = packed record
PublicField: Integer;
end;
TMyClass = class
ImplicitField: Integer;
public
PublicField: Integer;
end;
implementation
end. pasdoc/tests/testcases/ok_macros_off.pas 0000600 0001750 0001750 00000000605 13237143042 021137 0 ustar michalis michalis { @abstract(This is a test that macro support can be turned off
in pasdoc.)
With macro support turned on this unit would cause parsing error,
because it would have brain-damaged declaration like
@longcode(#
procedure interface interface(a: Integer);
#)
}
unit ok_macros_off;
interface
{$define FOO := interface interface}
procedure FOO(a: Integer);
implementation
end. pasdoc/tests/testcases/ok_enum_field_var.pas 0000600 0001750 0001750 00000000543 13237143042 022001 0 ustar michalis michalis unit ok_enum_field_var;
interface
type
TServerConnController = class
public
AutoConnectAction: (acNone,
acConnectOnDisconnect,
acLoginOnDisconnect,
acLoginOnConnect);
end;
var
ApplicationStatus: (apInitializing, apReady, apClosing, apDestroying);
implementation
end. pasdoc/tests/testcases/ok_unit_uses_filename.pas 0000600 0001750 0001750 00000000252 13237143042 022675 0 ustar michalis michalis unit ok_unit_uses_filename;
interface
uses
ok_auto_abstract in './ok_auto_abstract.pas',
Classes,
ok_back_comment in 'ok_back_comment.pas';
implementation
end.
pasdoc/tests/testcases/warning_table.pas 0000600 0001750 0001750 00000000525 13237143042 021145 0 ustar michalis michalis { @abstract(Test of @@table-related warnings.)
Various incorrect table tags nesting:
@table( @cell(Foo) )
@table( @row(Foo) )
@row( @cell(Foo) )
@cell( @row(Foo) )
Table with no rows is not allowed:
@table( )
Row with no cells is not allowed:
@table( @row( ) )
}
unit warning_table;
interface
implementation
end. pasdoc/tests/testcases/ok_packed_class_object.pas 0000600 0001750 0001750 00000000250 13237143042 022757 0 ustar michalis michalis unit ok_packed_class_object;
interface
type
TMyPackedClass = packed class
Blah: Integer;
end;
TMyPackedObject = packed object
end;
implementation
end.
pasdoc/tests/testcases/ok_enum_explicit_assign.pas 0000600 0001750 0001750 00000000240 13237143042 023225 0 ustar michalis michalis unit ok_enum_explicit_assign;
interface
type
TEnum1 = (e1One, e1Two = 12, e1Three, e1Four := 15);
TEnum2 = (e2One := 3, e1Two := 4);
implementation
end. pasdoc/tests/Makefile 0000600 0001750 0001750 00000000216 13237142276 015273 0 ustar michalis michalis .PHONY: clean
clean:
rm -Rf current_output/ \
correct_output/ \
scripts/check_cache_tmp/ \
scripts/upload_correct_tests_output_tmp/
pasdoc/old_docs/ 0000700 0001750 0001750 00000000000 13237143042 014246 5 ustar michalis michalis pasdoc/old_docs/pasdoc.css 0000600 0001750 0001750 00000010576 13237143042 016244 0 ustar michalis michalis
/* start css.sty */
.cmr-10x-x-109{}
.cmr-17{font-size:154%;}
.cmr-12{font-size:109%;}
.cmtt-10x-x-109{font-family: monospace;}
.cmti-10x-x-109{ font-style: italic;}
.cmsy-10x-x-109{}
.cmbx-10x-x-109{ font-weight: bold;}
.cmmi-10x-x-109{font-style: italic;}
p.noindent { text-indent: 0em }
p.nopar { text-indent: 0em; }
p.indent{ text-indent: 1.5em }
@media print {div.crosslinks {visibility:hidden;}}
a img { border-top: 0; border-left: 0; border-right: 0; }
center { margin-top:1em; margin-bottom:1em; }
td center { margin-top:0em; margin-bottom:0em; }
.Canvas { position:relative; }
img.math{vertical-align:middle;}
li p.indent { text-indent: 0em }
.obeylines-h,.obeylines-v {white-space: nowrap; }
div.obeylines-v p { margin-top:0; margin-bottom:0; }
.overline{ text-decoration:overline; }
.overline img{ border-top: 1px solid black; }
td.displaylines {text-align:center; white-space:nowrap;}
.centerline {text-align:center;}
.rightline {text-align:right;}
div.verbatim {font-family: monospace; white-space: nowrap; }
span.fbox {padding-left:3.0pt; padding-right:3.0pt; text-indent:0pt; border:solid black 0.4pt; }
table.minipage{width:100%;}
div.center, div.center div.center {text-align: center; margin-left:1em; margin-right:1em;}
div.center div {text-align: left;}
div.flushright, div.flushright div.flushright {text-align: right;}
div.flushright div {text-align: left;}
div.flushleft {text-align: left;}
.underline{ text-decoration:underline; }
.underline img{ border-bottom: 1px solid black; margin-bottom:1pt; }
.framebox-c, .framebox-l, .framebox-r { padding-left:3.0pt; padding-right:3.0pt; text-indent:0pt; border:solid black 0.4pt; }
.framebox-c {text-align:center;}
.framebox-l {text-align:left;}
.framebox-r {text-align:right;}
span.thank-mark{ vertical-align: super }
div.array {text-align:center;}
div.tabular, div.center div.tabular {text-align: center; margin-top:0.5em; margin-bottom:0.5em;}
table.tabular td p{margin-top:0em;}
div.td00{ margin-left:0pt; margin-right:0pt; }
div.td01{ margin-left:0pt; margin-right:5pt; }
div.td10{ margin-left:5pt; margin-right:0pt; }
div.td11{ margin-left:5pt; margin-right:5pt; }
td.td00{ padding-left:0pt; padding-right:0pt; }
td.td01{ padding-left:0pt; padding-right:5pt; }
td.td10{ padding-left:5pt; padding-right:0pt; }
td.td11{ padding-left:5pt; padding-right:5pt; }
.hline hr, .cline hr{ height : 1px; }
.tabbing-right {text-align:right;}
div.newtheorem { margin-bottom: 2em; margin-top: 2em;}
span.TEX {letter-spacing: -0.125em; }
span.TEX span.E{ position:relative;top:0.5ex;left:-0.0417em;}
a span.TEX span.E {text-decoration: none; }
span.LATEX span.A{ position:relative; top:-0.5ex; left:-0.4em; font-size:85%;}
span.LATEX span.TEX{ position:relative; left: -0.4em; }
.marginpar {width:20%; float:right; text-align:left; margin-left:auto; margin-top:0.5em; font-size:85%; text-decoration:underline;}
.marginpar p{margin-top:0.4em; margin-bottom:0.4em;}
div.float img, div.float .caption {text-align:center;}
div.figure img, div.figure .caption {text-align:center;}
.equation td{text-align:center; }
td.equation { margin-top:1em; margin-bottom:1em; }
td.eqnarray4 { width:5%; white-space: normal; }
td.eqnarray2 { width:5%; }
table.eqnarray-star, table.eqnarray {width:100%;}
div.eqnarray{text-align:center;}
div.pmatrix {text-align:center;}
span.pmatrix img{vertical-align:middle;}
div.pmatrix {text-align:center;}
img.cdots{vertical-align:middle;}
.partToc a, .partToc, .likepartToc a, .likepartToc {line-height: 200%; font-weight:bold; font-size:110%;}
.caption td.id{font-weight: bold; white-space: nowrap; }
table.caption {text-align:center;}
h1.partHead{text-align: center}
p.bibitem { text-indent: -2em; margin-left: 2em; margin-top:0.6em; margin-bottom:0.6em; }
p.bibitem-p { text-indent: 0em; margin-left: 2em; margin-top:0.6em; margin-bottom:0.6em; }
.paragraphHead, .likeparagraphHead { margin-top:2em; font-weight: bold;}
.subparagraphHead, .likesubparagraphHead { font-weight: bold;}
.quote {margin-bottom:0.25em; margin-top:0.25em; margin-left:1em; }
.verse{white-space:nowrap; margin-left:2em}
div.maketitle {text-align:center;}
h2.titleHead{text-align:center;}
div.maketitle{ margin-bottom: 2em; }
div.author, div.date {text-align:center;}
div.thanks{text-align:left; margin-left:10%; font-size:80%; font-style:italic; }
div.author{white-space: nowrap;}
.quotation {margin-bottom:0.25em; margin-top:0.25em; margin-left:1em; }
.abstract p {margin-left:5%; margin-right:5%;}
/* end css.sty */
pasdoc/old_docs/README.txt 0000600 0001750 0001750 00000000130 13034465544 015751 0 ustar michalis michalis Latest documentation of pasdoc is available online
on [http://pasdoc.sourceforge.net/].
pasdoc/old_docs/pasdoc.html 0000600 0001750 0001750 00000174354 13034465544 016436 0 ustar michalis michalis
Manual for pasdoc 0.8
Pasdoc creates documentation for Pascal unit files.
Descriptions for variables, constants, types (called ’items’ from now
on) are taken from comments stored in the interface sections of unit
source code files, each comment must be placed directly before the item’s
declaration.
This way, you as a programmer can easily generate reference manuals of your
libraries without having to deal with the details of document formats like HTML
or LATEX.
Moreover, you can edit the source code and its descriptions in one place, no
need to add or modify explanations in other files. The rest is done automatically,
you should write a script / batch file that does the actual call to pasdoc...
Download the latest version from
http://pasdoc.sourceforge.net.
For an example of source code that can be used with pasdoc, try the pasdoc
sources themselves - type pasdoc[.exe] --format html *.pas to generate
HTML documentation.
You can compile pasdoc with Free Pascal (version 1.0 or higher), as well as
with Delphi and Kylix.
2 Directives
As you may know, Pascal allows for directives in the source code. These are
comments that contain commands for the compiler introduced by the dollar
sign.
To distinguish different compilers, libraries or development stages, conditionaldirectives make it possible to make the compiler ignore part of the file. An
example:
The ifdef part checks if a conditional directive called WIN32 is currently
defined (that would be the case for Delphi or FPC/Win32). If this is true, all
code until else or endif are compiled, everything between else and endif is
ignored. The contrary would apply if the directive is not defined, e.g. under
FPC/DOS or Borland Pascal. These statements can also be nested. Using define
and undef, a programmer can add and delete directives, in the above example
DEBUG and OPTIMIZE.
As pasdoc loads Pascal files in a similar way a compiler does, it must
be able to regard conditional directives. All define and undef parts are
evaluated by pasdoc, modifying an internal list of directives as source code is
parsed.
Different from a real compiler, pasdoc starts with an empty list of conditional
directives. To get back to the above example, if you want to write documentation
for the WIN32 code part, you must explicitly tell pasdoc that you want this
directive defined.
You can do so using the Specify directive or Add directives from file switch
(see sections 5.5.6 and 5.5.8).
Next to those directives already presented, pasdoc also supports include
files:
type TInteger = Integer;
{$I numbers.inc}
const MAX_FILES = 12;
In the above code, pasdoc would parse TInteger, get the include directive
and start parsing the include file numbers.inc. This file could contain other
directives, types or whatever. It is treated as it would be treated by any Pascal
compiler.
Pascal compilers also know switch directives. These are boolean options,
either on or off. They can be checked similar to conditional directives with the
$ifopt directive. Pasdoc does not yet fully support these, but at least does not
give up when it encounters one.
3 Adding descriptions
You can provide documentation for
types (including enumerations),
variables,
constants,
classes, interfances, objects,
procedures, functions and
units.
Providing a description for the different items is fairly easy. You simply need
to provide a comment containing the description before the name of the item
itself.
For units, the comment declaration must be done before the unit keyword.
Example:
type
{ This record type stores all information on a customer, including
name, age and gender. }
TCustomer = record
Name: String;
Age: Byte;
Gender: Boolean;
end;
{ Initializes a TCustomer record with the given parameters. }
procedure InitCustomer(Name: String; Age: Byte;
Gender: Boolean; var Customer: TCustomer);
It is possible to specify that items will only be documented when
certain comment markers are present at the start of the comment. Please
refer to 5.3 for further information. Furthermore, undocumented items
may or may not appear in the final document, depending on the output
format.
An interesting feature of pasdoc is its ability to link items from within
comments. If you are currently writing about an array of integers TIntArray
you’ve declared as a type, you might mention that the number of values it can
store is specified in the constant MAX_INTS. You’ve probably already
documented this constant when you declared it earlier in the same or another
unit. Now, if you write @link(MAX_INTS) instead of simply MAX_INTS,
pasdoc knows that you are referring to another item it has found or will
find in the list of units you gave to it. After all input files have been
parsed, pasdoc will start substituting all occurrences of @link(something)
with ”real” links. Depending on the type of output, these links could be
hyperlinks (in HTML) or page references (in LATEX). If the current output
format is HTML, the description of TIntArray would contain a link to
MAX_INTS. Viewing TIntArray’s description in your favourite web browser
you’d now be able to click on MAX_INTS and the browser would jump
to the definition of MAX_INTS, where you’d find more information on
it.
If pasdoc cannot resolve a link (for whatever reasons), it will issue a warning
to standard output and will write the content of @link() to the documentation
file, not as a link, but in a special font.
4 Formatting your comments
All comments recognize special directives that are used for different purposes.
Each of these special directives starts with the at character @, followed by and
identifier and optinally followed by text between parentheses.
As an example, lets take the well-known DOS unit. Its top part could look like
this:
{
@abstract(provides access to file and directory operations)
@author(John Doe <doe@john-doe.com>)
@created(July 12, 1997)
@lastmod(June 20, 1999)
The DOS unit provides functionality to get information on files and
directories and to modify some of this information.
This includes disk space (e.g. @link(DiskFree)), access rights, file
and directory lists, changing the current directory, deleting files
and directories and creating directories.
Some of the functions are not available on all operating systems.
}
unit DOS;
Pasdoc would read this comment and store it with the unit information. After
all Pascal source code files you gave to pasdoc have been read, pasdoc will try to
process all tags, i.e., all words introduced by a @ character.
If you want to use the character @ itself, you must write it twice so that
pasdoc knows you don’t want to specify a tag.
Note in the example above that the character does not need this special
treatment within the parentheses, as shown in the author tag at the example of
the email address.
Following is a list of all tags that you may use in pasdoc. A tag like @link
must always be followed by an opening and then a closing parenthesis, even if
you add nothing between them.
The following tags are supported:
@@
represents the @ character
@abstract
This is an abstract of the description (nowadays called
”management summary”)
@author
Treat the argument as an author’s name and email address
@classname
PasDoc inserts the class name here.
@code
Treat argument as code example
@created
Creation date of item
@cvs
The argument is related to source versioning with e.g. cvs
@exclude
The current item is to be excluded from documentation
@false
PasDoc inserts the specially formatted text ’false’ here.
@html
Inserts html code in the output
@inherited
PasDoc inserts the name of the ancestor class here.
@lastmod
last modified date of item
@link
The argument is the name of another entity, PasDoc will add a link
to it here.
@longcode
Format the text and output it in fixed width font, with correct
formatting.
@name
PasDoc inserts the name of the item (class, object, function,
variable...) here
@nil
PasDoc inserts the specially formatted text ’nil’ here.
@param
Treat first argument as parameter name and all following
arguments as the description
@raises
Treat first argument as exception name and all following arguments
as the description
@return, @returns
Description of a function’s return value
@true
PasDoc inserts the specially formatted text ’true’ here.
4.1 @
Represents the @ character, for example if you want to use one of the tags
literally
4.2 abstract
For some item types like classes or units you may write very large descriptions to
give an adequate introduction. However, these large texts are not appropriate in
an overview list. Use the abstract tag to give a short explanation of what an item
is about. One row of text is a good rule of thumb. Of course, there should only be
one abstract tag per description.
The abstract text will appear in the overview section of the documentation (if
the document format supports this overview section), and will also appear as the
first paragraph of the item full documentation.
4.3 author
For each author who participated in writing an item, one author tag should be
added. The format of the author tag should conform to the following specification
: @author(Name <URI>)
Author tags will only result in documentation output for classes, interfaces,
objects and units.
Example:
@author(Johannes Berg <email@address.here>)
4.4 classname, inherited, name
PasDoc uses the tags @inherited, @classname and @name as placeholders for the
names of the ancestor class, current class and name of the current item
respectively.
Example:
{ @name is a method of @classname which overrides the method of
@inherited to do something completely different...}
4.5 code
PasDoc uses the tag @code to mark example code which is preformatted and
should not be changed in the output. It will usually appear in a teletype font in
the final documentation.
Example:
{: how to declare a variable.
Example:
@code(
var
SomeVariable: SomeType;)
}
4.6 created
This tag should contain the date the item was created. At most one created tag
should be in a description. Created tags will only result in documentation output
for classes, interfaces, objects and units. There is no special format that must be
followed.
4.7 cvs
This tag is used to extract the last modification date and authors of the item.
The parameter of this tag should conform to the Author : ccodere or
Date : 2004/04/2002 : 01 : 52 string of cvs or rcs.
@cvs($Date$)
4.8 exclude
If an exclude tag is found in a description, the item will not appear in the
documentation. As a logical consequence, no information except the exclude tag
itself should be written to the description. Whenever high-level items like units or
classes are excluded from the documentation process, all items contained in them
will not appear as well, e.g. constants or functions in an excluded unit or
methods and fields in an excluded class.
The following example will produce no documentation, as the entire unit will
be excluded from the documentation process.
Example:
{@exclude }
unit myunit;
interface
procedure hello;
implementation
procedure hello;
begin
WriteLn('Hello');
end;
end.
4.9 false
PasDoc inserts the specially formatted text ’false’ here at the location of the tag.
This tag does not have any parameters.
4.10 html
Pasdoc directly outputs the text that is between parentheses, without any
conversion for the html output format. For other formats, the text is converted to
standard text.
There is no syntax checking on the validity of the HTML syntax.
If there are no parentheses, @HTML is directly written to the output
documentation.
4.11 lastmod
This tag should contain the date the item was last modified. At most one created
tag should be in a description. Lastmod tags will only result in documentation
output for classes, interfaces, objects and units. There is no special format that
must be followed.
4.12 link
Use this tag to make your documentation more convenient to the reader.
Whenever you mention another item in the description of an item, enclose the
name of the mentioned item in a link tag, e.g.
@link(GetName).
This will result in a hyperlink in HTML and a page reference in LATEX.
4.13 longcode
Use this tag to output code, and pre-formatted text. The output text will closely
ressemble the text typed, and will be represented in a fixed width font. In
the case of pascal code typed within this tag, it will be pretty-printed
first.
To be able to put special characters in this tag, the tag should be followed by
a # and finished with a # before the closing parentheses.
Example:
@longCode(#
procedure TForm1.FormCreate(Sender: TObject);
var
i: integer;
begin
// Note that your comments are formatted.
{$H+} // You can even include compiler directives.
// reserved words are formatted in bold.
for i := 1 to 10 do
begin
It is OK to include pseudo-code like this line.
// It will be formatted as if it were meaningful pascal code.
end;
end;
#)
4.14 nil
PasDoc inserts the specially formatted text ’nil’ here. This tag does not have any
parameters.
4.15 param
Treats first argument as parameter name and all following text as the description
of this parameter.
Example:
{ A small description
@param(Filepath The file to open)
}
constructor Init(FilePath : String);
4.16 raises
Treats the first argument as exception name and all following text as the
description for this exception.
Example:
{ A small description
@raises(EMyException Raises this exception)
}
constructor Init;
4.17 return, returns
Treat the text in the argument as the description of the returns value of this
function or method.
4.18 true
PasDoc inserts the specially formatted text ’true’ here at the location of the tag.
This tag does not have any parameters.
5 Switches
This is a list of all switches (program parameters) supported by pasdoc.
Enter pasdoc --help at the command line to get this list. Make sure you
keep the exact spelling of the switches, pasdoc is case-sensitive. Most
switches exist in two variations, a short one with a single dash and a
longer one with two dashes. You can use either switch to get the same
effect.
5.1 Documentation file format
After loading all Pascal source code files, pasdoc will write one or more
output files, depending on the output file format. Choose the output
format according to your needs - you might want to create several versions
for
5.1.1 HTML
-O html --format html
This switch makes pasdoc write HTML (Hypertext Markup Language)
output. HTML files are usually displayed in a web browser, which available on all
modern computer systems.
It is the default output file format. Several files will be created for this output
type, one for each unit, class, interface and object, additionally some overview
files with lists of all constants, types etc.
This is the preferred output for online viewing.
It is to note that even undocumented items will appear in the final output file
format.
5.1.2 htmlhelp
-O htmlhelp --format htmlhelp
This switch makes pasdoc write HTML (Hypertext Markup Language)
output. It also writes additional files that can be used to create Microsoft
htmlhelp files. Please consult the htmlhelp Microsoft SDK for more information.
5.1.3 LATEX
-O latex --format latex
This switch makes pasdoc write output that can be interpreted using
LATEX. This is the preferred output format for printing the documentation.
A single output file, either having the name specified with the -N switch, or
the default name docs.tex will be created.
With latex you will be able to create a dvi file that can then be converted to
a Postscript file using dvips. Or you can also directly generate a huge HTML file
by using htlatex, or a PDF file by using pdflatex.
It is to note that the output generated by pasdoc has been optimized for
pdflatex and htlatex.
It is to note that only documented items will appear in the final output file
format.
5.1.4 LaTeX2rtf
-O latex2rtf --format latex2rtf
This switch makes pasdoc write output that can be interpreted using
latex2rtf. This is the preferred output format for adding the documentation to
word processor documentation.
A single output file, either having the name specified with the -N switch, or
the default name docs.tex will be created. This file can then be converted to rtf
by using latex2rtf.
This output will only work with the latex2rtf tool. Using other tools might
not produce the expected results.
It is to note that only documented items will appear in the final output file
format.
5.2 Format-specific switches
The following switches can only be used with one output file format and are
useless for the others.
5.2.1 No generator information
-X --exclude-generator
By default, pasdoc includes some information on itself and the document
creation time at the bottom of each generated HTML file. This switch keeps
pasdoc from adding that information.
5.2.2 Specify name of document
-N NAME --name NAME
When the output format of the documentation is not HTML (such as latex,
or CHM), this specifies the name of the final name of the documentation. If this
is not specified, it uses the defaultdocs filename.
You can specify texts files which PasDoc should use as header or footer for all
generated html pages. This option is only available for the html output
format.
It is possible for pasdoc to ignore comments that do not start with the correct
start markers. By default, all comments are treated as item descriptions. This
can be changed using the following switches:
--staronly
Parse only {**, (*** and //** style comments
--marker
Parse only {<marker>, (*marker and //marker comments.
Overrides the staronly option, which is a shortcut for ’-marker=**’
--marker-optional
Do not require the markers given in -marker but
remove them from the comment if they exist.
5.4 Output language switches
-L lg --language lg
You can specify the language that will be used for words in the output like
Methods or Classes, interfaces and objects. Your choice will not influence the
status messages printed by pasdoc to standard output - they will always be in
English. Note that you can choose at most one language switch - if you specify
none, the default language English will be used.
The lg parameter can take one of the following values:
ba
Bosnian (Codepage 1250)
br
Portugese / Brazilian
ct
Catalan
dk
Danish
en
English
fr
French
de
German
id
Indonesian
it
Italian
jv
Javanese
pl
Polish
ru.1251
Russian (Codepage 1251)
ru.866
Russian (Codepage 866)
ru.KOI8
Russian (KOI-8
sk
Slovak
es
Spanish
se
Swedish
5.5 Other switches
5.5.1 Include / Exclude class Members by visiblity
-M --visible-members
By default all non-private fields, methods properties are included in the
documentation. This switch permits to change which items of the specified
visibility will be documented.
The possible arguments, separated by a comma are:
private
protected
public
published
automated
In the following example only the private and protected members will be
documented, all others will be ignored.
pasdoc --visible-members private,protected
5.5.2 Output directory
-E DIRECTORY --output DIRECTORY
By default, pasdoc writes the output file(s) to the current directory. This
switch defines a new output directory - this makes sense especially when you
have many units and classes, they should get a subdirectory of their own, e.g.
htmloutput.
5.5.3 Read file names from file
-S FILE --source FILE
If you want pasdoc to write documentation for a large project involving many
unit source code files, you can use this switch to load the file names from a text
file. Pasdoc expects this file to have one file name in each row, no additional
cleaning is done, so be careful not to include spaces or other whitespace like
tabs.
5.5.4 Change verbosity level
-v LEVEL --verbosity LEVEL
Using this switch in combination with an integer number >0 lets you define
the amount of information pasdoc writes to standard output. The default
level is 2, this switch is optional. A level of 0 will result in no output at
all.
5.5.5 Show help
-? --help
This switch makes pasdoc print usage hints and supported switches to
standard output (usually the console) and terminates.
5.5.6 Specify a directive
-D DIRECTIVE --define DIRECTIVE
Adds DIRECTIVE to the list of conditional directives that are present
whenever parsing a unit is started.
The list of directives will be adjusted whenever a directive like WIN32 or FPC
is defined or undefined in the source code. Each define should be separated by the
others by a comma, as shown in the following example:
pasdoc --define debug,hello,world
5.5.7 Specify an include file path
-I DIR --include DIR
Adds DIR to the list of directories where pasdoc will search for include files.
Whenever an include file directive is encountered in the source code, pasdoc
first tries to open that include file by the name found in that directive.
This will work in all cases where the current directory contains that
include file or when the file name contains a valid absolute or relative
path.
It is possible to use this switch more than once on the command
line.
Adds the defines specified in a file DIRECTORY to the list of conditional
directives that are present whenever parsing a unit is started.
The list of directives will be adjusted whenever a directive like WIN32 or FPC
is defined or undefined in the source code. There should be one defibe per line in
the conditional file.
This option sets the title of the output document. The characters in the title
should be enclosed in double quotes.
By default, depending on the documentation format, the document contains
either no title, or the name of the unit being documented.
Example:
pasdoc -T "This is my document title"
5.5.10 Include uses list
--write-uses-list
PasDoc can optionally include the list of units in a unit’s uses clause to that
unit’s description.
Example:
pasdoc --write-uses-list
If a unit in the uses list is part of the documentation, it will be clickable in
the output.
By default this option is disabled.
5.5.11 Full link output
--full-link
This option controls the behaviour of ”@link(unit.procedure)” type links. If it
is set, the output generated will look like this:
unit.procedure with the ”unit” part linking to the unit and the ”procedure”
part linking to the procedure inside the unit. If it is unset, then the output will
only be procedure.
5.5.12 Non documented switches
This lists the other unusual switches that are recognized by pasdoc:
-R, --description
read description from this file
-C, --content
Read Contents for HtmlHelp from file
--numericfilenames
Causes the html generator to create numeric
filenames
--graphviz-uses
write a GVUses.gviz file that can be used for the dot
program from GraphViz to generate a unit dependency graph.
--graphviz-classes
write a GVClasses.gviz file that can be used for the
dot program from GraphViz to generate a class hierarchy graph.
--abbreviations
abbreviation file, format is ”[name] value”, value is
trimmed, lines that do not start with ’[’ (or whitespace before that)
are ignored
--aspell
enable aspell, giving language as parameter, currently only done
in HTML output
--ignore-words
When spell-checking, ignore the words in that file. The file
should contain one word on every line, no comments allowed
--cache-dir
Cache directory for parsed files (default not set)
6 Known problems
6.1 Documentation of program files
As was said before, only units are regarded by pasdoc. In an OOP environment
for which pasdoc was written, an application is usually a class overriding an
abstract application class, so all code that is ever needed in the program file looks
like this:
program main;
uses myapp;
var App: TMyApplication;
begin
App := TMyApplication.Create;
App.Run;
App.Destroy;
end.
So there isn’t much to do for documentation. If you’re not using OOP, you
could at least try to move as much code as possible out of the main program to
make things work with pasdoc.
6.2 Records
Pasdoc cannot create separate documentation for members of a record. In
object-oriented programs, records will not appear most of the time because all
encapsulated data will be part of a class or object. However, you can give a single
explanation on a record type which could contain a description of all
members.
6.3 Non-unique identifiers
In some larger projects, identifiers may be used in different contexts, e.g. as the
name for a parameter and as a function name. Pasdoc will not be able to tell
these contexts apart and as a result, will create in the above-mentioned example
links (at least in HTML) from the argument name of a function to the type of
the same name.
7 Adding support for another output format
If you want to write a different type of document than those supported, you can
create another unit with a new object type that overrides TDocGenerator from
unit PasDoc_Gen.pas. You’ll have to override several of its methods to
implement a new output format. As examples, you can always look at how the
HTML and LATEXgenerators work. First of all, you must decide whether your
new output format will store the documentation in one (like LATEX) or multiple
files (like HTML).
8 Credits
Thanks to Michael van Canneyt, Marco van de Voort, Dan Damian, Philippe
Jean Dit Bailleul, Jeff Wormsley, Johann Glaser, Gudrun Plato, Erwin
Scheuch-Hellig, Iván Montes Velencoso, Mike Ravkin, Jean-Pierre Vial, Jon
Korty, Martin Krumpolec, André Jager, Samuel Liddicott, Michael Hess, Ivan
Tarapcik, Marc Weustink, Pascal Berger, Rolf Offermanns and Rodrigo Urubatan
Ferreira Jardim for contributing ideas, bug reports and fixes, help and
code!
pasdoc/old_docs/pasdoc.pdf 0000600 0001750 0001750 00000454734 13034465544 016246 0 ustar michalis michalis %PDF-1.4
3 0 obj <<
/Length 241
/Filter /FlateDecode
>>
stream
x=Ao &VݡNm%iK*y流Wlz t; q ,gE^ƛ&yV(T{C(Edu#5Ъ^ Bpk@h`OH=ӆ4<1/cMΡ^D6Fi,s{Zy EߏW5,Xiυ!.unG9!萏2 uZURendstream
endobj
2 0 obj <<
/Type /Page
/Contents 3 0 R
/Resources 1 0 R
/MediaBox [0 0 595.276 841.89]
/Parent 13 0 R
>> endobj
1 0 obj <<
/Font << /F16 6 0 R /F17 9 0 R /F15 12 0 R >>
/ProcSet [ /PDF /Text ]
>> endobj
16 0 obj <<
/Length 1044
/Filter /FlateDecode
>>
stream
xYM6Q*ߤnM,"i!@҃" Z2d)i}g8{ǺXE g ᯋoM*2bp [2^pMxfiܿt8d/ .(YX U(]KK?A(NGtTeg@gg'D:D77KgHp~-,/ ?5 LjASZ7#ªB,p9?'DH7ȰRs#~3ɉ
X1]XX& "pm!DAG`S` > endobj
14 0 obj <<
/Font << /F27 19 0 R /F28 22 0 R /F15 12 0 R /F18 25 0 R >>
/ProcSet [ /PDF /Text ]
>> endobj
28 0 obj <<
/Length 795
/Filter /FlateDecode
>>
stream
x[s0)x P Zu3o l Ne^Z|)I~ߗ I8åNpY埘@v_0baȺ[gnsXw=I2 > /7P~p㡯d".%{]e yFlqsV]G-izo4N] Ǎ5O2]^_fKj"S{x[8O'oM|=|07͑MGlg k
|i-
p) V (-u$WdRa1]`P~QzQYȏXOj-aK*o"'s}QqCaLCiޝfi%Μ=Z YjDVǸrN; =Dž80@zӓSBVo,k=lڕ =d([KyeYD//܌W0 ڡ
IT=}AZuaX"UPRRf^ >s? ],*C fi}
{ 7 q'Z@Rendstream
endobj
27 0 obj <<
/Type /Page
/Contents 28 0 R
/Resources 26 0 R
/MediaBox [0 0 595.276 841.89]
/Parent 13 0 R
>> endobj
26 0 obj <<
/Font << /F15 12 0 R /F28 22 0 R >>
/ProcSet [ /PDF /Text ]
>> endobj
31 0 obj <<
/Length 1866
/Filter /FlateDecode
>>
stream
xڍXKF WP rkv$mRh{ƶPY2$y HdzۜpH 9~u 'z3 _l~du!ѽ
: Κ $ o~${|g3T"ov"@2sM5 Lj"Xp>̜K?WEiu0 :3+"v媌g:ک$
ɠ#ZPi~
S:Csmid'lg: }+?%7 -I.bS.lDYCF)ǪF%!lvc
a \cwE ;wT)-*8yX_Hya
ؽ;/I ;Nb
瞕LD ԆpPhDpntz w58S];JQh=]sAL&mF(K8Ga1̚/qvF 0|X>{!m5DD ٍlSr/9WZSd aP;aBxuuLWF&P!
ihwt' DTN SeYْ|)S_qP%?Nźrtx{:N"$_f " <81ق ,A l. EK85=ߊѲS
SgS:Ey eůJ;c7K7uL
9 d r jSא4aVHR 7 {ٳw^>i):!+y\1e0@VB*4;G&1 ,ӯK,U/N"=?۾n-X! ڶNpN
_R{9Sw^AI̾eB?jXDeKx? J>rs֯\E+?eDM)FX{K }9M)1½rTM~{SW _]HmL߷xPB~C5XWB]_\onmHjM n?uNeQ }ʂغ_߶ jk hn p-ijL0A%|~\?&endstream
endobj
30 0 obj <<
/Type /Page
/Contents 31 0 R
/Resources 29 0 R
/MediaBox [0 0 595.276 841.89]
/Parent 13 0 R
>> endobj
29 0 obj <<
/Font << /F27 19 0 R /F15 12 0 R /F18 25 0 R /F31 34 0 R /F32 37 0 R >>
/ProcSet [ /PDF /Text ]
>> endobj
40 0 obj <<
/Length 2151
/Filter /FlateDecode
>>
stream
xڍXK6WЃ Q^
zHp6"}ZZ,܍Qw^bhșf_m=B~dnt⇑^iGYzQ]Y*
#W?~ͷ`RڏL&bY/oH[|UQ`,(]PܡkeZq1o뗫0v#x; ^.RM]bٗM
ϼEdm/Te僼l1w@ڸ|\[MQr wkmՙA&N.o2;[ߛ-~GM= VWq'&^[Tw4K3kZ~VGKr}Z+"ozv,B!@%ʰGOfGW366+`}!x*K[uva<+AC]7 )[9y9 l Kp V? BPA 0s@L'S}֕ց (]4hCݴ) JK
_ htGV%/ n)#ek#;KwyPCan 6m02?30;a0 0
~獬j
o2 Y&υnwc}Am^ _ rGu f@
ItǟË܁ :]):#ByhÁ2!(dPˠEuF 8F)k
=Ek(5TTT M45 y`tH t2%1H=D4cOel˯&/H*AlŜ $Y
-P&sD \|0 Ԥg!o T\.JjrJB*YཬюRrw3ȵv&SGg Rk NFa&vPB
/q OjCZYR5;`-Cn&uk#q75힔.re?9'e$ NB!PAN!H qt8 Ri>\QCՐ=;(܃M7 J
n9V :x#rB!17c:e_hK?q){N}c
ЉY3a@McOc8t 'j4# V Kr)3$R{yuTq<%-#?ЎD]؝M /;~Gb79B
KsHÕK"I>">bi{|F~VW,! 2n P3ulsI*uU;a82qMKSV'i/9w_dp0N\7뺷Hp?d텫(aU2po·3s% o߽0C/fLu]|Bؒk抎s zp݃ᶛ-iA$I0 0S^n d0J" _ޫ#
,lO"%&Hẏ &:qU8# ?cn@o:.˻mr3
玹Цc˛~!p#
o%? . e . Y<
F?C >BAA.Jc fQޱk|7BUtfX̀[HkfeeۛU9D <:-)Q过^{,-hn I B5IHtRڱ( tXټS6GbPj.u:ݖx !xS.D+ Nq> endobj
38 0 obj <<
/Font << /F31 34 0 R /F15 12 0 R /F32 37 0 R >>
/ProcSet [ /PDF /Text ]
>> endobj
43 0 obj <<
/Length 1613
/Filter /FlateDecode
>>
stream
xڭXK6WVI^ zI- h[<(Y@{YppV/ڗzwXAi=e m|'MulE,\YGs|ݽ^<6 no=Tŋs7A<\^^oS-&0?rE$Abz> VvM/g;mjY/L=n* FYJ
Zmr& &?u>+B-{Ӱ$`Tf :UǦ w SH1n"Ak]$$.BD6kiE`qQcYc. ,hѝ4_@[
(%rdK ӚNC
c&kl鸛>Vj֔ge"71|ʔ,0MP1$:(A`^0ta~d[4.]Q+M[kkKrInJ 1l!GίhjoGLڽ ;"S[I95 ;m0HjōNa̪|8 .{ ĹOer C9CqRUAĞM`zhF yT1AnfeO\h*% *[EA`bҹ]p \d}3.4<6MWѿ i
ɂ;4Sx /vaaw_uwM. Y~ IEȆsX/p:\S- iJs<
@?:nX$9bIaZJ"s^+3r\0zHK9ښT3 %Z.&S I/ ::17Yݭ0LY q7!0+W>[_#=Ou *VV> endobj
41 0 obj <<
/Font << /F27 19 0 R /F15 12 0 R /F30 46 0 R /F31 34 0 R >>
/ProcSet [ /PDF /Text ]
>> endobj
49 0 obj <<
/Length 2548
/Filter /FlateDecode
>>
stream
xڭY[~ׯ
Xg8E
l64"@YH=^Vܭ\Μ9s~[zµ"z_+?qc
.˛֏lUez'^_䛭Nc?F$zpz=jsI
UuJXhϴqW֓[ 3,4-zea-[E҃wRl{7(
ɳgAx\Ʈ7 endstream
endobj
48 0 obj <<
/Type /Page
/Contents 49 0 R
/Resources 47 0 R
/MediaBox [0 0 595.276 841.89]
/Parent 50 0 R
>> endobj
47 0 obj <<
/Font << /F15 12 0 R /F31 34 0 R /F18 25 0 R /F27 19 0 R >>
/ProcSet [ /PDF /Text ]
>> endobj
53 0 obj <<
/Length 1741
/Filter /FlateDecode
>>
stream
xڥXnFW=dsi
099ɡMQc.HA."[z~K@A;X,JvY0ww6ҡ3 l3籒 z^`Ĕmjӗ(\O. y
`t|mQT5p#
y2ETX\\0E{4an\ $! '3a [( sE $ݍgB垌9"Jڕg,4 *!'ī;|Ƴ`{A ,l'S$'D%֠ ,-qӔb<,iѮ]EzJjӈٯCelKg9$g> !<5TV#
=3Br$= ˳n9~)/^^L{SFJ Nunԍ ͺ *6/~ {}0Ě,Ob,# %@Nz
x\OV\X^|t44#s:DRk{H`@a=NqEA
j.Yd[y.pa廓
XjI ?ElvhM,)O~M?:~
'ʇK 52
Wq0vԩ:,dw<1Ժ۵ƄwAD`T;
S(3f9L"4|bu"^/jy XpeN:풴"IHh1m J
kH-K9e!:. ,S3-ʡƤm^$A*M
NS(4a-q3m&j s"$g- HMeJgхvJÖC3G f|.^6vBgbnd3t'2עи`[1F\`XI
$JDفKArIYϺLA;E/VΠ3ۡp *Ŷ?
+Y{WRxN\# qo%Qq b عb
`[>ڷOT(XR"%-fֳ?1/>ȏNM(L=MyQ#Wl^U6ԵfueکdV[ORB., wͭ`+_58 X9xr¹^d
NzӑzqK˨Pє$~*V:tRҰSy Zcu!Ev f ܕ7> M hC8M\|u9k2m,pxO=~߈hCMq&uw+XQdy钎n9q?o}3+n?UƺGCtmRFl* duaDlSBa<7L]f5rnDe:u<խ /(,?]FvaP[dr
ՅɆ/*t~//<! U4T~ۡjW껇R\YۣE>"wмEfܝ3N2E7YyLxYPǞ=C)݃"Bse?L4.O
pv.RPs{;t?q+{}3% o:b*ȶw[Lq)T>^n6&S&%UZ]g*sWf8Ǚ}Һendstream
endobj
52 0 obj <<
/Type /Page
/Contents 53 0 R
/Resources 51 0 R
/MediaBox [0 0 595.276 841.89]
/Parent 50 0 R
>> endobj
51 0 obj <<
/Font << /F15 12 0 R /F31 34 0 R /F28 22 0 R >>
/ProcSet [ /PDF /Text ]
>> endobj
56 0 obj <<
/Length 1771
/Filter /FlateDecode
>>
stream
xڕXɎF+t3X45av`ȧ$ Pe\F 'TWUZ[o/^K7F&dw.5߫pF z(D;maNrN=0?rꭟ8 1 h2EMĤPUTUܮe
ǎ a;w}7Ni7 IׅA
t?8Ib_65c lǮ k*7֚Ovȫ[.F7Or8!"G ~5cH2"9!" w|VX(:b~0R-a]֯M Xk)/vu xoomh93WK}D0bMk+vvϞ {f4xmX'h-TK"m߱I.@l(wAgQ}'_{yKpVF)7`[N*[Ԟ&}˖ gzqj%(R͚6l 8 'HY_X]P@y9_*JС<#* <9\+}'8y (Q!"JrJhu#ޚcxd_,``|xo3-!jk08B7yX߸)')+1$BePT^6c$EC9ĻWJ =q PJȄd []%p>J8Xc9VZykH cE zY_|%TPv+kmӯ\(-Y D %`N:-y(+oVe׃A:_FuN(00֑x eаnAD6SRXm.Y 6f!Rz }A~ܓ+6^!TTLۊ!̲Dpe#9ݫ zaԑJ3uks!!T}A="c6rfAd\X˳^*"7B= P fh?Y cZ*HJ0-/*_DKB!p͎a%ex~<7P Vn!lz+'IZ[9OB/['e"֟fJY@z|ýB
E䣓+zגk pg}U c?HN:i`aaK@hNͰ*U?5DyÌwX nOf89+kKF9pG紱 d%s U*2 m
|,3HUb@ Tq -dth:>A[ >=3 qf7æOtRefX<כ:8\b~wGϿP
Yy "侊B/"E.3XcD32Z ȱa(d84G8I vN}l
iڜmw]k6q)|j5xSG1Lq6eug 26~ Q#ߚҍZ'nO8DcOۗ Ké?Fy'}WNOR_(_3tz\rC+m} Q-gh1riz~矚*)A\ߎ$rC̣;%\cQ;H6'YŴ͚J.樝*HG.b-g9L!)-ަ, ?y?uʐ0wF)kna)x/mendstream
endobj
55 0 obj <<
/Type /Page
/Contents 56 0 R
/Resources 54 0 R
/MediaBox [0 0 595.276 841.89]
/Parent 50 0 R
>> endobj
54 0 obj <<
/Font << /F28 22 0 R /F15 12 0 R /F27 19 0 R /F31 34 0 R >>
/ProcSet [ /PDF /Text ]
>> endobj
59 0 obj <<
/Length 1590
/Filter /FlateDecode
>>
stream
xڍWIFW<hEےsQrs3=-S[cpbi4T/U]]? |]eX]A^ȃO{5Vf[gж5
(뾚G[rk]I
Ҥ$m^ucji
t㉇νm'= 3^ssk,X&>_UYzr"(:F;> m L{Kw 32/U.Au;: GT 肇3D/]fc *:"bL0JpyG?# HO:3c͂RW{{F! -z}0
½c X/7}{
6髀2Zn6< k0
7@W@QgHo~\M¨v
-aL$ tq645t|\jYh8F q3y Dk:wfʌzͳeznAILk EL @Dy?O 1mpB z f қ1B(>zoʂ.W3$"z y&&Ǫ;&}$ˈb,Ih ȁ, ~;OWRQ'_, >8I +hmx
<\ z/"`-Wͪ?gRo f܋[Z6I j 8C@<ͲR^ fupF]l+@X@{,芃e
7]Ca%$E>Ul$
=mA[+ǶN HvOai0dzgv"endstream
endobj
58 0 obj <<
/Type /Page
/Contents 59 0 R
/Resources 57 0 R
/MediaBox [0 0 595.276 841.89]
/Parent 50 0 R
>> endobj
57 0 obj <<
/Font << /F31 34 0 R /F27 19 0 R /F15 12 0 R /F29 62 0 R >>
/ProcSet [ /PDF /Text ]
>> endobj
65 0 obj <<
/Length 1191
/Filter /FlateDecode
>>
stream
xڕVI6ϯm(VDQ -@zhzHV!Q1屑b?=}ȟwo dQXDj[$3H2W/=` gM Eq.5|v{>4/=6Nn8 jD='չ# +SkICOVۺG J"*ևjD,E&o[&,T*LSʈSJ'rk#ڕXbG ,a鯇LG8 Qf )eXIAqaMP1oQ̓qJNw{3UZ39)OX:lOHE,
ntY3tin 4484
N!hMJx20/P[}RBS7]u+[`\^2,P|GBEKEBI}(!bawF/V0-R@lHYl )#IMsb t'9ּX}D8y;0[
n.3R2W3c> I ԣ w06e5we⠱>G
QA 7~2v$(Iڑ.QPM`h-[e'M W !*?s &a/Xs&ͣ_ 8GNd 4aƎ},1bd9MCհ@ f˜ @!ȕzo
]z? ;b
FghEu
1XA**? jpVn&I֤ڜ> 6gTٿuCK_MaՖ;/$?ltOix#_Q1 Ύas'P{B*Ɖ?h r&*{~ㄨAҺX kE۳\X#gn^<)ZPE՝-ÄFcm "6XۀI5GO\pVE֣Ef Z#C-E IH&`J;Km]2h{6H^ ^&fJRLyf~ΊD> endobj
63 0 obj <<
/Font << /F15 12 0 R /F31 34 0 R /F27 19 0 R >>
/ProcSet [ /PDF /Text ]
>> endobj
68 0 obj <<
/Length 1407
/Filter /FlateDecode
>>
stream
xڅWY6~ϯ0"1WaI
MsH
E[4}%VW
͢ ,m"9>|<~e )En!TdEB)d/6՟A"2r%eM
f2]Pa{*
EZ^/WIuYVqְnQ h;֩@'ʂ<grānQ*qY1PZ%m>:}'UD &XIAv 5^>rD)FQZc7$>iyxCP}'\7* $ !1=!6&NV ݈ducuZ.xСAԈэOxD^prZ: Wװ}} PΔ[
K؊{VN6tC?4,tK.i&LDe8紱xz?GD!I ?Pp^zf8iFQdr,#ΊE$fDda8(m(][rqg
8*DJF xD XKh8 *~H.S(6: w"Ų?[0'T ETf^!ƟC8u?X\q
mWWѸ>nݚ{0q=%VҶA n+I 2i<Mlt=\amWP&`G,Q8En̝aJHalEхN#8R9ʡT_!pLڠ_҄*iYBZ4*b]87 Ӗ=N 7cDHn(˼"ע),҈MU~eY, - C UJ;pMv(w(U{g#JNhڣ%|EAgRr& W1U!hmQn9Gw5Hz]|KUw\7NuwInS7~^|} ':3wD!3F"kwvTxW Lh'O)uuƸ(
6/MwwZYn+=ulnUǙH@ˍjgn;"VV>a5օl4WJs<;83sx忬!o [,\ߩn^ T~Ώ7"t' 5lXȟ_W:.J1;>>`]~ r2xAS -+D")rF9}FʅIT .[ > endobj
66 0 obj <<
/Font << /F27 19 0 R /F15 12 0 R /F31 34 0 R /F18 25 0 R >>
/ProcSet [ /PDF /Text ]
>> endobj
71 0 obj <<
/Length 1238
/Filter /FlateDecode
>>
stream
xWM6-)(YRzi-@R4=6m %A(;o+EЋErș7wiP*|.TEU.D*+oA*Py)fP!}ӻ/TWIdIW9۬R
#]Dee"`0-ikΌ"x#i[lio n'<_8w64 N+ YkHƆt h [|++
H1R˸řg =5%Z0 4Ւ
<̓c|f 7ƮFvAUQO~CӚv{1]!liYFo? nF}gx\~/?v~þ/n!73GU*}ވմXc
YRQդea$xK.LD@ Ods
-a
ozQiZ$~1RuwLs63dϱF!Ǘ{J?f'FfRo0 ,Nh"G vo)ż~ ee\3 %.1+VgaP#3Tb_a4N `N ɧ0_N)=(=#d̺fYIk& a-ftV&>C4@"0 Ml_D,MuTd2CڎLf~k7eH-)P8)IZ\6ջ8!ˈְw2̞yBz'}|
E
^dryړdΖ>Ú&E \49̓i.r4/[˧e2$8%sEdlH@, s (Fã{d f Su 3Cs{iUyAGQn#Skr
@Q=: ѬVy<(ڛv(,,E^Pc l
ݙٔz0Ԇ PPs9X39 U'`U[9
o[Ý&߀[<[iv31&vt6S7¢euSG(^yndLmx8V =3B$SjXypFN%= ??Os <5,3 <9Ny62g3iMbIr'ē2cs K{Z'PЋhYEVQ~uIendstream
endobj
70 0 obj <<
/Type /Page
/Contents 71 0 R
/Resources 69 0 R
/MediaBox [0 0 595.276 841.89]
/Parent 72 0 R
>> endobj
69 0 obj <<
/Font << /F27 19 0 R /F15 12 0 R /F31 34 0 R >>
/ProcSet [ /PDF /Text ]
>> endobj
75 0 obj <<
/Length 1590
/Filter /FlateDecode
>>
stream
xWKsF WHXc$qۙ萙5ElHQÇ O|ˇl:MϽH ˷~zazK$//zz*uS nvtWG!Aba9Uc%TO Ӂ535CK2O:r:gDŽD R쭒洝7M=8J); pL{zҡO8[| Dȓ:TW-`?6jN", k m-z8M4B4y Nc2C'onلVl6EN9cw[ vەͩ6qFp'p枂>Fvw"x+`
Yh;ʢj%VQx^ &rS%\/lK,hS6_AXjY.>YbϮv= oXfx^}ڀe84方HFW. ":RDn:\C7P?`S%G+ <ɿ{D,Mۀ^^Ċۄ
-Vkǔ|MZ'w!^Z%kj)=tŚWS .z.Tc-f,eq`lrFBMDعv%= TfD 6RAJV?~c5hA&Y48 +H 0*MP Z,/rȚ*́1חZB ]KZh;ѨR6-9>BWF}}@8ehXټϾ -UHAi%&p.5Neh.4y.FxU)#@٭V ߎXl1ɠyCm?ѭ fS1 fs MkO)Vؒ:+7NH;dV?<|;-M?Q_Ӭ3ʿpوٶNH 7D gBqLj24ˬm8v͑ki D BTxyׄIDfP$ 8.h2Ce+:澐x|z]l6H
Z(`Ց>V "LR" lp4 7rX+J
OL{)RQ RRoFr nf꧕RE.Ղhx~]:Wqb^%&J q!F,yZ&
G*o 4p0wF8ua2*5^HIn G _;t\Qyɔ:_%̹2sUƜ94fV
#Ca@W pɹ͏y;#0Ϧv4eA'<7bOq_<(;0XyI/Nps+V6~ǖ>~'T6tvff&G!E,ygӐ
[zZnGIs%|t^3]dy9GHTrOJc^ɑ&z
uh&sG, Zz~bk0uh?CXendstream
endobj
74 0 obj <<
/Type /Page
/Contents 75 0 R
/Resources 73 0 R
/MediaBox [0 0 595.276 841.89]
/Parent 72 0 R
>> endobj
73 0 obj <<
/Font << /F27 19 0 R /F15 12 0 R /F28 22 0 R /F31 34 0 R /F34 78 0 R /F18 25 0 R >>
/ProcSet [ /PDF /Text ]
>> endobj
81 0 obj <<
/Length 1658
/Filter /FlateDecode
>>
stream
xڽXMoFWHᆻ1AcEh{`D""Iq}R%9%k?fgg-_v#GlĨ44J'lYYs l,}s둴IUDŶE_}ʘ49ǹɂ8]Z99J V+0@?/?~ 8>=_pQxwJ̽`_N(y-*V~ 8Nά^P8뫦Xl11Y|/Zu< U8fDfa c[kDl]C߈$#{%Iڎ{ٗEJxbdؚIZPٺ=aV#RrW?h+Z%M_bU9^"ْlp&6yBl ܹ·ɧϮH3
8n`,^TFtʼn}Yu>;m{ ^
?!#K:Y!
fSkIGHqT/UCqj=67եoiF6G nURZL*>
~u"~9B>Ŝ}!CNlEfyhwT,1-pЩ+j8] ?,ayOY\fw kk2]ҁ m>_oU/7jR\A%L?Ht`F8cA.g=}Rhl /]UKW۵Xz_q-O+SRW]<Ê&|lBp.e*_"Ys?hbW)'ƚtzozNfzrɄZ@H8a8Un:h0:X)9vo۷ ߋa( Mk1Z [baEB A$endstream
endobj
80 0 obj <<
/Type /Page
/Contents 81 0 R
/Resources 79 0 R
/MediaBox [0 0 595.276 841.89]
/Parent 72 0 R
>> endobj
79 0 obj <<
/Font << /F15 12 0 R /F31 34 0 R /F28 22 0 R /F27 19 0 R >>
/ProcSet [ /PDF /Text ]
>> endobj
84 0 obj <<
/Length 1975
/Filter /FlateDecode
>>
stream
xڅXnF}Wa.Av $Eh@KĆ$[wnKQ{9sV7W" Ȫr2H|:> E\ydl] 9%T.dLgKȪ̢\~Q( Y;^tc*cYׇ
myF=gN"hd~&$ ;4q`4% ephXŢle7u儕p*#{zw >~yKcz8NٹOn`N6{o *$"yp> endobj
82 0 obj <<
/Font << /F15 12 0 R /F31 34 0 R /F28 22 0 R /F27 19 0 R /F30 46 0 R /F29 62 0 R /F32 37 0 R >>
/ProcSet [ /PDF /Text ]
>> endobj
87 0 obj <<
/Length 875
/Filter /FlateDecode
>>
stream
xڕUMs0W(f 1iI2tZߚ 0ȁdՊ7rۧ :_]L< b5IΒ@pE9r(*0 Λ|Mn{xÐ,1 /AHv ]Sco-x<߶Tb?"|\MȌp%\,&HG| e< 3@;Bs[/
u <SWH0
98Ep;əL:702h.yc ):Y E~FT:< cn ,b=uz56'xpIxp#2P4k~"v | ErZ ?ZX%/xŲB$#q.h "㌌ eVK :q qΑL1f\0[, M;y"4[ %%Y="VM9dҕ* lzu=-"G6%6vr#S>J Pzښƪҹ;d8ҥ4$mLm ,3
6GDd鎾 MSD&+!ZsۭȬ++#rckHI7Ǻ#/4KkkJnrR-*5ՠ 6v'GM }")̋>H#W9]k8ګOFPDP; %>x}U_m
g9!%"AǓ Tnendstream
endobj
86 0 obj <<
/Type /Page
/Contents 87 0 R
/Resources 85 0 R
/MediaBox [0 0 595.276 841.89]
/Parent 72 0 R
>> endobj
85 0 obj <<
/Font << /F28 22 0 R /F15 12 0 R /F27 19 0 R /F31 34 0 R >>
/ProcSet [ /PDF /Text ]
>> endobj
90 0 obj <<
/Length 1410
/Filter /FlateDecode
>>
stream
xڅWKo6W(VÒݭ-P4=m+D w lNb
gy|3?>=Db!?zayH8[iREOĒdr4e DrnkQjR\/2T
q0uuEj^ya*Q gd_ d,]ɇ{l"[Zn9׃ci,=MދOY=bԴ*pA Tf{T ƈГ|;GNt?m)9R$~\&9IC=ԛFyj7
D rybZ1``GBI| ~4c9eMA<~}OrΣbo~} W8g Oۓ4CY9o H )Vbm ESJ5%@](<^3X> Ca:ρ $YBibbH[tX^AN}u⬑5mApT\7acIGSG^CvAMh+s珩jk1ec~P [;
B'C. ^I \Y=Y
>2ۃ\ځdžX{Z%/wX;V¹w7~(BХMX_C> endobj
88 0 obj <<
/Font << /F31 34 0 R /F15 12 0 R /F28 22 0 R /F30 46 0 R >>
/ProcSet [ /PDF /Text ]
>> endobj
93 0 obj <<
/Length 1461
/Filter /FlateDecode
>>
stream
xڥXKo6W(^v7C[l.nDʒ!q;/ɒ<^L g Շ Yh*]l ~&Xi_Ŧ _^;-W&1Ζߛ?=R@a(:yFD~jbP*eε_hu2H q,#eY[KP2и*xձ 8`":YUlv<Ingq~͈ ф&W/#
1ƫ ns
qSdeSd]^.{#`fqfP4cZ>9{<ď=9?u$R0@6 "`0w_n>mIa3oǢ=7$H(Ѱ5H'"Q'aS^|0C$JB[\cIC<>f:7uY#; ےq hV?ZW=(9VXr":Zقpso
KO,Ynh̊6=ϞppǪxmiF0>$z f Q$@ou}Qh?Cq Ek$*r^ G!"7Z<5>ɥD` ɄhEîF)e}&Up4NAva Kf;XF7hϮex +91H}uY QfCi?@Mk?
yD$gҙRPaאT7i:VVyy,$=ɔ8hMjsT]H)&g>G~`#&5) 2 nC ˻ma ^#*-_
D >)"TP0[ xӰCh!E"|I0e >800SG;L/r'zB* /+A:轒=VǤ|
k0qXg8" Jc+gy R[q` kܧpM ϤTkD|,_cf0R;VRMcjS}u4[ v2c %,JǚK̾62 2N8>2jh2 hhr'c5mֺD&Xմ9Q16x x.T/ݐښh %ieBoڬO[ϊ8@ݏ73%fk*2*/қ٨~s6'u531duY6t:fYD
1*f(%v͔|Q+3}I BtԈ<&ǹk7z+RP)(Xk۴$4)Iqx
15nh> sxbZ"Ç*Ε {7Dl
`I2n6WP` endstream
endobj
92 0 obj <<
/Type /Page
/Contents 93 0 R
/Resources 91 0 R
/MediaBox [0 0 595.276 841.89]
/Parent 94 0 R
>> endobj
91 0 obj <<
/Font << /F28 22 0 R /F31 34 0 R /F15 12 0 R >>
/ProcSet [ /PDF /Text ]
>> endobj
97 0 obj <<
/Length 1412
/Filter /FlateDecode
>>
stream
xڝW[F~ϯR;\Ɔ>Ui!K}hxM咭}m^MZ 1Ùssfxysw ETvġb?ŦEATe:Eٺˁ7L RaKD 3*CM ' \ǰ^9PEH
_1%,8cV`b{vٻ-Ý33iCkfRD~? pY
@. 3 T72q
Ui9R~V~g`P3$ |Ѡ3\ {`(jss*K1O0BKi=m<NjR NWa|-: ZK5'q=TWe`endstream
endobj
96 0 obj <<
/Type /Page
/Contents 97 0 R
/Resources 95 0 R
/MediaBox [0 0 595.276 841.89]
/Parent 94 0 R
>> endobj
95 0 obj <<
/Font << /F15 12 0 R /F31 34 0 R /F28 22 0 R >>
/ProcSet [ /PDF /Text ]
>> endobj
100 0 obj <<
/Length 1613
/Filter /FlateDecode
>>
stream
xڕ˒FPbT` v S.9>`V-/b==7O
ҕV
d*t)>:U
k7LCh 8`5 ق7rKB帹g Wn{:$j/{C*q
@ z D( S!@p(T1-c;#uW~-nx: -b|"p Ena+ۡ=v/U #[gQX ˮ9bWQerGnxZŬ]ԃ͒ VEmX%A,2g
aA57ázcV eE8+I5$\WweeksX+姞h}k=ju9ٓʇwvPm )ghwlp2@iCyb츨M$!41SAͻδSK Δơ{ߕ(J ÿ xf:"%YA(75[HġRkX nbfc[{J)Qh
UbD!`$,#5. VBΕPjL J| mÜu~n +ߑ0a6#mtD`"1\Hc&TbR;]0kpANU*fOB'U} $ Y7ɱщRUtvSi{~v`578-b~D}>bEqZ#GM9? C|rDHw;G ygz<]b.@JXе $j=By)|S~ v&ҭg18 U2JnDnԦf%dVBt4g&Gv,-UU7ή> endobj
98 0 obj <<
/Font << /F28 22 0 R /F15 12 0 R /F31 34 0 R /F27 19 0 R >>
/ProcSet [ /PDF /Text ]
>> endobj
103 0 obj <<
/Length 2057
/Filter /FlateDecode
>>
stream
xڍXKFWjĐl>c;vśIVC[T RHn4>~<t[c=f)Xʶ ^^ r:G싎?u덉#wܯ\ocگh6
KSH {ݧ haF;`lm0(5F2Z';,cq Z҂W59U ':3ZC︰D!) Cߵ#[OW(LcNM;JA6_XE 9l;!غa#1 ݫJcYث=،Q6jT 7j谖K)0ρ{^!;m%
"JĞ8^ j
0ϡEg.҈?|4? ?8n# y ^O q(=,Qt'e{ޖmIһ}i9p, +KLفDkz
;c|*MA _~b;WgyHc iVƋLztfqˋ7cY"t#x{hFG7xSH L^X5}`҆s33* H%p=hY<Y5Q՜U$3C=mA/tϝ)Jk2H4_
Y4fN)^A/9K}щi
`FWx=)fz1|MO=(ZK
Ң}y~.K ` (O#=S8y*P)C \I2w!\ &ʥLx_gwe8'S?ໝ l걚[#Nfĥ_3-\=Ȟ\ WvnvjB/dW7ⷔ -Ks9#W/共q?~g,@T8UNt;qڦR_GͶ;K2ߗ SaE.v
#""`w^*t*W PG`q DR8+kDxYJx1p0J 5endstream
endobj
102 0 obj <<
/Type /Page
/Contents 103 0 R
/Resources 101 0 R
/MediaBox [0 0 595.276 841.89]
/Parent 94 0 R
>> endobj
101 0 obj <<
/Font << /F31 34 0 R /F15 12 0 R /F27 19 0 R /F18 25 0 R >>
/ProcSet [ /PDF /Text ]
>> endobj
106 0 obj <<
/Length 491
/Filter /FlateDecode
>>
stream
xmRMs0W2c0plfIzqhzhzAcȴڕhվtS->,,-YU,"O*
u,
8;' . q"ō3@VzLfsOqM_؛ֱO5 xx=kWc1\j@~i5TE i9S,rk9ZIh*%s|~]VKŸ,W@ {ąx|[ д0M
PT#Үwh$qy-G%yePŅm5.Cݞi5VG}FcMVw~܍7n;t{*̸Įgc:j@ 6D nߞ7ڢm.J y=2ڿvmh[2G?X:`?яYrx@ѥ@^'"\E.$c*h kendstream
endobj
105 0 obj <<
/Type /Page
/Contents 106 0 R
/Resources 104 0 R
/MediaBox [0 0 595.276 841.89]
/Parent 94 0 R
>> endobj
104 0 obj <<
/Font << /F15 12 0 R >>
/ProcSet [ /PDF /Text ]
>> endobj
77 0 obj <<
/Length1 756
/Length2 1101
/Length3 532
/Length 1656
/Filter /FlateDecode
>>
stream
xRiTg*j
JYEY$L 6a!d&L&Aĸ[.(PEE
(bpCDJEң`Tz:g}ݤPgA| rf1Y+H1 D`
%poB<ÃX
Ӎ 3!Whl I/CHT !1JQR3 ÀhB&!&TL$. aR
M: ڢ15 RK0ABh'} C
PLɕB B{od1Tc1@!TዪIJ-Щ
p{8͡^TZ yfUِ
DBLbDY>8 .IV3轠+Hf *h.L#N$H 1x\mrb| Jvx gW (y8DހA;;$|( &1HY(go} &șF +x,$̸Өs7VsJmgҒe'"e;_yhRQ`NÝE}raAw-UG& ޝu楯-6Id+h=;]tۖkkRGpT;*hdﭐL2wۚ sc>/]8lqqn!g=%@ޘ%m+S%YHoz?p]"$m =}&
zy4X#l%%IJu?nصats# $_SWiPovuIm*=myG1y&Զa3-,Xս=euk4NᝒX"*
;f}ml閻\~/liΘr#~:~küK舿خ}g~wϬaMA"ܽQPhm~oL"v/r[Elсh+ .1\#ֵ{p˷}xGn@i| .:ߵ4_ZO`28ԕ8|g|yЦ++6PS*bB]*Aˊ7o֜oy y p@gޡ([L~
J$?(=)C6MN]
ÇB@!0I2L`܀endstream
endobj
78 0 obj <<
/Type /Font
/Subtype /Type1
/Encoding 107 0 R
/FirstChar 65
/LastChar 65
/Widths 108 0 R
/BaseFont /ANCKKP+CMBX8
/FontDescriptor 76 0 R
>> endobj
76 0 obj <<
/Ascent 694
/CapHeight 686
/Descent -194
/FontName /ANCKKP+CMBX8
/ItalicAngle 0
/StemV 122
/XHeight 444
/FontBBox [-59 -250 1235 750]
/Flags 4
/CharSet (/A)
/FontFile 77 0 R
>> endobj
108 0 obj
[922 ]
endobj
107 0 obj <<
/Type /Encoding
/Differences [ 0 /.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/A/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef]
>> endobj
61 0 obj <<
/Length1 972
/Length2 3243
/Length3 532
/Length 3911
/Filter /FlateDecode
>>
stream
xy< e9l!-dYdqFYY= cFcƾeY
S#](KYJY:2w%R|A"p,p$'C !h|A æ,0# CfdF7?ЈD3?&oq 7
R S2z Ü)#м5bɍ
SS ?3'P C O'1>k'c$u7~f`Of Ba0x|sG34 KHn BYP( ?1TD2> d
^U` |W ԇq kd/M$5 1
$$ E!7<@63J2
mi?߷KRPB
e6j2,'ڐi> SSURSbi
H 06' A "cգ3y_Q[Gxy<%Җˠ8Z +hO~ټL+OE'Vn[ߏ 4&9VazGx9hxhw=3(M|1$<0K_:M't :dn
NzN @&䘲 ǿ0˸.q;T 3S\ ^ϴ7|1lI" P^'M/?gBڵ~}{- Y'=)Gݥ5JcY
%9#|t ')KMmʭl煮Gx&).Y4 >9,VH,)2.
XEr#+7mws()@qئlU;.;G-$
i|;謳ޠ=˻AaVO]vގ"сiߢFNӸx}=oȦ<4
۲-gh[( xA0|t)\ R~) \.MfT˔pCc@*}v:7]"N5rE:aXKcbd&4It՚$D< :-r|x)U vy!89J3{Ԧv %BarI.0n~]lP(("p$dQhފ)AFG^{^|%}B2:2ꥶq̊e㗮 ӁCwD>B})lL{9o։Xr8'I8UhEEׇ;>~uψÞ]0Bbco dj'm|ޟkZNZ>hXvXw}AE56UXq )~oEI.Y/PL/"%\ k÷OȲs9gJ8tnj|*m?2K
vs oJ
?KĬ[iz
|{`ћ~>vjkb3车q-
n cW˶BKLI'I{II.NX D}
ɟ=j~槶<
<% bx߄5IL 艑6tx4BQ~ *B &CY^NYp]
]@U p х,8l`)[
%.B*:)6 P=CreFZy(bIC U@"pk*彠DMoD23?q,S !+c{ Ȯ[ٙ'{">Ԕ&l:햲O)< E@GR4"F_=kqȥ11aUIׇ: 1U.y^+'#lnV
lr tyUmβ6q ս}^gWQy`)z[ktrMmICv>oE+6 !'.0IRЦ GYKU>aCYIk˭W)ԋaB]=S0X۵'[,eD17O÷ [}ŏU_"?U1N@=Abgڟ'=ϟOEf&?ײ] ySvQ,rvtzi?bNC{=yӖ,h HW[!
6b/,a Mi:DH8 Jp UF} uir|ΚU. !WcT[X&ЊeCsDƵE;U#ȝL'!$gG1kEzXy^/
t,M/R QIsF}4G X8iiuqMz4emOMMY@eP,Ht8=F9:k=,3XNsޅ".W^Y
lxit{*TL\
oUgv,݀" >+kwLB0A
Z'NT(\h *Fف̪ |'
o#vؽ~7ԞD
ƭCvB peJH) WaD/7+\ih6Y4Uu=R)aθoGBy
kUj+ wQ/0R> endobj
60 0 obj <<
/Ascent 694
/CapHeight 683
/Descent -194
/FontName /UKHBUC+CMMI10
/ItalicAngle -14
/StemV 72
/XHeight 431
/FontBBox [-32 -250 1048 750]
/Flags 4
/CharSet (/less/slash/greater/A/D/a/c/d/e/h/o/r/t/u)
/FontFile 61 0 R
>> endobj
110 0 obj
[778 500 778 0 0 750 0 0 828 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 529 0 433 520 466 0 0 576 0 0 0 0 0 0 485 0 0 451 0 361 572 ]
endobj
109 0 obj <<
/Type /Encoding
/Differences [ 0 /.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/less/slash/greater/.notdef/.notdef/A/.notdef/.notdef/D/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/a/.notdef/c/d/e/.notdef/.notdef/h/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/o/.notdef/.notdef/r/.notdef/t/u/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef]
>> endobj
45 0 obj <<
/Length1 820
/Length2 923
/Length3 532
/Length 1517
/Filter /FlateDecode
>>
stream
xSiTWF*D TE zL0 UAVPCF&*V7 G \8ڸD (
RJ;=WO{gc rЛ)F܀g@h˴$!JaR
pK \7 ´D$1# w$1! 2PBAJR)H !0Pf"aB
DC 39:E .i<#ZEDK@LςCrTt\ GeTA$A !$> "L.R),d. oLEA%bT B7$'(C_ éqp?bSLDb
esMǿ-%w(IJ&=AtpT s8A[ mM*$SVz8ѴR<p$$m \ M&Q!B0{xd\i! \\'X z>˝vB('ISCG1ct# T@!߸voS%5
8Fou62jVbP~~*x~d[ii~MKs٫z-멾 ݬ2h<`#lj{|,oUĻ&
[L g_=8K4*GPoQKB'wQGXh.^*<;#-oq|p8k͂k}?o;~e
9O]8Plg ءĈ[͉
Z_
)~/wwfyJR]ެfgۑw̍YkqI os>5"=5t } '
%)B̿ > endobj
44 0 obj <<
/Ascent 750
/CapHeight 683
/Descent -194
/FontName /HGCGPY+CMSY10
/ItalicAngle -14
/StemV 85
/XHeight 431
/FontBBox [-29 -960 1116 775]
/Flags 4
/CharSet (/bullet/greaterequal/braceleft)
/FontFile 45 0 R
>> endobj
112 0 obj
[500 0 0 0 0 0 778 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 500 ]
endobj
111 0 obj <<
/Type /Encoding
/Differences [ 0 /.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/bullet/.notdef/.notdef/.notdef/.notdef/.notdef/greaterequal/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/braceleft/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef]
>> endobj
36 0 obj <<
/Length1 1191
/Length2 6996
/Length3 532
/Length 7766
/Filter /FlateDecode
>>
stream
xe\T}ip(P@@:$a!fK)AD閖 p]ܗ~^|̼ߵ^^^Y] i
A" `A, 02J:LHLL . ~^A0/(sw[X:_HU9&%aN @q_w8Ua0 N@S Ia+ll))m L!6@39 |P=xa?8(I-*vN0 R-ؿ)ζu2C60 ;_q
f wZMl aat0}t45hN*Nv0 ?3 ~
0eC CLE@./ Dzp
s{p @ n>Lht u`. WoH[[" w!$A $o{) RL.2@?,? \6l#!? >:N r=s$$n`^n ;/Y^ ^;dNNN~.PgWa{i$T(C]g "L')AڂkR8' GaOOŏKAf:q^O5P,Q/>)KvtO/6#lknݮe6;` p3ӿ|}Vp͞m$ &4c_#ss}$wsT )ЧRDn qitsڙo+j9]Sf
>$ዦ_/Vq0,=aLc
RoOls2 ^GNn؛hTs]O8ENf3b 8{yuwL~Q t(jhiQHĹ% ȕYИ+?ɔŋl0-l$
$>5 t9OZ&>
C
Wc7洘
= ~_3V:1/ MK ;(hn\,U5p])N\Iju-.U\TX1Si 0W(njSȠM~F R5=dԨX¥Li/
ͽ+
͓ VuDkv pYV+{GAƗҳV;5mDMoٷ*D}`0Κ P ɒȥ~l`5ԛe<*֥b7
֥z ^37tF
I}W\+Q%R`0A@m"ґ~lYv|}% =OSפ_\ >Z=
N7fdMQ|hc&*FzނW/hDJ>X'O.LhKhnZ.KLilQ˭וN ?Wls(};KE3Ktfu{殖6%(WK*xX.BLdn{"r rH1|q##D1)m]q
+2PpŜʹ)֧nTaDsՃ Ox4i 3tEtnl|GAxLjgp49 B1b^OP]wBhWMH aFpmbyBA(:o M D8NnNclL$s'$7hS6Gv|?W@Zwz)\M~H֜hq,]mgA82$Cw.
%z4 ?sso*d?3L|Vd&P]'ab=oIJ
I6dpd?{]fv (TIŧ\C:cg jd}c$Dg|q]|煑I6 kP4 IIx{K= PQa훨L6wn,Rrf.-/Pw
XVOyC}^Y[#
Eh|%0FUQ۰ FZ$a5"ݞ]1ԑntsq&B%1{c:'.x3J>=~F-IV5r.#k5%MG@plE_u[ m v2|+L 谼չll8rd dM~
xZʜ|1f_JY )逑&+nˬP1 I'$At%&v<[<:ώƝY&
n~#C[coQJwlXg)Wp{1WܻV5_c8$݂kd7oKgK^c'u`K +HeS()+x^XL՞m_wv /wH Ԭ'ʗNG) /8-?<d QbgkpI8;l>/pjS Zil[PJXB߾))}ơ_vLw %]{@mDQm(5n~0SZ ;DɞI#6Bl/?!wuj oP/z CXT}jBn7:#.CK_Z@CQCS_Q, |@VT߮| dǭ*{ѸVK.LɏG2'BBAn:huфES@: gՔn#+Ru "q-~q ڑqsREЄ-V9TߧD(Bv~|nZuÕlax*.iT1uz½ Akba?G;NHX嫸xDllnlNq_An ;+:>!?+g[Qv:IVY!%?m?ʒ f{濵pGH (r+j
~#[*"P[`eoofPOm{ѭsMF?{י N>7k+=OޔG䠭2rʍGF]zl1Qm4/e23.F=BZYbGKVYS3$^ [.uiSʪ,ZI#p%ݳQ,$ {Rl uva ֥+vyyo3fd[ s \4q{Xդ*^}p;8+D?`#q7m-bB9h0IֺN]аS-
kؚ53!X~ $ʼnl?}%"!7*)oU Znm=8J<>#qZ,2O߰E C>Iomˀ/BCH~R0s3٧;{^&;(xr?Nb mw֣js,mbbO\MI!,||))5 c}%g Wb8Y?h֮KA!7^ @zgX ieaJ P{tٶ%8]T~Mj&N0v愽sǞ{pЄ6%8h{ϴ#{'#9\g |4)=lA1qi?8N:9@,lXw鯗nnW
P*i|;\5sŴ@e nV\z+!i)
g_gC,kNں~%$# Ʌ3%7E,VzMީx_OOf 2j{ Q]*B ұ4.&S!$)-
I+4i6 Ӽ ⢈g7ӐsbhBMzèO2L]䒿͂ ^/V?WijHԒ`'&8b4" I',rt
, Gd)nZ>Z n8I 6]{;xg+3Oa<_?mr a+jO~Rێ2܀Řl^ <)^z ɏzGj1Ո+U淉'U gkŋ. mQ,dB}a]
!f'4ȅrLWy<3E\`ɞM
Cf.}I)}EQy_TG Qbr8UL2jnv'8ͻ _(ט< ;b
kٟ-+-NHp<X R4\`PWW*)t -\жj=r (xc(?&o%:1;T!sx֗RegB S%oӜƟ|%(\9Q<@"yVbBQ>wKT2lDT1[ VO;6l쐗%[ l(.b=6Vm ֯9JIyO`f 9T 4~hr⭻4i{&[*[rbs'_љIzGGW
ElUӾu=}xlk}-B:.D #(Mp<f\Q WqD ]x|C];*`
Dh@-֞xdW2wΏ@_䝷q58~ƙKZ z(oog@|;سS킾;; s@:z4E4
UY<*C'5'< ): ݷمdF cQPXWbVh_(\ Wn(A)<lk=o{bXh}iza8>l T8 "Y}CϤ;ڏ]؏Gmd ~Yl`)͐\хL aIc:qyB*Os
mxԿ6rϟvkD5H{g w68*ω1 ]p="JoP rū-44<m_̘@*i<TCܫ;zA=ĐxE<ذ' %*) Uc^):Gέ [$>0ЁIyׁ>|c_ RM EKTg, q(ͩ֩Og H a9x63 et-)K$"ֈM>AmҭĭnP\m)R\`4&3W)DLżOtPk6"ꘓ*b IO^Σ'y X?/ j
KTϥawXHBx< J&BV| 4}-0:!ŋ[j>l{HZdb pij2 ]`@2O UX³`Kmܛ%Og)f%Z8&=9f\_d;L|A/ Kf$]QW=x4mXEi]롥N*6!O_(Ad4bioq䱰nR?E0 k; ,iu2 Rc 3#7M5JH@SJٮ?N汾#a_><1d+ UO 8f.Aj|HdLksB>lߎf3`4Á|IQ!|&t.Z@!Y K}?jQ-+5{^'
. c]ӎt{ c>ͤAXg p gR(vUk7R2QVV4/GB*ѿckQ 03\p6E^%p;h13~ؑ}/qX+k'e<]jHbH=w
d~ Z㍮}c-7_6euЗrmme%쯃>ڼ~J
{AWmwxyy.Ht*ezN? 8h-bZ|щMlA;m6Vyf+¥q;/5t <
TB&4MxFwMX'pb+v3®%)!Wd" 4XUP]Nz$ޤ0:Zpg4]#&]5DMRX4 0~kZurD]\FE6Gs6
? j3qpBښ8X4fh-endstream
endobj
37 0 obj <<
/Type /Font
/Subtype /Type1
/Encoding 113 0 R
/FirstChar 12
/LastChar 121
/Widths 114 0 R
/BaseFont /ZKJUNV+CMTI10
/FontDescriptor 35 0 R
>> endobj
35 0 obj <<
/Ascent 694
/CapHeight 683
/Descent -194
/FontName /ZKJUNV+CMTI10
/ItalicAngle -14
/StemV 68
/XHeight 431
/FontBBox [-163 -250 1146 969]
/Flags 4
/CharSet (/fi/comma/hyphen/A/C/E/M/S/a/b/c/d/e/f/g/h/i/j/l/m/n/o/p/r/s/t/v/w/y)
/FontFile 36 0 R
>> endobj
114 0 obj
[562 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 307 358 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 743 0 716 0 678 0 0 0 0 0 0 0 897 0 0 0 0 0 562 0 0 0 0 0 0 0 0 0 0 0 0 0 511 460 460 511 460 307 460 511 307 307 0 256 818 562 511 511 0 422 409 332 0 460 664 0 486 ]
endobj
113 0 obj <<
/Type /Encoding
/Differences [ 0 /.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/fi/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/comma/hyphen/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/A/.notdef/C/.notdef/E/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/M/.notdef/.notdef/.notdef/.notdef/.notdef/S/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/a/b/c/d/e/f/g/h/i/j/.notdef/l/m/n/o/p/.notdef/r/s/t/.notdef/v/w/.notdef/y/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef]
>> endobj
33 0 obj <<
/Length1 2121
/Length2 13522
/Length3 532
/Length 14686
/Filter /FlateDecode
>>
stream
xUX\ݶh
-knwNp ]CSk/y~Z }ުJ* ¦@ {;F^* 3YB hbio'f f^vV jdin' l t41X mAs TM,. ap|:܀,, SK1 'i;3{ M] {
PK 4AՀ 766
FLN_F6ΰupu:MNv;U_r@SKW=*bdci"lgn0WYhdbbpqr+ 3ˀIMASJCߋA%#K;UOOAq 0Jz9`d > x ,L H _?+`rtw3_A ?ln 09x-ٙLFN@;_QGW2+)߃l\W H=t @ٛ L6Fn = v0}b+lf_ 9g_n ;˿plJ![ [ :/' >ރ.d)NW@bq% d'N 3w9IHF@.r{';\ (wUWy'PuwUW{'PuwUx'PuwUkNF&@q@81(?%α]LdeN + 3H/gladd,BPB_ AVB_r AN?/i
4ߑ4 ƾN.MLJ6hhɉPS~VptkWpyI`&0A"_[37t 6b`Jz(j2jV:W{U2;E4^1jn{Ч>/: PPrP<cQM"b+|laBR Yq=;CKzhcy$c>J;9|72zŬ V1 VUl_>@I lW}G' hwŇgrq\br Tv~S@71ݴ5s[KۆdǗGe<_zWh<<טd|k N87=}-`$hpNVVDVQP[IwET^ Zf": m'#e̖1*p,}^fAPGcoQ
J0άXøٻ]B-W wxp I}L!*q 1b3ganXa_ sB F?CXn*k` LI8Е;:C3OQ/
7ұ %p;ϙF\֍peq KW֜nl/XH RaTL
`etڦ@pC Yu2#J &vm2Ơ Ce_]mUP"rkx#10DݔH.~Z9ɚRZG 5@hVul@)
fthŋ~3S Rx(^DY8g6o4~2|C NLxQz1RӶ_1.)$hC^cC7:M0LǶ_S簛:B̜yD,VeΑFdG 52.'Gg~L*ǦܲaSS;?ϴ,H'K(C7ә`#.r6hPGޜ0\ըT5"
"hHi͡
As{)xtA,3g'Q
X
X(-ؒ4 4f,=nq/љaBju,2w'~ |6Ψ-HI6oeNH BVd^4P'HM}7c#Pbh Ϝ4R ayD+
Jx{jB03es 05`g\7 T ZM~ꍝ~PO
lL3n=T&Ӭr0-[=ʏchRHW^?.^>bm[]VFr 6rϵs`=M =8?|㯼R⧱A;&O\t}Q-! }n[v̟df~]xmα=θO|Le/n?O;rF6ίX> gù ˦(qu8¥/# P_ LK>Π,n0^/ "B|I؟9Z a7a\]Sk.ƳӦ4*Vv "gHK0%i=_F}w ǾEB5}::Gn [w/
J83
2t178 DwӲ
P(8i G~!T9qWQ d&U/$쿁b1Gv3
V'`YT1I A+psjoǧ!4DSI?גoK|c-Ͳ/i6HȻ܉W"2y N"(rȕXNh>Z$Zx) ͒۬Y0ˌSz~d(ļV᎘`{m'8$E'_ͤέ*B Ob'7O4]*|HŅcGZO%]S^u__y1
"DH3y]?|
if`c 25+d%
$ ğBA
Φ5"Z:Xq"05Q.L'SR]AgJ ʿ[^tLՒL)@7
9 lG& frl9Z% ]:)z:۫=AI(pVVm\\7[k IxPG>80TW Uj,Xm >**b~0TRϟ~ԿyR{Hedk bJEzt/Ex6F_k0} a,cCڰgXxvw8hV嚳&Vo^ TTh&G
u``w5u{7d
t55,,Zrr\rcEQ_` aJF C=+ge
^k3:vV+-bzf:U%=ORȽ4 S0o#݄R6A_@AJ^¶Z-M5H̤TCM$P|kw]釢// iOW(WK]f|4
`1)K֢\mR\͖(U?e^D!`
+5K#?*3瀚vC `ܓ*.X
9 FDχBq<.5DUyy"E*uݕ? -me˹lYpg$A zζ
M3(qPP d8vw {ª=&"
ߒ]3q#6Sǣ)+_(Vr?x Z k0.Q]Zi '7Y@`n 066B'0YWC8+LNe
v ٽcvϺP?9]İ,a
!^uʦܬ # >6j_ c~} PgK=O?E?4 }X))#$!@1 )뵾emٽΆxۍM_K'7k8!j/^dq6rfdQ׆%p#g)X+f3g=rؕ t ZA?.rrǨyCEc^X %,2֕e,]/VgWW Ä6}֑&j?os \ILk ֥pUe٬}ɣ۬z`FK >;
Ϛw'ck!8e紴qRIi
Lk7|SS?%tP wF2nbWrܝQD"<鄫Тxsk3ڡ`c7 fa?z4ıܗL:kR"hܗʖKդZ!UuH74ΈD,2 -c Cy~9!
gBjsr9XiZxn2P]P+KkyR4ڇ?=4/p7c. V&w>'pn9N-m10
2
db{SFIb:GPWIqAcnM @ ~# 8wk1 K##x3iwsK'M1 ;cz0uϛ#Zg}2 o S6 G 2r
u:"sϿ0)G $:7G%@ stl(5*e='oH,7TT9!e@ޠd [/.I \)eKiP\zs[8 L -j&WMFk7?[ Ҵ?6`36U
EU9nʝyRrmaG yTW!ojEVeՙ*eFjNKQ7y
re8 :V p`AjђiDuF3 2Od#t#M7jml 3kF$g -Gad9r:Ti.&
RG!(L¾ B_G0MxSs
õHb韼JxYjh|tпa\ڳt hYF gc%&xقzkQpE\A&Zi՛ݖQkL;g+N|'6M{6""o91jT,$*:-g~_qHteDl D̙ׯ+%~xy]_Y$[dd-<UGαOv3y{"B PC:N ǵR
#*E,1zy Fse3 oLVz$'_
;!zZ>9(1XQe6(v8^w.r yXI'Qk)ޯ,Šm欍b}Gf+:KyƗUn7LPEN~dT+jJaoH$!G5M"K^P648O߬~ x&T:wGQGa|Mc t=/DI,JۉL#{ܐD
QkԿ䦮
)ø\?7h@O ӽ86wA_CGIo]&%nr֭1#ke8r
m=B] EGŅNL:a^=p잆&<6 q$Պ jwv fB;`Ѡ)G/=h., }2h\) .}Kj-e;8(667,deJ-51WmA+nqS6oQt96[oD}%I~j 8;<ρEw)pFcGuu4V3rHގYn `%|B ДF*gh s6"#@@[ca$>bîNdeߑic?
*"4i3j~s80fceH3 6.*%~G~peY/=(n7VN" A|>uظ'WA/ X8NxX#l 6uѽBv隁 \#Zh3
cKjBrO
u K Zc}x9#͢h[h`Yw4ԺMD؈PuA˳-K ɂ8{Tq KE'_KG>R sj p {K+Dg
m|g4%veatg@£ f][pȲxN %!V:I
q>}"KJ8mpcdfs^x|XZZ~8||,w[պ (~ʧ 2(n". V}k&-E} LPeVoN&>`/UWoBcn"O M0/RlK:s I' ${Bw
% [\?i-q=S> ՞H6O }.&c%hY "lO
K qSR(& ci [M?U7
j xR*bp͢L9_2IX ONX%K"'x?8~e9%^Pt` z6Ru;2A 5WDwF
jݞX-z*!Ͱ ?B, OyZJXma_ TN2 ϶wu=4d1qrz96A~1jl@jFw<^[! V]
^u xԞbj7sw/ʄ_\)_Eg9X0Kߊ!Sw)y@;k?t7+ǎ Q;,pԄGٞJҧVXyp_L B
|q͗tQY%2_> ,//poȌMFDv!*auSOģD2k (#.]H GVQq+5
$|
ٔgl65
Yo3.J0Gr*)
G9DwT/x T;8"i~D\O^JWaT%{LSFڦ_ȮO)}ˢ-n~C W_\e aj۴fJmC~:iiT F./´(g]#.K JȀQOohN]1AO
7E`3=< l(Ѿ~Jx[ o*'nP>yVzcR
m[?XnCd= |qV<A:A[1w\UBoD rW72v`#2e93q-Kt;zҚP 'v= `; N샋 ǵ=x͗cCt:0(BطuVf%XΜ6ZyA$|U}Op(Qbgݼ *
QѫEŊ?uJ-`LXlXf77_>F^7MW7k
gIhߨr47 *K9:J=)han]7%Dm SA G?f&v5$9xOuq-4j#q)u qT 46+f.*\tk nΪçXf w2t,0 >jNàk' V[li)p
ց< I 鷟Նh#jP:%M)]';MW=|E@N;ؗj!u
I`"OA0j{B͐$S([Q2j
7ʂ[ipn qN&$k_ݟfݸ#)+^Y' ${OTN6F ʿeZ| dUc+D5Ƌ{1ٷgU~"*Y"M_h| cAeP5'{J EꃁZԉa$J*h$h2BzaOf|2E]AfA' GZ#xb1VȄ2똈$Kxn ǖ*}-{ىK:@¸dW+CTd!wr#OVCYKbW[ߩ3 tZT:a?"":E+%Ht:p ,>[nhPRRx̑2kKUZ͠8TE6({?#^4 Z3S}Qv 3NW#\p2e{6yRIZN"f
n`+v4$,"DzpDW Mx?ώgk-gAǬ
{d}m@d\: ܌Iji<U"ך?D*nu!qeV~b*lOhm V,K NP; -ˉ Kɕ[ɨ"IN4 )pjgKBՔ7 KzSܠ'VBD,r!ɴ$5=Eh^H;
q1өf:jZ Bwmym F-;|ݙFEh }E/6 h7<Ȩ#e8L߂"-1KhGF{kG;jVpHHB`y Ӵfhv$% ([G\O{ϥpmf:e[)K=j*a'k*k' ᓦ=ėx3?yk}1t2'p C$DԖ,F+۷UzؤA֕\%Z;uا'8~cZ^#Nbx?CsB͛*EUB |(+_~SFSB
KP#jG 8M_mMo&Qzkk JS5GbtГA{f
6,|rnmc:Fڔ16`[ B%M$OG$
(]n.yr/۫|m2VsAsSAOG7%"dBW72k_C:{3)|=Sp:+͖P[l%}Mg-9\[\*3k8ZOz 3'3uN_S:&?Dv-еdu#@d;/wD/8მK6Q>ao
`K֥JIOn+ ̩,r`DS*9 ABwD UxV" *Aܖ`8jM aѵl&l2d] bUQ`6u-I y: Z[~0c8 zg2)Uت[ԝy`AYBY.sfy(bөQ|t>`CP
KFuKF:Gݞ!/, PpKա"*x\Y x[l.kQYɟOQՈXPlS!BMݧ*x~)dh߇ߍ"B<]4ƥ'8Mv8fe9a?7%i ܅uc]ժWYy15|Յ0Qp|lxm#V j` }⏁=i`֟BỌnB4z01ꐂ z>p fY) ,Hks*ױ *߈sU~iM 3"hp`wȥ^[~d̙7)<ߝ[ OѤp#`GNHC5v2>!MzL0 w{. kr-c^$1Bĭ'Ll^
~LS!bDHv!hd>q= ,`E`5/X. ,.Eb
;[ܬaI˂W*o :k؍|R
]# lɁ%u gl6)|R+pBB =rXIv<;Ǻ z`! +)= dM SE~l6!˵p ,{ܥpR^L`7Ҷ vA߿[Ks DQ y y>[;dm:?p\JO:r *{qW> :XWGi kF7Kb>}WK*$.W{SOUʶ½'.lurII:Rԟ]tIs 'ѓ֑Uc!Ia*~ĺ'{hN"2vT 51\7Y啝A9;ܟcgDH+Re[>ߍ?Rv33_;<.jBZQJљc8_oyD]u1ZX-֫Z)J}ׅwҥ5i)QRh<k'T!ŗ$D|g+ȮwPs!E]% g,Pduw|̹nRz&ry%㬼dЩBG^,{ˋvNÔK$ĵ)P^v ^(ԝ!h$ig.UKrG-1h Nby?UI7bևb9
"k] & OL`\m(endstream
endobj
34 0 obj <<
/Type /Font
/Subtype /Type1
/Encoding 115 0 R
/FirstChar 34
/LastChar 125
/Widths 116 0 R
/BaseFont /UNXHWF+CMTT10
/FontDescriptor 32 0 R
>> endobj
32 0 obj <<
/Ascent 611
/CapHeight 611
/Descent -222
/FontName /UNXHWF+CMTT10
/ItalicAngle 0
/StemV 69
/XHeight 431
/FontBBox [-4 -235 731 800]
/Flags 4
/CharSet (/quotedbl/numbersign/dollar/quoteright/parenleft/parenright/asterisk/plus/comma/hyphen/period/slash/zero/one/two/three/four/five/seven/nine/colon/semicolon/less/equal/greater/question/at/A/B/C/D/E/F/G/H/I/J/K/L/M/N/O/P/R/S/T/U/V/W/X/Y/Z/bracketleft/backslash/bracketright/underscore/a/b/c/d/e/f/g/h/i/j/k/l/m/n/o/p/r/s/t/u/v/w/x/y/z/braceleft/braceright)
/FontFile 33 0 R
>> endobj
116 0 obj
[525 525 525 0 0 525 525 525 525 525 525 525 525 525 525 525 525 525 525 525 0 525 0 525 525 525 525 525 525 525 525 525 525 525 525 525 525 525 525 525 525 525 525 525 525 525 525 0 525 525 525 525 525 525 525 525 525 525 525 525 0 525 0 525 525 525 525 525 525 525 525 525 525 525 525 525 525 525 525 0 525 525 525 525 525 525 525 525 525 525 0 525 ]
endobj
115 0 obj <<
/Type /Encoding
/Differences [ 0 /.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/quotedbl/numbersign/dollar/.notdef/.notdef/quoteright/parenleft/parenright/asterisk/plus/comma/hyphen/period/slash/zero/one/two/three/four/five/.notdef/seven/.notdef/nine/colon/semicolon/less/equal/greater/question/at/A/B/C/D/E/F/G/H/I/J/K/L/M/N/O/P/.notdef/R/S/T/U/V/W/X/Y/Z/bracketleft/backslash/bracketright/.notdef/underscore/.notdef/a/b/c/d/e/f/g/h/i/j/k/l/m/n/o/p/.notdef/r/s/t/u/v/w/x/y/z/braceleft/.notdef/braceright/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef]
>> endobj
24 0 obj <<
/Length1 755
/Length2 1111
/Length3 532
/Length 1671
/Filter /FlateDecode
>>
stream
xRkTSW%@0#$Ą׀! PKACrW{MFPp!ڦb8.P
*>yTQH
ť\pYCNu=}gϖݙ#ƣ/)4'(T8*'`xx0 G
\dzxn$I˓4:F yIn#*b P2RC$$H tzB$⡘0@
F2 ][! M{@Z4 q ɳ 05[W% edFB2T/ UJH@\ l65 ŨJ6W
EK!k
_4Q(HRCL<ی>c.Ǚל(ܑ$4wf&!DN Hڂp1b!Ar.Ȋ0 a"_+-$Hp~L6 p[ȯol"5ntƢ7q'Ʃ? tǻKT1Ȑ鼯%(%Pt"CW~ORd(8q~fs#;[ J /$L|ȸӸɾ}}
F
<[rugѶGctu^?wAu 7
ҝivLjY~ fr 6kRT9vWTƊL̝3S'XS[GLL#shUtXIMf]v>}2WR.cKS=i MYt8+ l]csIY{3,-iG><5$|Ɜy %\vWE o% ԂFU DGwF*&l=|],--4
>9!s ȁG-m[t}R/ceP 1K6{|{ֿR
aQE'Vԍ<4y-R$05^1xEuFgE~ 5w:q)ތﭫ"zo<]!r#e _|IDaƃo.:o +c??Á^Nxm 1ֹ)l5jL`9>_PR='w>xyPc[uwC=˂߆5.'לcܑܾK ZP}hBWB 2l|l)_ȿ5-l++HpVpC}>RK\N et FTlES!:kw_<{P"8EZ"FJsҸ~|ܒ35
GN{US5̛r#T2 OڿN^:h]j"{.-vlΨdH}K^!+7|OW
.%
Gb]qKEG˰
}iQb´_(lPj'v>Rfn:23 Tfg50Ogkn6=Qgv5? SzAuS%quͰݏ~A_v_n jR?-?"aO +t
Z:tI*dL2ԏߘhmܒ/X3/~-74k#2Cͩ]EQK}zBIWw^?~~")J\&$b 2endstream
endobj
25 0 obj <<
/Type /Font
/Subtype /Type1
/Encoding 117 0 R
/FirstChar 65
/LastChar 65
/Widths 118 0 R
/BaseFont /DAFVBY+CMR8
/FontDescriptor 23 0 R
>> endobj
23 0 obj <<
/Ascent 694
/CapHeight 683
/Descent -194
/FontName /DAFVBY+CMR8
/ItalicAngle 0
/StemV 76
/XHeight 431
/FontBBox [-36 -250 1070 750]
/Flags 4
/CharSet (/A)
/FontFile 24 0 R
>> endobj
118 0 obj
[796 ]
endobj
117 0 obj <<
/Type /Encoding
/Differences [ 0 /.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/A/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef]
>> endobj
21 0 obj <<
/Length1 1586
/Length2 10789
/Length3 532
/Length 11713
/Filter /FlateDecode
>>
stream
xUX\[; ݝpw5;=Kpww'еϗ9WtU]wQcS֪"'VT23:330 D5 LL"@Cg ;[QCg 4]>ZU3r$WJT vGǵ'=SSha@"ߠ|(.}Nj \ 'qx(*( =]1 ,]hT u*a\mfcN fkoP`] dq˺Kn̻<7>L8
ܳfeA#Yj17!
Oj_~BP?"ͥ!;)^5&
,5[,;iMPdz
؆BRig+b7>s
:n"S Pn~1G S үx7c : 2ܘtA(fkUdq4eu݊_ 0uRVhsG_SLfs#`zIr
.:M^0E`'hMYua|BEmWйd>xp`t#hXP|ae^Vurٶ.@_P uDj.w8 0犎b{ⱺeaT_1iycp*t5χ`]"x>KqiZYk@إϑZY۵e
Ed]wgfZ1/J5m Hv
?C ̸Yz4YhQIWw*M5O0?/][ bVE ZW!Khط֕: Ӿ^Џ(l&nna{_#>1+qTplݝf1$QI:U]yecR21$A6u8_s0˟=n%JkOPd83SeIUظYEg:3
fIGH733Ι#0Җ%mUH`dg#}aux#] wq c80rqgmz @Ih،Fr F)3e łL_7DwazjY-|f(Byt"/yl͵f"qt̡! q f2#m
+= W Edl0&:ycmAwx
{!P{ 7hwJSGi$MWx8< ~uS:VoRΚO8
f%$=6\سoq-$sWpٹ?|Tw`,[|KZQ(J&Un&,W
2itĸr' Z lDp*0"UV;~ۨqy]B3, #ca-
Vgޮ̆Gr^(ͻX۲:*
S O\n0̦R:ji'
uDD%ivL|'E4c՛B:F 3aMmoD&F7F/xZ NwI}2TDp!gz f_T)d
#.AQBJؖk2{8?XMFkTϡׅޔz.Ϲ dE3<;lJwj;(QZPE{ d y0{~4]! d\ ƫP3 X@/^ Y Bɇ}_z_ B[Xs3#n3w)
uݲ.-K;a) ߃֖tǢ0m2%1$عϼ|&j*BAI.hMtbƥ'dGs6 H
I_j\ ˞(a6]*4Cø?H{~OexBt V/%fn"h~
IhCN4T?`pK CMe ƺ@}~龎ޮy ią_U EsC 5%aAY'M-G ^3C "З<
Lsg)63DnG7 sQTDèHbļO|T|O,I% 8;
jo·WM T%/z-5\hHOLI\u
&H %f+ h"])嫫6= rڵ* 2\.k [Lw9w2;0Kq") CF M 8i{s`$O
%w! 'p=Ur~*Nu}0|gD: 7Hi f͑\#x[Ipv<pe-Oþq %o }U,qv"%LXԱcwXs k2VoȰ}J0 ap O3?XF>PVROoWE]XY/ĩF~Dϥ".!m1:}
ͧc#E|x.DRl$x^GĴ3WJ26R?:ld\
TnQC +m{*4Bz/㧚|߾7m
ei% B5-|!lYGx?yxdX vWX
NrzcH{~휭C&"!R0פ+QC. |}Rx<cw̩<
ZVʡ19Vx_#v a쫍
O!Ŋ^Ra.F`(б0phE^.QUk*-š.sE" !N )\^B L1y7h6SXzEDqe;0,,z5
Ne4|ÐF}x$f0rt'Rm&&hv=D
vjCC}5ЯY[-3l:e*r'\'ż6]k meM rltN ϐVJ"R e\!LK ` (bн]5Ly3:0 ,$1nsSe!6ӱmpW /֓5~CƘ%[zo ZWf3 Tʨb[
OCs8j''㐱я
%L;Kt
!hU @&6ؼF# regPi&ϣVTYZv ig@Ɩ$X,{w55Φ#m*@g?@JeݠQ ַ)+ ޏVO3n mH>Xn6Rʘ1L):&;%cS&
X|Ó H3dZS֤XYq YlM[Ӗ e/\09`#!%5[<5Eᵷ!Q֒4"$}<,'8:>_
K1y 9 x({ 1
)3njF>K)!씐}?Wb{ vD(h
veWT<#6VǢdD r@uYD֪thB He_L~ÎAUv ҢGڎ"E~4tL a̞&zJG\r&rQDɵlH|ċGpvЯuqHPVKj\Q>Fˀyndцlqz.`I!y 8֩~mf_DRI~hB%vAW=d 7ˣ'%1릦N]ײOa$T0 AoYtlSȌ2IqցfJ", A kb g|
Yb3?)fͱ5Jhu-L=
L〇.
B8CŹ!;pYf$&m𪓍&#}]QnTrH?En?,h-,8[s8Ȁ5 ue>U:mIvlZ@kAKZ**\``{T |#Eǎg]DPWP! 17 | "挏֤nQF'M;Q74- g5 C
[~#M$1g<tDr(SZIf[W Š5'8-Q%oE, [dY;^ԔӑF)zv:} ѯU~&cl)!:Zє]r>Wm'
MM~8 T.V{ RH
LںeE~iKDnllM~b$)IBi
Y@ tj?c)O{~{ BRX fM~qҿW
ӓ zJ":1<~ݻ}GSԈGі92=jw/Q 1_OCT"nkK~[Tب?ֵEӫ߸$wk5&5BH~GR^,lMhI\7
ac
jK\SD{`}c#"טּ5ֈW,owmlW2x o奆*KxӭIBFrx0T^\VOl2
%Ow,CN ΅$EYUjF1f#4"ENG4{kO {P{WY^kc'rnF|E
Z~ъvi"E=4 Mt:"SÓߪ趛>:#j Aymm0E(2PPgev>9[
P Bu*I. Yq
ъ\OOHK`(8riĸ '2>|?)W=pi`Q\LlI |:5~Jw.!bBtIӕr7qח آ"
鍨16 S%l!/;dגnr E#tVu8w"%Df=/] :O"{̢WLha$ ,v+u )g1Ln(&"E&n3g|S Ĝ
O( yRtDV 4TUu4Ux2 }hG ,qZz\ exӺ%bkxTqIςOקW%WӶMu629^Alt\ F RPKV7[8ٖD]f/, .NOTa.lef@w3 d O7&FYd*?O>.sBpPv
* *yGnKu뾚'UfI4 s7433}JAьam?991 &s:R*LqFQi?h1 ͦx2q#[
%v(cm_KyJ`ݤnd
-Wb+X^YT{pパyoFt^8}
pED\0? Ӏ1>B]|Y-xOl=O0(Z'ie>,&MorKG 5{7Q3sF:ru'˓-
'%bF4*t!`z Cq#\KtzHj99<*ᥞkl S1R& -V3a] NSf[ ]CTE၆s
J ƁC@
Z
1\ 3Q `)IK_};˻:YE;mtCf݈'`|3H1V%#{
TzP˰>;g_qFSu/v+DlU+rp:/? cK+1@Y҆`,ɀ+BV?J2J LoX,K-8;Zz_*b( |W # ϚSV
xP7 d2S{S)xIXDY5.=c]`hgQ~GJ{{|j"! eHBntr[!
P|ajnrFMYL)MEh>%M6I 3W u"RK~eY"ȬP9% c.;oilZWhᓸ`¬nh??{٥|PĀxhqeq*~tO?(O!ꖊk" mFdLncT$iP| Odmj
%wR=
YHbZiX%@삨uT k5asmg'BjdXIYÊǷ FI I)W 坧霰8 ^ufa5oRdWV k-sB"e[XJs҈/Uqr1I}7哽\jDpxG oX K9aT̜=qWU8 vWu&g~{koQ
'eSO| VWڙ o:`13=ř8xf!8+xcwOw}^>YygR6
DVMhнL 8sO0Ͼә$,?ԞBt = R'1'RrqA}uFزM,{ P ClWRqo^WwD?2@M}?AvP>)i+5 Gb߷{B8 U rA,?8Д
O/e 6"]Ss| V:=:-h
곺#{)v=RH5 D% BNx6FNt7s\y^ò!jjҒ6m ꉊgr$2^S*[)7V =ÒCMwn2J0%n$@c? ڱE~^1C[O^Xߵ^W` ;;&
J ʒ#plBvj9S cb`¥e[w\L8¡XƯY'
q ztZb_cEa'"/ (IDJ+=pOΘ`f>!o#Iybv8֬Bډ$mv6L xuðM7PЃ \\'QEAmC#X,F@V VsB#һQB^>/'
[
l /XDendstream
endobj
22 0 obj <<
/Type /Font
/Subtype /Type1
/Encoding 119 0 R
/FirstChar 12
/LastChar 121
/Widths 120 0 R
/BaseFont /NQATZQ+CMBX10
/FontDescriptor 20 0 R
>> endobj
20 0 obj <<
/Ascent 694
/CapHeight 686
/Descent -194
/FontName /NQATZQ+CMBX10
/ItalicAngle 0
/StemV 114
/XHeight 444
/FontBBox [-301 -250 1164 946]
/Flags 4
/CharSet (/fi/comma/period/slash/zero/one/two/three/four/five/six/seven/eight/nine/at/A/C/D/E/F/H/I/K/L/M/N/O/R/S/T/X/a/b/c/d/e/f/g/h/i/j/k/l/m/n/o/p/r/s/t/u/v/w/x/y)
/FontFile 21 0 R
>> endobj
120 0 obj
[639 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 319 0 319 575 575 575 575 575 575 575 575 575 575 575 0 0 0 0 0 0 894 869 0 831 882 756 724 0 900 436 0 901 692 1092 900 864 0 0 863 639 800 0 0 0 869 0 0 0 0 0 0 0 0 559 639 511 639 527 351 575 639 319 351 607 319 958 639 575 639 0 474 454 447 639 607 831 607 607 ]
endobj
119 0 obj <<
/Type /Encoding
/Differences [ 0 /.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/fi/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/comma/.notdef/period/slash/zero/one/two/three/four/five/six/seven/eight/nine/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/at/A/.notdef/C/D/E/F/.notdef/H/I/.notdef/K/L/M/N/O/.notdef/.notdef/R/S/T/.notdef/.notdef/.notdef/X/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/a/b/c/d/e/f/g/h/i/j/k/l/m/n/o/p/.notdef/r/s/t/u/v/w/x/y/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef]
>> endobj
18 0 obj <<
/Length1 1512
/Length2 8641
/Length3 532
/Length 9536
/Filter /FlateDecode
>>
stream
xUX֠]
\ݛk!H=k X%x !?;s.g~Wo[ꫧ4
N\@n(@VU rb21g'9Kw( ("H{x@!Q~QAL& bk`e+I A@N UKw;#
vA> i(n - ;
l q襓3@_akyanp) +\
Wvv 6'A q{pc n'gw# xK 60̿c+7
x@Ύ# ; ;ֿC <` xܽ~ lw/5?2rnp57 fkSx X אMl_?$ _o˽M*ʿ ^E7&x_g5k&xMxp5?[ Wc@, v |%?.- \7N \kp
?? [yp+(y@/ q'\Q{R~yyD<`0߷$B7@
a.;Z" *Pdl[{gB%] n+3 qPh(ݢ5B\ <-2})
e_ u~?DP^ -O6,9 :`G[{gԗ&$l } OZ )z ?-dhk6 . ̑,OS}pnƮEo{S02^CdͲ\rd,TG'PRƁDwt>Oel]+貳0R+SV|l;lxHf 2 ֲf1>*+/χW7eи% +Fk0Fp\o^< MY znW*.m!OX!bo0U \\VI[c{7VYYDה@?:j hS8 XY2)
t;RAunu.S8,YT
fdOjxyKObmpv
`]\|vmT;yX6ff3hgLAևY cCLUUB@ᦶѭ
+$qgZpxb˖n^ݗmBs%N3 (>g
m ANsg>TF*_W7Q|7!"Q>/Bϣpa-A4 l.4Is= 1OO.IanaC9 E )9v
̬C\4 *^1 V)= TU\3XF>ck'|xTQv M/??f\+D 5osBzx7/T E1$3)?1< 4Ulv0Vg5Yej;
ԮKReS0Y/'+'sIq2=4ą4;t:cU#`}'0w2cv PJ[s Pe]]ҼuϊPՀr3DWK#:ks^Jy<ɯ9tKqrs<>
"&yDvxǃ= yHSKқ; qH}}&t݅A*- w i8/B59*E Kxi1ϩ"d0`+iO49bn330=xӥ-}N\d6MҎLzפ C|-Wtm(VT(1HBPP>`clL+ίeB&M;"Ήv LTl*oK7\Y@'g h E]yN~)ZGcuڋԋ&>FIc٤R>I;Ik٣B!BI R3~$Rg'c/=ya7TUF4Eăǘ^FBNҤ""M@}'vn*NJlz;3{c8(ҥ ?Ve[C/i.1"m
^tαت[AvlQelkR#? Hgi+C(v<5%S "Ƈq3OF=3yjed5'ޅ
x =|nY'^Ym^<=N99VLi
5_eʥ H_vB P<-ŹN(g;
(gZ`{Q-}ӤՠMsud 6fsXG9WbvO}IC*M:9 +=%p==@N_9Lҙs43h8xAd
q 8V_lIYhcBѯ>w]/,U"}Hy'A(|)A Ӓd\4
5:1$eaخwq:̂HB_. 5ʺ*GvF3?-2cy >*ibpkuai<Â\ %Ci_3SRD +y~ mEֆ ^9bYDY \{g.%-0Ģ4KeiPIk* $HtУC&fBENe@ -3@)j}@XdnUʼn g,=(7FbJ* x5ڌj8$`wU'S$Å#?KڢOf]ګF_D02j$ o@[EOTL {N ;x]9ЂM$r;t(]-eO~X_ܠ} thB> iY0u,PBL Tvwx?meeҹ?ny ʝ3h1a8zl#;C| lҩ++fg;!߽N̪&z㶬A>qq}0&3*<-$Əi,si G˟9[˳UM%ja6HíH Jc2ugC/;vzfO9ȼujOªY7k?2n -6.5w\Ow r꾥t/{Ia}nwDZ
\r--xEgȡ(,ґߴqO#
ב蚹pNb>y5L'\_53hL)}ݠn$-̗Ƙ%+N6Uk;ulhOab۠' =#dwp=?4SȆ
E۷Q`z J"HȞk'-L7g=V?n j3tI a2&f1[OyQנ46l]89u٦X$. ߣmQ3[z)tY&" -5G| RJ-ew3*^ ָ!o
J +o7oB}f3ZΨIӸ,b昅 XZ(vc+h,25d&PY|O8փA9ET-+{~sJ%(C0sEP[nPXfڼ +){r ^p3ԫ =1 ?f^xʼnd(: >̘NusVUqB&TVɵ57_G V'-"b Kv+0b00JxY+߱gelV;|2 Fb ￔ|(x-Rn{ QNv6>Y#Yw*^a EAuzqPgԙ7 !|LBn{/~ XMi Tw # > GtJx'%>EB
['«< *@-ey6l9ZB&GyJ({rgk~Z_'/ oK 6Gmuʝ췉O\j
}̕VY?v[Zu'Zum9|#S1Sԁh:|I&0jw[зdp 2b6Q )[^=D0j]-v}wUez c6yʱcmLQSJdPA
G⩢VFDbܤ
^Hfˮw,wLkRՙ69P+kW6Dܬ/fԎ K_[R" by>Z#?u { B*Dz>R,x^U &b$mS6hqp+p
ӣ&ß9+.~W1$WCf d}5)Uh捣/Q $կV+*/[yI0,}AH7+ O5k>,x=ljoU)ܪVg"٩+bzvͽq.'B _89t$0j҂ n1b8el7T$k\T he4g,4 t@gUB uVl4 DnakA_` V "RU"CŰKM )# *V1l/% /YHyH+֗bU6"g= O+"e G RSeV0v:50RٮXjDzǻl <a?
Ţ4j=zyn\56 ;ဘɾf U?5.:w[BUFʸ 3
u0KO>`!y)օ
lEHcۜ`Ulq:=(nF^aXR/vt#|m+rc YTJkq|y{(,V'e7-J-䞃 )BJ U2M:ZjZ\l#}q\J|n;՜ߏr[ >m|N G4v4~ۖZ.dNJ}S#IBV*v ~ܷ48䐮`Sv{z LSY!7=;Ć] *Y2ǾeR O,+Hrb1â a~ꭆ =a
%jI>3BO]gp{Yc G(KAaќigg{Ղ x_4poƊ :.QbR~CV3aq 4jq) Og E^X7;BqnouR&>"I- 715^~p* #=lmftԻn
rY;~ans9enn)\{t Z(hHcaAu-I۔"ohplcrwZ&̎Z}>%w%4LּRBdQ/?(R, }VUⷼ>ף`|W_ OwK[NV z`$ VH̎[Gy?TT_=<I 5Bfj)0X4N^GV)Mp[s8$FK ot0 P]2WQgn_̼\.{byJОAh%f}
ԭ. KK^{;N gS,:|5"NQ,57ϰڳ/^-7ȩ 0㙻2q[XnKBb5OF"
SpY:1rT+x: 3žb+5|6+:. 96up< Ueڟ2)RnVPPm9ñ[}]<ŘNbhT/
p-c t=m_J.nuE
A-o3Zg>LzgH#wV%⭾IVBOH: ́H8l1^ S\6"HiɡoH4f$Y__|rqe ,@,?m=^~\ 2"Qhd0W^㌄Kni]R~a]e_!+V~ǀĶTةhl=/{4eF"pr'0WS˻]07|Q%@p+I\}#cyB;trfS&[R>lKf*ޖ0HU@kjhP۫!Y
+ zdum8@ej:ӷJO}gƋ}CG yT/C$g}iV?.6IBB1WOL.#,!Qe$da)O7eu&Kko?,izgkzĴ8gO>fDLp6x.2v"$' m-Ul33 |]RxJ$𰂕 ^deB_Be3R}cʻ赋+=eC(> endobj
17 0 obj <<
/Ascent 694
/CapHeight 686
/Descent -194
/FontName /XBZPKP+CMBX12
/ItalicAngle 0
/StemV 109
/XHeight 444
/FontBBox [-53 -251 1139 750]
/Flags 4
/CharSet (/fi/comma/hyphen/period/zero/one/two/three/four/five/six/seven/eight/nine/at/A/C/D/F/I/K/M/N/O/R/S/a/b/c/d/e/f/g/h/i/k/l/m/n/o/p/q/r/s/t/u/v/w/x/y)
/FontFile 18 0 R
>> endobj
122 0 obj
[625 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 313 375 313 0 563 563 563 563 563 563 563 563 563 563 0 0 0 0 0 0 875 850 0 813 862 0 707 0 0 419 0 881 0 1067 880 845 0 0 839 625 0 0 0 0 0 0 0 0 0 0 0 0 0 547 625 500 625 513 344 563 625 313 0 594 313 938 625 563 625 594 459 444 438 625 594 813 594 594 ]
endobj
121 0 obj <<
/Type /Encoding
/Differences [ 0 /.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/fi/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/comma/hyphen/period/.notdef/zero/one/two/three/four/five/six/seven/eight/nine/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/at/A/.notdef/C/D/.notdef/F/.notdef/.notdef/I/.notdef/K/.notdef/M/N/O/.notdef/.notdef/R/S/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/a/b/c/d/e/f/g/h/i/.notdef/k/l/m/n/o/p/q/r/s/t/u/v/w/x/y/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef]
>> endobj
11 0 obj <<
/Length1 2118
/Length2 15348
/Length3 532
/Length 16510
/Filter /FlateDecode
>>
stream
xeT]ݲh[p='݃9{^{@^>kYXQN noBDM$"HD( GF&0r5rp1qq1 llpdD"N.D"T$q ,M\, 5LlTM,.DB66DL p8LᘘL-M\vp (Iٙq;lߗ N@)"iR%Ml"(#=q FM$QR(#.2".r".
!N VWC*X]!`u?5 X];addb
p ?yS 2CB&^_F`%ӿ#sBB`A!g N!P)3//Z@+h^h\B_rkHI.1TڐV_32{1!e8$x
f 8Y!X S)BUf)tev FH:wm' J'X a
q8~\N <Ĵ2K1ɿ@_wۮKDi煠m5(Hi )PRJ[:ͮڜGԕ_pߞ )vf]~LLBnq |)Z' Ly< /*݅qq
=e~s2@bPW'\b lkgKفC8RtjVAY),qTV\T$}٘-Eԓ8(|ԋ/ƣ:8s8y H 3%h<\3dEv YWC lA@/ùa
TML0eCWضn}R/rmmX".VX$
yJΤ=iͺzbj 0p蜺SBki~ĭDcCոq#/fe 1&y`Y\buepra =DCG㲐9c[AZ6P t+!vӾz\Mcę ^R%[,h< +.,V.& P}
,f?F{\m@=~ĘE wȿ}횰Q(3"a8o $ҍ.kEwFoz3W/(cm\
$tl:kF1E)S GճM\n+g(P&. A&9e0d&MW/ y teB$uQ)DvkM5N UtX~ډ?U;qk߬)DWIA7hVxV;SR)ng랠^)kD2^x]j6Qv @< `G3uNF&r&-ll:
V\SwU= ɡ9,jU7nAɶ/Xs1~Tѝ/CyzPȳƃv%9⢞*3Z2|9E;yCl I. UiHhrfڈ@;Qg Sz#}xArk\RR%Y]8>̨|;Sm&,79- :*7CdݹWB{dKUJ*6S {=y#KXI(
_IT j/ ZVq*^}'*=x^B?mr Gd r&@:Ej=?Gr){~W~ v}Y~]s8 pd TЇj5t$\Cj{Ss >#7=):qQ6-X.w>2@YaЉ b,Іs" 5"XE^dga 룝Dgxn$
9CD*ˀ3vƤ|.$p :"R]֕CdBuO2T_Dٲ+~'g:vm"@cen~6uSzW
x#
>sëRn9 J}fLԃcdZkl'/;5D4 [.t@оwhܻ̞Q} ldX:,7k25 ͧ8 qIC@,9>
ZH|wy6 G[ŋIfq?K-bUX[ l#K/'kRޭS
іVAZJw l躍J/R}
Y97"ՉnsoK,t.tvN ~7J8 ]/6h: rUwfmfաgZ<<`_>: mGƬQE{
ԉq8o4#f6-eD+ZL 5GKx 3 NpLnd=rR,cPhlפ# CKc\7Xu:f $nd9TyPC'%c\Ao@ a ; yfdful<ϰx _,Qg ^28dIf ibsR*8RI$PehN&t jlM#2A ־\:JpJw" 71Jݘ5wme{kV b̬0 NѕsNF7L_O'*^1|O Yg#gs$+!J<QHfq2Lnѝ ?%S`L3Ҿ^OieMoV0p<=ƻCO=j|=߯-T.W* e{oޑ{
z} [
jY`Fx+xԒ~tcdNqUT.
El,oߎ8 x)*XZ2;Ձ
ZK`P{ Ōر~GNc}yt8}EC~kd5b1tX^YKPuw {FIQ_#t$jǎzN?/ʔtVr% Y&MSَ\M5r맦m_d td_+6' &q
^cx$c}٫쉓]4#EWwj VKZ17AvvA謻J*XSkݳh42hc{Dzm'GwAD,Pȩ
p0[YVc
y#4o1Ѓ
؇֏HR;0 ߣ
B蚵3-Nsc~
,I]YWT|kNzJK.(ݳS>%XX 2ߔ)N1cNW/l/lY-8_py1 ɠ
~
נ7foEn SXee` gatQ@o$\;AGj&V`#sMZ)Z ⽪A-!ky_¿ zWiذ/k k6W#s4 k2nd$ni^V'rgo^5eqFԞyQ4KqZPda 5i
myRHYaC
'! %WW}U>+U:Y$16D}7> LIE6 t u22.IzBcA0ϑ w5i#I`b^e٤Tr@JQzJ:j.T.D.θ/V}c')wRtW 5)-=-8Rh'Jh'#d9^1NFc)f)î/H+8zE n,G@lSspHE^#
@2TÃC@PO5ږ9%f8فU"ӼG3 C""N=Kvxd#[Rg}d?-tyƷPīLYw\fa>^d1|яB2i>utqG|]Q,,TDiRL , mfCULvV_yAy[Joh<^9b d٘ڐ9`v}/Wnvp qZ `nykdA2OM ;_ə0CVi6{fYLG44N9 U;z`~ÈW0+67nkvSwFWXڧ2v;/*tQ:vyR ZJ 7N鲞/b+ d& Cg CWպUgQ N!v|[sfUeg5
xHNO9ACIjAaW_1ߜn|R
FRcVu2UG*ƚQ"7@5@B *!p˜ {)-@cBN⮥$mVV Q*%3u!o;LyvB/]dYA"r`t S `z(o@ ?ru=İ}% BG\w*rwm;?N{-}`u c@8TlĉFsP=Ng
/! -%/r/s52ljA%kp$ K R eaar 4UIBI
>wmL(E]pSV
S'MT` ZXflLX'
L~[$ 5{ .$gu^hv0OV8/1c6]slNJd,`]#!WA}ƻSw湦ܤ
_ 8P;E"x zM ;
-d722@2z G9L=s7y )Q nkϯ+`e |X`3":)HntxXֲr>uP8ʜrpuuʥ7&P&$ϴG+N*a|S$62M*^V9=ǐ}b4q\y
d֛ed'wBߍR h:@<0O'no QX}$k1*yŏOƬ}Xa`'fbkQSqgcg(.][}*֚I ~L-2(uldž5j&Byl*&/mE0ru0K<Q!R~Sr'ؕ;.[Qm6䃛ol 0ߥ혴r>I K pbx?UP3Ϩ2o%m}t
M
^-WA* ^霹oDs~WU}SϪ\dgLC^M} gc݄
u/4 9Z_
}Irs8鹅Mvj])ZNڈLǃeDnX͎_ 7h\7K~2)k7' '5=44`L[S6))^>Rz˺UVu&j=c
uF[9
hYCɀdKU CE0 Ú 쉡(=I TXc4 4dep =,[Ct A@"2Ac}':qjrبl!3R5e*|SjQ swkP/D7 -gI_-V"$v|)lt_ Mg.y%r ޕE{2*&OV(TdxZ3_ER:%_4˙C+us.*s{, 1XEƜ8W(]3c6%Y-/L/֦ʑ=++|cʀT@DIgODzON|pabyVXc^y_DWG}gB*~@dwÌv`~܄ wUIul
.$V bzs흢9MQ(hxunxֈN`LwROF\LVM{qyb/`f OA(+
Ȓ.Kɢ"H=uZduMr\L N^B)du㵘:&T u] &]9{CڪK{ڦzP2ufR) }! Tbϒ
*۠4S wR6PB.B3+B^ \/ QzY
t <˥(1|M
s5i}b <0GR
DxEҜݨ GZ]Ȧ==U?,iΟQR&eSw@8[\!:;t6E49< J^3Zu' :Sow0B |a
H4xmTJL%{CWAzWo{G65 }ph+C\IkCܷⅱmǘԱ8W)ד.˂X*Ibh72f6>jNg Zu|$R
|i4 2zؾ,*R&땍>VӘvޗpޕ:b;Kf"f8)B{3rFf gL#M
mxaRU<`r( o
NZuq CLD{mJ'8m?&ca7 i
yWQ֛O&fE4{l .Vٱ",$'LIboB#C9&S}vZz1X@JŽwR" 8_7ڗ`pQ{>'3Xul(Zl{ԃ^BrZ68E \? ahi% )f Yon-T|U[B("7u º4AҴ u;F(I4 9UޘQ 5dj6=s{k{jSB<-Rv ^, Ϯ pvH;xgxChc>ÀbgpIiz¼SdqUP9uB$prJrX,qLg
^)(@73ǻg;x ,mܑ"; '3 D(2jOR61 `K~24,(>%-T8ŶW IrON
g/u3: 0<>wRrΧz7"`惷o2&T/acu D7:^Bѩ hTh s< \DO F`3 v(\Pbro2UW /'7%] iq?T5W~H ,cc8sQ߾gh 2\$M85_N7aҴl4c~yG=$i F;{8XeL{ S7IkXyV
7Y PBͳ4 ,HtB=4]-+#͖gݫѩ }D ;:)2?:_(. E8BLb2"
F1Qye meU< E5[f Yɭ[
`au: , sXg~Ӽbj\D؆
!l&S@ * 1 G*U?Q %NPЇ7ɾaP3RAɆoRH[i0($j9(쵇٤9_k̐]".e7ԆT
$IN :"V3縲 J
B{5>vVX;%b1$Zced g `Pm?ň\`&N'Zv/^a79|ey!nh?u|DCqT ys Ѽǻi=鮴,
0Ǫ(5TϔK
6S$Q;$mWCYaz
Nt+RqA5}ۏs_X[_&^[kJ0Kʰ+
%XϨh]j< >\:lpL[G1Ƿϭ6L:<װ#e j}cr#-w-":
u?`
4>H}; F5v4^9B8M6e#xدj}7)%$9 O3s=Un[{Ehl37|CC?$~{֒ l'X x 1UcNm~6gq0jTϛ7톟| " ְ4 <*1&igi9-;N]M.hƯr9fwSjfq. b5 endstream
endobj
12 0 obj <<
/Type /Font
/Subtype /Type1
/Encoding 123 0 R
/FirstChar 11
/LastChar 123
/Widths 124 0 R
/BaseFont /PROATU+CMR10
/FontDescriptor 10 0 R
>> endobj
10 0 obj <<
/Ascent 694
/CapHeight 683
/Descent -194
/FontName /PROATU+CMR10
/ItalicAngle 0
/StemV 69
/XHeight 431
/FontBBox [-251 -250 1009 969]
/Flags 4
/CharSet (/ff/fi/fl/acute/exclam/quotedblright/numbersign/quoteright/parenleft/parenright/asterisk/comma/hyphen/period/slash/zero/one/two/three/four/five/six/seven/eight/nine/colon/exclamdown/equal/questiondown/at/A/B/C/D/E/F/G/H/I/J/K/L/M/N/O/P/R/S/T/U/V/W/X/Y/Z/bracketleft/bracketright/a/b/c/d/e/f/g/h/i/j/k/l/m/n/o/p/q/r/s/t/u/v/w/x/y/z/endash)
/FontFile 11 0 R
>> endobj
124 0 obj
[583 556 556 0 0 0 0 0 500 0 0 0 0 0 0 0 0 0 0 0 0 0 278 500 833 0 0 0 278 389 389 500 0 278 333 278 500 500 500 500 500 500 500 500 500 500 500 278 0 278 778 472 0 778 750 708 722 764 681 653 785 750 361 514 778 625 917 750 778 681 0 736 556 722 750 750 1028 750 750 611 278 0 278 0 0 0 500 556 444 556 444 306 500 556 278 306 528 278 833 556 500 556 528 392 394 389 556 528 722 528 528 444 500 ]
endobj
123 0 obj <<
/Type /Encoding
/Differences [ 0 /.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/ff/fi/fl/.notdef/.notdef/.notdef/.notdef/.notdef/acute/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/exclam/quotedblright/numbersign/.notdef/.notdef/.notdef/quoteright/parenleft/parenright/asterisk/.notdef/comma/hyphen/period/slash/zero/one/two/three/four/five/six/seven/eight/nine/colon/.notdef/exclamdown/equal/questiondown/.notdef/at/A/B/C/D/E/F/G/H/I/J/K/L/M/N/O/P/.notdef/R/S/T/U/V/W/X/Y/Z/bracketleft/.notdef/bracketright/.notdef/.notdef/.notdef/a/b/c/d/e/f/g/h/i/j/k/l/m/n/o/p/q/r/s/t/u/v/w/x/y/z/endash/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef]
>> endobj
8 0 obj <<
/Length1 1205
/Length2 5728
/Length3 532
/Length 6511
/Filter /FlateDecode
>>
stream
xe\mN$!EiafCB:n$D[TKs>~ڿ=ח kk :Ŧg(`|UE"Ђ@! @I (
pq)`4 P2 4f %dĤdDI JHg/
Q+I `0
FC A^B ''_'\PW( j#Dl`4 ː: l;1`, N^ - qWusr*א[ 9y$
E6P?SM
3;
;'(@_U у! [+o OmA\PGQ_wL CW ͘` ! &襂 m`BK (؋ 0
B ј# L H_ ۡп1;cy @L7-H߅E hqqQ-
[#`+& o$+&L/HcN7a2!)1?YA߯ "6 1@LO?c bb#b!@̜@L# ib
**"=}@ AQq @ZJ
).#`.nPuemHJV!n(lPO( rCJChJX)> ]cNmd;iKlAM455VK&6_aս@5w4f&4m'[
Sűu'>$eo( \`pN!!id R-f@R
[J|8F v<('ɯ y iY=8*?5:?6"CXnL;>1 #,jzpѷ._(ha*cPZqy7 o5DHdQb]Iw=?gܑGV]ו~t4>K
L(.UcqYc5(ʌ״+z×;ꆈJ W=/ћM*Am3ZD# V*]vqUڼ7~7I%X^%,Rr͜gQ2n<4 I>4;͢ o1uxZi:}7j4մ9/=yxuzy<}˪9
0=3YE{':,np7o2tOmP .8T2 gx9 f2_5xPDF%L%X"t
;!T67[d'Q=ת;t`fkq89,
],IOBf
Oҟ9st,o2Ƶ?'E$|8<䖯59 j Sip1L k (uTȧ mW]>ȘlwW U>J=xNm2 /) Й,i^&;DleM2=qK4BMi$xJCur^$k$qqí
8[A_SH [@Eʻ<-L1@7pY`Zӛy1Z qy3{WX*KZ3\tw ጩ 7i[A3bYCLq-Qo54D)ؙ?gc))XkVيL+&~H['ya.]zoE|NĶnB+OٓcͬS7j?ǰ2HD桰Ͷ-]j jr$
[{DlXF=Ƨgx[vr䍸<2%+曦QRcHTTcSl Arj;劊Ao,IvR{9NQk:J&%h S`ڢ>U|4z`HZ2@_0!Vͭ!t{+U va|Ǯ 6cIJE<=DG*)/U÷/ix';tE^0W# j?voj?puE]+tX
a*r ds=|K%Np_HQ;)[d ǧ[~|ǺZWo鲙PYm,}y|˝;q cG7"s5+9HF5?wW&&;8}.YH{ZSWdDk9~;Y:ǙhjV#EԘyblkX
%1OgٔjWH{j)}9[3ܫRmՈ\rEr&j{c쫶"RI"=Y%gͫiqTF|@
uG6 4D.#,^L6>мa_e˱verv:b>* ^v%˖Y,ONn CVztϰ\x4pgPI"fnl"io\I喡WK뱠 gn+ͦdeè%/u^-qs Ƈ
tԟZ,Io e^f7i$d?}%RE
d$Rw֮ΟA?b n%h+@=ga:'l3 O@_U
Aڲ/'ZZ`2'm!iMys~fWwˈ^n> oj{ **Wsz@fXOQ P߷T"۰时B b'xÔ!?/&]iz2s
:uQD>{H9jyb0f uyQ
Vj6m-g-r4ǻ:^u|J [ Ezq
^ݹ ~#ƚ!r ⨌>.%"[D o=ě\wC)uI¼X\.4mf\O i] vn]i> W i2 ,.)U,ijZ `w6`K܀E:C$1g:V=0 =I[!\[u&mpec=jUK'cL!$PQj(Q+v;}m)zd Onu ϲI|jpծ^d%\O|5
G+i;.'
&dJ h?/TK"D u hbN$^)!! dQwo/11> yO3&ȟJ#nZ})}S GdڥUe}^,%R e$nքVNjɊƓa/F_νGh *
」=R[$ OGF )f5?ZYMz|*~U2g:J_C>KK<_ "$ih(ֺK'*/3;j'l
|b =k8q3mRwM [SSL.Yۂ nJMjs}C\&| ?X79m|,] 桧pFe&#">82'+&F|bVw)KGz82)My+%zO `_J)YTMxVe%>A/7>~@[rlC!nkTVhf BH'8[(z{`pη0qQmЌNpC
>떡ܾs6c H~Lǰ_;Va>;<8:}U/4Tz w& O j~]须9%se $;X3, !'
:6Py´{Ts'jt5ITyz3IA5!={o
gR 8'.3N^z'ߕx&h6keQCDZ=qfL KH@#'6}{6
m to7kR"C:uwjY kSUf`~aq,#bO/ }O IQK=\bljχ|X#W3pHƯ FФo j
sR[p#>jhUd=rYJȝIy4ZG
Io}o~w Tu6oR$F6 e#,q82J~j3|PbLLȜ>Km$َ:>3ϟ?p- /r 5o3 螆}P?WY{d6.IE$N[dK*aebR~|-> endobj
7 0 obj <<
/Ascent 694
/CapHeight 683
/Descent -194
/FontName /YMSNBF+CMR12
/ItalicAngle 0
/StemV 65
/XHeight 431
/FontBBox [-34 -251 988 750]
/Flags 4
/CharSet (/grave/ampersand/comma/zero/one/two/four/nine/A/B/C/E/J/M/S/a/c/d/e/g/h/i/l/m/n/o/p/r/s/t)
/FontFile 8 0 R
>> endobj
126 0 obj
[490 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 762 0 0 0 0 0 272 0 0 0 490 490 490 0 490 0 0 0 0 490 0 0 0 0 0 0 0 734 693 707 0 666 0 0 0 0 503 0 0 897 0 0 0 0 0 544 0 0 0 0 0 0 0 0 0 0 0 0 0 490 0 435 544 435 0 490 544 272 0 0 272 816 544 490 544 0 381 386 381 ]
endobj
125 0 obj <<
/Type /Encoding
/Differences [ 0 /.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/grave/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/ampersand/.notdef/.notdef/.notdef/.notdef/.notdef/comma/.notdef/.notdef/.notdef/zero/one/two/.notdef/four/.notdef/.notdef/.notdef/.notdef/nine/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/A/B/C/.notdef/E/.notdef/.notdef/.notdef/.notdef/J/.notdef/.notdef/M/.notdef/.notdef/.notdef/.notdef/.notdef/S/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/a/.notdef/c/d/e/.notdef/g/h/i/.notdef/.notdef/l/m/n/o/p/.notdef/r/s/t/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef]
>> endobj
5 0 obj <<
/Length1 974
/Length2 3179
/Length3 532
/Length 3848
/Filter /FlateDecode
>>
stream
xi<}-R.Z('3 ,3#ØaeK %2v~U%[HY*d{纮8NAS3)
%@Q `6-Aq"Z `@ JJ2rl"ޝD\s&Zߓ
74D #FD`3<&
,? ўh7% ( 8aplqNx@r+&xL4 "
Ò ډ
d݅90{q]/,&['ED #<
Mjx '"
JO]/e!"'CGP. ~<L ќw?ӺC6`i0BK}vGapAbm?Ph_ K3 ቴ# '}r ȝ6ůz-ň4.T;7zFI8}bkAvTn
""JTV~$ك)1s$A.,g'> yqod]eb㩠2
3Ts'J<)%awebķ=@^[=/ ,䓪O6M*HF7. {-.o,
E4 튅 6dKg()l gw>ɘ9 _rgc+zߖ7 T)W1Y͆4>2/^9yυ:lЛR +ĉ\-ʼm 1,;!y2.J я qnwv\6L9P.aefhWNѡ=f߀结u ՞//+6Ӧn˵)L]I|o?w#draX6+f@ ._ѝJ|
;rUVemri,ޡ!#sqY%&5ߢW6x32} |xg+1qvnwKQHD<ָ-,4褽jz%ʺS#/^ƏόDr5_>ɠ Ѻ4h+̍x:fpMcC܉{M#?tO=:G%
A/"oiLC;IK_> [ wKQxjq)gV튦 EzH)GyJR=dk=}| hpu$iL=]m ߸V4&iOBCI`W]b&=OА,XT3SSx鎂ٳJxVkV>[۷ޞّx$u#=3:WG%f_@r|pT`O>К B msΓמ[dj߽+x8ue,I?N*tj IhBR踥*^p NVc|" de,v)qA\]O/y>n_ƛD%qP3Iܔ
dՅ%B|Qcr=()Ψ# k܉CtDSGj-0þ~V!H''kG51ΌgӪDKʡp8ߋKOvpkZY3ZX iExb-Qk{xB;#DyWyb# o4Y1Ы@ew9ŋl:+X] 5]a7[19Cܴ լc*?>39fH>AdSF8yޚQ9LGr@ޘbVWbO ,X]<6Z0 *py>*gfW}6Ә ]1
a*2W}^^Hil=κjPB{Z(ɢϺ27W
nd,4xcȘ
Im+57/Sʮ3W ʎE#CVʲ{EgnmBνLwЧ Kڬm*Q
i#: ǥR{]bq7ZQ!M.-C'Jn }w#E??7/ kl$zWZyEsQ f%Ydb7عicWrà]y \x&2ON/g;w%{lpi%xvEl٤ ,6Å 7nJyd?֛h,뉵RiFޱ͇/Vvz{W*t$upc|a@f>nvvصw7¿O :=+-#$V %xWe3 7JZԫF J9KHίt(xEU}C m1yNeo?-aqBmi}佂b <\
?>l- Q E#D/[ endstream
endobj
6 0 obj <<
/Type /Font
/Subtype /Type1
/Encoding 127 0 R
/FirstChar 46
/LastChar 117
/Widths 128 0 R
/BaseFont /PXVFRR+CMR17
/FontDescriptor 4 0 R
>> endobj
4 0 obj <<
/Ascent 694
/CapHeight 683
/Descent -195
/FontName /PXVFRR+CMR17
/ItalicAngle 0
/StemV 53
/XHeight 431
/FontBBox [-33 -250 945 749]
/Flags 4
/CharSet (/period/zero/eight/M/a/c/d/f/l/n/o/p/r/s/u)
/FontFile 5 0 R
>> endobj
128 0 obj
[250 0 459 0 0 0 0 0 0 0 459 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 850 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 459 0 406 511 0 276 0 0 0 0 0 250 0 511 459 511 0 354 359 0 511 ]
endobj
127 0 obj <<
/Type /Encoding
/Differences [ 0 /.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/period/.notdef/zero/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/eight/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/M/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/a/.notdef/c/d/.notdef/f/.notdef/.notdef/.notdef/.notdef/.notdef/l/.notdef/n/o/p/.notdef/r/s/.notdef/u/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef]
>> endobj
13 0 obj <<
/Type /Pages
/Count 6
/Parent 129 0 R
/Kids [2 0 R 15 0 R 27 0 R 30 0 R 39 0 R 42 0 R]
>> endobj
50 0 obj <<
/Type /Pages
/Count 6
/Parent 129 0 R
/Kids [48 0 R 52 0 R 55 0 R 58 0 R 64 0 R 67 0 R]
>> endobj
72 0 obj <<
/Type /Pages
/Count 6
/Parent 129 0 R
/Kids [70 0 R 74 0 R 80 0 R 83 0 R 86 0 R 89 0 R]
>> endobj
94 0 obj <<
/Type /Pages
/Count 5
/Parent 129 0 R
/Kids [92 0 R 96 0 R 99 0 R 102 0 R 105 0 R]
>> endobj
129 0 obj <<
/Type /Pages
/Count 23
/Kids [13 0 R 50 0 R 72 0 R 94 0 R]
>> endobj
130 0 obj <<
/Type /Catalog
/Pages 129 0 R
/PTEX.Fullbanner (This is pdfTeX, Version 3.141592-1.11b)
>> endobj
131 0 obj <<
/Producer (MiKTeX pdfTeX-1.11b)
/Creator (TeX)
/CreationDate (D:20040419220150-04'00')
>> endobj
xref
0 132
0000000000 65535 f
0000000440 00000 n
0000000328 00000 n
0000000009 00000 n
0000148083 00000 n
0000143960 00000 n
0000147926 00000 n
0000141448 00000 n
0000134661 00000 n
0000141291 00000 n
0000131944 00000 n
0000115154 00000 n
0000131785 00000 n
0000150537 00000 n
0000001769 00000 n
0000001654 00000 n
0000000531 00000 n
0000112620 00000 n
0000102804 00000 n
0000112460 00000 n
0000100281 00000 n
0000088287 00000 n
0000100121 00000 n
0000085969 00000 n
0000084022 00000 n
0000085812 00000 n
0000002864 00000 n
0000002749 00000 n
0000001875 00000 n
0000005006 00000 n
0000004891 00000 n
0000002946 00000 n
0000081312 00000 n
0000066345 00000 n
0000081152 00000 n
0000063840 00000 n
0000055794 00000 n
0000063680 00000 n
0000007469 00000 n
0000007354 00000 n
0000005124 00000 n
0000009370 00000 n
0000009255 00000 n
0000007563 00000 n
0000053254 00000 n
0000051459 00000 n
0000053094 00000 n
0000012218 00000 n
0000012103 00000 n
0000009476 00000 n
0000150646 00000 n
0000014259 00000 n
0000014144 00000 n
0000012324 00000 n
0000016318 00000 n
0000016203 00000 n
0000014353 00000 n
0000018208 00000 n
0000018093 00000 n
0000016424 00000 n
0000049023 00000 n
0000044833 00000 n
0000048863 00000 n
0000019699 00000 n
0000019584 00000 n
0000018314 00000 n
0000021394 00000 n
0000021279 00000 n
0000019793 00000 n
0000022932 00000 n
0000022817 00000 n
0000021500 00000 n
0000150756 00000 n
0000024810 00000 n
0000024695 00000 n
0000023026 00000 n
0000042513 00000 n
0000040580 00000 n
0000042355 00000 n
0000026792 00000 n
0000026677 00000 n
0000024940 00000 n
0000029067 00000 n
0000028952 00000 n
0000026898 00000 n
0000030278 00000 n
0000030163 00000 n
0000029209 00000 n
0000031988 00000 n
0000031873 00000 n
0000030384 00000 n
0000033749 00000 n
0000033634 00000 n
0000032094 00000 n
0000150866 00000 n
0000035449 00000 n
0000035334 00000 n
0000033843 00000 n
0000037352 00000 n
0000037236 00000 n
0000035543 00000 n
0000039713 00000 n
0000039595 00000 n
0000037458 00000 n
0000040509 00000 n
0000040391 00000 n
0000039820 00000 n
0000042733 00000 n
0000042709 00000 n
0000049424 00000 n
0000049260 00000 n
0000053682 00000 n
0000053480 00000 n
0000064403 00000 n
0000064105 00000 n
0000082227 00000 n
0000081857 00000 n
0000086187 00000 n
0000086163 00000 n
0000100983 00000 n
0000100632 00000 n
0000113302 00000 n
0000112961 00000 n
0000132890 00000 n
0000132475 00000 n
0000142005 00000 n
0000141727 00000 n
0000148509 00000 n
0000148315 00000 n
0000150971 00000 n
0000151053 00000 n
0000151164 00000 n
trailer
<<
/Size 132
/Root 130 0 R
/Info 131 0 R
/ID [<7642862A4CE41D90B9896340699319DC> <7642862A4CE41D90B9896340699319DC>]
>>
startxref
151274
%%EOF
pasdoc/old_docs/pasdoc.tex 0000600 0001750 0001750 00000100632 13034465544 016256 0 ustar michalis michalis %
% pasdoc.tex
%
% Manual for pasdoc
% Written by Marco Schmidt
% Updated by Carl Eric Codere
%
%
\documentclass[11pt]{article}
\begin{document}
\title{Manual for pasdoc 0.8}
\author{Marco Schmidt \& Carl Eric Cod\`{e}re \& Johannes Berg}
\maketitle
\newpage
\tableofcontents
\newpage
\section{Introduction}
% This section is present in the wiki (more-or-less, i.e. sometimes in
% different places with different words etc., but I think that all the
% useful informations from this section are somehow kept in the wiki -- kambi)
Pasdoc creates documentation for Pascal unit files.
% equivalent paragraph is in wiki at the beginning of WhereToPlaceComments page
Descriptions for variables, constants, types (called 'items' from now on) are
taken from comments stored in the interface sections of unit source code files,
each comment must be placed directly before the item's declaration.
% This paragraph is rather obvious, will not be moved to wiki docs ?
This way, you as a programmer can easily generate reference manuals of your
libraries without having to deal with the details of document formats like
HTML or \LaTeX.
% This sentence is rather obvious, will not be moved to wiki docs ?
Moreover, you can edit the source code and its descriptions in one
place, no need to add or modify explanations in other files.
The rest is done automatically, you should write a script / batch file that
does the actual call to pasdoc...
Download the latest version from
\begin{verbatim}
http://pasdoc.sourceforge.net.
\end{verbatim}
% This is replaced by section on CommandlineExamples page (at the end,
% ,,PasDoc autodoc'') and PasDocAutoDoc in wiki
For an example of source code that can be used with pasdoc, try the pasdoc
sources themselves - type {\tt pasdoc[.exe] --format html *.pas} to generate HTML
documentation.
% equivalent (and much more elaborate and up-to-date)
% text is in wiki on CompilingPasDoc
You can compile pasdoc with Free Pascal (version 1.0 or higher), as well
as with Delphi and Kylix.
\section{Directives}
% Sense of this section is present in the wiki.
% Begin: Block below is in the wiki docs (on the ConditionalDefines page)
As you may know, Pascal allows for \emph{directives} in the source code.
These are comments that contain commands for the compiler introduced by the
dollar sign.
To distinguish different compilers, libraries or development stages,
\emph{conditional directives} make it possible to make the compiler ignore
part of the file.
An example:
\begin{verbatim}
unit SampleUnit;
{$ifdef WIN32}
uses Windows, WinProcs;
procedure WindowMove(H: TWindowHandle; DX, DY: Integer);
procedure WindowPrintText(H: TWindowHandle; X, Y: Integer; S: String);
{$else}
procedure ClearConsole;
procedure PrintText(S: String);
{$endif}
{$define DEBUG}
{$undef OPTIMIZE}
\end{verbatim}
The {\tt ifdef} part checks if a conditional directive called {\tt WIN32} is
currently defined (that would be the case for Delphi or FPC/Win32).
If this is true, all code until {\tt else} or {\tt endif} are compiled,
everything between {\tt else} and {\tt endif} is ignored.
The contrary would apply if the directive is not defined, e.g. under FPC/DOS
or Borland Pascal.
These statements can also be nested.
Using {\tt define} and {\tt undef}, a programmer can add and delete
directives, in the above example DEBUG and OPTIMIZE.
As pasdoc loads Pascal files in a similar way a compiler does, it must be able
to regard conditional directives. All define and undef parts are evaluated by
pasdoc, modifying an internal list of directives as source code is parsed.
Different from a real compiler, pasdoc starts with an empty list of
conditional directives. To get back to the above example, if you want to write
documentation for the {\tt WIN32} code part, you must explicitly tell pasdoc
that you want this directive defined.
You can do so using the \emph{Specify directive} or \emph{Add directives from
file} switch (see sections \ref{specifydirective} and \ref{specifydirectives}).
% End: Block above is in the wiki docs (on the ConditionalDefines page)
% Begin: Sense of block below is in the wiki docs (on the IncludeInSearchPath page)
Next to those directives already presented, pasdoc also supports include
files:
\begin{verbatim}
type TInteger = Integer;
{$I numbers.inc}
const MAX_FILES = 12;
\end{verbatim}
In the above code, pasdoc would parse {\tt TInteger}, get the include
directive and start parsing the include file {\tt numbers.inc}.
This file could contain other directives, types or whatever.
It is treated as it would be treated by any Pascal compiler.
% End: Sense of block above is in the wiki docs (on the IncludeInSearchPath page)
% Right now PasDoc handles switch directives and $ifopt correctly.
% The only really meaningfull switch for pasdoc is $M, and this is said on wiki
% page ImplicitVisibilityOption.
% So the up-to-date sense of paragraph below is present in the wiki.
Pascal compilers also know \emph{switch directives}.
These are boolean options, either on or off.
They can be checked similar to conditional directives with
the {\tt \$ifopt} directive.
Pasdoc does not yet fully support these, but at least does not give
up when it encounters one.
\section{Adding descriptions}
% Sense of this section is present in the wiki.
% Begin: Sense of block below is in the wiki docs (on the WhereToPlaceComments page)
You can provide documentation for
\begin{itemize}
\item types (including enumerations),
\item variables,
\item constants,
\item classes, interfances, objects,
\item procedures, functions and
\item units.
\end{itemize}
Providing a description for the different items is fairly easy. You simply
need to provide a comment containing the description before the name of
the item itself.
For units, the comment declaration must be done before the {\tt unit} keyword.
Example:
\begin{verbatim}
type
{ This record type stores all information on a customer, including
name, age and gender. }
TCustomer = record
Name: String;
Age: Byte;
Gender: Boolean;
end;
{ Initializes a TCustomer record with the given parameters. }
procedure InitCustomer(Name: String; Age: Byte;
Gender: Boolean; var Customer: TCustomer);
\end{verbatim}
% End: Sense of block below is in the wiki docs (on the WhereToPlaceComments page)
% Sense of this paragraph is in the wiki docs (on the WhereToPlaceComments page).
% (and note that *all* output formats show *all* items now,
% including undocumented ones; some reasoning is on the WritingDocumentation page).
It is possible to specify that items will only be documented when certain
comment markers are present at the start of the comment. Please refer
to \ref{specifymarkers} for further information. Furthermore, undocumented
items may or may not appear in the final document, depending on the
output format.
% Sense of this paragraph is in the wiki docs (on the LinkTag page).
An interesting feature of pasdoc is its ability to link items from within
comments. If you are currently writing about an array of integers {\tt TIntArray} you've
declared as a type, you might mention that the number of values it can store
is specified in the constant {\tt MAX\_INTS}.
You've probably already documented this constant when you declared it earlier
in the same or another unit.
Now, if you write {\tt @link(MAX\_INTS)} instead of simply {\tt MAX\_INTS},
pasdoc knows that you are referring to another item it has found or will find
in the list of units you gave to it.
After all input files have been parsed, pasdoc will start substituting all
occurrences of {\tt @link(something)} with "real" links.
Depending on the type of output, these links could be hyperlinks (in HTML)
or page references (in \LaTeX).
If the current output format is HTML, the description of {\tt TIntArray} would
contain a link to {\tt MAX\_INTS}.
Viewing {\tt TIntArray}'s description in your favourite web browser you'd
now be able to click on {\tt MAX\_INTS} and the browser would jump to the
definition of {\tt MAX\_INTS}, where you'd find more information on it.
If pasdoc cannot resolve a link (for whatever reasons), it will issue a
warning to standard output and will write the content of {\tt @link()}
to the documentation file, not as a link, but in a special font.
\section{Formatting your comments}
% Sense of this paragraph is in the wiki on the SupportedTags page
All comments recognize special directives that are used for different
purposes. Each of these special directives starts with the at character
{\tt @}, followed by and identifier and optinally followed by text
between parentheses.
As an example, lets take the well-known {\tt DOS} unit.
Its top part could look like this:
\begin{verbatim}
{
@abstract(provides access to file and directory operations)
@author(John Doe )
@created(July 12, 1997)
@lastmod(June 20, 1999)
The DOS unit provides functionality to get information on files and
directories and to modify some of this information.
This includes disk space (e.g. @link(DiskFree)), access rights, file
and directory lists, changing the current directory, deleting files
and directories and creating directories.
Some of the functions are not available on all operating systems.
}
unit DOS;
\end{verbatim}
Pasdoc would read this comment and store it with the unit information.
After all Pascal source code files you gave to pasdoc have been read,
pasdoc will try to process all tags, i.e., all words introduced by a
{\tt @} character.
% Sense of this paragraph is in the wiki on the SupportedTags page
If you want to use the character {\tt @} itself, you must write it twice
so that pasdoc knows you don't want to specify a tag.
% Up-to-date sense of this paragraph is in the wiki on the TagsParameters page
Note in the example above that the character does not need this
special treatment within the parentheses, as shown in the author tag
at the example of the email address.
Following is a list of all tags that you may use in pasdoc.
A tag like {\tt @link} must always be followed by an opening
and then a closing parenthesis, even if you add nothing between them.
The following tags are supported:
\begin{description}
\item[@@] represents the @ character
\item[@abstract] This is an abstract of the description
(nowadays called "management summary")
\item[@author] Treat the argument as an author's name and email address
\item[@classname] PasDoc inserts the class name here.
\item[@code] Treat argument as code example
\item[@created] Creation date of item
\item[@cvs] The argument is related to source versioning with e.g. cvs
\item[@exclude] The current item is to be excluded from documentation
\item[@false] PasDoc inserts the specially formatted text 'false' here.
\item[@html] Inserts html code in the output
\item[@inherited] PasDoc inserts the name of the ancestor class here.
\item[@lastmod] last modified date of item
\item[@link] The argument is the name of another entity, PasDoc will
add a link to it here.
\item[@longcode] Format the text and output it in fixed width font,
with correct formatting.
\item[@name] PasDoc inserts the name of the item (class, object, function, variable...)
here
\item[@nil] PasDoc inserts the specially formatted text 'nil' here.
\item[@param] Treat first argument as parameter name and all following
arguments as the description
\item[@raises] Treat first argument as exception name and all following
arguments as the description
\item[@return, @returns] Description of a function's return value
\item[@true] PasDoc inserts the specially formatted text 'true' here.
\end{description}
\subsection{@}
Represents the {\tt @} character, for example if you want to use one
of the tags literally
\subsection{abstract}
% This subsection is in the wiki on the AbstractTag page
For some item types like classes or units you may write very large
descriptions to give an adequate introduction.
However, these large texts are not appropriate in an overview list.
Use the abstract tag to give a short explanation of what an item
is about.
One row of text is a good rule of thumb.
Of course, there should only be one abstract tag per description.
The abstract text will appear in the overview section of the
documentation (if the document format supports this overview section),
and will also appear as the first paragraph of the item full
documentation.
\subsection{author}
% This subsection is in the wiki on the AuthorTag page
For each author who participated in writing an item, one author tag
should be added. The format of the author tag should conform to
the following specification : {\tt @author(Name )}
Author tags will only result in documentation output for
classes, interfaces, objects and units.
Example:
\begin{verbatim}
@author(Johannes Berg )
\end{verbatim}
\subsection{classname, inherited, name}
% subsection moved to wiki
PasDoc uses the tags {\tt @inherited}, {\tt @classname} and {\tt @name} as
placeholders for the names of the ancestor class, current class and name of the
current item respectively.
Example:
\begin{verbatim}
{ @name is a method of @classname which overrides the method of
@inherited to do something completely different...}
\end{verbatim}
\subsection{code}
% subsection moved to wiki
PasDoc uses the tag @code to mark example code which is preformatted and should
not be changed in the output. It will usually appear in a teletype font in
the final documentation.
Example:
\begin{verbatim}
{: how to declare a variable.
Example:
@code(
var
SomeVariable: SomeType;)
}
\end{verbatim}
% ------------------------------------------------------------------------------
% kamb says: All the content above this line is already present in the wiki
% documentation (i.e. it's sense is more-or-less preserved in some place
% in the wiki).
% Content below remains to be carefully checked.
% ------------------------------------------------------------------------------
\subsection{created}
This tag should contain the date the item was created.
At most one created tag should be in a description.
Created tags will only result in documentation output for
classes, interfaces, objects and units.
There is no special format that must be followed.
\subsection{cvs}
This tag is used to extract the last modification
date and authors of the item. The parameter of this
tag should conform to the $Author$ or $Date$ string
of cvs or rcs.
\begin{verbatim}
@cvs($Date$)
\end{verbatim}
\subsection{exclude}
If an exclude tag is found in a description, the item will not
appear in the documentation.
As a logical consequence, no information except the
exclude tag itself should be written to the description.
Whenever high-level items like units or classes are excluded from the
documentation process, all items contained in them will not appear as well,
e.g. constants or functions in an excluded unit or methods and fields in
an excluded class.
The following example will produce no documentation, as the entire unit
will be excluded from the documentation process.
Example:
\begin{verbatim}
{@exclude }
unit myunit;
interface
procedure hello;
implementation
procedure hello;
begin
WriteLn('Hello');
end;
end.
\end{verbatim}
\subsection{false}
PasDoc inserts the specially formatted text 'false' here
at the location of the tag. This tag does not have any
parameters.
\subsection{html}
Pasdoc directly outputs the text that is between parentheses,
without any conversion for the html output format. For other
formats, the text is converted to standard text.
There is no syntax checking on the validity of the HTML syntax.
If there are no parentheses, {\tt @HTML} is directly written
to the output documentation.
\subsection{lastmod}
This tag should contain the date the item was last modified.
At most one created tag should be in a description.
Lastmod tags will only result in documentation output for
classes, interfaces, objects and units.
There is no special format that must be followed.
\subsection{link}
Use this tag to make your documentation more convenient to the reader.
Whenever you mention another item in the description of an item,
enclose the name of the mentioned item in a link tag, e.g.\\
{\tt @link(GetName)}.\\
This will result in a hyperlink in HTML and a page reference in
\LaTeX.
\subsection{longcode}
Use this tag to output code, and pre-formatted text. The output
text will closely ressemble the text typed, and will be represented
in a fixed width font. In the case of pascal code typed within this
tag, it will be pretty-printed first.
To be able to put special characters in this tag, the
tag should be followed by a \# and finished with a \# before
the closing parentheses.
Example:
\begin{verbatim}
@longCode(#
procedure TForm1.FormCreate(Sender: TObject);
var
i: integer;
begin
// Note that your comments are formatted.
{$H+} // You can even include compiler directives.
// reserved words are formatted in bold.
for i := 1 to 10 do
begin
It is OK to include pseudo-code like this line.
// It will be formatted as if it were meaningful pascal code.
end;
end;
#)
\end{verbatim}
\subsection{nil}
PasDoc inserts the specially formatted text 'nil' here. This tag does
not have any parameters.
\subsection{param}
Treats first argument as parameter name and all following text as the
description of this parameter.
Example:
\begin{verbatim}
{ A small description
@param(Filepath The file to open)
}
constructor Init(FilePath : String);
\end{verbatim}
\subsection{raises}
Treats the first argument as exception name and all following
text as the description for this exception.
Example:
\begin{verbatim}
{ A small description
@raises(EMyException Raises this exception)
}
constructor Init;
\end{verbatim}
\subsection{return, returns}
Treat the text in the argument as the description of the returns
value of this function or method.
\subsection{true}
PasDoc inserts the specially formatted text 'true' here
at the location of the tag. This tag does not have any
parameters.
\section{Switches}
This is a list of all switches (program parameters) supported by {\tt pasdoc}.
Enter {\tt pasdoc --help} at the command line to get this list.
Make sure you keep the exact spelling of the switches, pasdoc is case-sensitive.
Most switches exist in two variations, a short one with a single dash and
a longer one with two dashes.
You can use either switch to get the same effect.
\subsection{Documentation file format}
After loading all Pascal source code files, pasdoc will write one or more
output files, depending on the output file format.
Choose the output format according to your needs -- you might want to create
several versions for
\subsubsection{HTML}
{\tt -O html}\\
{\tt --format html}\\
This switch makes pasdoc write HTML (Hypertext Markup Language) output.
HTML files are usually displayed in a web browser, which available on
all modern computer systems.
It is the default output file format. Several files will be created for
this output type, one for each unit, class, interface and object,
additionally some overview files with lists of all constants, types etc.
This is the preferred output for online viewing.
It is to note that even undocumented items will appear in the final
output file format.
\subsubsection{htmlhelp}
{\tt -O htmlhelp}\\
{\tt --format htmlhelp}\\
This switch makes pasdoc write HTML (Hypertext Markup Language) output.
It also writes additional files that can be used to create Microsoft
htmlhelp files. Please consult the htmlhelp Microsoft SDK for more
information.
\subsubsection{\LaTeX}
{\tt -O latex}\\
{\tt --format latex}\\
This switch makes pasdoc write output that can be interpreted using
\LaTeX. This is the preferred output format for printing the
documentation.
A single output file, either having the name specified with
the {\tt -N} switch, or the default name {\tt docs.tex} will
be created.
With {\tt latex} you will be able to create a dvi file
that can then be converted to a Postscript file using
{\tt dvips}. Or you can also directly generate a huge
HTML file by using {\tt htlatex}, or a PDF file
by using {\tt pdflatex}.
It is to note that the output generated by pasdoc has been
optimized for {\tt pdflatex} and {\tt htlatex}.
It is to note that only documented items will appear in the final
output file format.
\subsubsection{LaTeX2rtf}
{\tt -O latex2rtf}\\
{\tt --format latex2rtf}\\
This switch makes pasdoc write output that can be interpreted using
{\tt latex2rtf}. This is the preferred output format for adding
the documentation to word processor documentation.
A single output file, either having the name specified with
the {\tt -N} switch, or the default name {\tt docs.tex} will
be created. This file can then be converted to rtf by using
{\tt latex2rtf}.
This output will only work with the {\tt latex2rtf} tool. Using
other tools might not produce the expected results.
It is to note that only documented items will appear in the final
output file format.
\subsection{Format-specific switches}
The following switches can only be used with one output file format
and are useless for the others.
\subsubsection{No generator information}
{\tt -X}\\
{\tt --exclude-generator}\\
By default, pasdoc includes some information on itself and the document
creation time at the bottom of each generated HTML file.
This switch keeps pasdoc from adding that information.
\subsubsection{Specify name of document}
{\tt -N NAME}
{\tt --name NAME}
When the output format of the documentation is not
HTML (such as latex, or CHM), this specifies the
name of the final name of the documentation. If this
is not specified, it uses the default{\tt docs}
filename.
\subsubsection{Specify footers and headers to use}
% Text equivalent to this subsubsection is present in wiki
% (on FileAsHeaderOrFooter page)
{\tt -F FILNAME}
{\tt --footer FILENAME}
{\tt -H FILNAME}
{\tt --header FILENAME}
You can specify texts files which PasDoc should use as header or footer
for all generated html pages. This option is only available for
the html output format.
Example:
\begin{verbatim}
pasdoc --header myheader.txt --footer myfooter.txt
\end{verbatim}
\subsection{Comment Marker switches}
\label{specifymarkers}
% This subsubsection is present in wiki (on CommentMarker page)
It is possible for pasdoc to ignore comments that do not
start with the correct start markers. By default, all
comments are treated as item descriptions. This can
be changed using the following switches:
\begin{description}
\item[{\tt --staronly}] Parse only \{**, (*** and //** style comments
\item[{\tt --marker}] Parse only \{$<$marker$>$, (* and //
comments. Overrides the staronly option, which is a shortcut for
'--marker=**'
\item[{\tt --marker-optional}] Do not require the markers given in --marker but
remove them from the comment if they exist.
\end{description}
\subsection{Output language switches}
% This subsubsection is more-or-less present in the wiki (on OutputLanguage page).
% The fact that ,,stdout is always in English'' is *not* stated in the wiki,
% and in fact it may change some day.
% Of course the list of languages is much more up-to-date in the wiki.
{\tt -L lg}\\
{\tt --language lg}\\
You can specify the language that will be used for words in the output like
\emph{Methods} or \emph{Classes, interfaces and objects}.
Your choice will not influence the status messages printed by pasdoc to
standard output -- they will always be in English.
Note that you can choose at most one language switch -- if you specify none,
the default language \emph{English} will be used.
The {\tt lg} parameter can take one of the following values:
\begin{description}
\item[ba] Bosnian (Codepage 1250)
\item[br] Portugese / Brazilian
\item[ct] Catalan
\item[dk] Danish
\item[en] English
\item[fr] French
\item[de] German
\item[id] Indonesian
\item[it] Italian
\item[jv] Javanese
\item[pl] Polish
\item[ru.1251] Russian (Codepage 1251)
\item[ru.866] Russian (Codepage 866)
\item[ru.KOI8] Russian (KOI-8
\item[sk] Slovak
\item[es] Spanish
\item[se] Swedish
\end{description}
\subsection{Other switches}
\subsubsection{Include / Exclude class Members by visiblity}
% Sense of this subsubsection is present in wiki (on IncludeByVisibility page)
{\tt -M}\\
{\tt --visible-members}\\
By default all non-private fields, methods properties are included
in the documentation. This switch permits to change which items
of the specified visibility will be documented.
The possible arguments, separated by a comma are:
\begin{description}
\item[{\tt private}]
\item[{\tt protected}]
\item[{\tt public}]
\item[{\tt published}]
\item[{\tt automated}]
\end{description}
In the following example only the private and protected members
will be documented, all others will be ignored.
\begin{verbatim}
pasdoc --visible-members private,protected
\end{verbatim}
\subsubsection{Output directory}
% Sense of this subsubsection is present in wiki (on OutputOption page)
{\tt -E DIRECTORY}\\
{\tt --output DIRECTORY}\\
By default, pasdoc writes the output file(s) to the current directory.
This switch defines a new output directory -- this makes sense
especially when you have many units and classes, they should get
a subdirectory of their own, e.g. {\tt htmloutput}.
\subsubsection{Read file names from file}
{\tt -S FILE}\\
{\tt --source FILE}\\
If you want pasdoc to write documentation for a large project involving many
unit source code files, you can use this switch to load the file names from
a text file.
Pasdoc expects this file to have one file name in each row, no additional
cleaning is done, so be careful not to include spaces or other whitespace
like tabs.
\subsubsection{Change verbosity level}
{\tt -v LEVEL}\\
{\tt --verbosity LEVEL}\\
Using this switch in combination with an integer number $\geq$ 0 lets you
define the amount of information pasdoc writes to standard output.
The default level is 2, this switch is optional.
A level of 0 will result in no output at all.
\subsubsection{Show help}
{\tt -?}\\
{\tt --help}\\
This switch makes pasdoc print usage hints and supported switches to standard
output (usually the console) and terminates.
\subsubsection{Specify a directive}
\label{specifydirective}
% this subsubsection is present in wiki (on ConditionalDefines page)
{\tt -D DIRECTIVE}\\
{\tt --define DIRECTIVE}\\
Adds {\tt DIRECTIVE} to the list of conditional directives that are present
whenever parsing a unit is started.
The list of directives will be adjusted whenever a directive like {\tt WIN32}
or {\tt FPC} is defined or undefined in the source code. Each define should
be separated by the others by a comma, as shown in the following example:
\begin{verbatim}
pasdoc --define debug,hello,world
\end{verbatim}
\subsubsection{Specify an include file path}
\label{specifyincludefilepath}
% Begin: Sense of this subsubsection is in the wiki docs (on the IncludeInSearchPath page)
{\tt -I DIR}\\
{\tt --include DIR}\\
Adds {\tt DIR} to the list of directories where pasdoc will search for include
files.
Whenever an include file directive is encountered in the source code, pasdoc
first tries to open that include file by the name found in that directive.
This will work in all cases where the current directory contains that include
file or when the file name contains a valid absolute or relative path.
It is possible to use this switch more than once on the command line.
\begin{verbatim}
pasdoc --include c:\mysources\include --include c:\3rdparty\somelib\include
\end{verbatim}
\subsubsection{Specify directive file}
\label{specifydirectives}
% this subsubsection is present in wiki (on ConditionalDefines page)
{\tt -d DIRECTORY}\\
{\tt --conditionals DIRECTORY}\\
Adds the defines specified in a file {\tt DIRECTORY} to the list of conditional directives
that are present whenever parsing a unit is started.
The list of directives will be adjusted whenever a directive like {\tt WIN32}
or {\tt FPC} is defined or undefined in the source code. There should be one
defibe per line in the conditional file.
\begin{verbatim}
pasdoc --conditionals /home/me/pascal/myconditionals
\end{verbatim}
\subsubsection{Set title of document}
{\tt -T "STRING"}\\
{\tt --title "STRING"}\\
This option sets the title of the output document.
The characters in the title should be enclosed in double quotes.
By default, depending on the documentation format, the document
contains either no title, or the name of the unit being documented.
Example:
\begin{verbatim}
pasdoc -T "This is my document title"
\end{verbatim}
\subsubsection{Include uses list}
{\tt --write-uses-list}\\
PasDoc can optionally include the list of units in a unit's uses
clause to that unit's description.
Example:
\begin{verbatim}
pasdoc --write-uses-list
\end{verbatim}
If a unit in the uses list is part of the documentation, it
will be clickable in the output.
By default this option is disabled.
\subsubsection{Full link output}
{\tt --full-link}\\
This option controls the behaviour of "@link(unit.procedure)" type links.
If it is set, the output generated will look like this:
{\tt unit.procedure} with the "unit" part linking to the unit and the
"procedure" part linking to the procedure inside the unit. If it is unset,
then the output will only be {\tt procedure}.
\subsubsection{Non documented switches}
This lists the other unusual switches that are recognized by
pasdoc:
\begin{description}
\item[{\tt -R, --description}] read description from this file
\item[{\tt -C, --content}] Read Contents for HtmlHelp from file
\item[{\tt --numericfilenames}] Causes the html generator to create numeric filenames
\item[{\tt --graphviz-uses}] write a GVUses.gviz file that can be used for the
{\tt dot} program from GraphViz to generate a unit dependency graph.
\item[{\tt --graphviz-classes}] write a GVClasses.gviz file that can be used for the
{\tt dot} program from GraphViz to generate a class hierarchy graph.
\item[{\tt --abbreviations}] abbreviation file, format is "[name] value", value
is trimmed, lines that do not start with '[' (or whitespace before that) are ignored
\item[{\tt --aspell}] enable aspell, giving language as parameter, currently only done in HTML output
\item[{\tt --ignore-words}] When spell-checking, ignore the words in that file.
The file should contain one word on every line, no comments allowed
\item[{\tt --cache-dir}] Cache directory for parsed files (default not set)
\end{description}
\section{Known problems}
\subsection{Documentation of program files}
As was said before, only units are regarded by pasdoc.
In an OOP environment for which pasdoc was written, an application is
usually a class overriding an abstract application class, so all
code that is ever needed in the program file looks like this:
\begin{verbatim}
program main;
uses myapp;
var App: TMyApplication;
begin
App := TMyApplication.Create;
App.Run;
App.Destroy;
end.
\end{verbatim}
So there isn't much to do for documentation.
If you're not using OOP, you could at least try to move as much code
as possible out of the main program to make things work with pasdoc.
\subsection{Records}
% this subsection is no longer relevant, pasdoc handles records perfectly now
Pasdoc cannot create separate documentation for members of a record.
In object-oriented programs, records will not appear most of the time
because all encapsulated data will be part of a class or object.
However, you can give a single explanation on a record type which
could contain a description of all members.
\subsection{Non-unique identifiers}
In some larger projects, identifiers may be used in different contexts,
e.g. as the name for a parameter and as a function name.
Pasdoc will not be able to tell these contexts apart and as a result,
will create in the above-mentioned example links (at least in HTML)
from the argument name of a function to the type of the same name.
\section{Adding support for another output format}
If you want to write a different type of document than those supported,
you can create another unit with a new object type that overrides
{\tt TDocGenerator} from unit {\tt PasDoc\_Gen.pas}.
You'll have to override several of its methods to implement a new
output format.
As examples, you can always look at how the HTML and \LaTeX generators
work.
First of all, you must decide whether your new output format will
store the documentation in one (like \LaTeX) or multiple files
(like HTML).
\section{Credits}
Thanks to Michael van Canneyt, Marco van de Voort, Dan Damian, Philippe
Jean Dit Bailleul, Jeff Wormsley, Johann Glaser, Gudrun Plato, Erwin
Scheuch-Hellig, Iv\'{a}n Montes Velencoso, Mike Ravkin, Jean-Pierre Vial,
Jon Korty, Martin Krumpolec, Andr\'{e} Jager, Samuel Liddicott, Michael
Hess, Ivan Tarapcik, Marc Weustink, Pascal Berger, Rolf Offermanns and
Rodrigo Urubatan Ferreira Jardim for contributing ideas, bug reports and
fixes, help and code!
\end{document}
pasdoc/old_docs/Makefile 0000600 0001750 0001750 00000000167 13034465544 015725 0 ustar michalis michalis default:
@echo 'No default target defined in this Makefile'
clean:
rm -f pasdoc.aux pasdoc.log pasdoc.toc pasdoc.dvi pasdoc/LICENSE 0000600 0001750 0001750 00000043102 13034465544 013500 0 ustar michalis michalis GNU GENERAL PUBLIC LICENSE
Version 2, June 1991
Copyright (C) 1989, 1991 Free Software Foundation, Inc.
59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
Everyone is permitted to copy and distribute verbatim copies
of this license document, but changing it is not allowed.
Preamble
The licenses for most software are designed to take away your
freedom to share and change it. By contrast, the GNU General Public
License is intended to guarantee your freedom to share and change free
software--to make sure the software is free for all its users. This
General Public License applies to most of the Free Software
Foundation's software and to any other program whose authors commit to
using it. (Some other Free Software Foundation software is covered by
the GNU Library General Public License instead.) You can apply it to
your programs, too.
When we speak of free software, we are referring to freedom, not
price. Our General Public Licenses are designed to make sure that you
have the freedom to distribute copies of free software (and charge for
this service if you wish), that you receive source code or can get it
if you want it, that you can change the software or use pieces of it
in new free programs; and that you know you can do these things.
To protect your rights, we need to make restrictions that forbid
anyone to deny you these rights or to ask you to surrender the rights.
These restrictions translate to certain responsibilities for you if you
distribute copies of the software, or if you modify it.
For example, if you distribute copies of such a program, whether
gratis or for a fee, you must give the recipients all the rights that
you have. You must make sure that they, too, receive or can get the
source code. And you must show them these terms so they know their
rights.
We protect your rights with two steps: (1) copyright the software, and
(2) offer you this license which gives you legal permission to copy,
distribute and/or modify the software.
Also, for each author's protection and ours, we want to make certain
that everyone understands that there is no warranty for this free
software. If the software is modified by someone else and passed on, we
want its recipients to know that what they have is not the original, so
that any problems introduced by others will not reflect on the original
authors' reputations.
Finally, any free program is threatened constantly by software
patents. We wish to avoid the danger that redistributors of a free
program will individually obtain patent licenses, in effect making the
program proprietary. To prevent this, we have made it clear that any
patent must be licensed for everyone's free use or not licensed at all.
The precise terms and conditions for copying, distribution and
modification follow.
GNU GENERAL PUBLIC LICENSE
TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
0. This License applies to any program or other work which contains
a notice placed by the copyright holder saying it may be distributed
under the terms of this General Public License. The "Program", below,
refers to any such program or work, and a "work based on the Program"
means either the Program or any derivative work under copyright law:
that is to say, a work containing the Program or a portion of it,
either verbatim or with modifications and/or translated into another
language. (Hereinafter, translation is included without limitation in
the term "modification".) Each licensee is addressed as "you".
Activities other than copying, distribution and modification are not
covered by this License; they are outside its scope. The act of
running the Program is not restricted, and the output from the Program
is covered only if its contents constitute a work based on the
Program (independent of having been made by running the Program).
Whether that is true depends on what the Program does.
1. You may copy and distribute verbatim copies of the Program's
source code as you receive it, in any medium, provided that you
conspicuously and appropriately publish on each copy an appropriate
copyright notice and disclaimer of warranty; keep intact all the
notices that refer to this License and to the absence of any warranty;
and give any other recipients of the Program a copy of this License
along with the Program.
You may charge a fee for the physical act of transferring a copy, and
you may at your option offer warranty protection in exchange for a fee.
2. You may modify your copy or copies of the Program or any portion
of it, thus forming a work based on the Program, and copy and
distribute such modifications or work under the terms of Section 1
above, provided that you also meet all of these conditions:
a) You must cause the modified files to carry prominent notices
stating that you changed the files and the date of any change.
b) You must cause any work that you distribute or publish, that in
whole or in part contains or is derived from the Program or any
part thereof, to be licensed as a whole at no charge to all third
parties under the terms of this License.
c) If the modified program normally reads commands interactively
when run, you must cause it, when started running for such
interactive use in the most ordinary way, to print or display an
announcement including an appropriate copyright notice and a
notice that there is no warranty (or else, saying that you provide
a warranty) and that users may redistribute the program under
these conditions, and telling the user how to view a copy of this
License. (Exception: if the Program itself is interactive but
does not normally print such an announcement, your work based on
the Program is not required to print an announcement.)
These requirements apply to the modified work as a whole. If
identifiable sections of that work are not derived from the Program,
and can be reasonably considered independent and separate works in
themselves, then this License, and its terms, do not apply to those
sections when you distribute them as separate works. But when you
distribute the same sections as part of a whole which is a work based
on the Program, the distribution of the whole must be on the terms of
this License, whose permissions for other licensees extend to the
entire whole, and thus to each and every part regardless of who wrote it.
Thus, it is not the intent of this section to claim rights or contest
your rights to work written entirely by you; rather, the intent is to
exercise the right to control the distribution of derivative or
collective works based on the Program.
In addition, mere aggregation of another work not based on the Program
with the Program (or with a work based on the Program) on a volume of
a storage or distribution medium does not bring the other work under
the scope of this License.
3. You may copy and distribute the Program (or a work based on it,
under Section 2) in object code or executable form under the terms of
Sections 1 and 2 above provided that you also do one of the following:
a) Accompany it with the complete corresponding machine-readable
source code, which must be distributed under the terms of Sections
1 and 2 above on a medium customarily used for software interchange; or,
b) Accompany it with a written offer, valid for at least three
years, to give any third party, for a charge no more than your
cost of physically performing source distribution, a complete
machine-readable copy of the corresponding source code, to be
distributed under the terms of Sections 1 and 2 above on a medium
customarily used for software interchange; or,
c) Accompany it with the information you received as to the offer
to distribute corresponding source code. (This alternative is
allowed only for noncommercial distribution and only if you
received the program in object code or executable form with such
an offer, in accord with Subsection b above.)
The source code for a work means the preferred form of the work for
making modifications to it. For an executable work, complete source
code means all the source code for all modules it contains, plus any
associated interface definition files, plus the scripts used to
control compilation and installation of the executable. However, as a
special exception, the source code distributed need not include
anything that is normally distributed (in either source or binary
form) with the major components (compiler, kernel, and so on) of the
operating system on which the executable runs, unless that component
itself accompanies the executable.
If distribution of executable or object code is made by offering
access to copy from a designated place, then offering equivalent
access to copy the source code from the same place counts as
distribution of the source code, even though third parties are not
compelled to copy the source along with the object code.
4. You may not copy, modify, sublicense, or distribute the Program
except as expressly provided under this License. Any attempt
otherwise to copy, modify, sublicense or distribute the Program is
void, and will automatically terminate your rights under this License.
However, parties who have received copies, or rights, from you under
this License will not have their licenses terminated so long as such
parties remain in full compliance.
5. You are not required to accept this License, since you have not
signed it. However, nothing else grants you permission to modify or
distribute the Program or its derivative works. These actions are
prohibited by law if you do not accept this License. Therefore, by
modifying or distributing the Program (or any work based on the
Program), you indicate your acceptance of this License to do so, and
all its terms and conditions for copying, distributing or modifying
the Program or works based on it.
6. Each time you redistribute the Program (or any work based on the
Program), the recipient automatically receives a license from the
original licensor to copy, distribute or modify the Program subject to
these terms and conditions. You may not impose any further
restrictions on the recipients' exercise of the rights granted herein.
You are not responsible for enforcing compliance by third parties to
this License.
7. If, as a consequence of a court judgment or allegation of patent
infringement or for any other reason (not limited to patent issues),
conditions are imposed on you (whether by court order, agreement or
otherwise) that contradict the conditions of this License, they do not
excuse you from the conditions of this License. If you cannot
distribute so as to satisfy simultaneously your obligations under this
License and any other pertinent obligations, then as a consequence you
may not distribute the Program at all. For example, if a patent
license would not permit royalty-free redistribution of the Program by
all those who receive copies directly or indirectly through you, then
the only way you could satisfy both it and this License would be to
refrain entirely from distribution of the Program.
If any portion of this section is held invalid or unenforceable under
any particular circumstance, the balance of the section is intended to
apply and the section as a whole is intended to apply in other
circumstances.
It is not the purpose of this section to induce you to infringe any
patents or other property right claims or to contest validity of any
such claims; this section has the sole purpose of protecting the
integrity of the free software distribution system, which is
implemented by public license practices. Many people have made
generous contributions to the wide range of software distributed
through that system in reliance on consistent application of that
system; it is up to the author/donor to decide if he or she is willing
to distribute software through any other system and a licensee cannot
impose that choice.
This section is intended to make thoroughly clear what is believed to
be a consequence of the rest of this License.
8. If the distribution and/or use of the Program is restricted in
certain countries either by patents or by copyrighted interfaces, the
original copyright holder who places the Program under this License
may add an explicit geographical distribution limitation excluding
those countries, so that distribution is permitted only in or among
countries not thus excluded. In such case, this License incorporates
the limitation as if written in the body of this License.
9. The Free Software Foundation may publish revised and/or new versions
of the General Public License from time to time. Such new versions will
be similar in spirit to the present version, but may differ in detail to
address new problems or concerns.
Each version is given a distinguishing version number. If the Program
specifies a version number of this License which applies to it and "any
later version", you have the option of following the terms and conditions
either of that version or of any later version published by the Free
Software Foundation. If the Program does not specify a version number of
this License, you may choose any version ever published by the Free Software
Foundation.
10. If you wish to incorporate parts of the Program into other free
programs whose distribution conditions are different, write to the author
to ask for permission. For software which is copyrighted by the Free
Software Foundation, write to the Free Software Foundation; we sometimes
make exceptions for this. Our decision will be guided by the two goals
of preserving the free status of all derivatives of our free software and
of promoting the sharing and reuse of software generally.
NO WARRANTY
11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY
FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN
OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES
PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED
OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS
TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE
PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING,
REPAIR OR CORRECTION.
12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR
REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES,
INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING
OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED
TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY
YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER
PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE
POSSIBILITY OF SUCH DAMAGES.
END OF TERMS AND CONDITIONS
How to Apply These Terms to Your New Programs
If you develop a new program, and you want it to be of the greatest
possible use to the public, the best way to achieve this is to make it
free software which everyone can redistribute and change under these terms.
To do so, attach the following notices to the program. It is safest
to attach them to the start of each source file to most effectively
convey the exclusion of warranty; and each file should have at least
the "copyright" line and a pointer to where the full notice is found.
Copyright (C) 19yy
This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
Also add information on how to contact you by electronic and paper mail.
If the program is interactive, make it output a short notice like this
when it starts in an interactive mode:
Gnomovision version 69, Copyright (C) 19yy name of author
Gnomovision comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
This is free software, and you are welcome to redistribute it
under certain conditions; type `show c' for details.
The hypothetical commands `show w' and `show c' should show the appropriate
parts of the General Public License. Of course, the commands you use may
be called something other than `show w' and `show c'; they could even be
mouse-clicks or menu items--whatever suits your program.
You should also get your employer (if you work as a programmer) or your
school, if any, to sign a "copyright disclaimer" for the program, if
necessary. Here is a sample; alter the names:
Yoyodyne, Inc., hereby disclaims all copyright interest in the program
`Gnomovision' (which makes passes at compilers) written by James Hacker.
, 1 April 1989
Ty Coon, President of Vice
This General Public License does not permit incorporating your program into
proprietary programs. If your program is a subroutine library, you may
consider it more useful to permit linking proprietary applications with the
library. If this is what you want to do, use the GNU Library General
Public License instead of this License.
pasdoc/ChangeLog 0000600 0001750 0001750 00000062712 13237135164 014252 0 ustar michalis michalis 2018-02-08 v0.15.0
* @links to enumerated type members work now.
* New @includeCode tag https://github.com/pasdoc/pasdoc/wiki/IncludeCodeTag
(by Silvio Clécio)
* @longCode and @preformatted improved to better honor indentation.
* parsing "experimental" directive.
* Allow to customize HTML output more, with your own CSS and HTML, by
--html-head, --html-body-begin, --html-body-end command-line params.
* HTML output is now HTML5.
* Add our tools to the binary release: pascal_pre_proc (Pascal preprocessor),
file_to_pascal_data, file_to_pascal_string.
* Improve CSS and HTML, in particular for accessibility and mobile browsers.
Among many improvements, we removed fixed font size in pixels,
changed some tables into divs, and fixed HTML validity around Tipue search box.
* pasdoc_gui uses now default font size on your system.
* Updated Spanish (Spain) translation (by Guillermo Martínez Jiménez)
* Tipue works now more efficiently -- the (potentially large) "index data"
is only loaded on the "Search Results" page.
* Automatic tests rearrangements and simplifications (see tests/run_all_tests.sh).
Authors: Michalis Kamburelis and contributors mentioned above (thank you!).
2015-08-09 v0.14.0
* Many fixes to parsing "deprecated", "platform", "library" directives.
* simplexml output fixes (by Denis Grinyuk)
* The document creation time is not printed in the docs by default.
Use "--include-creation-time" to show it.
--include-creation-time is orthogonal to --exclude-generator.
* The build duration time is not printed in the output by default.
Use "--verbosity 3" to show it.
* Brazilian utf8 translation (by Alexsander da Rosa)
* Upgrade tipue to 3.0.1, update jquery to 2.0.0.
* Fix Delphi compilation (long generated tipue code)
(thanks to Marcos Rocha for investigating)
* Add pasdoc_gui icon (by Karl-Michael Schindler)
* Copyrights and docs fixes (thanks to Paul Gevers)
* Various other small fixes and code cleanups.
2013-07-14 v0.13.0
* Handling of declarations nested inside classes (of other types, classes,
constans and such) (by Arno Garrels)
* Handling HelpInsight comments (by VCejka)
* Parsing Delphi attributes (by VCejka)
* Parsing "final" standard directive (by VCejka)
* Tipue search upgraded to latest Tipue version, fixes problems in
Google Chrome in some cases (by Michalis Kamburelis)
* Parsing of "deprecated", "platform", "library" directives for properties
(by Michalis)
* HTML ouput changes (no more