diff options
author | Thomas Lange <lange@informatik.uni-koeln.de> | 2019-03-17 12:13:33 +0100 |
---|---|---|
committer | Thomas Lange <lange@informatik.uni-koeln.de> | 2019-03-17 12:13:33 +0100 |
commit | e64f14dabbc209061f6ad3b317236189aa702271 (patch) | |
tree | 3e302dc6f4a63aa96c17724611d9b294b3b4ce78 /english | |
parent | 19e3a0d71b6a59d450a3275b97188eda8fc1a4d2 (diff) |
remove obsolete docs about cvs
Diffstat (limited to 'english')
-rw-r--r-- | english/devel/website/index.wml | 1 | ||||
-rw-r--r-- | english/devel/website/using_cvs.wml | 174 |
2 files changed, 0 insertions, 175 deletions
diff --git a/english/devel/website/index.wml b/english/devel/website/index.wml index 4b7e56fa221..bea82491236 100644 --- a/english/devel/website/index.wml +++ b/english/devel/website/index.wml @@ -23,7 +23,6 @@ All discussions involving the web site are held there.</p> <li><a href="working">creating or editing pages in English</a> <ul> <li><a href="using_git">how to use git</a></li> - <li><a href="using_cvs">how to use CVS (deprecated)</a></li> <li><a href="using_wml">how to use WML</a></li> <li><a href="htmlediting">how to use HTML in Debian Web pages</a></li> <li><a href="todo">the to-do list</a></li> diff --git a/english/devel/website/using_cvs.wml b/english/devel/website/using_cvs.wml deleted file mode 100644 index caee6fa1a4b..00000000000 --- a/english/devel/website/using_cvs.wml +++ /dev/null @@ -1,174 +0,0 @@ -#use wml::debian::template title="Using CVS (deprecated)" - -<div class="important"> -<h3>Important note</h3> - -<p>We recently converted the website content repository from CVS to -git. This page is here for historical interest only. See our <a -href="using_git">guide to using git</a> instead. </p> -</div> - -<p>CVS is a program to help manage having multiple people work on -the same material simultaneously. Every user creates a local copy -of the main repository. The local copies can be on the same machine, -or across the world. Users can then modify the local copy as they -wish and when the modified material is ready, commit the changes -back to the main repository.</p> - -<p>For a read only access it's possible -to use the <a href="https://anonscm.debian.org/viewvc/webwml/webwml/">web -frontend</a>. There exist also many graphical CVS clients such as -KDE's <a href="https://packages.debian.org/cervisia">cervisia</a>. -This document describes the workflow with the command line program -<code>cvs</code>, other clients provide similar functionality.</p> - -<p>CVS will not let you commit a file if the copy in the main -repository has been modified since your last update. This is -not normally a problem as you can still update your local copy. -If the modifications were to different parts than you were working -on, the changes are silently merged. If the changes affect the same area you -were working on, you will be warned that there is a conflict -and you need to edit the file to fix the problem before committing.</p> - -<p>In what follows anonymous access will be used as an example. If -you have access to another account which gives you write permission to -the repository then you should use that account instead. If you -are planning on making changes, you should get an account before -starting as anonymous users cannot commit changes. See <a -href="#write-access">the section on write access</a> for more -information.</p> - -<p>To begin using CVS, you must first <code>login</code> to the CVS server</p> - -<pre> - cvs -d :pserver:anonymous@anonscm.debian.org:/cvs/webwml login -</pre> - -<p>(just hit enter for the password here)</p> - -<p>To check out a copy of the wml files on your local machine, you need to use</p> - -<pre> - cvs -d :pserver:anonymous@anonscm.debian.org:/cvs/webwml checkout webwml -</pre> - -<p>You can check out a subset of the pages like this:</p> - -<pre> - cvs -d :pserver:anonymous@anonscm.debian.org:/cvs/webwml checkout -l \\ - webwml webwml/<<var>language</var>> - cvs -d :pserver:anonymous@anonscm.debian.org:/cvs/webwml checkout \\ - webwml/Perl webwml/english/template webwml/<<var>language</var>>/Pics - cvs -d :pserver:anonymous@anonscm.debian.org:/cvs/webwml checkout \\ - webwml/<<var>language</var>>/<<var>path to desired files</var>> -</pre> - -<p>Repeat for all subdirectories or files that you want. The second line -includes all the files you will need if you wish to create HTML from the WML -files. Partial checkouts such as these aren't really supported, though, so -the above instructions may not always work.</p> - -<p> -For write access to the repository over SSH you may need to tell CVS to -use SSH instead of rsh for logging in by adding a line to your shell config: -</p> - -<pre> - export CVS_RSH=ssh -</pre> - -<p> -If you have an Alioth account, with an associated <a -href="https://alioth.debian.org/account/editsshkeys.php">\ -public SSH key</a>, you can use it instead like this: -</p> - -<pre> - cvs -d :ext:username@cvs.debian.org:/cvs/webwml checkout webwml/english/doc -</pre> - -<p>From then on, you will not need to use the <code>'-d :ext:...'</code> -part. Every few days you will want to do a</p> - -<pre> - cvs update -d -</pre> - -<p>to retrieve any files from the repository which have changed. The -<code>-d</code> update option will add any new directories, automatically. -It will also check out all the directories that were omitted if you performed a -partial checkout — in that case you might want to use the -<code>cvsup.py</code> script.</p> - -<p> -You may want to create a <code>~/.cvsrc</code> file so that you don't have -to type some options all the time. For example, it can contain:</p> - -<pre> -cvs -z9 -update -d -P -diff -u -</pre> - -<p>The following is for those who have write permission on the repository. -When you are done with a page, you can commit your changes to the repository using</p> - -<pre> - cvs commit <file>.wml -</pre> - -<p>or</p> - -<pre> - cvs commit <dir> (to commit all the changes in <dir>) -</pre> - -<p>or</p> - -<pre> - cvs commit (to commit all changes from the current dir down) -</pre> - -<p>If you are the first person translating a page, you need to do</p> - -<pre> - cvs add <file>.wml -</pre> - -<p>before you commit it. Note that <code>cvs add</code> is not recursive so -you need to add a directory before you can add its contents.</p> - -<p>For more information on CVS, use <code>info cvs</code>.</p> - -<p> -If you include <code>Closes: #</code><var>nnnnnn</var> in your commit log -entry then bug number <code>#</code><var>nnnnnn</var> will be closed -automatically when you commit. The precise form of this is the same as -<a href="$(DOC)/debian-policy/ch-source.html#id24">in Debian policy</a>.</p> - -<p> -Many Debian websites support SSL, please use HTTPS links for the -ones that do support SSL. -Some Debian/DebConf/SPI/etc websites do not have HTTPS support or are -only signed by SPI and not by any SSL CA that is trusted by browsers -outside of Debian, we should avoid linking to https: versions of -these websites so that people not using Debian don't get errors -they may not understand. -The CVS repository will reject commits containing plain HTTP links for -Debian websites that support HTTPS or containing HTTPS links for the -Debian/DebConf/SPI websites that are known to either not -support HTTPS or use certificates signed only by SPI.</p> - -<h3><a name="write-access">CVS Write Access</a></h3> - -<p> -If you already know <a href="$(DEVEL)/website/desc#help">how to help</a>, and -have provided enough patches that have been accepted by the web team or a -localization team, you could obtain write access to the website: please <a -href="https://alioth.debian.org/project/request.php?group_id=1135">request -to join the <code>webwml</code> project on Alioth</a> (you will have to <a -href="https://alioth.debian.org/account/register.php">create an Alioth -account</a> if you don't already have one). -Please write something useful in your request, like which language or which -part of the website you plan to work on, and who would vouch for you. -</p> |