Sign in Join

Live chat for Free Pascal, Lazarus, Delphi and every Pascal programmer.

Mailing lists / lazarus / 2013-08

LCL chms pipe dream part n

6 messages · 3 people · –

Reply by email Subscribe to this list Your subscription

Read-only archive. Use j and k to move between messages.

Reinier Olislagers

FPC trunk, Lazarus trunk, Windows

Tried to fix fpcup not generating LCL chm docs.
It uses build_lcl_docs.exe to do that.

Found out that fpdoc is complaining about a missing .css file: Writing 19901 pages...
Exception at 00441644: Exception:
Can't find CSS file "..\fpdoc.css".
306 Warnings hidden. Use --warnings to see them all.

Fiddled with the --arg options like this to pass the path cd C:\Development\lazarus\docs\chm
C:\development\lazarus\docs\html\build_lcl_docs.exe "--fpcdocs" "C:\development\lazarus\docs\chm\" "--fpdoc"
"C:\development\fpctrunk\bin\i386-win32\fpdoc.exe" "--arg css-file=C:\development\fpctrunk\utils\fpdoc\fpdoc.css " "--outfmt" "chm" gives this error message from fpdoc
Ignoring unknown option
"css-file=C:\development\fpctrunk\utils\fpdoc\fpdoc.css"

.. but same error
doing this
"--arg --css-file=C:\development\fpctrunk\utils\fpdoc\fpdoc.css" doesn't help either.

Any suggestions [1]?
Has anybody gotten build_lcl_docs to work?

Thanks,
Reinier

[1] I remember having a big discussion on fpc about where to place .css files; apparently the way things are now are as they should be so I'm not really interested in any fixes that involve changing the fpdoc source code/fpc directory layout.

Reply by email

waldo kitty
to Reinier Olislagers
Reinier Olislagers wrote 17 lines
FPC trunk, Lazarus trunk, Windows Tried to fix fpcup not generating LCL chm docs. It uses build_lcl_docs.exe to do that. Found out that fpdoc is complaining about a missing .css file: Writing 19901 pages... Exception at 00441644: Exception: Can't find CSS file "..\fpdoc.css". 306 Warnings hidden. Use --warnings to see them all. Fiddled with the --arg options like this to pass the path cd C:\Development\lazarus\docs\chm C:\development\lazarus\docs\html\build_lcl_docs.exe "--fpcdocs" "C:\development\lazarus\docs\chm\" "--fpdoc" "C:\development\fpctrunk\bin\i386-win32\fpdoc.exe" "--arg css-file=C:\development\fpctrunk\utils\fpdoc\fpdoc.css " "--outfmt" "chm"

i notice the above has a trailing space after fpdoc.css...

Show quoted text 8 lines
gives this error message from fpdoc Ignoring unknown option "css-file=C:\development\fpctrunk\utils\fpdoc\fpdoc.css" .. but same error doing this "--arg --css-file=C:\development\fpctrunk\utils\fpdoc\fpdoc.css" doesn't help either.

maybe just one dash?

-css-file=blah

does the build_lcl_docs.exe give any hints or --help?

NOTE: No off-list assistance is given without prior approval. Please keep mailing list traffic on the list unless private contact is specifically requested and granted.

Reply by email

Marco van de Voort
to Reinier Olislagers: FPC trunk, Lazarus trunk, Windows Tried to fix fpcup not generating LCL chm docs. It uses…
Reinier Olislagers wrote 8 lines
.. but same error doing this "--arg --css-file=C:\development\fpctrunk\utils\fpdoc\fpdoc.css" doesn't help either. Any suggestions [1]? Has anybody gotten build_lcl_docs to work?

I typically use build_lcl_html.sh. IIRC I played with chm_docs too last time, and that worked.

[1] I remember having a big discussion on fpc about where to place .css files; apparently the way things are now are as they should be so I'm not really interested in any fixes that involve changing the fpdoc source code/fpc directory layout.

The fpcdoc repository makefile has support for it there. The html is afaik generated with a path to the root of the CHM file, and the --css-file param places it there. So maybe that is about html, and not CHM.

Reply by email

Reinier Olislagers
to waldo kitty: i notice the above has a trailing space after fpdoc.css... maybe just one dash?…
waldo kitty wrote
On 8/2/2013 07:23, Reinier Olislagers wrote: > FPC trunk, Lazarus trunk, Windows i notice the above has a trailing space after fpdoc.css...

Yes, so did I. If it isn't there, fpdoc barfs with an unrecognized options error.

Show quoted text 6 lines
> .. but same error > doing this > "--arg --css-file=C:\development\fpctrunk\utils\fpdoc\fpdoc.css" > doesn't help either. maybe just one dash?

Why? the option is two dashes if you directly call fpdoc

does the build_lcl_docs.exe give any hints or --help?

Do you really think I didn't look there first?

Reply by email

waldo kitty
to Reinier Olislagers
Reinier Olislagers wrote 6 lines
On 02/08/2013 16:30, waldo kitty wrote: > On 8/2/2013 07:23, Reinier Olislagers wrote: >> FPC trunk, Lazarus trunk, Windows > i notice the above has a trailing space after fpdoc.css... Yes, so did I. If it isn't there, fpdoc barfs with an unrecognized options error.

interesting...

Show quoted text 7 lines
>> .. but same error >> doing this >> "--arg --css-file=C:\development\fpctrunk\utils\fpdoc\fpdoc.css" >> doesn't help either. > > maybe just one dash? Why? the option is two dashes if you directly call fpdoc

i didn't try... perhaps it is the ordering of the parameters fed to that executable? it shouldn't be but stranger things have been seen...

> does the build_lcl_docs.exe give any hints or --help? Do you really think I didn't look there first?

hehehe... i didn't know if you had or not so i asked the obvious question ;)

NOTE: No off-list assistance is given without prior approval. Please keep mailing list traffic on the list unless private contact is specifically requested and granted.

Reply by email

Reinier Olislagers
to waldo kitty: i notice the above has a trailing space after fpdoc.css... maybe just one dash?…
waldo kitty wrote
On 8/2/2013 07:23, Reinier Olislagers wrote: does the build_lcl_docs.exe give any hints or --help?

Well, waldo, your crystal ball worked ;)

Had another look at the build_lcl_docs source code and found a hardcoded --css-file value that probably is no longer valid because of changed fpc directory layout.

Wrote and tested a patch that allows you to specify a parameter to override the default.

http://bugs.freepascal.org/view.php?id=24823

Thanks,
Reinier

Reply by email