Page MenuHomeFreeBSD
Files F146232659

D36369.id109933.diff
No OneTemporary
Actions

D36369.id109933.diff
View Options

diff --git a/documentation/content/en/books/porters-handbook/makefiles/_index.adoc b/documentation/content/en/books/porters-handbook/makefiles/_index.adoc
--- a/documentation/content/en/books/porters-handbook/makefiles/_index.adoc
+++ b/documentation/content/en/books/porters-handbook/makefiles/_index.adoc
@@ -1145,6 +1145,7 @@
MAINTAINER= mat@FreeBSD.org
COMMENT= BIND DNS suite with updated DNSSEC and DNS64
+WWW= https://www.isc.org/bind/
LICENSE= ISCL
@@ -2515,6 +2516,33 @@
The COMMENT variable immediately follows the MAINTAINER variable in the [.filename]#Makefile#.
+[[makefile-www]]
+== Project website
+
+Each port should point to a website that provides more information about the software.
+
+Whenever possible, this should be the official project website maintained by the developers of the software:
+
+[.programlisting]
+....
+WWW= http://ffmpeg.org/
+....
+
+But it can also be a directory or resource in the source code repository:
+
+[.programlisting]
+....
+WWW= https://sourceforge.net/projects/mpd/
+....
+
+The WWW variable immediately follows the COMMENT variable in the [.filename]#Makefile#.
+
+If the URI is the root of the website or directory, it must be terminated with a slash.
+
+This information used to be placed into the last line of the [.filename]#pkg-descr# file.
+It has been moved into the Makefile for easier maintenance and processing.
+Having a `WWW:` line at the end of the [.filename]#pkg-descr# file is deprecated.
+
[[licenses]]
== Licenses
diff --git a/documentation/content/en/books/porters-handbook/order/_index.adoc b/documentation/content/en/books/porters-handbook/order/_index.adoc
--- a/documentation/content/en/books/porters-handbook/order/_index.adoc
+++ b/documentation/content/en/books/porters-handbook/order/_index.adoc
@@ -112,6 +112,7 @@
* crossref:makefiles[makefile-maintainer,`MAINTAINER`]
* crossref:makefiles[makefile-comment,`COMMENT`]
+* crossref:makefiles[makefile-www,`WWW`]
[[porting-order-license]]
== `LICENSE` Block
diff --git a/documentation/content/en/books/porters-handbook/plist/_index.adoc b/documentation/content/en/books/porters-handbook/plist/_index.adoc
--- a/documentation/content/en/books/porters-handbook/plist/_index.adoc
+++ b/documentation/content/en/books/porters-handbook/plist/_index.adoc
@@ -248,6 +248,7 @@
MAINTAINER= perl@FreeBSD.org
COMMENT= Building machine
+WWW= http://search.cpan.org/dist/Machine-Build
USES= perl5
USE_PERL5= configure
diff --git a/documentation/content/en/books/porters-handbook/porting-samplem/_index.adoc b/documentation/content/en/books/porters-handbook/porting-samplem/_index.adoc
--- a/documentation/content/en/books/porters-handbook/porting-samplem/_index.adoc
+++ b/documentation/content/en/books/porters-handbook/porting-samplem/_index.adoc
@@ -88,6 +88,7 @@
"ports@FreeBSD.org".]
MAINTAINER= asami@FreeBSD.org
COMMENT= DVI Previewer for the X Window System
+WWW= http://xdvi.sourceforge.net/
[license -- should not be empty]
LICENSE= BSD2CLAUSE
diff --git a/documentation/content/en/books/porters-handbook/quick-porting/_index.adoc b/documentation/content/en/books/porters-handbook/quick-porting/_index.adoc
--- a/documentation/content/en/books/porters-handbook/quick-porting/_index.adoc
+++ b/documentation/content/en/books/porters-handbook/quick-porting/_index.adoc
@@ -85,6 +85,7 @@
MAINTAINER= youremail@example.com
COMMENT= Cat chasing a mouse all over the screen
+WWW= http://www.daidouji.com/oneko/
.include <bsd.port.mk>
....
@@ -118,27 +119,6 @@
A well-written [.filename]#pkg-descr# describes the port completely enough that users would not have to consult the documentation or visit the website to understand what the software does, how it can be useful, or what particularly nice features it has.
Mentioning certain requirements like a graphical toolkit, heavy dependencies, runtime environment, or implementation languages help users decide whether this port will work for them.
-Include a URL to the official WWW homepage.
-Prepend _one_ of the websites (pick the most common one) with `WWW:` (followed by single space) so that automated tools will work correctly.
-If the URI is the root of the website or directory, it must be terminated with a slash.
-
-[NOTE]
-====
-If the listed webpage for a port is not available, try to search the Internet first to see if the official site moved, was renamed, or is hosted elsewhere.
-====
-
-This example shows how [.filename]#pkg-descr# looks:
-
-[.programlisting]
-....
-This is a port of oneko, in which a cat chases a poor mouse all over
-the screen.
- :
-(etc.)
-
-WWW: http://www.oneko.org/
-....
-
[[porting-pkg-plist]]
=== [.filename]#pkg-plist#
diff --git a/documentation/content/en/books/porters-handbook/special/_index.adoc b/documentation/content/en/books/porters-handbook/special/_index.adoc
--- a/documentation/content/en/books/porters-handbook/special/_index.adoc
+++ b/documentation/content/en/books/porters-handbook/special/_index.adoc
@@ -607,6 +607,7 @@
MAINTAINER= tobik@FreeBSD.org
COMMENT= Display statistics about your code
+WWW= https://github.com/XAMPPRocky/tokei
USES= cargo
USE_GITHUB= yes
@@ -651,6 +652,7 @@
MAINTAINER= tobik@FreeBSD.org
COMMENT= Display statistics about your code
+WWW= https://github.com/XAMPPRocky/tokei
USES= cargo
USE_GITHUB= yes
@@ -814,21 +816,22 @@
[.programlisting]
....
-PORTNAME= hey
-PORTVERSION= 0.1.4
-DISTVERSIONPREFIX= v
-CATEGORIES= benchmarks
+PORTNAME= hey
+PORTVERSION= 0.1.4
+DISTVERSIONPREFIX= v
+CATEGORIES= benchmarks
-MAINTAINER= dmgk@FreeBSD.org
-COMMENT= Tiny program that sends some load to a web application
+MAINTAINER= dmgk@FreeBSD.org
+COMMENT= Tiny program that sends some load to a web application
+WWW= https://github.com/rakyll/hey
-LICENSE= APACHE20
-LICENSE_FILE= ${WRKSRC}/LICENSE
+LICENSE= APACHE20
+LICENSE_FILE= ${WRKSRC}/LICENSE
-USES= go:modules
-GO_MODULE= github.com/rakyll/hey
+USES= go:modules
+GO_MODULE= github.com/rakyll/hey
-PLIST_FILES= bin/hey
+PLIST_FILES= bin/hey
.include <bsd.port.mk>
....
@@ -847,6 +850,7 @@
MAINTAINER= tobik@FreeBSD.org
COMMENT= Remote repository management made easy
+WWW= https://github.com/x-motemen/ghq
USES= go:modules
USE_GITHUB= yes
@@ -896,6 +900,7 @@
MAINTAINER= tobik@FreeBSD.org
COMMENT= Remote repository management made easy
+WWW= https://github.com/x-motemen/ghq
USES= go:modules
USE_GITHUB= yes
@@ -976,6 +981,7 @@
MAINTAINER= haskell@FreeBSD.org
COMMENT= Shell script analysis tool
+WWW= https://www.shellcheck.net/
USES= cabal
@@ -1307,7 +1313,7 @@
[NOTE]
====
-Ports of Perl modules which do not have an official website must link to `cpan.org` in the WWW line of [.filename]#pkg-descr#.
+Ports of Perl modules which do not have an official website must link to `cpan.org` in the WWW line of [.filename]#Makefile#.
The preferred URL form is `http://search.cpan.org/dist/Module-Name/` (including the trailing slash).
====
@@ -1597,6 +1603,7 @@
MAINTAINER= kwm@FreeBSD.org
COMMENT= Interactive tool for performing search and replace operations
+WWW= http://regexxer.sourceforge.net/
USES= gettext gmake localbase:ldflags pathfix pkgconfig tar:xz
GNU_CONFIGURE= yes
@@ -3399,6 +3406,7 @@
MAINTAINER= example@domain.com
COMMENT= PEAR Date and Time Zone Classes
+WWW= https://pear.php.net/package/Date
USES= pear
@@ -3446,6 +3454,7 @@
MAINTAINER= horde@FreeBSD.org
COMMENT= Horde Core Framework libraries
+WWW= http://pear.horde.org
OPTIONS_DEFINE= KOLAB SOCKETS
KOLAB_DESC= Enable Kolab server support
@@ -3570,6 +3579,7 @@
MAINTAINER= john@doe.tld
COMMENT= Python sample module
+WWW= https://pypi.org/project/sample
RUN_DEPENDS= ${PYTHON_PKGNAMEPREFIX}six>0:devel/py-six@${PY_FLAVOR}
@@ -4228,6 +4238,7 @@
MAINTAINER= john@doe.tld
COMMENT= Sample
+WWW= https://github.com/lua_sample/sample
RUN_DEPENDS= ${LUA_REFMODLIBDIR}/lpeg.so:devel/lua-lpeg@${LUA_FLAVOR}
@@ -4251,6 +4262,7 @@
MAINTAINER= john@doe.tld
COMMENT= Sample
+WWW= https://github.com/lua_sample/sample
USES= lua:module

File Metadata

Mime Type
text/plain
Expires
Sun, Mar 1, 11:45 PM (1 h, 14 m)
Storage Engine
blob
Storage Format
Raw Data
Storage Handle
29105627
Default Alt Text
D36369.id109933.diff (7 KB)

Event Timeline