From owner-svn-doc-head@FreeBSD.ORG  Fri Jan 24 17:03:58 2014
Return-Path: <owner-svn-doc-head@FreeBSD.ORG>
Delivered-To: svn-doc-head@freebsd.org
Received: from mx1.freebsd.org (mx1.freebsd.org
 [IPv6:2001:1900:2254:206a::19:1])
 (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits))
 (No client certificate requested)
 by hub.freebsd.org (Postfix) with ESMTPS id 42E723EC;
 Fri, 24 Jan 2014 17:03:58 +0000 (UTC)
Received: from svn.freebsd.org (svn.freebsd.org
 [IPv6:2001:1900:2254:2068::e6a:0])
 (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits))
 (No client certificate requested)
 by mx1.freebsd.org (Postfix) with ESMTPS id 14E091318;
 Fri, 24 Jan 2014 17:03:58 +0000 (UTC)
Received: from svn.freebsd.org ([127.0.1.70])
 by svn.freebsd.org (8.14.7/8.14.7) with ESMTP id s0OH3veG031603;
 Fri, 24 Jan 2014 17:03:57 GMT (envelope-from jgh@svn.freebsd.org)
Received: (from jgh@localhost)
 by svn.freebsd.org (8.14.7/8.14.7/Submit) id s0OH3vmB031602;
 Fri, 24 Jan 2014 17:03:57 GMT (envelope-from jgh@svn.freebsd.org)
Message-Id: <201401241703.s0OH3vmB031602@svn.freebsd.org>
From: Jason Helfman <jgh@FreeBSD.org>
Date: Fri, 24 Jan 2014 17:03:57 +0000 (UTC)
To: doc-committers@freebsd.org, svn-doc-all@freebsd.org,
 svn-doc-head@freebsd.org
Subject: svn commit: r43639 - head/en_US.ISO8859-1/books/porters-handbook
X-SVN-Group: doc-head
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
X-BeenThere: svn-doc-head@freebsd.org
X-Mailman-Version: 2.1.17
Precedence: list
List-Id: SVN commit messages for the doc tree for head
 <svn-doc-head.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/options/svn-doc-head>,
 <mailto:svn-doc-head-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/svn-doc-head/>
List-Post: <mailto:svn-doc-head@freebsd.org>
List-Help: <mailto:svn-doc-head-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/svn-doc-head>,
 <mailto:svn-doc-head-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Fri, 24 Jan 2014 17:03:58 -0000

Author: jgh
Date: Fri Jan 24 17:03:57 2014
New Revision: 43639
URL: http://svnweb.freebsd.org/changeset/doc/43639

Log:
  - document proper handling of .war file in porters handbook
  
  Approved by:	wblock (mentor)
  Reviewed by:	bcr, remko (mentors)

Modified:
  head/en_US.ISO8859-1/books/porters-handbook/book.xml

Modified: head/en_US.ISO8859-1/books/porters-handbook/book.xml
==============================================================================
--- head/en_US.ISO8859-1/books/porters-handbook/book.xml	Fri Jan 24 08:04:00 2014	(r43638)
+++ head/en_US.ISO8859-1/books/porters-handbook/book.xml	Fri Jan 24 17:03:57 2014	(r43639)
@@ -7547,6 +7547,33 @@ USE_QT4=	moc_build qmake_build rcc_build
 	  already installed ones (from
 	  <filename>${JAVAJARDIR}</filename>).</para>
 
+	<para>When porting a &java; application that requires an
+	  application server such as
+	  <package role="port">www/tomcat7</package> to run the
+	  service, it is quite common for a vendor to distribute a
+	  <filename>.war</filename> file.  A <filename>.war</filename>
+	  file is a Web application ARchive and is extracted when called
+	  by the application.  Avoid adding a <filename>.war</filename>
+	  file to the <filename>pkg-plist</filename>.
+	  It is not considered best practice.  An application server
+	  will expand the <filename>war</filename> archive, but not
+	  clean it up properly if the port is removed.  A more
+	  desirable way of working with this file is to extract the
+	  archive, then install the files, and lastly add these files
+	  to <filename>pkg-plist</filename>.</para>
+
+	<programlisting>TOMCATDIR=	${LOCALBASE}/apache-tomcat-7.0
+WEBAPPDIR=	myapplication
+
+post-extract:
+	@${MKDIR} ${WRKDIR}/${PORTDIRNAME}
+	@${TAR} xf ${WRKDIR}/myapplication.war -C ${WRKDIR}/${PORTDIRNAME}
+
+do-install:
+	cd ${WRKDIR} &amp;&amp; \
+	${INSTALL} -d -o ${WWWOWN} -g ${WWWGRP} ${TOMCATDIR}/webapps/${PORTDIRNAME}
+	@cd ${WRKDIR}/${PORTDIRNAME} &amp;&amp; ${COPYTREE_SHARE} \* ${WEBAPPDIR}/${PORTDIRNAME}</programlisting>
+
 	<para>Regardless of the type of your port (library or
 	  application), the additional documentation should be
 	  installed in the