Page MenuHomeFreeBSD

D36369.diff
No OneTemporary

D36369.diff

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,34 @@
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= https://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 same content can be accessed via HTTP and HTTPS, the URL starting with `https://` shall be used.
+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/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= https://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,11 @@
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.
+The URL that used to be included as the last line of the [.filename]#pkg-descr# file has been moved to the [.filename]#Makefile#.
====
-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
@@ -821,6 +823,7 @@
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
@@ -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
@@ -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= https://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
Thu, Nov 27, 7:13 AM (10 h, 33 m)
Storage Engine
blob
Storage Format
Raw Data
Storage Handle
26226778
Default Alt Text
D36369.diff (6 KB)

Event Timeline