Details

      Description

      "Seam Solder" still mentioned in several places (e.g. the header), I am not sure if that term should still be used or not.

      Chapter 1 Getting Started
      1.2. Transitive dependencies
      the "tip" still contains old groupId and artifactId (org.jboss.seam.solder, seam-solder-parent, seam.solder.version)

      1.3. Pre-Servlet 3.0 configuration
      org.jboss.seam.solder.resourceLoader.servlet.ResourceListener

      Chapter 3 Annotation Literals
      @GenericConfiguration literal is not mentioned in the list of literals

      Chapter 4 Evaluating Unified EL
      missing description of the @Resolver annotation

      Chapter 6 Logging, redesigned
      "The license for Seam is " confusing to have Seam in the example if Solder is not part of Seam anymore

      6.4 Native logger API
      it should probably be "org.jboss.solder.logging.Logger;" instead of "org.jboss.logging.Logger;"

      6.6.1. Generating the implementation classes
      "TrainMessages_fr.i18n.properties" should be "TrainMessages.i18n_fr.properties" instead

      Chapter 7 Annotation and AnnotatedType Utilities
      7.1 Annotated Type Builder
      in the 1st code block, "AnnotatedTypeBuilder builder = new AnnotatedTypeBuilder() ... .create()" the last line (".create()") should not be there.
      in the 4th code block, "RedefinitionContext<A>" should probably be "RedefinitionContext<Unique>" instead,
      in the 4th code block, the ".create();" line should not be there.

      7.3. Annotation Inspector
      1st code block, AnnotationInspector.getAnnotations should have only two arguments

      Chapter 8. Obtaining a reference to the BeanManager
      "When developing a framework that builds on CDI, you may need to obtain the BeanManager for the application, can't simply inject it as you are not working in an object managed by the container. " missing "you" before "can't simply inject"?

      Chapter 10. Properties
      Table 10.1 Property methods
      methods "Member getMember();" and "void setAccessible()" are not mentioned in the table, could be intentional.

      Chapter 11. Unwrapping Producer Methods
      "The lifecycle of the bean is are managed by the bean that defines the producer method " one "are" too many.

      Chapter 13. Generic Beans
      13.1 Using generic beans
      "Seam XML" is mentioned twice

      Chapter 15. XML Configuration Introduction
      error in formatting in the HTML output, some XML piece 'ml_plain">' on each line in the example

      "mvn jetty:run" it has to be "mvn -Pjetty jetty:run" now, either the example or the docs should be fixed

      Chapter 16.1 XML Namespaces
      namespaces need to be updated:
      org.jboss.weld.extensions.core
      org.jboss.weld.extensions.unwraps
      org.jboss.weld.extensions.resourceLoader

      Chapter 16.2 Adding, replacing and modifying beans
      (or somewhere else) there should be a note on how s:modifies behaves with @Veto

      18.3.1. @HandlesExceptions
      "The @HandlesExceptions annotation may be deprecated in favor of annotation indexing done by Solder. "
      the link links to http://seamframework.org/Seam3/Solder which doesn't make sense, as this text is now inside the solder documentation.

      18.3.2. @Handles
      "stout" typo? (stdout)

      20.3. Supporting ServiceHandlers

      "ServiceHandlers make for a very easy and concise way to define exception handlers." link to ServiceHandlers should now be an internal one, as this document is now the solder documenation.

      "The following example comes from the jaxrs example in the distribution", there is no "jaxrs" example in the Solder distribution

      24.2. Defining a exception handler for a web request
      "Currently, @WebRequest is required to catch exceptions initiated by the Servlet integration because of a bug in Solder."
      is this stll true? SOLDER-130 is marked as resolved, Should @Any be used?

        Gliffy Diagrams

          Activity

          Hide
          lightguard Jason Porter added a comment -

          The issues with the chapter 15 seem like bugs with the highlighting program, xml, and callouts. Not sure what can be done there.

          Show
          lightguard Jason Porter added a comment - The issues with the chapter 15 seem like bugs with the highlighting program, xml, and callouts. Not sure what can be done there.

            People

            • Assignee:
              lightguard Jason Porter
              Reporter:
              maschmid Marek Schmidt
            • Votes:
              0 Vote for this issue
              Watchers:
              1 Start watching this issue

              Dates

              • Created:
                Updated:
                Resolved:

                Development