- Add upgrade instructions

PR:		ports/68966
Submitted by:	Aho K.F. Li <thinker@branda.to> (maintainer)

2 files changed, 24 insertions, 0 deletions

diff --git a/www/trac/Makefile b/www/trac/Makefile
index 5207e7132a1e..5cd8f1078412 100644
--- a/www/trac/Makefile
+++ b/www/trac/Makefile
@@ -25,4 +25,7 @@ USE_PYDISTUTILS=	yes
 x-generate-plist:
 	(${PORTSDIR}/Tools/scripts/plist -d -m ${MTREE_FILE} ${PREFIX}|sed -E 's,.*share/nls/.+$$,,g;s,${PYTHON_SITELIBDIR:S,^${PYTHONBASE}/,,},%%PYTHON_SITELIBDIR%%,g'|tr -s '\n') > temp-pkg-plist
 
+post-install:
+	@${CAT} ${PKGMESSAGE}
+
 .include <bsd.port.mk>
diff --git a/www/trac/pkg-message b/www/trac/pkg-message
new file mode 100644
index 000000000000..0682ff5b9ef1
--- /dev/null
+++ b/www/trac/pkg-message
@@ -0,0 +1,21 @@
+
+*******************************************************************************
+Trac 0.7 has a new database format, requiring manual upgrade.
+The following steps are needed to upgrade:
+
+1) convert the old-style trac databases to new-style trac environments:
+
+  # tracdb2env /path/to/old/project.db /path/to/new/projectenv
+
+
+2) update your httpd.conf. change the line
+      SetEnv TRAC_DB "/path/to/old/project.db"
+   to
+      SetEnv TRAC_ENV "/path/to/new/projectenv"
+
+
+3) once you verified everything works fine, delete your old database:
+
+  # rm /path/to/old/project.db
+*******************************************************************************
+