Here's more details about it http://lists.jboss.org/pipermail/jboss-as7-dev/2011-April/001402.html. In that discussion, Brian also points to a commit which added the javadoc to org.jboss.msc.service.Service explaining how it should be done.