85 lines
3.2 KiB
Plaintext
85 lines
3.2 KiB
Plaintext
git guidelines for gparted
|
|
==========================
|
|
|
|
Please do not commit directly to the git.gnome.org/gparted repository
|
|
unless you have been given the green light to commit freely to
|
|
gparted. When in doubt assume you haven't ;-).
|
|
|
|
If you are a translator feel free to mark strings for translation, fix
|
|
typos in the code, etc. I'd appreciate it if you would notify me of
|
|
anything you've done.
|
|
|
|
Please send patches for build & configure fixes too. I really appreciate
|
|
your help, I just want to review these fixes before applying.
|
|
|
|
!!WHENEVER YOU COMMIT, PLACE A COMMENT IN GIT!!
|
|
even when it's only one character. =)
|
|
|
|
Thanks,
|
|
Curtis
|
|
|
|
|
|
|
|
Translatable files
|
|
==================
|
|
|
|
The file po/POTFILES.in lists all source files which do or could contain
|
|
translatable strings. Remember to update when adding new and removing
|
|
old source code files include/*.h and src/*.cc. Generally .cc files are
|
|
included and .h files are not, but there are exceptions. Some mistakes
|
|
can be detected using:
|
|
make distcheck
|
|
|
|
|
|
|
|
partition usage and unallocated space
|
|
=====================================
|
|
|
|
After addressing bug #499202 GParted now also displays unallocated space
|
|
as well as used and unused space for recognised file systems. Many file
|
|
systems which actually fill their partition report a small amount of
|
|
intrinsic unallocated space when mounted, but not when unmounted. To
|
|
avoid confusing the user and unnecessarily alarming them don't show
|
|
unallocated space below a threshold, 2 to 5% depending on partition
|
|
size. It is just included in the used figure instead. (This is
|
|
effectively how GParted behaved before bug #499202 was addressed). When
|
|
above the threshold unallocated space is shown graphically, the numeric
|
|
figure is shown in the Information Dialog and a is warning displayed.
|
|
See the code and commit messages for more details.
|
|
|
|
Worked example of partition and file system usage for a newly created
|
|
jfs file system in a 200 MiB partition reporting a small amount of
|
|
unallocated space:
|
|
|
|
# sfdisk -s /dev/sda9
|
|
204800
|
|
|
|
# echo dm | jfs_debugfs /dev/sda9 | egrep 'Block Size:|dn_mapsize:|dn_nfree:'
|
|
Aggregate Block Size: 4096
|
|
[1] dn_mapsize: 0x0000000c6cb [9] dn_agheigth: 0
|
|
[2] dn_nfree: 0x0000000c6a3 [10] dn_agwidth: 1
|
|
|
|
Partition size = 204800 (1K blocks) = 409600 (512 byte sectors)
|
|
FS size = 0x0c6cb (4K blocks)
|
|
= 50891 (4K blocks) = 407128 (512 byte sectors)
|
|
FS free = 0x0c6a3 (4K blocks)
|
|
= 50851 (4K blocks) = 406808 (512 byte sectors)
|
|
|
|
Calculation:
|
|
size = ptn_size = 409600 = 200.00 MiB
|
|
used = fs_size - fs_free = 407128 - 406808 = 320 = 160.00 KiB
|
|
unused = fs_free = 406808 = 198.64 MiB
|
|
unallocated = ptn_size - fs_size = 409600 - 407128 = 2472 = 1.21 MiB
|
|
|
|
(Threshold %age for 200 MiB partition is approximately 4.675%)
|
|
threshold = ptn_size * pct = 19150 = 9.35 MiB
|
|
|
|
(Unallocated is below threshold so is included in used figure)
|
|
disp_used = used + unallocated = 320 + 2472 = 2792 = 1.36 MiB
|
|
disp_unused = unused = 406808 = 198.64 MiB
|
|
|
|
Figures displayed in the Information dialog:
|
|
Size: 200.00 MiB
|
|
Used: 1.36 MiB ( 1% )
|
|
Unused: 198.64 KiB ( 99% )
|