Development/FreeBSD Ports

From Sit

SiT! Manual

Developers Guide → Development/FreeBSD Ports

Chapter 6

FreeBSD Ports allow you to easily install SiT and dependencies.

All new upgrades needs to be comitted using diff, read the porters handbook

This is for development when a new version of SiT has been released.

Word of caution: all indents must be tabs, not spaces in the Makefile, otherwise you'll get alot of strange errors

Pre-reqs

• FreeBSD
• The following tools are needed:
  • portlint
  • porttools
  • genplist

• Modify the Makefile to match the new version
• Delete pkg-plist

• Run the commands below to automatically create the "distinfo" OR edit "distinfo" and fill in the new version and replace the SHA256, MD5 hashes and FILESIZE from the new version.
  • download the sitpackage (sit_x.xx.tar.gz) into /usr/ports/distfiles

• install all dependencies before continuing

• Clean out any old remnants in the port, and make a copy

cd /usr/ports/www/sit
make clean
cd /usr/ports/www
cp -R sit sit.old

• change the Makefile in /usr/ports/www/sit to match the new version

cd /usr/ports/www/sit
make makesum

• Generate the new plist

cd /usr/ports/www/sit
genplist create /tmp
genplist diff
ee pkg-plist.new (make any necessary manual changes)
genplist commit
rm manplist.new

genplist test
genplist clean

• run the following, and fix any warnings (tabs, spacings etc), doing so by editing the Makefile

cd /usr/ports/www/sit
make clean
portlint -a

• Test the port

port test /usr/ports/www/sit

• Remove any files that shouldn't be here, i.e. any *.tbz files or work/ directories

• if all is good, run

This is for upgrading from one version to another (major or minor)

cd /usr/ports/www
diff -ruN sit.old sit > /tmp/sit_port

• run the following, and copy all the text

send-pr

• edit the sit_port file and paste the previously copied text to the top of the file, replace to your needs

To: FreeBSD-gnats-submit@freebsd.org
From: carsten@sitracker.org
Reply-To: carsten@sitracker.org
Cc:
X-send-pr-version: 3.113
X-GNATS-Notify:

>Submitter-Id:  current-users
>Originator:    Carsten Jensen
>Organization:  sitracker.org
>Confidential:  no
>Synopsis:      Update port: www/sit - Incident tracker / Help Desk based on Apache/MySQL/PHP
>Severity:      non-critical
>Priority:      low
>Category:      ports
>Class:         change-request
>Release:       FreeBSD 8.1-RELEASE i386
>Environment:
System: FreeBSD freebsd.vmhost.local 8.1-RELEASE FreeBSD 8.1-RELEASE #0: Mon Jul 19 02:55:53 UTC 2010 root@almeida.cse.buffalo
>Fix:

The output from the diff command should come after ">Fix:"

• Send it as a mail after saving the file.

send-pr -f /tmp/sit_port

After some time, the submitted update will appear here : http://www.freebsd.org/cgi/query-pr-summary.cgi?category=ports though it can take a long time before anyone takes a look at it, it might be a good idea to talk to a port committer either on the bsd ports mailing list, or on IRC EFnet #bsdports

For more thorough reading, go here : http://www.freebsd.org/doc/en/books/porters-handbook/