From owner-svn-doc-all@FreeBSD.ORG Sun Jul 15 19:27:18 2012 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 5A2CF106566B; Sun, 15 Jul 2012 19:27:18 +0000 (UTC) (envelope-from beat@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:4f8:fff6::2c]) by mx1.freebsd.org (Postfix) with ESMTP id 43CED8FC08; Sun, 15 Jul 2012 19:27:18 +0000 (UTC) Received: from svn.freebsd.org (localhost [127.0.0.1]) by svn.freebsd.org (8.14.4/8.14.4) with ESMTP id q6FJRIUf067632; Sun, 15 Jul 2012 19:27:18 GMT (envelope-from beat@svn.freebsd.org) Received: (from beat@localhost) by svn.freebsd.org (8.14.4/8.14.4/Submit) id q6FJRI87067629; Sun, 15 Jul 2012 19:27:18 GMT (envelope-from beat@svn.freebsd.org) Message-Id: <201207151927.q6FJRI87067629@svn.freebsd.org> From: Beat Gaetzi Date: Sun, 15 Jul 2012 19:27:18 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Cc: Subject: svn commit: r39216 - in head: en_US.ISO8859-1/books/porters-handbook share/sgml X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "SVN commit messages for the entire doc trees \(except for " user" , " projects" , and " translations" \)" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 15 Jul 2012 19:27:18 -0000 Author: beat (ports committer) Date: Sun Jul 15 19:27:17 2012 New Revision: 39216 URL: http://svn.freebsd.org/changeset/doc/39216 Log: - Add information about Subversion PR: docs/169771 Submitted by: myself, modified by wblock Approved by: wblock Modified: head/en_US.ISO8859-1/books/porters-handbook/book.sgml head/share/sgml/man-refs.ent Modified: head/en_US.ISO8859-1/books/porters-handbook/book.sgml ============================================================================== --- head/en_US.ISO8859-1/books/porters-handbook/book.sgml Sun Jul 15 16:30:14 2012 (r39215) +++ head/en_US.ISO8859-1/books/porters-handbook/book.sgml Sun Jul 15 19:27:17 2012 (r39216) @@ -143,7 +143,7 @@ USE_IMAKE= yes See if you can figure it out. Do not worry about the contents of the $FreeBSD$ - line, it will be filled in automatically by CVS when the port + line, it will be filled in automatically by SVN when the port is imported to our main ports tree. You can find a more detailed example in the sample Makefile @@ -716,7 +716,7 @@ PLIST_DIRS= lib/X11/onekopatch-ab etc, always mention the path and file name in patch names. - Do not put RCS strings in patches. CVS will mangle them + Do not put RCS strings in patches. SVN will mangle them when we put the files into the ports tree, and when we check them out again, they will come out different and the patch will fail. RCS strings are surrounded by dollar @@ -747,7 +747,7 @@ PLIST_DIRS= lib/X11/oneko @@ -4144,7 +4144,7 @@ ${MANPREFIX}/man/de/man3/baz.3.gzThese variables are designed to be set by the system administrator. There are many that are standardized in the ports/KNOBS + url="http://svn.FreeBSD.org/ports/head/KNOBS?view=markup">ports/KNOBS file. When creating a port, do not make knob names specific @@ -4224,7 +4224,7 @@ ${MANPREFIX}/man/de/man3/baz.3.gzKNOBS + url="http://svn.FreeBSD.org/ports/head/KNOBS?view=markup">KNOBS file. Knob names should reflect what the knob is and does. @@ -6951,8 +6951,8 @@ QT_COMPONENTS= moc_build qmake_build rcc section are implemented in bsd.java.mk. If you ever think that your port needs more sophisticated Java support, please first have a look at the - bsd.java.mk CVS log as it usually takes some time + url="http://svn.FreeBSD.org/ports/head/Mk/bsd.java.mk?view=markup">bsd.java.mk + SVN log as it usually takes some time to document the latest features. Then, if you think the support you are lacking would be beneficial to many other Java ports, feel free to discuss it on the &a.java;. @@ -9066,8 +9066,7 @@ CFLAGS+= -DLUA_VERSION_STRING="${VER_STR More details are available in - bsd.database.mk. + url="http://svn.FreeBSD.org/ports/head/Mk/bsd.database.mk?view=markup">bsd.database.mk. @@ -10204,8 +10203,8 @@ as .putsy.conf and edit it.&prompt.user; /usr/bin/diff something.orig something > something.diff - Otherwise, you should either use the cvs - diff method () or copy the + Otherwise, you should either use the svn + diff method () or copy the contents of the port to an entire different directory and use the result of the recursive &man.diff.1; output of the new and old ports directories (e.g., if your modified port directory is @@ -10244,7 +10243,7 @@ as .putsy.conf and edit it.Class of your PR should be change-request. Please mention any added or deleted files in the message, as they have to be explicitly - specified to &man.cvs.1; when doing a commit. If the diff is + specified to &man.svn.1; when doing a commit. If the diff is more than about 20KB, please compress and uuencode it; otherwise, just include it in the PR as is. @@ -10273,11 +10272,11 @@ as .putsy.conf and edit it.Now that you have done all that, you will want to read about how to keep up-to-date in . - - Using <literal>CVS</literal> to Make Patches + + Using <literal>SVN</literal> to Make Patches - If you can, please submit a &man.cvs.1; diff; they are - easier to handle than diffs between new and old + If you can, please submit a &man.svn.1 diff; they are easier to + handle than diffs between new and old directories. Plus it is easier for you to see what you have changed and to update your diff if something is modified in the Ports Collection from when you started to work on it until @@ -10285,7 +10284,7 @@ as .putsy.conf and edit it. &prompt.user; cd ~/my_wrkdir -&prompt.user; cvs -d R_CVSROOT co pdnsd +&prompt.user; svn co svn://svn.FreeBSD.org/ports/head/dns/pdnsd &prompt.user; cd ~/my_wrkdir/pdnsd @@ -10296,53 +10295,38 @@ as .putsy.conf and edit it./usr/ports/. - - R_CVSROOT is any public cvs server, see how to use cvs - in the &os; - Handbook. - - - - pdnsd is the module name for the port; it is generally - the name of the port, although there are some exceptions, - notably for language-specific categories (german/selfhtml has the module - name de-selfhtml); you can either look up the module name - via the cvsweb - interface or use the whole path, in our example - ports/dns/pdnsd. + + svn.FreeBSD.org + is a public SVN server. While in the working directory, make any changes that you would usually make to the port. If you add or remove a file, - use cvs to track these changes: + use svn to track these changes: - &prompt.user; cvs add new_file -&prompt.user; cvs remove deleted_file + &prompt.user; svn add new_file +&prompt.user; svn remove deleted_file Make sure that you check the port using the checklist in and . - &prompt.user; cvs status -&prompt.user; cvs update + &prompt.user; svn status +&prompt.user; svn update - + This will try to merge the differences between your - patch and current CVS; watch the output carefully. The + patch and current SVN; watch the output carefully. The letter in front of each file name indicates what was done - with it. See for a complete + with it. See for a complete list. - - <literal>CVS</literal> Update File Prefixes +
+ <literal>SVN</literal> Update File Prefixes @@ -10352,7 +10336,7 @@ as .putsy.conf and edit it. - P + G The file was updated without problems (you will only see this when working against a remote repository). @@ -10374,17 +10358,17 @@ as .putsy.conf and edit it. If you get C as a result of - cvs update it means something changed in - the CVS and &man.cvs.1; was not able to merge your local - changes and those from CVS. It is always a good idea to - inspect the changes anyway, since cvs does - not know anything about how a port should be, so it might (and - probably will) merge things that do not make sense. + svn update it means something changed in + the SVN repository and &man.svn.1; was not able to merge your + local changes and those from the repository. It is always a good idea + to inspect the changes anyway, since &man.svn.1; + does not know anything about how a port should be, so it might + (and probably will) merge things that do not make sense. The last step is to make a unified &man.diff.1; - of the files against CVS: + of the files against SVN: - &prompt.user; cvs diff -uN > ../`basename ${PWD}`.diff + &prompt.user; svn diff -N > ../`basename ${PWD}`.diff It is important to use to ensure @@ -11028,7 +11012,7 @@ Reference: <http://www.freebsd.org/po The preferred way to tell 4.3BSD/Reno (1990) and newer versions of the BSD code apart is by using the BSD macro defined in sys/param.h. + url="http://svnweb.freebsd.org/base/head/sys/sys/param.h?view=markup">sys/param.h. Hopefully that file is already included; if not, add the code: @@ -11132,7 +11116,7 @@ Reference: <http://www.freebsd.org/po Here is a convenient list of __FreeBSD_version values as defined in sys/param.h: + url="http://svnweb.FreeBSD.org/base/head/sys/sys/param.h?view=markup">sys/param.h:
<literal>__FreeBSD_version</literal> Values @@ -15782,7 +15766,7 @@ exec %%LOCALBASE%%/bin/java -jar %%DATAD <filename>README.html</filename>Do not include the README.html file. - This file is not part of the cvs collection but is generated + This file is not part of the SVN collection but is generated using the make readme command. @@ -16198,9 +16182,9 @@ not be changed when upgrading the port l # Whom: Satoshi Asami <asami@FreeBSD.org> # # $FreeBSD$ -[ ^^^^^^^^^ This will be automatically replaced with RCS ID string by CVS +[ ^^^^^^^^^ 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 -this line back to "$FreeBSD$". CVS deals with it automatically.] +this line back to "$FreeBSD$". SVN deals with it automatically.] # [section to describe the port itself and the master site - PORTNAME @@ -16311,20 +16295,20 @@ pre-install: commits. - + The Web Interface to the Source Repository It is possible to browse the files in the source repository by using a web interface. Changes that affect the entire port system are now documented in the - CHANGES file. Changes that affect individual ports + url="http://svnweb.FreeBSD.org/ports/head/CHANGES">CHANGES + file. Changes that affect individual ports are now documented in the - UPDATING file. However, the definitive answer to + url="http://svnweb.FreeBSD.org/ports/head/UPDATING">UPDATING + file. However, the definitive answer to any question is undoubtedly to read the source code of - bsd.port.mk, and associated files. + url="http://svnweb.FreeBSD.org/ports/head/Mk/bsd.port.mk">bsd.port.mk, + and associated files. Modified: head/share/sgml/man-refs.ent ============================================================================== --- head/share/sgml/man-refs.ent Sun Jul 15 16:30:14 2012 (r39215) +++ head/share/sgml/man-refs.ent Sun Jul 15 19:27:17 2012 (r39216) @@ -614,6 +614,7 @@ +