You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@forrest.apache.org by Nicola Ken Barozzi <ni...@apache.org> on 2004/04/26 14:18:24 UTC

Copyless branch ready for testing

The "copyless" branch is ready for testing folks :-)

To try it, you must get this tree:

  http://svn.apache.org/repos/asf/xml/forrest/branches/copyless

or use 'svn switch' to "transform" your local copy of the forrest trunk 
in this branch (see http://subversion.tigris.org/ docs for more details).

Once you have it on your HD, do:

  cd path/to/copyless
  build
  cd path/to/your/project
  forrest run

If you want to make a webapp, instead of run do

   forrest webapp

To make the webapp run in Tomcat 5.0, just make a mywebapp.file in this dir:

   path/to/tomcat/conf/Catalina/localhost/mywebapp.xml

with something like:

   <Context path="/mywebapp"
      docBase="path/to/my/webapp/build/webapp"
      reloadable="true" debug="0" privileged="true"/>

                   - 0 -

What has changed
=================

First of all, a build of Forrest just created a jar of the Forrest 
classes. *Everything* else is gotten from the main forrest files. No 
copying around.

(If you want to be sure that nothing wrong happens to your local Forrest 
copy, just make another copy of it somewhere else, or run the dist 
target that does exactly that)

The FORREST_HOME has thus changed to this dir:

   /path/to/forrest/src/core
                   ^^^^^^^^^^^

The bin is still in

    %FORREST_HOME%/bin


The webapp that Forrest generates is different from the ones it 
generated before, as it does *not* *overwrite* files.

Instead, the webapp will be like this:

   mywebapp/
     -(contents of src/core)
     -project/(all the project to be documented)
     -WEB/INF/libs/(all Forrest /libs + the forrest jar)

basically it copies the src/core in the root webapp dir, the project in 
/project, and the libs in WEB-INF/lib


Let me know how the test goes. There will surely be things to fix, let's 
get these bugs out! :-)

I'd like to clean up many things that are there yet, but there are not 
relevant to this branch, so when this will get merged back I will 
eventually branch again to do them. Let's get this working, first.

-- 
Nicola Ken Barozzi                   nicolaken@apache.org
             - verba volant, scripta manent -
    (discussions get forgotten, just code remains)
---------------------------------------------------------------------


Re: Copyless branch ready for testing

Posted by David Crossley <cr...@apache.org>.
Nicola Ken Barozzi wrote:
> David Crossley wrote:
> > I saw some warnings about directory not found for
> > src/documentation/skins/common etc.
> 
> Hmmm, could you please post them here?

Same warnings that Brian reported in another thread about the trunk.

Building Forrest's own documentation:

cd /usr/local/svn/forrest-copyless
forrest
...
...
site:
Deleting directory /usr/local/svn/forrest-copyless/build/tmp/cocoon-work
Created dir: /usr/local/svn/forrest-copyless/build/tmp/cocoon-work
Copying 2 files to /usr/local/svn/forrest-copyless/build/site
Copying 38 files to
/usr/local/svn/forrest-copyless/build/site/skin/images
Warning:
/usr/local/svn/forrest-copyless/src/documentation/skins/common/images
not found.
Warning:
/usr/local/svn/forrest-copyless/src/documentation/skins/forrest-site/images not found.
Copying 7 files to /usr/local/svn/forrest-copyless/build/site/skin
Warning: /usr/local/svn/forrest-copyless/src/documentation/skins/common
not found.
Warning:
/usr/local/svn/forrest-copyless/src/documentation/skins/forrest-site
not found.
 
Static site will be generated at:
...
... build was successful and everything looks fine.
-----------------------------------




Re: Copyless branch ready for testing

Posted by Nicola Ken Barozzi <ni...@apache.org>.
David Crossley wrote:

> Nicola Ken Barozzi wrote:
> 
>>David Crossley wrote:
>>
>>
>>>The 'forrest validate-xdocs' does not work. Adding -v shows
>>>that it cannot find the resolver library - not sure why.
>>
>>Ok, will check it and clean up all the validation stuff.
> 
> I think that i found the reason, but not sure how to fix it.
> 
> In the trunk we copy the xml-commons-resolver.jar and the
> ant-apache-resolver.jar into the build area (build.xml line 275).
> and i presume that we are not doing this in the copyless branch.

Then we need to change the classpath for the validation task IIUC.

-- 
Nicola Ken Barozzi                   nicolaken@apache.org
             - verba volant, scripta manent -
    (discussions get forgotten, just code remains)
---------------------------------------------------------------------


Re: Copyless branch ready for testing

