Re: Procedure for generating Javadoc and User Guide

Wed, 13 Jan 2010 08:13:09 -0800 

Hi Matthias,
Thanks for the offer. I was able to generate the pdf. The issue that Mark and I are discussing is the generation of html, which I don't need. 

Thanks again,

David

Matthias Wessendorf wrote:

Hey David,

should we generate the doc for you? As a tmp work-around ? :)

-M

On Wed, Jan 13, 2010 at 4:35 PM, David Ezzio <[email protected]> wrote:

Hi Mark,

I run it from the command line.

Don't know anything about "offline" mode.  I use maven for other projects.
 But I have found that docbook generation has always been an issue.  Others
that I work with have also found it to be problematic.

The only setting that I change in my settings.xml configuration file is to
set the location of my local repository, overriding the default which I find
suboptimal on Windows.

I initially used maven 2.0.8, but now with OWB, I am using 2.2.1.  I also am
using Java 1.6.0_10.

Thanks for digging into this,

David



Mark Struberg wrote:

do you run maven from the commandline or from an IDE?
Maybe the 'offline' mode is activated somehow?

Another option: do you have
<remoteresources.skip>true</remoteresources.skip>
in one of your settings.xml or defined as property?

LieGrue,
strub

--- On Tue, 1/12/10, David Ezzio <[email protected]> wrote:


From: David Ezzio <[email protected]>
Subject: Re: Procedure for generating Javadoc and User Guide
To: [email protected]
Date: Tuesday, January 12, 2010, 9:37 PM
Hi Jean-Louis,

I am not behind a corporate firewall.  For that
reason, I don't know why I would require a proxy.  And if I did, I have
no idea
what proxy it would be.

Any other ideas?

David

Jean-Louis MONTEIRO wrote:

Hi,

As suggested by Matthias, did you get a try adding

-Dhttp.proxyHost=<host>

-Dhttp.proxyPort=<port> ?
It should solve your problem.

JLouis

2010/1/12 David Ezzio <[email protected]>


Hi Gurkan and Jean-Louis,

After updating to latest, and clearing out my

docbook entries in my local

repository, I was able to get the following to

work in webbeans-doc.

mvn docbkx:generate-pdf

However, the generation of html, which follows

when invoking with clean

compile, failed with the following:

[INFO] [docbkx:generate-html {execution:

single-html-page}]

[INFO] Executing tasks
[INFO] Executed tasks
[INFO] Processing userguide.xml
Error
 Failure reading


C:\code\svn\RO_OpenWebBeansTrunk\webbeans-doc\src\docbkx\userguide.xml:

Server returned HTTP response code: 403 for URL:
http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd
[INFO]


------------------------------------------------------------------------

[ERROR] BUILD ERROR
[INFO]


------------------------------------------------------------------------

[INFO] Failed to transform userguide.xml.

The error message is a puzzle since I can follow

the URL in my browser.

But I did get the PDF generated.  The little

information that it contained

was quite helpful, since it concerned

configuration.

Thanks,

David


Gurkan Erdogdu wrote:


I tried the following, it works but takes

time, so wait patiently :)

 mvn clean compile

......
 BUILD SUCCESSFUL
[INFO]


------------------------------------------------------------------------

[INFO] Total time:4 minutes 59 seconds
[INFO] Finished at: Mon Jan 11 23:33:51 EET

2010

[INFO] Final Memory: 17M/107M

Thanks;




________________________________
From: David Ezzio <[email protected]>
To: [email protected]
Sent: Mon, January 11, 2010 8:05:40 PM
Subject: Re: Procedure for generating Javadoc

and User Guide

All,

In the webbeans-doc subdirectory, using either

docbkx:generate-pdf or

install, attempting to generate the user guide

appears to lead to a black

hole.  No CPU or disk activity appears to

be going on, and no progress is

indicated.

This is on a windows platform.

Any suggestions or insights, appreciated.

Thanks,

David

-------------- console output below

----------------
C:\code\svn\RO_OpenWebBeansTrunk\webbeans-doc>mvn
-Dmaven.test.skip=true

docbkx:generate-pdf
[INFO] Scanning for projects...
[INFO]


------------------------------------------------------------------------

[INFO] Building Apache OpenWebBeans ::

Documentation

[INFO]    task-segment:

[docbkx:generate-pdf]

[INFO]


------------------------------------------------------------------------

[INFO] [docbkx:generate-pdf {execution:

default-cli}]

[INFO] Processing userguide.xml
Terminate batch job (Y/N)? y



C:\code\svn\RO_OpenWebBeansTrunk\webbeans-doc>mvn
-Dmaven.test.skip=true

install
[INFO] Scanning for projects...
[INFO]


------------------------------------------------------------------------

[INFO] Building Apache OpenWebBeans ::

Documentation

[INFO]    task-segment: [install]
[INFO]


------------------------------------------------------------------------

[INFO] [docbkx:generate-pdf {execution:

single-pdf-page}]

[INFO] Processing userguide.xml
Terminate batch job (Y/N)? y

---------------- end of console output

-------------

David Ezzio wrote:


I've answered the first part of my

question:

mvn -Dmaven.test.skip=true

javadoc:javadoc

produces the javadoc, SFAICT.

Still having no luck generating the user

guide.

David Ezzio wrote:


Hi,

I didn't see Javadoc or User Guide

with the binary distribution.  What

is the procedure for generating these

from source?

Thanks,

David



___________________________________________________________________

Yahoo! Türkiye açıldı!  http://yahoo.com.tr
İnternet üzerindeki en iyi içeriği Yahoo!

Türkiye sizlere sunuyor!
































					Reply via email to