Date: Sun, 20 May 2012 00:37:19 +0000 (UTC) From: Glen Barber <gjb@FreeBSD.org> To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r38842 - head/en_US.ISO8859-1/books/fdp-primer/overview Message-ID: <201205200037.q4K0bJwn055648@svn.freebsd.org>
next in thread | raw e-mail | index | archive | help
Author: gjb Date: Sun May 20 00:37:19 2012 New Revision: 38842 URL: http://svn.freebsd.org/changeset/doc/38842 Log: Update the FDP Primer Overview chapter to reflect the CVS->SVN repository conversion: - Update an overview of where (as in, what repository) various parts of the documentation project are located. - Update CVS->Subversion/svn where necessary. - Remove references to CVSup, CTM. - Update commands for checking out the documentation tree. - In an example, prefer to use 'svn export foo bar' instead of 'cp -R foo bar', since the latter will also copy '.svn' directories (if they exist). 'svn export' is much cleaner, and will produce a diff that makes sense. Modified: head/en_US.ISO8859-1/books/fdp-primer/overview/chapter.sgml Modified: head/en_US.ISO8859-1/books/fdp-primer/overview/chapter.sgml ============================================================================== --- head/en_US.ISO8859-1/books/fdp-primer/overview/chapter.sgml Sat May 19 23:49:28 2012 (r38841) +++ head/en_US.ISO8859-1/books/fdp-primer/overview/chapter.sgml Sun May 20 00:37:19 2012 (r38842) @@ -133,15 +133,21 @@ </varlistentry> </variablelist> - <para>These four groups of documentation are all available in the - FreeBSD CVS tree. This means that the logs of changes to these - files are visible to anyone, and anyone can use a program such - as <application>CVSup</application> or - <application>CTM</application> to keep local copies of this - documentation.</para> + <para>The documentation for the web site, &os; Handbook, and FAQ + are available in the <literal>doc/</literal> Subversion + repository, which is located at + <literal>svn://svn.FreeBSD.org/doc/</literal>.</para> + + <para>Manual pages are available in the <literal>src/</literal> + Subversion repository, which is available at + <literal>svn://svn.FreeBSD.org/base/</literal>.</para> + + <para>This means that the logs of changes to these + files are visible to anyone, and anyone can use + <application>svn</application> to view the changes.</para> <para>In addition, many people have written tutorials or other web - sites relating to FreeBSD. Some of these are stored in the CVS + sites relating to FreeBSD. Some of these are stored in the Subversion repository as well (where the author has agreed to this). In other cases the author has decided to keep his documentation separate from the main FreeBSD repository. The FDP endeavors to @@ -158,11 +164,7 @@ <listitem> <para>How to maintain an up-to-date local copy of the FreeBSD documentation by maintaining a local copy of the - FreeBSD CVS repository (using <application>CVS</application> - and either <application>CVSup</application> or - <application>CTM</application>) or by using - <application>CVSup</application> to download just a - <emphasis>checked-out</emphasis> copy.</para> + FreeBSD Subversion repository using <application>svn</application>.</para> </listitem> <listitem> @@ -191,23 +193,23 @@ <step> <para>Get a local copy of the FreeBSD <filename>doc</filename> - tree. Either use CVSup in <literal>checkout</literal> mode - to do this, or get a full copy of the CVS repository - locally.</para> - - <para>If you have the CVS repository locally then as a minimum - you will need to checkout the - <filename>doc/share</filename>, and - <filename>doc/en_US.ISO8859-1/share</filename> - directories.</para> + tree using <application>svn</application>.</para> - <screen>&prompt.user; <userinput>cvs checkout doc/share</userinput> -&prompt.user; <userinput>cvs checkout doc/en_US.ISO8859-1/share</userinput></screen> + <para>If network bandwidth or local drive space is a concern, + then at minimum, the <filename>head/share</filename> and + <filename>head/<replaceable>language</replaceable>/share</filename> + directories will need to be checked out. For + example:</para> + + <screen>&prompt.user; <userinput>mkdir -p head/share</userinput> +&prompt.user; <userinput>mkdir -p head/en_US.ISO8859-1/share</userinput> +&prompt.user; <userinput>svn checkout svn://svn.freebsd.org/doc/head/share head/share</userinput> +&prompt.user; <userinput>svn checkout svn://svn.freebsd.org/doc/head/en_US.ISO8859-1/share head/en_US.ISO8859-1/share</userinput></screen> <para>If you have plenty of disk space then you could check out everything.</para> - <screen>&prompt.user; <userinput>cvs checkout doc</userinput></screen> + <screen>&prompt.user; <userinput>svn checkout svn://svn.freebsd.org/doc/head head</userinput></screen> </step> <step> @@ -225,7 +227,7 @@ <para>Check out the <filename>articles</filename> directory.</para> - <screen>&prompt.user; <userinput>cvs checkout doc/en_US.ISO8859-1/articles</userinput></screen> + <screen>&prompt.user; <userinput>svn checkout svn://svn.freebsd.org/doc/head/en_US.ISO8859-1/articles</userinput></screen> </step> <step> @@ -234,17 +236,17 @@ belongs in a directory called <filename>vpn-w2k</filename>.</para> - <screen>&prompt.user; <userinput>cd doc/en_US.ISO8859-1/articles</userinput> -&prompt.user; <userinput>cp -R committers-guide vpn-w2k</userinput></screen> + <screen>&prompt.user; <userinput>cd head/en_US.ISO8859-1/articles</userinput> +&prompt.user; <userinput>svn export committers-guide vpn-w2k</userinput></screen> </step> </procedure> <para>If you wanted to edit an existing document, such as the FAQ, which is in - <filename>doc/en_US.ISO8859-1/books/faq</filename> you would + <filename>head/en_US.ISO8859-1/books/faq</filename> you would check it out of the repository like this.</para> - <screen>&prompt.user; <userinput>cvs checkout doc/en_US.ISO8859-1/books/faq</userinput></screen> + <screen>&prompt.user; <userinput>svn checkout svn://svn.freebsd.org/doc/head/en_US.ISO8859-1/books/faq</userinput></screen> </step> <step> @@ -268,7 +270,7 @@ <literal>pdf</literal>, and <literal>rtf</literal> are supported. The most up to date list of supported formats is listed at the top of the - <filename>doc/share/mk/doc.docbook.mk</filename> file. Make + <filename>head/share/mk/doc.docbook.mk</filename> file. Make sure to use quotes around the list of formats when you build more than one format with a single command.</para>
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201205200037.q4K0bJwn055648>