History | Log In     View a printable version of the current page.  
Issue Details (XML | Word | Printable)

Key: LPP-3720
Type: Bug Bug
Status: Closed Closed
Resolution: Fixed
Priority: P1 P1
Assignee: Benjamin Shine
Reporter: Jim Grandy
Votes: 0
Watchers: 0
Operations

If you were logged in you would be able to see more operations.
OpenLaszlo

Refguide is being built twice on build machines.

Created: 15/Mar/07 01:34 PM   Updated: 20/Dec/07 01:17 PM
Component/s: Doc Tools
Affects Version/s: 4.0.0
Fix Version/s: RingDing (4.1), RingDingTools (4.1 Ref Guide + Tools)

Time Tracking:
Not Specified

Severity: Minor
Fixed in Change#: 7,396
Runtime: N/A
Fix in hand: False


 All   Comments   Work Log   Change History      Sort Order: Ascending order - Click to sort in descending order
Mark Davis - 17/Mar/07 06:05 PM
this is an internal tools issue and doesn't warrant a release note

Amy Muntz - 17/Oct/07 03:08 PM
Mamye - can you verify/close this? Thanks.

Mamye Kratt - 18/Oct/07 01:21 PM
(trunk (4.1.x) r6893)
Checked on linux-builder and it is building twice.

Mamye Kratt - 18/Oct/07 01:22 PM
Amy, please assign. Thanks.

Benjamin Shine - 26/Oct/07 05:51 PM
This issue is not actually preventing work or the builds from getting done, so I'm de-prioritizing it.

Benjamin Shine - 05/Nov/07 08:24 PM
Fix sent to ptw for review: Change 20071105-ben-M Summary: Add a check to only build doc if it hasn't already been built

Benjamin Shine - 07/Nov/07 11:50 AM
(Note that this is fixed in trunk!)
------------------------------------------------------------------------
r7183 | ben | 2007-11-07 11:48:40 -0800 (Wed, 07 Nov 2007) | 26 lines
Changed paths:
   M /openlaszlo/trunk/build.xml

Change 20071105-ben-M by ben@slim.local on 2007-11-05 10:58:31 PST
    in /Users/ben/src/svn/openlaszlo/trunk
    for http://svn.openlaszlo.org/openlaszlo/trunk

Summary: Add a check to only build doc if it hasn't already been built

New Features: faster distro build

Bugs Fixed: LPP-3720 Refguide is being built twice on build machines.

Technical Reviewer: ptw
QA Reviewer: mkratt (pending)

Documentation:
The dist-one target in build.xml previously built the documentation twice,
which slowed down the build by >20 minutes, depending on architecture.
This fix prevents the doc from building twice in the same invocation of
ant, by setting a property doc.build.done after building the docs.

Tests:
Run ant dist-one in the nightly build. Search for docs/reference/index.html
in the output. Before this change, it appeared twice, indicating that the
docs had built twice. After this change, it only appears once, indicating
that the docs only built once.

Mamye Kratt - 14/Nov/07 03:11 PM
(trunk4 build r7263)
doc is still building twice on the server.

Benjamin Shine - 26/Nov/07 06:07 PM
I just checked in another fix for this.

r7378 | ben | 2007-11-26 18:05:53 -0800 (Mon, 26 Nov 2007) | 36 lines
Changed paths:
   M /openlaszlo/trunk/build.xml

Change 20071126-ben-o by ben@slim.local on 2007-11-26 17:12:03 PST
    in /Users/ben/src/svn/openlaszlo/trunk-docbuild
    for http://svn.openlaszlo.org/openlaszlo/trunk

Summary: Make doc build only build once on build machines.

Bugs Fixed: LPP-3270 Refguide is being built twice on build machines

Documentation:
The doc build takes a lot of time, and doesn't work well on windows,
at the moment, so we want fine control over when exactly to build it.
This change adds logic so that we won't build the doc if we've
already built it in this invocation of ant, if we're running on
a windows box, or if we've set skip.doc to true.

As before, if you just call
$ ant doc
it should build the doc.

To skip building the doc, pass in -Dskip.doc=true, like this:
$ ant -Dskip.doc=true build

Most importantly, calling ant dist-one should build the docs
exactly once.

Tests:
Run ant dist-one in the nightly build. Search for docs/reference/index.html
in the output. Before this change, it appeared twice, indicating that the
docs had built twice. After this change, it only appears once, indicating
that the docs only built once.

Also, verify that the windows build succeeded, and that it did not
try to build the docs.



Benjamin Shine - 27/Nov/07 05:06 PM
r7396 | ben | 2007-11-27 17:04:50 -0800 (Tue, 27 Nov 2007) | 35 lines
Changed paths:
   M /openlaszlo/trunk/build.xml

Change 20071127-ben-L by ben@slim.local on 2007-11-27 16:56:09 PST
    in /Users/ben/src/svn/openlaszlo/trunk-work-11-27-07-noon
    for http://svn.openlaszlo.org/openlaszlo/trunk

Summary: Continued tweaks to the don't-build-doc-twice-in-nightly-build fix

Bugs Fixed: (again, I hope) LPP-3270 reference builds twice on nightly build

Technical Reviewer: ptw (pending)
QA Reviewer: mkratt (pending)

Documentation:
When calling an ant target from script in an ant file, as I do in the
"doc" target, it is a good idea to be thorough, if one wants the code
to work on a variety of architectures. To accomplish this, we explicitly
request a local variable for the ant tasks we are creating
programmatically. This apparently keeps the parent build alive long
enough that when the child build completes, the parent build can
continue. Without explicitly saying "var myTask..." the parent
build would terminate as soon as it invokes the child build,
and we'd never get to finish the parent build.

As before, the doc should not build if skip.doc is true, if
the doc has already been built, or if the OS is windows.

Tests:
Run a nightly build. It should work, and the doc should only be
built once.
Already verified on linux-builder that we get through building
the doc and on to the next task, checking for tabs. (In my
environment, checking for tabs failed because I didn't have
the path to python correct, but that's not what we're
worrying about right now.)

Benjamin Shine - 27/Nov/07 05:07 PM
Before closing this, please verify that this works in the first build for trunk after r7396.

Benjamin Shine - 12/Dec/07 03:38 PM
This is fixed, really fixed, conclusively fixed.

Benjamin Shine - 20/Dec/07 01:17 PM
This is so fixed.