[PATCH] xfsdocs: updates to XFS User Guide

[Geoffrey Wehrman]

On Fri, Jul 02, 2010 at 03:14:54AM -0400, Lachlan McIlroy wrote:
| Hi all, it's been a while since I posted here!
| 
| Various updates to chapters 1,2,4 and 5 of the XFS User Guide.
| 
| Fixed various spelling/grammar mistakes, updated outdated and/or
| incorrect facts, added some new slides for delayed allocation and
| direct i/o and fixed some XML formatting for command line examples.

I asked our tech pubs editor for comments.  Lori always has good editing
advice.

----- Forwarded message from Lachlan McIlroy <lmcilroy at redhat.com> -----

+					Extended attributes (ie Access Control Lists)
                                                             ^^
							     such as


+					Extent based allocation (incl. unwritten extents)
                                                                 ^^^^^
								 including


 		<listitem><para>Filesystem blocks are comprised of one or more device-level sectors.</para></listitem>
						      ^^^^^^^^^
						      composed


+		<listitem><para>Through direct IOs of specific alignment (ie stripe boundaries)</para></listitem>
                                                                          ^^
									  such as

+			<listitem><para>free block count is decremented</para></listitem>
                                        ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
					decrements free block count


+		<listitem><para>Reduces fragmentation by combining writes and allocating extents in large chunks</para></listitem>
                                ^^^^^^^^^^^^^^^^^^^^^
				Fragmentation is reduced


+		<listitem><para>Files written randomly (ie memory mapped) can now be allocated contiguously</para></listitem>
                                                        ^^
							such as those that are


+		<listitem><para>Data does not pass through the file system cache</para></listitem>
                                                               ^^^^^^^^^^^
							       filesystem



+		<listitem><para>Backup programs can work without polluting the page cache</para></listitem>
                                                ^^^
						that can 
						  or
                                                , so that they can
						
					         ??	

+		<para>Direct I/O can align block allocations on strip unit/width boundaries</para>
                                                                ^^^^^
								stripe
								 
								 ?


+		<listitem><para>In memory XFS inode used only by the filesystem</para></listitem>
                                ^^^^^^^^^
				In-memory


+		<para>Log replay will apply filesystem and metadata changes during mount that had been
                                                                                   ^^^^^
										   a mount



+		<para>mkfs.xfs supports a large number of options for configurating many different XFS filesystems</para>
                                                                      ^^^^^^^^^^^^^
								      configuring


+		<listitem><para>Allocator will rotor data extents across allocations groups to leave room for inodes</para></listitem>
                                               ^^^^
					       rotate ?


+		<listitem><para>Only available on 64 bit machines</para></listitem>
                                                  ^^^^^^
						  64bit
						  (to be consistent with other uses here)


+		<para>If neither of these two options are specified, then filesystem will behave as if
                                                                          ^^^^^^^^^^
									  the filesystem



-- 
Geoffrey Wehrman