Ports Tasks
This is a recompilation of all ports tasks, resources and ideas. Most of them are referenced by links (many not present in the FrontPage) and some of them are very short, which could be integrated here. They are grouped in categories for easier browsing.
Be sure to check the PR database to see if something has already been done. To correlate PRs with existing ports check here.
Table of Contents
Contents
New ports
New ports you would like to have in the tree, if possible with more details about the procedure (expected difficulties and so), a partially working port skeleton if available and/or who is working on it if anyone.
Application |
Description |
Porting notes |
Who is working |
Port preview |
|
|
|
|
|
See also:
WantedPorts (new desired ports)
AndrewPantyukhin/Ports (wanted and in progress ports)
Maybe all of these could be integrated in the same page with a common format (like the previous table template). For now use respective link.
Update ports
Existing ports that need to be updated, or don't need for some reason.
Port |
Current version |
Latest/affected version |
Intentional? |
Reason |
|
|
|
|
|
See also:
PortsNotUpgraded (ports intentionally not updated)
ports/TrackingUpstreamUpdates (info on checking for outdated ports)
Maybe all of these could be integrated in the same page with a common format (like the previous table template). For now use respective link.
Fix ports
Existing ports that have problems which need fixing. Use this to track them.
Port |
Problem class |
More details |
References |
|
|
|
|
See also:
PortsFailingOnPointyhat (ports failing on the official package building cluster)
ia64/Ports (ports that need attention in the ia64 platform)
DistfileSurvey (distfile availability for ports)
Ports marked BROKEN (freshports and portsmon), mainly unmaintained ones
Maybe all of these could be integrated in the same page with a common format (like the previous table template). For now use respective link.
Clean up ports
PortsLongtermTargets (statistics about ports which need clean up)
Some ports with CONFLICTS could be patched to rename conflicting files
Obsolete (deprecated and expired) ports to be removed/fixed (see freshports)
Ports/X11/Todo (FreeBSD/X11 TODO list)
Porting resources
Notes and clues about different porting scenarios.
ports (various general and per-port notes)
ports/Configure (various configure hacks and workarounds)
AvoidingLinuxisms (notes about porting Linux aplications)
XPI, NPAPI, and Linkfarming
MaintainerNotes (permission and preferences of maintainers about commits to their ports)
Status and monitoring
Statistics, reports and status of ports.
portsmon (specialized status reports, including PRs and correlation)
JavaPortsMonitoring (status, ideas, PRs, etc about Java ports)
PortsAndGPLv3 (list of ports that under GPLv3)
AndrewPantyukhin/Ports/Stats (some random statistics)
Ports documentation
Additions to the current ports documentation.
PortersHandbook (PavLucistnik ideas for PH)
ThePortersHandbookAdditions (empty; for docs not present in PH)
PortsPageProposal (additions for the ports section of the Handbook)
In addition, IMHO the whole ports documentation could be put in a single document. Currently some information is contained in the Handbook (usage for users; missing update information). Porter's Handbook (for port developers; some issues described in above links) and Committer's Guide (sections about ports tree integration in CVS, repocopies, etc). A single document could have the following sections (not necessarily ordered, and some could be appendices):
- Using the Ports Collection
Ports (adding, removing, searching, configuring - including knobs, OPTIONS and bsd.*.mk user variables, etc)
- Packages (using from CDs, FTP, etc)
- Updating the tree (CVSup, anoncvs, portsnap, snapshot tarballs, downgrading)
- Updating the installed packages (portupgrade, portmaster, ports/UPDATING, etc)
- Resources (web related pages: freshports, FreeBSD ports page, reporting errors, etc)
Developing ports (Porter's Handbook; all usable bsd.*.mk variables, recommended practices for various cases, useful targets and scripts for developing, etc)
Ports system internals (portbuild, package builds, package database format, how DESTDIR works, scripts in Tools, all targets, etc), or maybe in a manpage
- Submitter's guide (send-pr links, best practices, required information, etc)
- Committer's guide (Committer's guide relevant part; how ports are structured into CVS, ports practices, etc)
Ports system
Improvements to the current ports system and/or layout.
PortsToDo (recompilation of all ports system enhancenments)
PortsFlaws (few notes about current issues)
NewPortsCategories (proposed new category layouts)
PortsUsingSQLite (using SQLite for the package database)
RewriteOfOptions (ideas about reimplementing OPTIONS)
Metalink (supporting metalinks, P2P, etc)
AndrewPantyukhin/Ports/iport (scripts to help port related tasks)
portmgr (agenda/tasks of the ports management team)
Per port pages
Specific port pages, also see entries under ports.
Others
JavaPortlint (desired portlint checks related to Java)
Ports_BOF (topics for ports related discussions in last conference)
portupgrade (description, usage and desired features)
Adopting ports
At any given time, approximately 20 - 25% of ALL ports are unmaintained. Orphaned ports need love too! If you use it, consider adopting it. This shell script will generate a list of ports you have installed on your system that are up for grabs.
#
#!/bin/sh
cd /usr/ports; grep -F "`for o in \`pkg_info -qao\` ; \
do echo "|/usr/ports/${o}|" ; done`" `make -V INDEXFILE` | \
grep -i \|ports@freebsd.org\| | cut -f 2 -d \|Now that you know what is available, here are some links to guide you through the process.
http://lists.freebsd.org/pipermail/freebsd-announce/2006-May/001065.html, kris' announcement soliciting volunteers
http://www.freebsd.org/doc/en_US.ISO8859-1/articles/contributing-ports/index.html, Contributing to the ports collection
http://www.freebsd.org/doc/en_US.ISO8859-1/books/porters-handbook/, Porter's Handbook
http://www.portscout.org/ports@freebsd.org.html, provides current port version
http://portsmon.freebsd.org/portsconcordanceformaintainer.py?maintainer=ports%40FreeBSD.org, portsmon cluster, has information regarding errors and open PRs against the port
http://www.oook.cz/bsd/sexiness.html, Pav's Guide to PR Sexiness
http://people.freebsd.org/~fenner/errorlogs/ports@freebsd.org.html, Bill Fenner's possibly unbuildable ports@ list