Version taken as

   1:$(cat VERSION)

The debianized sources are tracked in fossil, of course.

Brief “cheat sheet” of relevant fossil commands.

 ## FOR NEW UPSTREAM RELEASE

 # fetch & merge new upstream release
 uscan
 # or if that doesn't work because upstream hasn't done what they promise, download manually and
 mk-origtargz ../fossil-xxx.tar.gz
 EPOCH=1
 VER=xxx
 DEBVER=1
 fossil clean -x -v
 fossil pull https://www.fossil-scm.org
 ID=fossil-commit-id	# find via: fossil timeline -t ci -n 400 | more
			# then search for the tag "version-xxx"
 fossil merge version-${VER}
 fossil commit -m "merge version-${VER}"
 debchange --distribution unstable --newversion=${EPOCH}:${VER}-${DEBVER} New upstream version
 fossil commit -m 'update debian/changelog'

 # BUILDING
 dpkg-checkbuildeps
 # Build binary package:
 env DEB_RULES_REQUIRES_ROOT=no debian/rules binary
 lintian ../fossil*.d??
 # Build source + binary upload:
 dpkg-buildpackage -i.fslckout -i_FOSSIL_
 lintian
 # Build source + binary upload using a chroot:
 pdebuild --pbuilder cowbuilder --debbuildopts "-i.fslckout -i_FOSSIL_"
 sudo mv --no-clobber /var/cache/pbuilder/result/fossil* ../
 lintian ../fossil*.d??
 # Build source-only upload:
 dpkg-buildpackage -i.fslckout -i_FOSSIL_ --build=source --no-check-builddeps
 lintian ../fossil*.d??

 # tag debian release
 fossil tag add debian_${EPOCH}:${VER}-${DEBVER} debian

 # push/pull to/from debian repository (modify URL if necessary)
 fossil sync ssh://people.debian.org/~bap/public_html/fossil.fsl

 ## TO START DEVELOPMENT

 # create local repository by cloning mine
 #  (Would have made a repo on chiselapp.com but couldn't get it to
 #  work for me on a repo of this size.  But this was a while ago...)
 wget https://people.debian.org/~bap/fossil.fsl

 # make a working checkout
 sudo apt install fossil
 mkdir fossil
 cd fossil
 fossil open ../fossil.fsl
 fossil co debian
 fossil user password ${USER} ${PWD}
 fossil set manifest on		# needed as of approx ver 2010.11.11.133638

 ## MISC

 # pull/view upstream development
 fossil pull https://www.fossil-scm.org/
 fossil timeline -t ci -n 40

 # create upstream tarball (not needed if using upstream release tarball)
 fossil co trunk
 tar --exclude .fslckout --exclude _FOSSIL_ -C .. -zcf fossil_${VER}.orig.tar.gz fossil

 -- Barak A. Pearlmutter <bap@debian.org>, Wed, 26 Feb 2025 09:24:29 +0000
