すでに御存知のように, ports はいくつかのカテゴリに 分類されています. これを有効に利用するためには, port を 行う人々とユーザが, そろぞれのカテゴリーが何であるか, どのようにしてカテゴリに分類するかを理解する必要があります.
まず, これが現在の port のカテゴリーのリストです.
アスタリスク(*
)が付いているものは, バーチャル(virtual)
カテゴリです -- これらには対応するサブディレクトリが port
ツリーにはありません. バーチャルカテゴリでないものは,
そのサブディレクトリ内の pkg/COMMENT
に1行の記述
があります(例, archivers/pkg/COMMENT
).
archivers
Archiving tools.
astro
Astronomical ports.
audio
Sound support.
benchmarks
Benchmarking utilities.
biology
Biology-related software.
cad
Computer aided design tools.
chinese
Chinese language support.
comms
Communication software. Mostly software to talk to your serial port.
converters
Character code converters.
databases
Databases.
deskutils
Things that used to be on the desktop before computers were invented.
devel
Development utilities. Do not put libraries here just because they are libraries -- unless they truly don't belong to anywhere else, they shouldn't be in this category.
editors
General editors. Specialized editors
go in the section for those tools (e.g., a
mathematical-formula editor will go in math
).
elisp
Emacs-lisp ports.
emulators
Emulators for other operating
systems. Terminal emulators do not belong here --
X-based ones should go to x11
and text-based ones to
either comms
or misc
, depending on the exact
functionality.
games
Games.
german
German language support.
graphics
Graphics utilities.
japanese
Japanese language support.
kde*
Ports that form the K Desktop Environment (kde).
korean
Korean language support.
lang
Programming languages.
mail
Mail software.
math
Numerical computation software and other utilities for mathematics.
mbone
MBone applications.
misc
Miscellaneous utilities -- basically
things that doesn't belong to anywhere else. This is the
only category that should not appear with any other
non-virtual category. If you have misc
with something
else in your CATEGORIES
line, that means you can safely
delete misc
and just put the port in that other
subdirectory! :)
net
Miscellaneous networking software.
news
USENET news software.
offix*
Ports from the OffiX suite.
perl5*
Ports that require perl version 5 to run.
pilot*
Software to use with the 3Com PalmPilot.
plan9
Various programs from Plan9.
print
Printing software. Desktop publishing tools (previewers, etc.) belong here too.
python*
Software written in python.
russian
Russian language support.
security
Security utilities.
shells
Command line shells.
sysutils
System utilities.
tcl75*
Ports that use tcl version 7.5 to run.
tcl76*
Ports that use tcl version 7.6 to run.
tcl80*
Ports that use tcl version 8.0 to run.
tcl81*
Ports that use tcl version 8.1 to run.
textproc
Text processing utilities. It does
not include desktop publishing tools, which go to
print
.
tk41*
Ports that use tk version 4.1 to run.
tk42*
Ports that use tk version 4.2 to run.
tk80*
Ports that use tk version 8.0 to run.
tk81*
Ports that use tk version 8.1 to run.
vietnamese
Vietnamese language support.
www
Software related to the World Wide Web. HTML language support belong here too.
x11
The X window system and friends. This
category is only for software that directly support the
window system. Do not put regular X applications here. If
your port is an X application, define USE_XLIB
(implied
by USE_IMAKE
) and put it in appropriate categories.
Also, many of them go into other x11-*
categories (see
below).
x11-clocks
X11 clocks.
x11-fm
X11 file managers.
x11-fonts
X11 fonts and font utilities.
x11-toolkits
X11 toolkits.
x11-wm
X11 window managers.
多くのカテゴリーに重なるので, どれを '第一'カテゴリにするか を決めなければならないことがたびたびあるでしょう. これを うまく決めるルールがいくつかあります. 以下はその優先順の リストで, 優先度の高いものから低いものの順に書いてあります.
CATEGORIES
`japanese x11-fonts
' となるでしょう.
www editors
'
となり, 逆順にはしないでください. また, port が
mail
, mbone
, news
, security
, www
のいづれかに属するとには, net
は必要ありません.
x11
を第2カテゴリにするのは, 第1カテゴリが自然言語
の場合のみにしてください. 特に X のアプリケーションには
x11
を指定しないでください.
misc
にしてください.もし, あなたがカテゴリについて自信が持てない場合には, そのこと
を send-pr
するときに書き加えてください. そうすれば,
import するまえにそれについて議論できます. (もしあなたが
commiter であれば, そのことを FreeBSD 移植ソフトウエアメーリングリスト
<freebsd-ports@FreeBSD.ORG>
に送って, 先に議論
するようにしてください -- 新しい port が間違ったカテゴリ
に import されて, すぐ移動されることが多いので.)