Fix building of tip and 5.0 API docs

RESOLVED FIXED in Bugzilla 5.0

Status

()

RESOLVED FIXED
4 years ago
4 years ago

People

(Reporter: gerv, Assigned: gerv)

Tracking

Bugzilla 5.0
Bug Flags:
approval +
approval5.0 +

Details

Attachments

(2 attachments)

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
Created attachment 8532266 [details] [diff] [review]
Patch v.1
Assignee: website → gerv
Status: NEW → ASSIGNED
Attachment #8532266 - Flags: review?(dkl)
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 on attachment 8532266 [details] [diff] [review]
Patch v.1

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

r=dkl
Attachment #8532266 - Flags: review?(dkl) → review+

Updated

4 years ago
Flags: approval5.0+
Flags: approval+
OS: Linux → All
Hardware: x86 → All
To ssh://gitolite3@git.mozilla.org/bugzilla/bugzilla.git
   d41a0a7..b6f9478  master -> master

To ssh://gitolite3@git.mozilla.org/bugzilla/bugzilla.git
   06033dc..9b55aa0  5.0 -> 5.0

Gerv
Status: ASSIGNED → RESOLVED
Last Resolved: 4 years ago
Resolution: --- → FIXED
Oops, there's more to do here.

Gerv
Status: RESOLVED → REOPENED
Resolution: FIXED → ---
Created attachment 8532681 [details] [diff] [review]
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
Attachment #8532681 - Flags: review?(dkl)

Updated

4 years ago
Target Milestone: --- → Bugzilla 5.0
Comment on attachment 8532681 [details] [diff] [review]
Patch B v.1

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

r=dkl
Attachment #8532681 - Flags: review?(dkl) → review+
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
Status: REOPENED → RESOLVED
Last Resolved: 4 years ago4 years ago
Resolution: --- → FIXED
You need to log in before you can comment on or make changes to this bug.