Dave Miller [:justdave] Assignee
	Description • 17 years ago

Bug 182975 reorganized the way the documentation source files were organized in CVS.  This change broke some basic assumptions made by the website build scripts, and as a consequence, the docs for the tip and the 3.2 branch never make it to the live website (what you see there now is essentially a static copy that was generated before the changes were made in CVS).

I could swear there was a bug filed on this a week or so after the above-mentioned change, but I can't find it, and the site is still broken.  Maybe my memory is just shot.

	Gervase Markham [:gerv]
	Comment 1 • 16 years ago

Dave: can you be more specific about where the script is that needs fixing? Is this a big job?

The installation list is also not updating.

Gerv

	Dave Miller [:justdave] Assignee
	Comment 2 • 16 years ago

Basically, the script was assuming that the completed built docs would be in docs/html within the bugzilla checkout, and that's no longer the case (they're in docs/{lang}/html now).

Something in the last RHEL4 update seems to have broken texpdf on mradm01 and that's jammed up the rest of the build script too (so it just hangs and never releases the build lock).

I bit the bullet this morning and moved this over to mradm02 (RHEL5 box).  While I was at it, I went ahead and fixed the rest of this, too.

	Dave Miller [:justdave] Assignee
	Comment 3 • 16 years ago

This is already live in production, the site should be updating based on the results of running this in the next hour or so.

	Dave Miller [:justdave] Assignee
	Comment 4 • 16 years ago

Seems the docs for versions 2.18 and below no longer build, and just it just hangs when it tries to build the PDF document.

Since those branches are no longer updated anyway, I have further changes coming to just use the existing static files for those branches instead of attempting to build them.

	Dave Miller [:justdave] Assignee
	Comment 5 • 16 years ago

Checking for the initial patch, since it's basically two separate problems, just to keep them distinct:

Checking in bin/build;
/www/bugzilla-org/bin/build,v  <--  build
new revision: 1.4; previous revision: 1.3
done
Checking in bin/build-docs.pl;
/www/bugzilla-org/bin/build-docs.pl,v  <--  build-docs.pl
new revision: 1.4; previous revision: 1.3
done
Checking in bin/build_full;
/www/bugzilla-org/bin/build_full,v  <--  build_full
new revision: 1.2; previous revision: 1.1
done

	Gervase Markham [:gerv]
	Comment 6 • 16 years ago

How often does this script run? I made an update three hours ago and it's still not showing up.

Gerv

	Dave Miller [:justdave] Assignee
	Comment 7 • 16 years ago

Every 15 minutes, but it's also behind a caching proxy, and popular pages can take up to 3 hours to expire from cache.

The script is also still broken, last I checked, the docs part just hangs.  I thought I'd disabled the docs build part in favor of keeping the rest of the site up to date, but maybe something else broke, too.  I'll check.

	Dave Miller [:justdave] Assignee
	Comment 8 • 16 years ago

Here's the rest of the changes, it appears to be working now except for the docs build getting wonky once in a great while (but it works most of the time).

	Dave Miller [:justdave] Assignee
	Comment 9 • 16 years ago

Checking in bin/build-docs.pl;
/www/bugzilla-org/bin/build-docs.pl,v  <--  build-docs.pl
new revision: 1.5; previous revision: 1.4
done
Checking in bin/build_full;
/www/bugzilla-org/bin/build_full,v  <--  build_full
new revision: 1.3; previous revision: 1.2
done

	Dave Miller [:justdave] Assignee
	Comment 10 • 16 years ago

one more fix...  need the stylesheet :)

Index: build-docs.pl
===================================================================
RCS file: /www/bugzilla-org/bin/build-docs.pl,v
retrieving revision 1.5
diff -u -r1.5 build-docs.pl
--- build-docs.pl	9 Jul 2008 20:16:23 -0000	1.5
+++ build-docs.pl	10 Jul 2008 04:13:46 -0000
@@ -45,6 +45,9 @@
         mkdir $docs_dir unless -d $docs_dir;
         my @docdirs;
         my $docs_base = "docs";
+        if (-e "$docs_base/style.css") {
+            system("/bin/cp","$docs_base/style.css","$docs_dir/");
+        }
         if (-d "$docs_base/xml") {
             push(@docdirs, "$docs_base");
         }

Checking in build-docs.pl;
/www/bugzilla-org/bin/build-docs.pl,v  <--  build-docs.pl
new revision: 1.6; previous revision: 1.5
done