From owner-svn-doc-all@FreeBSD.ORG Fri May 25 16:44:44 2012 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52]) by hub.freebsd.org (Postfix) with ESMTP id 3E625106566B; Fri, 25 May 2012 16:44:44 +0000 (UTC) (envelope-from gjb@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:4f8:fff6::2c]) by mx1.freebsd.org (Postfix) with ESMTP id 1F4E78FC0A; Fri, 25 May 2012 16:44:44 +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 q4PGihpR021549; Fri, 25 May 2012 16:44:43 GMT (envelope-from gjb@svn.freebsd.org) Received: (from gjb@localhost) by svn.freebsd.org (8.14.4/8.14.4/Submit) id q4PGihZt021547; Fri, 25 May 2012 16:44:43 GMT (envelope-from gjb@svn.freebsd.org) Message-Id: <201205251644.q4PGihZt021547@svn.freebsd.org> From: Glen Barber Date: Fri, 25 May 2012 16:44:43 +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: r38887 - head/en_US.ISO8859-1/books/fdp-primer/translations 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: Fri, 25 May 2012 16:44:44 -0000 Author: gjb Date: Fri May 25 16:44:43 2012 New Revision: 38887 URL: http://svn.freebsd.org/changeset/doc/38887 Log: Update fdp-primer/translations/chapter.sgml to reflect the CVS->SVN conversion, plus some additional fixes: - Update CVS-specific notes with SVN-specific counterparts - Provide an in-document example of a checkout from svn - Note devel/subversion is required - Replace a TODO item with an example of how to obtain a diff between two versions of a file - Replace "?" with "." at the end of a non-question - Replace "doc/" with "head/" as the top-level directory where necessary - Add the new "htdocs/" directory to the sample sv_SE directory layout - Update sample FreeBSD RCS IDs to the svn-style Modified: head/en_US.ISO8859-1/books/fdp-primer/translations/chapter.sgml Modified: head/en_US.ISO8859-1/books/fdp-primer/translations/chapter.sgml ============================================================================== --- head/en_US.ISO8859-1/books/fdp-primer/translations/chapter.sgml Fri May 25 14:40:55 2012 (r38886) +++ head/en_US.ISO8859-1/books/fdp-primer/translations/chapter.sgml Fri May 25 16:44:43 2012 (r38887) @@ -133,21 +133,28 @@ It is strongly recommended that you maintain a local - copy of the FreeBSD CVS repository (at least the - documentation part) either using - CTM or - CVSup. The "Staying current with - FreeBSD" chapter in the Handbook explains how to use these - applications. + copy of the FreeBSD Subversion repository (at least the + documentation part). This can be done by running: + + &prompt.user; svn checkout svn://svn.FreeBSD.org/doc/head/ head + + + This will require the devel/subversion package to + be installed. + You should be comfortable using - CVS. This will allow you to see + svn. This will allow you to see what has changed between different versions of the files that make up the documentation. - [XXX To Do -- write a tutorial that shows how to use - CVSup to get just the documentation, check it out, and see - what has changed between two arbitrary revisions] + For example, to view the differences between revisions + r33733 and r33734 of + en_US.ISO8859-1/books/fdp-primer/book.sgml, + run: + + &prompt.user; svn diff -r33733:33734 en_US.ISO8859-1/books/fdp-primer/book.sgml @@ -237,7 +244,7 @@ We are a translation team, and want to submit documentation that our members have translated for - us? + us. @@ -246,7 +253,7 @@ documentation tree and build straight away. Currently, the FreeBSD documentation is stored in a top - level directory called doc/. + level directory called head/. Directories below this are named according to the language code they are written in, as defined in ISO639 (/usr/share/misc/iso639 on a version of @@ -262,9 +269,11 @@ For example, a hypothetical Swedish translation might look like: - doc/ + head/ sv_SE.ISO8859-1/ Makefile + htdocs/ + docproj/ books/ faq/ Makefile @@ -440,14 +449,14 @@ <!-- The FreeBSD Documentation Project - $FreeBSD: doc/en_US.ISO8859-1/books/fdp-primer/translations/chapter.sgml,v 1.5 2000/07/07 18:38:38 dannyboy Exp $ + $FreeBSD: head/en_US.ISO8859-1/books/faq/book.sgml 38674 2012-04-14 13:52:52Z $ --> The exact boilerplate may change, but it will always include a $FreeBSD$ line and the phrase The FreeBSD Documentation Project. Note that the $FreeBSD part is expanded automatically - by CVS, so it should be empty (just + by Subversion, so it should be empty (just $FreeBSD$) for new files. @@ -465,8 +474,8 @@ <!-- The FreeBSD Spanish Documentation Project - $FreeBSD: doc/es_ES.ISO8859-1/books/fdp-primer/translations/chapter.sgml,v 1.3 1999/06/24 19:12:32 jesusr Exp $ - Original revision: 1.11 + $FreeBSD: head/es_ES.ISO8859-1/books/faq/book.sgml 38826 2012-05-17 19:12:14Z hrs $ + Original revision: r38674 -->