1107629 - Fix building of tip and 5.0 API docs

Status: RESOLVED FIXED

(Bugzilla :: bugzilla.org, defect)

Description

[Gervase Markham [:gerv]]

Bug 1105824 fixed the 4.2 and 4.4 docs by disabling the building of tip - because the builder doesn't have the necessary software installed. However, this means the tip API docs are not being built. And we need a line for 5.0 too.

We need to do the following things:

* Remove "use Bugzilla;" from makedocs.pl on trunk and 5.0. This line was added by dkl when he added his new API docs, but it seems it's not actually necessary - it works without.

* Change the file which defines which branches are built to have a "pod-only" option and make the build system pass "--pod-only" to makedocs.pl when that option is set.

* Edit that file to make tip and the 5.0 branch build pod-only.

* Edit the website to add a new line for the 5.0 docs.

Gerv

Comment 1

[Gervase Markham [:gerv]]

Attachment: Patch v.1

Comment 2

[Gervase Markham [:gerv]]

Looks like the rest of this was actually done in bug 961755. So we just need to remove the "use Bugzilla", and then re-update the docs.versions file to build the trunk and now 5.0 as well.

Gerv

Comment 3

[David Lawrence [:dkl]]

Comment on attachment 8532266 [details] [diff] [review]
Patch v.1

Review of attachment 8532266 [details] [diff] [review]:
-----------------------------------------------------------------

r=dkl

Comment 4

[Gervase Markham [:gerv]]

To ssh://[e-mail]/bugzilla/bugzilla.git
   d41a0a7..b6f9478  master -> master

To ssh://[e-mail]/bugzilla/bugzilla.git
   06033dc..9b55aa0  5.0 -> 5.0

Gerv

Comment 5

[Gervase Markham [:gerv]]

Oops, there's more to do here.

Gerv

Comment 6

[Gervase Markham [:gerv]]

Attachment: Patch B v.1

Website patch to re-enable tip. It will restore the tip docs, although because we are no longer updating bzr trunk, they will be frozen where they are until we do a git-based build system (bug 1108076).

Gerv

Comment 7

[David Lawrence [:dkl]]

Comment on attachment 8532681 [details] [diff] [review]
Patch B v.1

Review of attachment 8532681 [details] [diff] [review]:
-----------------------------------------------------------------

r=dkl

Comment 8

[Gervase Markham [:gerv]]

Checking in etc/docs-versions;
/www/bugzilla-org/etc/docs-versions,v  <--  docs-versions
new revision: 1.12; previous revision: 1.11
done

Work continues in bug 1108076.

Gerv