To build a new upstream source release from just the contents of the
Subversion repository, proceed as follows:

- get the original tar.bz2 file phpBB-$VERSION.tar.bz2, where e.g.
  $VERSION=3.0.7-PL1 -- this can be achieved by running

  debian/rules get-orig-source

  if the changelog is up to date, and the upstream/phpbb3.info and
  upstream/phpbb3-l10n-*.info files as well (the second ones can be
  automatically updated using the update_languages scripts).

- rename it phpbb3_$VERSION.orig.tar.bz2 (the script will do that for you)

- do NOT just extract it to phpBB3, but into phpbb3-<VERSION>:

  mkdir phpbb3-$VERSION && cd phpbb3-$VERSION && \
   tar -xj --strip 1 -f ../phpbb3_$VERSION.orig.tar.bz2

- move the debian folder in there,

- get the language packs, which should already have been fetched by
  the script, which in fact calls 

  debian/get-orig-source $VERSION l10n

  which is a wrapper for getting package components,

- make sure the downloaded stuff is NOT inside the phpbb directory

.
|-- phpbb3-3.0.7-PL1
|   |-- adm
|   |-- cache
|   |-- common.php
|   |-- config.php
|   |-- cron.php
|   |-- debian
|   |-- docs
|   |-- download
|   |-- faq.php
|   |-- feed.php
|   |-- files
|   |-- images
|   |-- includes
|   |-- index.php
|   |-- install
|   |-- l10n-ar
[...]
|   |-- l10n-zh-cmn-hant
|   |-- language
|   |-- mcp.php
|   |-- memberlist.php
|   |-- posting.php
|   |-- report.php
|   |-- search.php
|   |-- store
|   |-- style.php
|   |-- styles
|   |-- ucp.php
|   |-- viewforum.php
|   |-- viewonline.php
|   `-- viewtopic.php
|-- phpbb3_3.0.7-PL1.orig-l10n-ar.tar.gz
[...]
|-- phpbb3_3.0.7-PL1.orig-l10n-zh-cmn-hant.tar.gz
`-- phpbb3_3.0.7-PL1.orig.tar.bz2

- inside phpbb3-$VERSION,
  extract the components e.g. like this (for .tar.xz only):

  for i in ../*orig-*.tar.xz; do
    dir=$(basename $i | sed 's/.*orig-\(.*\).tar.xz/\1/')
    mkdir $dir && tar -xa --strip 1 -C $dir -f $i
  done

  Note that the (sole) leading directory is stripped, just as
  dpkg-source would do.

- Several files need to be taken care of, in case of a new upstream
  release (see also README.source):

  + debian/schema_data_debian.sql <- install/schemas/schema_data.sql
  + debian/database_update_debian.php <- install/database_update.php

  must be produced. The patches in maint-paches might come in handy.

- build using your favorite tool: pdebuild, debuild -i [-us -uc]
  [--lintian-opts --pedantic], ...

.info files in upstream
=======================

get-orig-source will look at the filename of the info file in order to
determine the .orig-XXX.tar.gz's name.

The files have to be named <package>_<component>.info and must contain:

  - Url
  - Md5

Optionally they may contain:

  - Copyright
  - Include (yes/no, default: yes)
  - RepackDirectoryStructure (+/-<n>, default:0) adds or strips
    trailing directories


 -- J.M. Roth, April 2010
