Mercurial > hg
comparison hgext/win32mbcs.py @ 9275:8164d1abaa36
win32mbcs: wrap docstrings at 70 characters
author | Martin Geisler <mg@lazybytes.net> |
---|---|
date | Sun, 26 Jul 2009 02:03:00 +0200 |
parents | 9b2649b6ce5c |
children | 2705e6816d33 |
comparison
equal
deleted
inserted
replaced
9274:4e61abab5f4b | 9275:8164d1abaa36 |
---|---|
9 # GNU General Public License version 2, incorporated herein by reference. | 9 # GNU General Public License version 2, incorporated herein by reference. |
10 # | 10 # |
11 | 11 |
12 '''allow the use of MBCS paths with problematic encodings | 12 '''allow the use of MBCS paths with problematic encodings |
13 | 13 |
14 Some MBCS encodings are not good for some path operations (i.e. splitting | 14 Some MBCS encodings are not good for some path operations (i.e. |
15 path, case conversion, etc.) with its encoded bytes. We call such a encoding | 15 splitting path, case conversion, etc.) with its encoded bytes. We call |
16 (i.e. shift_jis and big5) as "problematic encoding". This extension can be | 16 such a encoding (i.e. shift_jis and big5) as "problematic encoding". |
17 used to fix the issue with those encodings by wrapping some functions to | 17 This extension can be used to fix the issue with those encodings by |
18 convert to Unicode string before path operation. | 18 wrapping some functions to convert to Unicode string before path |
19 operation. | |
19 | 20 |
20 This extension is useful for: | 21 This extension is useful for: |
21 | 22 |
22 - Japanese Windows users using shift_jis encoding. | 23 - Japanese Windows users using shift_jis encoding. |
23 - Chinese Windows users using big5 encoding. | 24 - Chinese Windows users using big5 encoding. |
30 - Any user who do not use any of problematic encodings. | 31 - Any user who do not use any of problematic encodings. |
31 | 32 |
32 Note that there are some limitations on using this extension: | 33 Note that there are some limitations on using this extension: |
33 | 34 |
34 - You should use single encoding in one repository. | 35 - You should use single encoding in one repository. |
35 - You should set same encoding for the repository by locale or HGENCODING. | 36 - You should set same encoding for the repository by locale or |
37 HGENCODING. | |
36 | 38 |
37 Path encoding conversion are done between Unicode and encoding.encoding which | 39 Path encoding conversion are done between Unicode and |
38 is decided by Mercurial from current locale setting or HGENCODING. | 40 encoding.encoding which is decided by Mercurial from current locale |
41 setting or HGENCODING. | |
39 ''' | 42 ''' |
40 | 43 |
41 import os, sys | 44 import os, sys |
42 from mercurial.i18n import _ | 45 from mercurial.i18n import _ |
43 from mercurial import util, encoding | 46 from mercurial import util, encoding |