Page MenuHomeFreeBSD
Files F142179369

D35071.id105445.diff
No OneTemporary
Actions

D35071.id105445.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].
@@ -3670,13 +3671,24 @@
[[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 setup git hooks for the ports tree, as explained <<port-commit-message-formats,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
Sat, Jan 17, 9:21 PM (6 h, 48 m)
Storage Engine
blob
Storage Format
Raw Data
Storage Handle
27699403
Default Alt Text
D35071.id105445.diff (2 KB)

Event Timeline