498687 - makedocs fails under Windows

Status: RESOLVED FIXED

(Bugzilla :: Documentation, defect, P4)

Description

[Eric Olson]

User-Agent:       Mozilla/5.0 (Windows; U; Windows NT 5.1; en-US; rv:1.9.0.11) Gecko/2009060215 Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1) (.NET CLR 3.5.30729)
Build Identifier: 3.2.2

Running makedocs to compile the documentation fails under Windows.

1. There is a call to MadeDocs that copies a file that contains UNIX-only syntax: MakeDocs(undef, 'cp ../bugzilla.ent ./xml/')

2. Jade appears to be a prerequisite, but I haven't been able to find a Windows implementation. It's not even made clear that this *is* a prerequisite to build the Bugzilla Guide.


Reproducible: Always

Comment 1

[Frédéric Buclin]

Known bug, but doesn't seem to be filed yet.

Comment 2

[Max Kanat-Alexander]

Yeah, we're unlikely to ever fix this, since as you pointed out, the requirements to build the docs don't seem to exist on Windows.

Comment 3

[Frédéric Buclin]

API doc can be compiled without any problem on Windows, so we may add some code which only lets you compile the API doc and stops without throwing errors, as we did for install-module.pl.

Comment 4

[Gervase Markham [:gerv]]

We no longer use this system to compile the docs. I believe that the current system does, or should, work under Windows.

Gerv

Comment 5

[Frédéric Buclin]

(In reply to Gervase Markham [:gerv] from comment #4)
> I believe that the current system does, or should, work under Windows.

If it should work on Windows but doesn't, then I don't see how this bug can be closed as wontfix.

Comment 6

[Frédéric Buclin]

makedocs.pl now works correctly on Windows.