Page MenuHomeFreeBSD
Files F109663525

D35071.diff
No OneTemporary
Actions

D35071.diff
View Options

diff --git a/documentation/content/en/articles/committers-guide/_index.adoc b/documentation/content/en/articles/committers-guide/_index.adoc
--- a/documentation/content/en/articles/committers-guide/_index.adoc
+++ b/documentation/content/en/articles/committers-guide/_index.adoc
@@ -670,6 +670,7 @@
The 'current' branch is 'main' .
The quarterly branches are named 'yyyyQn' for year 'yyyy' and quarter 'n'.
+[[port-commit-message-formats]]
===== Commit message formats
A hook is available in the ports repository to help you write up your commit messages in https://cgit.freebsd.org/ports/tree/.hooks/prepare-commit-msg[.hooks/prepare-commit-message].
@@ -3666,13 +3667,25 @@
[[ports-qa-add-new]]
==== How do I add a new port?
-First, please read the section about repository copies.
+Adding a port to the tree is relatively simple. Once the port is ready to be added, as explained later <<ports-qa-add-new-extra,here>>, you need to add the port's directory entry in the category's [.filename]#Makefile#.
+In this [.filename]#Makefile#, ports are listed in alphabetical order and added to the `SUBDIR` variable, like this:
-The easiest way to add a new port is the `addport` script located in the [.filename]#ports/Tools/scripts# directory.
-It adds a port from the directory specified, determining the category automatically from the port [.filename]#Makefile#.
-It also adds an entry to the port's category [.filename]#Makefile#.
-It was written by `{mharo}`, `{will}`, and `{garga}`.
-When sending questions about this script to the {freebsd-ports}, please also CC `{crees}`, the current maintainer.
+[.programlisting]
+....
+ SUBDIR += newport
+....
+
+Once the port and its category's Makefile are ready, the new port can be committed:
+[source,shell]
+....
+% git add category/Makefile category/newport
+% git commit
+% git push
+....
+[TIP]
+====
+Don't forget to <<port-commit-message-formats,setup git hooks for the ports tree as explained here>>; a specific hook has been developed to verify the category's [.filename]#Makefile#.
+====
[[ports-qa-add-new-extra]]
==== Any other things I need to know when I add a new port?

File Metadata

Mime Type
text/plain
Expires
Sun, Feb 9, 2:37 AM (14 h, 28 m)
Storage Engine
blob
Storage Format
Raw Data
Storage Handle
16540708
Default Alt Text
D35071.diff (2 KB)

Event Timeline