Documentation issues

[thejavafreak]

I want to place all issues regarding Seam documentation here. I'll write some more if I found it on the way

version: Seam 1.2.0.Patch1
chapter: 10.3
page: 118

On <s:link> tag:
Should it be view-id, viewid, or view?


Thanks in advance

[christian.bauer]

We actually have an issue tracking system :)

http://jira.jboss.com/jira/browse/JBSEAM

[thejavafreak]

I know that. But sometimes I am uncertain to post on JIRA until someone else has confirmed that it is a bug. :(

[gavin.king]

It should be "view". And it should go in JIRA, if its wrong in the docs.

[shane.bryzak]

I've fixed up this particular issue, so don't post it in JIRA now. If you have any other documentation issues, then of course feel free to raise them.

[thejavafreak]

Do we need to document about setting entityManager for Home class? Just to prevent the same topic arise again for new users.

Related topic:
http://www.jboss.com/index.html?module=bb&op=viewtopic&t=104617
http://www.jboss.com/index.html?module=bb&op=viewtopic&t=102416

Thanks in advance

[thejavafreak]

version: Seam 1.2.0.Patch1
chapter: 21.5.1
page: 192

Does it suppose to be: jboss.beans.xml or jboss-beans.xml ?

Thanks in advance

[gavin.king]

-, of course. Fixed, thanks.

[thejavafreak]

version: Seam 1.2.1.GA
chapter: 12.8.2
page: 138

I think we need to add <s:validate> otherwise the input won't be compared/validated against the captcha image and a <h:commandButton> so new user won't be confused. Just an opinion.

<div>
 <h:graphicImage value="/seam/resource/captcha?#{captcha.id}"/>
 </div>

 <h:form>
 <div class="validationError"><h:message for="verifyCaptcha" /></div>

 <h:outputLabel for="verifyCaptcha">
 <h:outputText value="#{messages['captcha.message']}" />
 </h:outputLabel>

 <h:inputText id="verifyCaptcha" value="#{captcha.response}" required="true">
 <s:validate />
 </h:inputText>

 <h:commandButton value="#{messages['register']}" action="#{register.register}"/>

 </h:form>

[shane.bryzak]

I've added this to the docs in CVS.

[matt.drees]

On the topic of documentation, the last sentence of section 3.7 is

Note that the EntityHome class in the Seam Application Framework provides a great example of this pattern.

Perhaps this was true at one point in time, but EntityHome doesn't use @unwrap now.

[pmuir]

It's talking about EntityHome being a great example of managing an entity bean instance to allow efficient cluster replication; not the @Unwrap pattern

[matt.drees]

Gotcha. It's a little confusing though, given the example right before it.

[pmuir]

I've updated the wording to be less ambiguous :)

[dustismo]

Chapter 25 page 241 first example:

<s:commandButton action="#{hotelBooking.bookHotel(hotel)}" value="Book Hotel"/>

should be h:commandButton.