Posted by David Crossley <cr...@apache.org>.
Nicola Ken Barozzi wrote:
> David Crossley wrote:
> 
> > The 'forrest validate-xdocs' does not work. Adding -v shows
> > that it cannot find the resolver library - not sure why.
> 
> Ok, will check it and clean up all the validation stuff.

I think that i found the reason, but not sure how to fix it.

In the trunk we copy the xml-commons-resolver.jar and the
ant-apache-resolver.jar into the build area (build.xml line 275).
and i presume that we are not doing this in the copyless branch.

--David





Re: Copyless branch ready for testing

Posted by Nicola Ken Barozzi <ni...@apache.org>.
David Crossley wrote:
> Nicola Ken Barozzi wrote:
> 
>>The "copyless" branch is ready for testing folks :-)
> 
> Thanks for doing this - it is an excellent step forward.

And boy, does it make it easier to fix bugs!

>>Let me know how the test goes. There will surely be things to fix, let's 
>>get these bugs out! :-)
> 
> I tried 'forrest run' and 'forrest' on Forrest's own docs
> and tried 'forest seed site'. All seems okay on my Linux.
> Not yet tried on a complex site like Cocoon or Xml-Commons.
> 
> I saw some warnings about directory not found for
> src/documentation/skins/common etc.

Hmmm, could you please post them here?

> The 'forrest validate-xdocs' does not work. Adding -v shows
> that it cannot find the resolver library - not sure why.

Ok, will check it and clean up all the validation stuff.

>>I'd like to clean up many things that are there yet, but there are not 
>>relevant to this branch, so when this will get merged back I will 
>>eventually branch again to do them. Let's get this working, first.
> 
> What does "working" mean?

I meant let's iron all the evident bugs out of this branch before 
merging, and then we can rebranch for a "cleaning" of the codebase, as 
we can use some refactoring in our codebase (ant scripts, java classes, 
sitemaps).

-- 
Nicola Ken Barozzi                   nicolaken@apache.org
             - verba volant, scripta manent -
    (discussions get forgotten, just code remains)
---------------------------------------------------------------------


Re: Copyless branch ready for testing

Posted by David Crossley <cr...@apache.org>.
Nicola Ken Barozzi wrote:
> The "copyless" branch is ready for testing folks :-)

Thanks for doing this - it is an excellent step forward.

> Let me know how the test goes. There will surely be things to fix, let's 
> get these bugs out! :-)

I tried 'forrest run' and 'forrest' on Forrest's own docs
and tried 'forest seed site'. All seems okay on my Linux.
Not yet tried on a complex site like Cocoon or Xml-Commons.

I saw some warnings about directory not found for
src/documentation/skins/common etc.

The 'forrest validate-xdocs' does not work. Adding -v shows
that it cannot find the resolver library - not sure why.

> I'd like to clean up many things that are there yet, but there are not 
> relevant to this branch, so when this will get merged back I will 
> eventually branch again to do them. Let's get this working, first.

What does "working" mean?

--David



Re: Copyless branch ready for testing [patch]

Posted by Nicola Ken Barozzi <ni...@apache.org>.
Rick Tessner wrote:
...
> When building a war or webapp, the entire
> "build" directory is being copied into the "project" folder of the
> webapp.
...
> Attached is a patch that seems to resolve this issue.

Applied, thanks :-)

-- 
Nicola Ken Barozzi                   nicolaken@apache.org
             - verba volant, scripta manent -
    (discussions get forgotten, just code remains)
---------------------------------------------------------------------


Re: Copyless branch ready for testing [patch]

Posted by Rick Tessner <ri...@onnadayr.ca>.
On Mon, 2004-04-26 at 05:18, Nicola Ken Barozzi wrote:
> The "copyless" branch is ready for testing folks :-)
> 
> To try it, you must get this tree:
> 
>   http://svn.apache.org/repos/asf/xml/forrest/branches/copyless

Very nice!

I did find one little thing.  When building a war or webapp, the entire
"build" directory is being copied into the "project" folder of the
webapp.

This can create a very large webapp since any generated html, images and
pdf will be included in the webapp as well.

Attached is a patch that seems to resolve this issue.

HTH,

Rick

-- 
Rick Tessner <ri...@onnadayr.ca>

Re: Copyless branch ready for testing

Posted by Dave Brondsema <da...@brondsema.net>.
Nicola Ken Barozzi wrote:
> 
> The "copyless" branch is ready for testing folks :-)
> 

> Let me know how the test goes. There will surely be things to fix, let's 
> get these bugs out! :-)
> 

Works great for me!

