← Back to branch summary

~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to doc/developers/case-insensitive-file-systems.txt

  • Committer: Patch Queue Manager
  • Date: 2016-04-21 04:10:52 UTC
  • mfrom: (6616.1.1 fix-en-user-guide)
  • Revision ID: pqm@pqm.ubuntu.com-20160421041052-clcye7ns1qcl2n7w
(richard-wilbur) Ensure build of English use guide always uses English text
 even when user's locale specifies a different language. (Jelmer Vernooij)

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/developers/case-insensitive-file-systems.txt
9
9
For example, the FAT32 file-system is most commonly found on Windows operating
10
10
systems, and has the characteristics usually associated with a Windows
11
11
file-system.  However, USB devices means FAT32 file-systems are often used
12
 
with Linux, so the current operating system doesn't necessarily reflect the
 
12
with GNU/Linux systems, so the current operating system doesn't necessarily reflect the
13
13
capabilities of the file-system.
14
14
 
15
15
Bazaar supports 3 kinds of file-systems, each to different degrees.
16
16
 
17
17
* Case-sensitive file-systems: This is the file-system generally used on
18
 
  Linux - 2 files can differ only by case, and the exact case must be used
 
18
  GNU/Linux: 2 files can differ only by case, and the exact case must be used
19
19
  when opening a file.
20
20
 
21
21
* Case-insensitive, case-preserving (cicp) file-systems: This is the
27
27
* Case-insensitive: This is the file-system used by very old Windows versions
28
28
  and is rarely encountered "in the wild".  Two files that differ only by
29
29
  case is not allowed and the case used to create a file is not preserved.
30
 
  
 
30
 
31
31
As can be implied by the above descriptions, only the first two are considered
32
32
relevant to a modern Bazaar.
33
33
 
34
34
For more details, including use cases, please see
35
 
http://bazaar-vcs.org/CasePreservingWorkingTreeUseCases
 
35
http://wiki.bazaar.canonical.com/CasePreservingWorkingTreeUseCases
36
36
 
37
37
Handling these file-systems
38
38
---------------------------
84
84
  of the result to match any existing items.
85
85
 
86
86
* Tree.get_canonical_inventory_path - somewhat like Tree.get_symlink_target(),
87
 
  Tree.get_file_by_path() etc; returns a name with the case adjusted to match
 
87
  Tree.get_file() etc; returns a name with the case adjusted to match
88
88
  existing inventory items.
89
89
 
90
90
* osutils.canonical_relpaths() and Tree.get_canonical_inventory_paths() - like