Problem building the documentation

Support - Assistance technique
1

I think the below problem is somehow related to proxy settings - but it is really weird, because it works “sometimes”, that is, it works the first time when Maven downloads all dependencies, but not afterwards.

$ mvn clean docbkx:generate-html

[INFO] Scanning for projects…

[INFO] ------------------------------------------------------------------------

[INFO] Building DHIS 2 Documentation

[INFO] task-segment: [clean, docbkx:generate-html]

[INFO] ------------------------------------------------------------------------

[INFO] [clean:clean {execution: default-clean}]

[INFO] Deleting directory c:\docs2\dhis2-docbook-docs\target

[INFO] [docbkx:generate-html {execution: default-cli}]

[WARNING] Failed to find catalog files.

[INFO] Processing dhis2_user_man_mod3.xml

Error

Failure reading c:\docs2\dhis2-docbook-docs\src\docbkx\en\dhis2_user_man_mod3.xml: Connection timed out: connect

[INFO] ------------------------------------------------------------------------

[ERROR] BUILD ERROR

[INFO] ------------------------------------------------------------------------

[INFO] Failed to transform dhis2_user_man_mod3.xml.

Embedded error: Failure reading c:\docs2\dhis2-docbook-docs\src\docbkx\en\dhis2_user_man_mod3.xml

Connection timed out: connect

···

–
Cheers,
Knut Staring

2

I have seen this several times on Linux as well. No idea what causes it.

I seemed to be able to solve it on Linux by "touch
dhis2_user_man_mod3.xml" once (but not a second time), and another
time by opening the file, and saving it with no alterations. No clue
why. There seems to be some sort of cache. I have noticed that docbkx
will not build files that are unmodified and present in the "target"
directory. Again, I am not sure if these phenomena are related, just
some spooky observations about maven's magic. Perhaps it is a bit like
D&D, and the spell does not always work unless the roll of the dice is
high enough.

Maven does not provide any decent feedback. Is there a way to increase
the debugging levels to maybe see what the actual issue is?

Regards,
Jason

···

On Mon, Nov 2, 2009 at 8:33 PM, Knut Staring <knutst@gmail.com> wrote:

I think the below problem is somehow related to proxy settings - but it is
really weird, because it works "sometimes", that is, it works the first time
when Maven downloads all dependencies, but not afterwards.
$ mvn clean docbkx:generate-html
[INFO] Scanning for projects...
[INFO]
------------------------------------------------------------------------
[INFO] Building DHIS 2 Documentation
[INFO] task-segment: [clean, docbkx:generate-html]
[INFO]
------------------------------------------------------------------------
[INFO] [clean:clean {execution: default-clean}]
[INFO] Deleting directory c:\docs2\dhis2-docbook-docs\target
[INFO] [docbkx:generate-html {execution: default-cli}]
[WARNING] Failed to find catalog files.
[INFO] Processing dhis2_user_man_mod3.xml
Error
Failure reading
c:\docs2\dhis2-docbook-docs\src\docbkx\en\dhis2_user_man_mod3.xml:
Connection timed out: connect
[INFO]
------------------------------------------------------------------------
[ERROR] BUILD ERROR
[INFO]
------------------------------------------------------------------------
[INFO] Failed to transform dhis2_user_man_mod3.xml.
Embedded error: Failure reading
c:\docs2\dhis2-docbook-docs\src\docbkx\en\dhis2_user_man_mod3.xml
Connection timed out: connect
--
Cheers,
Knut Staring

_______________________________________________
Mailing list: https://launchpad.net/~dhis2-devs
Post to : dhis2-devs@lists.launchpad.net
Unsubscribe : https://launchpad.net/~dhis2-devs
More help : https://help.launchpad.net/ListHelp

3

It seems proxy and/or setup related - I have no problem on my laptop (bypassing the proxy).

Knut

···

On Mon, Nov 2, 2009 at 7:50 PM, Jason Pickering jason.p.pickering@gmail.com wrote:

I have seen this several times on Linux as well. No idea what causes it.

I seemed to be able to solve it on Linux by "touch

dhis2_user_man_mod3.xml" once (but not a second time), and another

time by opening the file, and saving it with no alterations. No clue

why. There seems to be some sort of cache. I have noticed that docbkx

will not build files that are unmodified and present in the “target”

directory. Again, I am not sure if these phenomena are related, just

some spooky observations about maven’s magic. Perhaps it is a bit like

D&D, and the spell does not always work unless the roll of the dice is

high enough.

Maven does not provide any decent feedback. Is there a way to increase

the debugging levels to maybe see what the actual issue is?

Regards,

Jason

On Mon, Nov 2, 2009 at 8:33 PM, Knut Staring knutst@gmail.com wrote:

I think the below problem is somehow related to proxy settings - but it is

really weird, because it works “sometimes”, that is, it works the first time

when Maven downloads all dependencies, but not afterwards.

$ mvn clean docbkx:generate-html

[INFO] Scanning for projects…

[INFO]

[INFO] Building DHIS 2 Documentation

[INFO] task-segment: [clean, docbkx:generate-html]

[INFO]

[INFO] [clean:clean {execution: default-clean}]

[INFO] Deleting directory c:\docs2\dhis2-docbook-docs\target

[INFO] [docbkx:generate-html {execution: default-cli}]

[WARNING] Failed to find catalog files.

[INFO] Processing dhis2_user_man_mod3.xml

Error

Failure reading

c:\docs2\dhis2-docbook-docs\src\docbkx\en\dhis2_user_man_mod3.xml:

Connection timed out: connect

[INFO]

[ERROR] BUILD ERROR

[INFO]

[INFO] Failed to transform dhis2_user_man_mod3.xml.

Embedded error: Failure reading

c:\docs2\dhis2-docbook-docs\src\docbkx\en\dhis2_user_man_mod3.xml

Connection timed out: connect

–

Cheers,

Knut Staring

Mailing list: https://launchpad.net/~dhis2-devs

Post to : dhis2-devs@lists.launchpad.net

Unsubscribe : https://launchpad.net/~dhis2-devs

More help : https://help.launchpad.net/ListHelp

–
Cheers,
Knut Staring