Changeset 745 in tailor

Timestamp:

09/02/05 15:07:46 (8 years ago)

Author:

lele@…

Hash name:

20050902130746-97f81-68846274e015a8515a796993a2e3ca7cea845a04

Message:

Forward port of documentation fixes by D.Love

Files:

• vcpx/cvsps.py (modified) (6 diffs)
• vcpx/darcs.py (modified) (1 diff)
• vcpx/tailor.py (modified) (4 diffs)
• README (modified) (3 diffs)

vcpx/cvsps.py

@@ -8 +8 @@
 """
 This module contains supporting classes for CVS. To get a
-cross-repository revision number ala Subversion, the implementation
+cross-repository revision number a la Subversion, the implementation
 uses `cvsps` to fetch the changes from the upstream repository.
 """
@@ -134 +134 @@
 
     """
-    An instance of this class represent a read/write CVS working directory,
-    so that it can be used both as source of patches, or as a target
-    repository.
+    An instance of this class represents a read/write CVS working
+    directory, so that it can be used both as a source of patches and
+    as a target repository.
 
     It uses `cvsps` to do the actual fetch of the changesets metadata
@@ -215 +215 @@
             # and thus new_revision is always None for them), and it's
             # going to be deleted, do not execute a 'cvs update', that
-            # in some cases does not what one would expect. Instead,
+            # in some cases does not do what one would expect. Instead,
             # remove it with everything it contains (that should be
             # just a single "CVS" subdir, btw)
@@ -254 +254 @@
     def _checkoutUpstreamRevision(self, revision):
         """
-        Concretely do the checkout of the upstream sources. Use `revision` as
-        the name of the tag to get, or as a date if it starts with a number.
+        Concretely do the checkout of the upstream sources. Use
+        `revision` as the name of the tag to get, or as a date if it
+        starts with a number.
 
         Return the last applied changeset.
@@ -376 +377 @@
         Verify that the hierarchy down to the entry is under CVS.
 
-        If the directory containing the entry does not exists,
-        create it and make it appear as under CVS so that succeding
+        If the directory containing the entry does not exist,
+        create it and make it appear as under CVS so that a subsequent
         'cvs update' will work.
         """
@@ -423 +424 @@
 
             # Add the "new" directory to the changeset, so that the
-            # replayer get its name
+            # replayer gets its name
 
             entry = changeset.addEntry(path, None)

vcpx/darcs.py

@@ -433 +433 @@
         from os import rename
 
-        # Check to see if the oldentry is still there. If it does,
+        # Check to see if the oldentry is still there. If it is,
         # that probably means one thing: it's been moved and then
         # replaced, see svn 'R' event. In this case, rename the

vcpx/tailor.py

@@ -140 +140 @@
             # Make printouts be encoded as well. A better solution would be
             # using the replace mechanism of the encoder, and keep printing
-            # in the user LC_CTYPE/LANG setting.
+            # in the user's LC_CTYPE/LANG setting.
 
             import codecs, sys
@@ -185 +185 @@
     RecogOption("--encoding", metavar="CHARSET", default=None,
                 help="Force the output encoding to given CHARSET, rather "
-                     "then using the user default settings specified in the "
-                     "environment."),
+                     "then using the user's default settings specified "
+                     "in the environment."),
 ]
 
@@ -201 +201 @@
                 default=False,
                 help="Remove the first line of the upstream changelog. This "
-                     "is intended to go in pair with --patch-name-format, "
-                     "when using it's 'firstlogline' variable to build the "
+                     "is intended to pair with --patch-name-format, "
+                     "when using its 'firstlogline' variable to build the "
                      "name of the patch."),
     RecogOption("-N", "--refill-changelogs", action="store_true",
@@ -232 +232 @@
                      "with a slash. Since it's used in the description of the "
                      "target repository, you may want to give it a value with "
-                     "darcs too even if it is otherwise ignored."),
+                     "darcs too, even though it is otherwise ignored."),
     RecogOption("-r", "--revision", "--start-revision", dest="start_revision",
                 metavar="REV",

README

@@ -85 +85 @@
 
 There's even a standard setup.py that you may use to install the
-script using Python conventional distutils.
+script using Python's conventional distutils.
 
 .. [#] Darcs 1.0.2 is too old, 1.0.3 is good, 1.0.4 (the fourth
@@ -594 +594 @@
 also a `wiki page`_ that may give you some other hints.  The
 development of Tailor is mainly driven by user requests at this point,
-and the preferred comunication media is the dedicated `mailing list`_
+and the preferred comunication medium is the dedicated `mailing list`_
 [#]_.
 
@@ -604 +604 @@
    
 I will be more than happy to answer any doubt, question or suggestion
-you may have on it. I'm usually hanging as "lelit" on the IRC channel
-devoted to darcs on the `freenode.net` network. Do not hesitate to
-contact me either by email or chatting there.
+you may have on it. I'm usually hanging out as "lelit" on the IRC
+channel devoted to darcs on the `freenode.net` network. Do not
+hesitate to contact me either by email or chatting there.
 
 .. [#] I wish to say a big `Thank you` to `Zooko <zooko@zooko.com>`_,