~ubuntu-branches/ubuntu/trusty/python-docutils/trusty-proposed

« back to all changes in this revision

Viewing changes to docs/dev/repository.txt

  • Committer: Package Import Robot
  • Author(s): Michael Schutte, Jakub Wilk, Michael Schutte, Dmitry Shachnev
  • Date: 2013-08-05 16:47:43 UTC
  • mfrom: (11.1.9 experimental)
  • Revision ID: package-import@ubuntu.com-20130805164743-00lyz2imgs85ttwz
Tags: 0.11-1
[ Jakub Wilk ]
* Remove martin f. krafft and Ben Finney from Uploaders at their requests.

[ Michael Schutte ]
* New upstream release 0.11, closes: #712284, #714880.
  - Drop patch math-output-html.diff: Fixed upstream.
  - Drop patch fix-buildhtml-progress.diff: Applied upstream.
  - Drop patch strict-csv-parser.diff: Fixed upstream.
  - Drop patch unknown-url-exc-use-repr.diff: Applied upstream.
  - Update patch move-data-to-usr-share.diff: Default stylesheet paths for
    writers/html4css1 have changed.
  - Refresh the remaining patches.
  - New patch no-local-roman.diff: Use the roman module from python-roman
    instead of the copy shipped with docutils.
  - Update information about upstream version control in debian/copyright.
* Change my e-mail host in Uploaders and debian/copyright to @debian.org.
* New patch rst2odt_prepstyles-elementtree.diff: Port the rst2odt_prepstyles
  utility to ElementTree.  Drop Recommends: python-lxml.  Closes: #714319.
* New patch odt-writer-ascii-filenames.diff: Only use ASCII for filenames of
  images embedded in ODT files, closes: #714317.

[ Dmitry Shachnev ]
* Use dh_python2 instead of deprecated dh_pysupport.
* Add XS-Testsuite header, and replace XS-Python-Version with preferred
  X-Python-Version (closes: #685509).
* Add myself to Uploaders.

Show diffs side-by-side

added added

removed removed

Lines of Context:
4
4
 
5
5
:Author: Lea Wiemann
6
6
:Contact: docutils-develop@lists.sourceforge.net
7
 
:Revision: $Revision: 7324 $
8
 
:Date: $Date: 2012-01-26 10:57:04 +0100 (Do, 26. Jan 2012) $
 
7
:Revision: $Revision: 7659 $
 
8
:Date: $Date: 2013-05-06 13:36:28 +0200 (Mon, 06 May 2013) $
9
9
:Copyright: This document has been placed in the public domain.
10
10
 
11
11
.. _Docutils: http://docutils.sourceforge.net/
15
15
   To get a checkout of the Docutils source tree (without the
16
16
   sandboxes), type ::
17
17
 
18
 
       svn checkout http://docutils.svn.sourceforge.net/svnroot/docutils/trunk/docutils
 
18
       svn checkout http://svn.code.sf.net/p/docutils/code/trunk docutils-code
 
19
 
19
20
 
20
21
   If you are going to commit changes to the repository, please read
21
22
   the **whole document**, especially the section "`Information for
22
23
   Developers`_"!
23
24
 
 
25
.. important::
 
26
   As of 2013-03-13 the subversion urls have changed.
 
27
 
 
28
   The Git clone at http://repo.or.cz/w/docutils.git is currently not
 
29
   updated and should not be used.
 
30
 
24
31
Docutils uses a Subversion_ repository located at
25
 
``docutils.svn.sourceforge.net``. 
 
32
``docutils.svn.sourceforge.net``.
26
33
Subversion is exhaustively documented in the `Subversion Book`_ (svnbook).
27
34
 
28
35
While Unix and Mac OS X users will probably prefer the standard
30
37
TortoiseSVN_, a convenient explorer extension.  The instructions apply
31
38
analogously.
32
39
 
33
 
There is a git_ mirror at http://repo.or.cz/w/docutils.git providing
34
 
`web access`_ and the base for `creating a local git clone`_.
 
40
.. There is a git_ mirror at http://repo.or.cz/w/docutils.git providing
 
41
   `web access`_ and the base for `creating a local git clone`_.
35
42
 
36
43
For the project policy on repository use (check-in requirements,
37
44
branching, etc.), please see the `Docutils Project Policies`__.
57
64
~~~~~~~~~~
58
65
 
59
66
The repository can be browsed and examined via the web at
60
 
http://docutils.svn.sourceforge.net/viewvc/docutils/.
61
 
 
62
 
Alternatively, use the web interface of the git mirror at
63
 
http://repo.or.cz/w/docutils.git.
 
67
http://sourceforge.net/p/docutils/code
 
68
 
 
69
.. currently not updated (last update 2012)
 
70
   Alternatively, use the web interface of the git mirror at
 
71
   http://repo.or.cz/w/docutils.git.
 
72
 
64
73
 
65
74
Repository Access Methods
66
75
~~~~~~~~~~~~~~~~~~~~~~~~~
69
78
of the repository depending on your preferred protocol:
70
79
 
71
80
anonymous access: (read only)
72
 
    ``https://docutils.svn.sourceforge.net/svnroot/docutils``
73
 
    
 
81
    ``http://svn.code.sf.net/p/docutils/code``
 
82
 
74
83
`developer access`_: (read and write)
75
 
    ``https://<username>@docutils.svn.sourceforge.net/svnroot/docutils``
 
84
    ``svn+ssh://<USERNAME>@svn.code.sf.net/p/docutils/code``
76
85
 
77
 
git clone: (read only)
 
86
.. git clone: (read only)
78
87
    ``git clone git://repo.or.cz/docutils.git``
79
88
 
80
89
Checking Out the Repository
102
111
 
103
112
    svn update
104
113
 
105
 
Creating a local git clone
106
 
~~~~~~~~~~~~~~~~~~~~~~~~~~
107
 
 
108
 
Users of git_ can clone a mirror of the docutils repository with ::
109
 
 
110
 
  git clone git://repo.or.cz/docutils.git
111
 
 
112
 
and proceed according to the `git documentation`_.
113
 
 
114
 
.. _git documentation: http://git-scm.com/documentation
 
114
..
 
115
  Creating a local git clone
 
116
  ~~~~~~~~~~~~~~~~~~~~~~~~~~
 
117
 
 
118
  Users of git_ can clone a mirror of the docutils repository with ::
 
119
 
 
120
    git clone git://repo.or.cz/docutils.git
 
121
 
 
122
  and proceed according to the `git documentation`_.
 
123
 
 
124
  .. _git documentation: http://git-scm.com/documentation
115
125
 
116
126
Switching the Repository Root
117
127
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
127
137
--------------------------
128
138
 
129
139
If you would like to have write access to the repository, register
130
 
with SourceForge.net_ and send your SourceForge.net 
 
140
with SourceForge.net_ and send your SourceForge.net
131
141
user names to docutils-develop@lists.sourceforge.net.
132
142
(Note that there may be a delay of several hours until you can commit
133
143
changes to the repository.)
134
144
 
135
 
Sourceforge subversion access is documented `here`__ 
 
145
Sourceforge subversion access is documented `here`__
136
146
 
137
 
__ http://sourceforge.net/apps/trac/sourceforge/wiki/Subversion
 
147
__ http://sourceforge.net/p/forge/documentation/svn/
138
148
 
139
149
 
140
150
Setting Up Your Subversion Client For Development