File: HACKING

package info (click to toggle)
cvs2svn 2.4.0-4
  • links: PTS
  • area: main
  • in suites: stretch
  • size: 3,720 kB
  • sloc: python: 22,383; sh: 512; perl: 121; makefile: 84
file content (70 lines) | stat: -rw-r--r-- 2,249 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
                                                                -*-text-*-

                      ===========================
                       Hacker's Guide To cvs2svn
                      ===========================

This project tends to use the same social and technical guidelines
(where applicable) as Subversion itself.  You can view them online at
http://subversion.apache.org/docs/community-guide/conventions.html.

* The source code is accessible from two places:

  * The primary repository for cvs2svn is held in Subversion under the
    following URL:

      http://cvs2svn.tigris.org/svn/cvs2svn

    The repository is readable by anybody using username="guest",
    password="" (i.e., just press return).

  * Michael Haggerty maintains a git mirror of the trunk of cvs2svn
    (and perhaps some other branches) at repo.or.cz.  The summary page
    is at

      http://repo.or.cz/w/cvs2svn.git

    and the (read-only) mirror is at

      git://repo.or.cz/cvs2svn.git

* Read the files under doc/, especially:

  * doc/design-notes.txt gives a high-level description of the
    algorithm used by cvs2svn to make sense of the CVS history.

  * doc/symbol-notes.txt describes how CVS symbols are handled.

  * doc/making-releases.txt describes the procedure for making a new
    release of cvs2svn.

* Read the files under www/, especially:

  * www/features.html describes abstractly many of the CVS
    peculiarities that cvs2svn attempts to deal with.

  Please note that changes committed to the trunk version of www/ are
  automatically deployed to the cvs2svn project website.

* Read the class and method docstrings.

* Adhere to the code formatting conventions of the rest of the
  project (e.g., limit line length to 79 characters).

* We no longer require the exhaustive commit messages required by the
  Subversion project.  But please include commit messages that:

  * Describe the *reason* for the change.

  * Attribute changes to their original author using lines like

    Patch by: Joe Schmo <schmo@example.com>

* Please put a new test in run-tests.py when you fix a bug.

* Use 2 spaces between sentences in comments and docstrings.  (This
  helps sentence-motion commands in some editors.)


Happy hacking!