diff options
author | Guillem Jover <guillem@debian.org> | 2018-07-11 15:58:02 +0200 |
---|---|---|
committer | Guillem Jover <guillem@debian.org> | 2019-03-18 00:12:58 +0100 |
commit | 63b253e9f683a3e51632a8be03911a02d53a936e (patch) | |
tree | c573e359ed5eda960de26eaf0ed2d548193759b9 | |
parent | 49505301a59910f7d0772a52219bfabfd50fd508 (diff) |
doc: Rename doc/cvs.wml to doc/vcs.wml
Keep the original in place with a text to redirect users to the new
page.
-rw-r--r-- | english/doc/Makefile | 1 | ||||
-rw-r--r-- | english/doc/cvs.wml | 106 | ||||
-rw-r--r-- | english/doc/vcs.wml | 103 |
3 files changed, 105 insertions, 105 deletions
diff --git a/english/doc/Makefile b/english/doc/Makefile index 7c589eabb49..37b1f272b0e 100644 --- a/english/doc/Makefile +++ b/english/doc/Makefile @@ -16,6 +16,7 @@ books.$(LANGUAGE).html: books.wml $(ENGLISHSRCDIR)/doc/books.def \ ddp.$(LANGUAGE).html: ddp.wml $(TEMPLDIR)/ddp.wml todo.$(LANGUAGE).html: todo.wml $(TEMPLDIR)/ddp.wml docpolicy.$(LANGUAGE).html: docpolicy.wml $(TEMPLDIR)/ddp.wml +vcs.$(LANGUAGE).html: vcs.wml $(TEMPLDIR)/ddp.wml cvs.$(LANGUAGE).html: cvs.wml $(TEMPLDIR)/ddp.wml topics.$(LANGUAGE).html: topics.wml $(TEMPLDIR)/ddp.wml user-manuals.$(LANGUAGE).html: user-manuals.wml $(TEMPLDIR)/ddp.wml \ diff --git a/english/doc/cvs.wml b/english/doc/cvs.wml index 195f684f9c6..86c4fcd84c9 100644 --- a/english/doc/cvs.wml +++ b/english/doc/cvs.wml @@ -1,105 +1 @@ -#use wml::debian::ddp title="Debian Documentation Project VCS" -#use wml::debian::toc - -<p>The Debian Documentation Project stores its web pages and much of the -manual text on the Debian Salsa service at -<strong>salsa.debian.org</strong>, which is Debian's GitLab instance. -Please read the <a href="https://wiki.debian.org/Salsa">Salsa documentation</a> -for more information about how this service works. -</p> - -<p>Everybody can download the sources from the Salsa service. Only members of -the Debian Documentation Project can update files.</p> - -<toc-display /> - -<toc-add-entry name="access">Accessing the sources in git</toc-add-entry> - -<p>You can use a web interface to access the files individually and -see changes on each project at -<url "https://salsa.debian.org/ddp-team/" /></p> - -<p>For downloading an entire manual, direct access to the git server -is often a better option. You need the -<tt><a href="https://packages.debian.org/git">git</a></tt> package on your -own machine.</p> - -<h3>Cloning a git repository anonymously (read-only)</h3> - -<p>Use this command to download all the files for one project:</p> - -<p style="margin-left: 2em"> - <code>git clone https://salsa.debian.org/ddp-team/release-notes.git</code> -</p> - -<p>Do the same for every project you want to clone locally.</p> - -<h3>Cloning a git repository with push privileges (read-write)</h3> - -<p>Before accessing the git server using this method you have to be -granted write access to it first. Please read how to <a -href="#obtaining">request</a> push permission first.</p> - -<p>Use this command to download all the files for one project:</p> - -<p style="margin-left: 2em"> - <code>git clone git@salsa.debian.org:ddp-team/release-notes.git</code> -</p> - -<p>Do the same for every project you want to clone locally.</p> - -<h3>Fetching changes from the remote git repository</h3> - -<p>To update your local copy with any changes made by other people, enter -the <strong>manuals</strong> directory and run the command:</p> - -<p style="margin-left: 2em"> - <code>git pull</code> -</p> - -<toc-add-entry name="obtaining">Obtaining push privileges</toc-add-entry> - -<p>Push privileges are available to anyone who wishes to participate in -writing the manuals. We generally request that you have submitted -a couple of useful patches first.</p> - -<p>After creating your account on <a href="https://salsa.debian.org/">Salsa</a>, -please request push privileges by clicking <q>Request to join</q> on the -group or any of the specific projects under -<url "https://salsa.debian.org/ddp-team/" />. -Please follow it up with an email to debian-doc@lists.debian.org explaining -the track record of your work on Debian.</p> - -<p>Once your request is approved, you'll be part of either the <a -href="https://salsa.debian.org/ddp-team/"><q>ddp-team</q> group</a> or -one of its projects. -</p> - -<hr /> - -<toc-add-entry name="updates">Automatic update mechanism</toc-add-entry> - -<p>The published web pages of the manual text are generated on -www-master.debian.org as part of the regular web site rebuilding process, -which happens every four hours.</p> - -<p>The script does a <kbd>svn export --force svn://svn.debian.org/svn/ddp/manuals</kbd>, and then -<kbd>make -C trunk publish</kbd>.</p> - -<p>The makefile is set up to rebuild each subdirectory (that contains -maintained documentation), and to install the files from each subdirectory -in <code>doc/manuals/</code> subdirectory of the web site. The subdirectory -makefiles are derived from <code>manuals/standard.makefile</code>.</p> - -<p>The documentation files generated by the update script can be found at -<a href="manuals/">https://www.debian.org/doc/manuals/</a>.</p> - -<p>The log files generated by the update script can be found at -<url "https://www-master.debian.org/build-logs/ddp/" /></p> - -<p>Note that this process regenerates the <code>/doc/manuals/</code> -directory. The contents of the <code>/doc/</code> directory is generated -either from <a href="/devel/website/desc">webwml</a> or from other scripts, -such as those which extract certain manuals from their packages.</p> - -# <!-- Created: Mon Jul 6 19:58:09 BST 1998 --> +#use wml::debian::redirect newpage="vcs" diff --git a/english/doc/vcs.wml b/english/doc/vcs.wml new file mode 100644 index 00000000000..0a313b05a24 --- /dev/null +++ b/english/doc/vcs.wml @@ -0,0 +1,103 @@ +#use wml::debian::ddp title="Debian Documentation Project VCS" +#use wml::debian::toc + +<p>The Debian Documentation Project stores its web pages and much of the +manual text on the Debian Salsa service at +<strong>salsa.debian.org</strong>, which is Debian's GitLab instance. +Please read the <a href="https://wiki.debian.org/Salsa">Salsa documentation</a> +for more information about how this service works. +</p> + +<p>Everybody can download the sources from the Salsa service. Only members of +the Debian Documentation Project can update files.</p> + +<toc-display /> + +<toc-add-entry name="access">Accessing the sources in git</toc-add-entry> + +<p>You can use a web interface to access the files individually and +see changes on each project at +<url "https://salsa.debian.org/ddp-team/" /></p> + +<p>For downloading an entire manual, direct access to the git server +is often a better option. You need the +<tt><a href="https://packages.debian.org/git">git</a></tt> package on your +own machine.</p> + +<h3>Cloning a git repository anonymously (read-only)</h3> + +<p>Use this command to download all the files for one project:</p> + +<p style="margin-left: 2em"> + <code>git clone https://salsa.debian.org/ddp-team/release-notes.git</code> +</p> + +<p>Do the same for every project you want to clone locally.</p> + +<h3>Cloning a git repository with push privileges (read-write)</h3> + +<p>Before accessing the git server using this method you have to be +granted write access to it first. Please read how to <a +href="#obtaining">request</a> push permission first.</p> + +<p>Use this command to download all the files for one project:</p> + +<p style="margin-left: 2em"> + <code>git clone git@salsa.debian.org:ddp-team/release-notes.git</code> +</p> + +<p>Do the same for every project you want to clone locally.</p> + +<h3>Fetching changes from the remote git repository</h3> + +<p>To update your local copy with any changes made by other people, enter +the <strong>manuals</strong> directory and run the command:</p> + +<p style="margin-left: 2em"> + <code>git pull</code> +</p> + +<toc-add-entry name="obtaining">Obtaining push privileges</toc-add-entry> + +<p>Push privileges are available to anyone who wishes to participate in +writing the manuals. We generally request that you have submitted +a couple of useful patches first.</p> + +<p>After creating your account on <a href="https://salsa.debian.org/">Salsa</a>, +please request push privileges by clicking <q>Request to join</q> on the +group or any of the specific projects under +<url "https://salsa.debian.org/ddp-team/" />. +Please follow it up with an email to debian-doc@lists.debian.org explaining +the track record of your work on Debian.</p> + +<p>Once your request is approved, you'll be part of either the <a +href="https://salsa.debian.org/ddp-team/"><q>ddp-team</q> group</a> or +one of its projects. +</p> + +<hr /> + +<toc-add-entry name="updates">Automatic update mechanism</toc-add-entry> + +<p>The published web pages of the manual text are generated on +www-master.debian.org as part of the regular web site rebuilding process, +which happens every four hours.</p> + +<p>The script does a <kbd>svn export --force svn://svn.debian.org/svn/ddp/manuals</kbd>, and then +<kbd>make -C trunk publish</kbd>.</p> + +<p>The makefile is set up to rebuild each subdirectory (that contains +maintained documentation), and to install the files from each subdirectory +in <code>doc/manuals/</code> subdirectory of the web site. The subdirectory +makefiles are derived from <code>manuals/standard.makefile</code>.</p> + +<p>The documentation files generated by the update script can be found at +<a href="manuals/">https://www.debian.org/doc/manuals/</a>.</p> + +<p>The log files generated by the update script can be found at +<url "https://www-master.debian.org/build-logs/ddp/" /></p> + +<p>Note that this process regenerates the <code>/doc/manuals/</code> +directory. The contents of the <code>/doc/</code> directory is generated +either from <a href="/devel/website/desc">webwml</a> or from other scripts, +such as those which extract certain manuals from their packages.</p> |