git: 1273537f9b - main - ports.cgi: explain the search types with examples

From: Wolfram Schneider <wosch_at_FreeBSD.org>
Date: Thu, 17 Sep 2026 14:15:39 UTC
The branch main has been updated by wosch:

URL: https://cgit.FreeBSD.org/doc/commit/?id=1273537f9b01ffcb5ebae232d1b4e78cffa58659

commit 1273537f9b01ffcb5ebae232d1b4e78cffa58659
Author:     Wolfram Schneider <wosch@FreeBSD.org>
AuthorDate: 2026-09-17 14:15:22 +0000
Commit:     Wolfram Schneider <wosch@FreeBSD.org>
CommitDate: 2026-09-17 14:15:22 +0000

    ports.cgi: explain the search types with examples
---
 website/content/en/cgi/ports.cgi | 52 +++++++++++++++++++++++++++++++++-------
 1 file changed, 43 insertions(+), 9 deletions(-)

diff --git a/website/content/en/cgi/ports.cgi b/website/content/en/cgi/ports.cgi
index 4c40d33a52..0067433e37 100755
--- a/website/content/en/cgi/ports.cgi
+++ b/website/content/en/cgi/ports.cgi
@@ -718,15 +718,7 @@ sub help {
 <p>
 The FreeBSD Ports and Packages Collection offers a simple way for
 users and administrators to install applications.
-</p>
-
-<p>
-<b>Package Name</b> searches for the name of a port or distribution.
-<b>Description</b> searches case-insensitive in a short comment about the port.
-<b>All</b> searches case-insensitive for the package name and in the
-description about the port.
-<b>Maintainer</b> searches for the email address of the port maintainer.
-<b>Requires</b> searches for ports which depends on this port.
+Use the search types below to find a port.
 </p>
 
 <p>
@@ -735,6 +727,48 @@ description about the port.
 For other FreeBSD release indexes, see the full <a href="https://download.freebsd.org/ports/index/">index listing</a>.
 </p>
 
+<h2>Search Types</h2>
+<table>
+  <thead>
+    <tr>
+      <th>Type</th>
+      <th>What it searches</th>
+      <th>Example</th>
+    </tr>
+  </thead>
+  <tbody>
+    <tr>
+      <td><strong>All</strong></td>
+      <td>Package name and description (case-insensitive)</td>
+      <td><code>netcat</code></td>
+    </tr>
+    <tr>
+      <td><strong>Package Name</strong></td>
+      <td>The name of a port or distribution</td>
+      <td><code>neovim</code></td>
+    </tr>
+    <tr>
+      <td><strong>Description</strong></td>
+      <td>The short one-line comment about a port (case-insensitive)</td>
+      <td><code>vim</code></td>
+    </tr>
+    <tr>
+      <td><strong>Maintainer</strong></td>
+      <td>The maintainer's email address</td>
+      <td><code>emacs\@FreeBSD.org</code></td>
+    </tr>
+    <tr>
+      <td><strong>Requires</strong></td>
+      <td>Ports that <em>depend on</em> the given port (not the other way around)</td>
+      <td><code>vim-tiny</code></td>
+    </tr>
+  </tbody>
+</table>
+
+<p>
+Note: search is substring-based; wildcards and regular expressions are not supported.
+</p>
+
 <h2>External Links</h2>
 
 <dl>