> I'd like to clean up many things that are there yet, but there are not 
> relevant to this branch, so when this will get merged back I will 
> eventually branch again to do them. Let's get this working, first.
> 

How long do you think until you merge it back in?  I'm going to create a 
branch for bringing the new forrestbot into the main distribution, and 
would like to wait until your branch is done so the final merge is less 
painful & confusing.

-- 
Dave Brondsema : dave@brondsema.net
http://www.splike.com : programming
http://csx.calvin.edu : student org
http://www.brondsema.net : personal

Re: Copyless branch ready for testing

Posted by Dave Brondsema <da...@brondsema.net>.
On Wed, 28 Apr 2004, Dave Brondsema wrote:

> On Mon, 26 Apr 2004, Nicola Ken Barozzi wrote:
>
> >
> > The "copyless" branch is ready for testing folks :-)
> >
> > To try it, you must get this tree:
> >
> >   http://svn.apache.org/repos/asf/xml/forrest/branches/copyless
> >
>
> I'm getting this error
>
> upgrade-skinconf:
> Processing D:\sandbox\codingStandards\src\documentation\skinconf.xml to
> D:\sandbox\codingStandards\b
> uild\webapp\skinconf.xml
> Loading stylesheet
> D:\sandbox\xml-forrest-copyless\src\core\context\resources\stylesheets\upgrade-sk
> inconf.xsl
> Warning: catalogpath listing external catalogs will be ignored
> : Fatal Error! java.io.FileNotFoundException:
> D:\sandbox\codingStandards\src\documentation\skinconfi
> g-v06.dtd (The system cannot find the file specified) Cause:
> java.io.FileNotFoundException: D:\sandb
> ox\codingStandards\src\documentation\skinconfig-v06.dtd (The system cannot
> find the file specified)
> Failed to process
> D:\sandbox\codingStandards\src\documentation\skinconf.xml
>
> BUILD FAILED
> D:\sandbox\xml-forrest-copyless\src\core\targets\context.xml:107: Fatal
> error during transformation
>
>

Heh.  Fixed it just by removing the DTD reference in my skinconf.xml.
Sorry for the noise.

-- 
Dave Brondsema : dave@brondsema.net
http://www.brondsema.net : personal
http://www.splike.com : programming
http://csx.calvin.edu : student org

Re: Copyless branch ready for testing

Posted by Dave Brondsema <da...@brondsema.net>.
On Mon, 26 Apr 2004, Nicola Ken Barozzi wrote:

>
> The "copyless" branch is ready for testing folks :-)
>
> To try it, you must get this tree:
>
>   http://svn.apache.org/repos/asf/xml/forrest/branches/copyless
>

I'm getting this error

upgrade-skinconf:
Processing D:\sandbox\codingStandards\src\documentation\skinconf.xml to
D:\sandbox\codingStandards\b
uild\webapp\skinconf.xml
Loading stylesheet
D:\sandbox\xml-forrest-copyless\src\core\context\resources\stylesheets\upgrade-sk
inconf.xsl
Warning: catalogpath listing external catalogs will be ignored
: Fatal Error! java.io.FileNotFoundException:
D:\sandbox\codingStandards\src\documentation\skinconfi
g-v06.dtd (The system cannot find the file specified) Cause:
java.io.FileNotFoundException: D:\sandb
ox\codingStandards\src\documentation\skinconfig-v06.dtd (The system cannot
find the file specified)
Failed to process
D:\sandbox\codingStandards\src\documentation\skinconf.xml

BUILD FAILED
D:\sandbox\xml-forrest-copyless\src\core\targets\context.xml:107: Fatal
error during transformation

-- 
Dave Brondsema : dave@brondsema.net
http://www.brondsema.net : personal
http://www.splike.com : programming
http://csx.calvin.edu : student org

Re: Copyless branch ready for testing

Posted by Nicola Ken Barozzi <ni...@apache.org>.
Juan Jose Pablos wrote:

> Nicola Ken Barozzi escribió:
> 
>> I saw them later, but in any case I have updated and it still works 
>> for me for 'forrest run', and also the webapp target creates a valid 
>> webapp that works.
>>
>> What are your FORREST_HOME and PATH variables?
>> Have you tried the webapp target with a fresh site?
>> What errors do these targets give you?
>>
> Everything works expect the webapp and the war targets. On the others 
> targets the  java.endorsed.dirs variable is set.
> 
> The issue is with the endorsed libraries. copying the lib/endorsed under 
> $CATALINA_HOME/common/endorsed fix it.

Ahhh... but wait, I didn't do that and it worked... probably because I 
used the latest Tomcat 5.0.

