[Pasdoc-main] [ pasdoc-Bugs-3101524 ] Somtimes log contains strage characters

[SourceForge.net <no...@so...>]

Bugs item #3101524, was opened at 2010-11-02 12:34
Message generated for change (Comment added) made by kambi
You can respond by visiting: 
https://sourceforge.net/tracker/?func=detail&atid=104213&aid=3101524&group_id=4213

Please note that this message will contain a full copy of the comment thread,
including the initial issue submission, for this request,
not just the latest update.
Category: None
Group: 0.12.0
Status: Pending
Resolution: None
Priority: 5
Private: No
Submitted By: Nobody/Anonymous (nobody)
Assigned to: Michalis Kamburelis (kambi)
Summary: Somtimes log contains strage characters

Initial Comment:
I'm using PasDoc for creating either HTML or CHM documentation. Whem I'm creating HTML documentation, the PasDoc's log is correct. But when I'm creating CHM documentation, then log contains strange characers.

My commandline for HTML documentation:
P:\PasDoc\bin\pasdoc.exe --include=. --output p:\Huzar\Doc\doc\ --write-uses-list --title "Huzar Tools" --use-tipue-search --marker : --language pl.cp1250 --format html --full-link --cache-dir p:\Huzar\Doc\doc.cache --implicit-visibility implicit --graphviz-classes --link-gv-classes png *.pas >pasdoc.log

My commandline for CHM documentation:
P:\PasDoc\bin\pasdoc.exe --include=. --output p:\Huzar\Doc\chm\ --write-uses-list --title "Huzar Tools" --use-tipue-search --marker : --language pl.cp1250 --format htmlhelp --full-link --cache-dir p:\Huzar\Doc\chm.cache --name "Huzar Software" --implicit-visibility implicit --graphviz-classes --link-gv-classes png *.pas >pasdoc.log



----------------------------------------------------------------------

>Comment By: Michalis Kamburelis (kambi)
Date: 2010-11-03 16:48

Message:
With new PasDoc 0.12.1, the cache files from the old PasDoc version will be
automatically detected and overridden.

----------------------------------------------------------------------

Comment By: Michalis Kamburelis (kambi)
Date: 2010-11-02 17:27

Message:
Looking more carefully at your command-line, I realized that you use
different cache directories for html and htmlhelp: 
- p:\Huzar\Doc\doc.cache for html
- p:\Huzar\Doc\chm.cache for htmlhelp

This is not needed (you can use the same cache directory for various
output formats, it's guaranteed to work Ok. It's even adviced, to take most
advantage of cache speedup).

This also kind-of confirms my previous suggestion. Inside
p:\Huzar\Doc\chm.cache you probably have old cache files, from previous
pasdoc version. You should remove them. Your html cache uses different
directory, that seemingly had no old cache files.

----------------------------------------------------------------------

Comment By: Michalis Kamburelis (kambi)
Date: 2010-11-02 12:51

Message:
Hm, the strange characters in log appear because you have strange content
in your cache files. The real problem is that our cache reading fails, with
"Warning[2]: Error ESerializedException: Tried loading unknown class"
(followed by a nonsense class name with strange characters).

Do you maybe have cache files from older PasDoc version inside
p:\Huzar\Doc\doc.cache? If yes, then you should delete them. Cache files
between PasDoc releases are incompatible. It may be a pure coincidence that
html generation succeeds without any strange errors. (Admittedly, we should
resolve it better, by placing a nice version marker in cache files and
simply automatically handling this case in pasdoc.)

I tried your commands on PasDoc files, and evereything seems to work here,
if I start from a clear (no files) cache directory:

cd trunk/source/component/
pasdoc --include=. --output /tmp/ --write-uses-list --title "Huzar Tools"
--use-tipue-search --marker : --language pl.cp1250 --format html
--full-link --cache-dir /tmp/cache --implicit-visibility implicit
--graphviz-classes --link-gv-classes png *.pas > pasdoc.log
pasdoc --include=. --output /tmp/ --write-uses-list --title "Huzar Tools"
--use-tipue-search --marker : --language pl.cp1250 --format htmlhelp
--full-link --cache-dir /tmp/cache --name "Huzar Software"
--implicit-visibility implicit --graphviz-classes --link-gv-classes png
*.pas > pasdoc.log

So
1. try deleting all cache files from p:\Huzar\Doc\doc.cache
2. if this doesn't help, you'll have to provide your source files, so that
we can reproduce the problem. Preferably, not your full source code, but a
sample unit / part of the unit that still causes the bug.

----------------------------------------------------------------------

You can respond by visiting: 
https://sourceforge.net/tracker/?func=detail&atid=104213&aid=3101524&group_id=4213