Clean up and clarify PartitionAlloc

Source/wtf/PageAllocator.h

 /*
  * Copyright (C) 2013 Google Inc. All rights reserved.
  *
  * Redistribution and use in source and binary forms, with or without
  * modification, are permitted provided that the following conditions are
  * met:
  *
  *     * Redistributions of source code must retain the above copyright
  * notice, this list of conditions and the following disclaimer.
  *     * Redistributions in binary form must reproduce the above
@@ skipping 79 matching lines @@
 // true).
 WTF_EXPORT WARN_UNUSED_RETURN bool setSystemPagesAccessible(void* addr, size_t len);
 
 // Decommit one or more system pages. Decommitted means that the physical memory
 // is released to the system, but the virtual address space remains reserved.
 // System pages are re-committed by calling recommitSystemPages(). Touching
 // a decommitted page _may_ fault.
 // Clients should not make any assumptions about the contents of decommitted
 // system pages, before or after they write to the page. The only guarantee
 // provided is that the contents of the system page will be deterministic again
-// after recommitting and writing to it. In particlar note that system pages are// not guaranteed to be zero-filled upon re-commit.
-// len must be a multiple of kSystemPageSize bytes.
+// after recommitting and writing to it. In particlar note that system pages are
+// not guaranteed to be zero-filled upon re-commit. len must be a multiple of
+// kSystemPageSize bytes.
 WTF_EXPORT void decommitSystemPages(void* addr, size_t len);
 
 // Recommit one or more system pages. Decommitted system pages must be
 // recommitted before they are read are written again.
 // Note that this operation may be a no-op on some platforms.
 // len must be a multiple of kSystemPageSize bytes.
 WTF_EXPORT void recommitSystemPages(void* addr, size_t len);
 
 // Discard one or more system pages. Discarding is a hint to the system that
 // the page is no longer required. The hint may:
 // - Do nothing.
 // - Discard the page immediately, freeing up physical pages.
 // - Discard the page at some time in the future in response to memory pressure.
 // Only committed pages should be discarded. Discarding a page does not
 // decommit it, and it is valid to discard an already-discarded page.
 // A read or write to a discarded page will not fault.
 // Reading from a discarded page may return the original page content, or a
 // page full of zeroes.
 // Writing to a discarded page is the only guaranteed way to tell the system
-// that the page is required again. Once written to, the content of the page is // guaranteed stable once more. After being written to, the page content may be
+// that the page is required again. Once written to, the content of the page is
+// guaranteed stable once more. After being written to, the page content may be
 // based on the original page content, or a page of zeroes.
 // len must be a multiple of kSystemPageSize bytes.
 WTF_EXPORT void discardSystemPages(void* addr, size_t len);
 
 } // namespace WTF
 
 #endif // WTF_PageAllocator_h