← 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: Vincent Ladeuil
  • Date: 2012-01-18 14:09:19 UTC
  • mto: This revision was merged to the branch mainline in revision 6468.
  • Revision ID: v.ladeuil+lp@free.fr-20120118140919-rlvdrhpc0nq1lbwi
Change set/remove to require a lock for the branch config files.

This means that tests (or any plugin for that matter) do not requires an
explicit lock on the branch anymore to change a single option. This also
means the optimisation becomes "opt-in" and as such won't be as
spectacular as it may be and/or harder to get right (nothing fails
anymore).

This reduces the diff by ~300 lines.

Code/tests that were updating more than one config option is still taking
a lock to at least avoid some IOs and demonstrate the benefits through
the decreased number of hpss calls.

The duplication between BranchStack and BranchOnlyStack will be removed
once the same sharing is in place for local config files, at which point
the Stack class itself may be able to host the changes.

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
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