git: be6f122288 - main - Remove dated and misleading paragraph on headers

Chris Rees crees at FreeBSD.org
Wed Mar 3 15:14:11 UTC 2021


The branch main has been updated by crees:

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

commit be6f122288de4bcd07a3ce78e5dcb764e88cb909
Author:     Chris Rees <crees at FreeBSD.org>
AuthorDate: 2021-03-03 14:54:44 +0000
Commit:     Chris Rees <crees at FreeBSD.org>
CommitDate: 2021-03-03 15:13:22 +0000

    Remove dated and misleading paragraph on headers
    
    We no longer have any of the "Ports collection Makefile for...." lines,
    so they do not need to be explained.
    
    Differential:   https://reviews.freebsd.org/D23589
    Submitted by:   salvadore (based on)
    Reviewed by:    mat
---
 .../content/en/books/porters-handbook/porting-samplem/chapter.adoc   | 1 -
 .../content/en/books/porters-handbook/quick-porting/chapter.adoc     | 5 -----
 2 files changed, 6 deletions(-)

diff --git a/documentation/content/en/books/porters-handbook/porting-samplem/chapter.adoc b/documentation/content/en/books/porters-handbook/porting-samplem/chapter.adoc
index 1196dc5813..9a7dbc37a2 100644
--- a/documentation/content/en/books/porters-handbook/porting-samplem/chapter.adoc
+++ b/documentation/content/en/books/porters-handbook/porting-samplem/chapter.adoc
@@ -35,7 +35,6 @@ The format shown is the recommended one for ordering variables, empty lines betw
 
 [.programlisting]
 ....
-[the header...just to make it easier for us to identify the ports.]
 # $FreeBSD$
 [ ^^^^^^^^^ This will be automatically replaced with RCS ID string by SVN
 when it is committed to our repository.  If upgrading a port, do not alter
diff --git a/documentation/content/en/books/porters-handbook/quick-porting/chapter.adoc b/documentation/content/en/books/porters-handbook/quick-porting/chapter.adoc
index 48d0cef894..08f96c6dab 100644
--- a/documentation/content/en/books/porters-handbook/quick-porting/chapter.adoc
+++ b/documentation/content/en/books/porters-handbook/quick-porting/chapter.adoc
@@ -70,11 +70,6 @@ COMMENT=	Cat chasing a mouse all over the screen
 .include <bsd.port.mk>
 ....
 
-[NOTE]
-====
-In some cases, the [.filename]#Makefile# of an existing port may contain additional lines in the header, such as the name of the port and the date it was created. This additional information has been declared obsolete, and is being phased out.
-====
-
 Try to figure it out. Do not worry about the contents of the `$FreeBSD$` line, it will be filled in automatically by Subversion when the port is imported to our main ports tree. A more detailed example is shown in the <<porting-samplem,sample Makefile>> section.
 
 [[porting-desc]]


More information about the dev-commits-doc-all mailing list