/usr/share/doc/fossil/README.Debian is in fossil 1:1.27-2ubuntu1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 | Version taken as
1:$(cat VERSION)
Man page created by manually editing output of this:
help2man ./fossil \
--help-option=help --version-option=version \
--no-info \
--name='Distributed Version Control System' \
--source=http://fossil-scm.org \
| egrep -v '^This is fossil version' \
| sed s'/^This \\-/Fossil \\-/' \
| sed s'/ THIS / FOSSIL /' \
> debian/fossil.1
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 --rename
VER=1:xxx
DEBVER=1
mv ../fossil_*.orig.tar.gz ../fossil_${VER}.orig.tar.gz
fossil pull http://www.fossil-scm.org
ID=fossil-commit-id # find via: fossil timeline -t ci -n 400 | more
# then search for "release"
fossil tag add upstream_${VER} ${ID}
fossil merge upstream_${VER}
fossil commit -m "merge upstream_${VER}"
debchange --append --newversion=${VER}-${DEBVER} New upstream version
fossil commit -m 'update debian/changelog'
# build debian release
dpkg-buildpackage -i.fslckout
# tag debian release
fossil tag add debian_${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
# (I would have made a repo on chiselapp.com but never managed to
# get it to work for me on a repo of this size.)
wget http://people.debian.org/~bap/fossil.fsl
# make a working checkout
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 http://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 -C .. -zcf fossil_${VER}.orig.tar.gz fossil
# less recently created checkouts may have _FOSSIL_ instead of
# .fslckout, edit any commands mentioning this file appropriately.
-- Barak A. Pearlmutter <bap@debian.org>, Mon, 30 Sep 2013 12:43:12 +0100
|