> I will check if this was the previous behaviour.

TIA

-- 
Nicola Ken Barozzi                   nicolaken@apache.org
             - verba volant, scripta manent -
    (discussions get forgotten, just code remains)
---------------------------------------------------------------------


Re: Copyless branch ready for testing

Posted by Juan Jose Pablos <ch...@che-che.com>.
Nicola Ken Barozzi escribió:
> 
> 
> I saw them later, but in any case I have updated and it still works for 
> me for 'forrest run', and also the webapp target creates a valid webapp 
> that works.
> 
> What are your FORREST_HOME and PATH variables?
> Have you tried the webapp target with a fresh site?
> What errors do these targets give you?
> 
Everything works expect the webapp and the war targets. On the others 
targets the  java.endorsed.dirs variable is set.

The issue is with the endorsed libraries. copying the lib/endorsed under 
$CATALINA_HOME/common/endorsed fix it.

I will check if this was the previous behaviour.


Cheers,
Cheche


Re: Copyless branch ready for testing

Posted by Nicola Ken Barozzi <ni...@apache.org>.
Juan Jose Pablos wrote:

> Nicola Ken Barozzi escribió:
> 
>>
>>> * [8/34]    [0/0]     4.883s 0b      samples/wiki-sample.html
>>> Exception in thread "main" java.lang.IllegalAccessError: class 
>>> org.apache.xml.dtm.ref.sax2dtm.SAX2DTM2$AncestorIterator cannot 
>>> access its superclass 
>>> org.apache.xml.dtm.ref.DTMDefaultBaseIterators$InternalAxisIteratorBase
>>>
>>> I have not idea what is this about.
>>
>> Unfortunately I don't either :-/
>>
>> The file renders correctly in the live Cocoon but fails in the static 
>> generation. It seems like a Xalan error to me... maybe forret run is 
>> not using the provided Xalan?
> 
> ¿? I got the opposite. I am able to run the static generation, but not 
> the war and webapp targets fail. Are you updating you brach, I have been 
> commited varios patches to the copyless brach..

I saw them later, but in any case I have updated and it still works for 
me for 'forrest run', and also the webapp target creates a valid webapp 
that works.

What are your FORREST_HOME and PATH variables?
Have you tried the webapp target with a fresh site?
What errors do these targets give you?

-- 
Nicola Ken Barozzi                   nicolaken@apache.org
             - verba volant, scripta manent -
    (discussions get forgotten, just code remains)
---------------------------------------------------------------------


Re: Copyless branch ready for testing

Posted by Juan Jose Pablos <ch...@che-che.com>.
Nicola Ken Barozzi escribió:
> 
>> * [8/34]    [0/0]     4.883s 0b      samples/wiki-sample.html
>> Exception in thread "main" java.lang.IllegalAccessError: class 
>> org.apache.xml.dtm.ref.sax2dtm.SAX2DTM2$AncestorIterator cannot access 
>> its superclass 
>> org.apache.xml.dtm.ref.DTMDefaultBaseIterators$InternalAxisIteratorBase
>>
>> I have not idea what is this about.
> 
> 
> Unfortunately I don't either :-/
> 
> The file renders correctly in the live Cocoon but fails in the static 
> generation. It seems like a Xalan error to me... maybe forret run is not 
> using the provided Xalan?
> 

¿? I got the opposite. I am able to run the static generation, but not 
the war and webapp targets fail. Are you updating you brach, I have been 
commited varios patches to the copyless brach..


Cheers,
Cheche


Re: Copyless branch ready for testing

Posted by Nicola Ken Barozzi <ni...@apache.org>.
Juan Jose Pablos wrote:
> Nicola Ken Barozzi escribió:
> 
>> The "copyless" branch is ready for testing folks :-)

Thanks for testing guys :-)

> The forrest site target complains:
> 
> X [0]                                     samples/faq.html      BROKEN: 
> /home/cheche/xml/forrest/branches/copyless/src/core/bin/../context/xslt/html/document2html.xsl 
> (No such file or directory)
> 
> The skins/forrest-site path is missing there.

Ok, fixed. The 'skinit' resource in the faq pipeline was not uptodate. 
(I really start thinking that putting the sitemaps back in a single one 
would not be bad, but it's another issue)

> * [8/34]    [0/0]     4.883s 0b      samples/wiki-sample.html
> Exception in thread "main" java.lang.IllegalAccessError: class 
> org.apache.xml.dtm.ref.sax2dtm.SAX2DTM2$AncestorIterator cannot access 
> its superclass 
> org.apache.xml.dtm.ref.DTMDefaultBaseIterators$InternalAxisIteratorBase
> 
> I have not idea what is this about.

Unfortunately I don't either :-/

The file renders correctly in the live Cocoon but fails in the static 
generation. It seems like a Xalan error to me... maybe forret run is not 
using the provided Xalan?

Dave Brondsema wrote:
> Nicola Ken Barozzi wrote:
...
>> Let me know how the test goes. There will surely be things to fix, 
>> let's get these bugs out! :-)
> 
> Works great for me!

:-)

