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