Euphoria
Ticket #449:
cannot build documentation
-
Reported by
SDPringle
Nov 27, 2010
E:\euphoria-dev\source>wmake -h htmldoc
eui.exe E:\euphoria-dev\source\eudoc\creole\creolehtml.ex -A=ON -t=E:\euphoria-d
ev\docs\offline-template.html -oE:\build\head\html E:\build\head\euphoria.txt
*** Failed to load template from 'E:\euphoria-dev\docs\offline-template.html'
Error(E42): Last command making (E:\build\head\html\index.html) returned a bad s
tatus
Error(E02): Make execution terminated
Details
1. Comment by jimcbrown
Nov 27, 2010
Assuming e:\euphoria-dev is your checkout of trunk, docs\offline-template.html should exist.
If it's missing, just do an svn up to get it back.
If e:\euphoria-dev is not your trunk, then there is some sort of configuration problem that's causing creolehtml and eudoc to look for it in the wrong place.
2. Comment by SDPringle
Nov 27, 2010
It does:
E:\euphoria-dev\source>dir e:\euphoria-dev\docs\offline-template.html
El volumen de la unidad E no tiene etiqueta.
El n?mero de serie del volumen es: 1C45-D1B4
Directorio de e:\euphoria-dev\docs
23/11/2010 10:38 a.m. 1.412 offline-template.html
1 archivos 1.412 bytes
0 dirs 1.829.363.712 bytes libres
3. Comment by SDPringle
Nov 27, 2010
Jim. Please don't just mark invalid without checking first your own machine.
4. Comment by jeremy
Nov 27, 2010
Mine use to work, but it's trying to execute eudoc.ex now for some reason, where did it get that from?
5. Comment by SDPringle
Nov 27, 2010
eudoc.ex or eudoc.exe processes the euphoria text and includes to make euphoria.txt. The eudoc.ex works fine in the HEAD version as long as EUDIR is set to the trunk and not some other directory. Then creolehtml makes html from that. The HEAD of creolehtml for some reason doesn't see the template or at least it takes the branch that says it doesn't.
6. Comment by jeremy
Nov 27, 2010
What I am saying is that something changed. It didn't use to call:
C:\Development\Projects\Euphoria\bin\eudoc.ex -blah -blah -blah
It was always eudoc.exe. Calling eudoc.ex isn't going to work right now unless you have file associations setup. The executable should be called.
7. Comment by SDPringle
Nov 27, 2010
The Makefile is putting the full path of the template and the script is prepending .\ before opening. This is confusing things. This happens in kanarie.e line 448.
For eudoc.ex try 'configure' again.
8. Comment by jeremy
Nov 27, 2010
4302 gets one step closer to making docs build, I removed the auto-detection stuff from configure.bat as it requires optional arguments to be passed to configure.bat. Now it will just use the good old system path to find eudoc.exe and creolehtml.exe.
I do get the error (now) that Shawn is getting:
creolehtml.exe -A=ON -t=C:\Development\Projects\euphoria\docs\offline-template.html \
-oC:\Development\Projects\euphoria\build\html \
C:\Development\Projects\euphoria\build\euphoria.txt
*** Failed to load template from 'C:\Development\Projects\euphoria\docs\offline-template.html'
Error(E42): Last command making (C:\Development\Projects\euphoria\build\html\index.html) returned a bad status
Error(E02): Make execution terminated
C:\Development\Projects\euphoria\source>dir C:\Development\Projects\euphoria\docs\offline-template.html
Volume in drive C has no label.
Volume Serial Number is B06C-243C
Directory of C:\Development\Projects\euphoria\docs
11/25/2010 07:38 PM 1,412 offline-template.html
1 File(s) 1,412 bytes
0 Dir(s) 475,190,964,224 bytes free
9. Comment by jeremy
Nov 27, 2010
I'm failing at getting it to work. I did find that:
C:\Development\Projects\Euphoria\build> creolehtml -A=ON -t..\docs\template.html -odocs euphoria.txt
That works, but it seems nothing I did from the makefile would work. I'll bet paths are getting all screwed up somewhere, maybe extra slashes or something.
10. Comment by jeremy
Nov 27, 2010
I take that back. That made it to where the error does not appear but there is no output. %ERRORLEVEL% is -1 when it finishes.
11. Comment by jeremy
Nov 27, 2010
I rebuild euphoria totally, rebuild creolehtml w/latest euc and still the same problem.
12. Comment by jeremy
Nov 28, 2010
This was actually a creolehtml bug, it was not loading the template file correctly. This has been fixed.
13. Comment by SDPringle
Nov 28, 2010
Wrong again Jeremy. This was a Make problem. We needed to supply a -d switch to creolehtml but it wasn't being supplied. I will add an error message to kearnie.e
14. Comment by jeremy
Nov 28, 2010
The -d is not required any longer. CreoleHTML was not setting the template directory from the filename. It now does. The -d is not required.