>> I'd like to clean up many things that are there yet, but there are
>> not relevant to this branch, so when this will get merged back I
>> will eventually branch again to do them. Let's get this working,
>> first.
>>  
> How long do you think until you merge it back in? 

As soon as the main bugs you guys find out are fixed. Hopefully a couple 
of days.

> I'm going to create
> a branch for bringing the new forrestbot into the main distribution,
> and would like to wait until your branch is done so the final merge
> is less painful & confusing.

Cool.

-- 
Nicola Ken Barozzi                   nicolaken@apache.org
             - verba volant, scripta manent -
    (discussions get forgotten, just code remains)
---------------------------------------------------------------------


Re: Copyless branch ready for testing

Posted by Juan Jose Pablos <ch...@che-che.com>.
Nicola Ken Barozzi escribió:
> 
> The "copyless" branch is ready for testing folks :-)
> 

The forrest site target complains:

X [0]                                     samples/faq.html      BROKEN: 
/home/cheche/xml/forrest/branches/copyless/src/core/bin/../context/xslt/html/document2html.xsl 
(No such file or directory)

The skins/forrest-site path is missing there.

* [8/34]    [0/0]     4.883s 0b      samples/wiki-sample.html
Exception in thread "main" java.lang.IllegalAccessError: class 
org.apache.xml.dtm.ref.sax2dtm.SAX2DTM2$AncestorIterator cannot access 
its superclass 
org.apache.xml.dtm.ref.DTMDefaultBaseIterators$InternalAxisIteratorBase


I have not idea what is this about.

Cheers,
Cheche


Re: Copyless branch ready for testing

Posted by Nicola Ken Barozzi <ni...@apache.org>.
Rick Tessner wrote:
> On Tue, 2004-04-27 at 09:44, Nicola Ken Barozzi wrote:
> 
>> 
>>
>>>the forrest file under $FORREST_HOME/bin needs to have run permissions
>>
>>Err... HOWTO? I'm on Wintel2000, if there is an SVN way of doing it, or 
>>else some Nix guy has to do it.
...
> 
>         cd bin
>         svn propset svn:executable true forrest
>         svn commit -m "making forrest executable" forrest
>         
> should do the trick. :)

Neat, thanks! :-)

-- 
Nicola Ken Barozzi                   nicolaken@apache.org
             - verba volant, scripta manent -
    (discussions get forgotten, just code remains)
---------------------------------------------------------------------


Re: Copyless branch ready for testing

Posted by Rick Tessner <ri...@onnadayr.ca>.
On Tue, 2004-04-27 at 09:44, Nicola Ken Barozzi wrote:
>  
> > the forrest file under $FORREST_HOME/bin needs to have run permissions
> 
> Err... HOWTO? I'm on Wintel2000, if there is an SVN way of doing it, or 
> else some Nix guy has to do it.

[sorry if this email is duplicated ... used wrong addy to reply first
time]

        cd bin
        svn propset svn:executable true forrest
        svn commit -m "making forrest executable" forrest
        
should do the trick. :)

-- 
Rick Tessner <ri...@onnadayr.ca>


Re: Copyless branch ready for testing

Posted by Nicola Ken Barozzi <ni...@apache.org>.
Juan Jose Pablos wrote:

> Nicola Ken Barozzi escribió:
> 
>> Let me know how the test goes. There will surely be things to fix, 
>> let's get these bugs out! :-)
>>
> 
> the forrest file under $FORREST_HOME/bin needs to have run permissions

Err... HOWTO? I'm on Wintel2000, if there is an SVN way of doing it, or 
else some Nix guy has to do it.

TIA

-- 
Nicola Ken Barozzi                   nicolaken@apache.org
             - verba volant, scripta manent -
    (discussions get forgotten, just code remains)
---------------------------------------------------------------------


Re: Copyless branch ready for testing

Posted by Juan Jose Pablos <ch...@che-che.com>.
Nicola Ken Barozzi escribió:
> Let me know how the test goes. There will surely be things to fix, let's 
> get these bugs out! :-)
> 

the forrest file under $FORREST_HOME/bin needs to have run permissions