A batch of docs style fixes.
R=nodir
BUG=524256
Review URL: https://codereview.chromium.org/1318503005
Cr-Commit-Position: refs/heads/master@{#345353}
diff --git a/docs/cygwin_dll_remapping_failure.md b/docs/cygwin_dll_remapping_failure.md
index 3b56273d..468d133e 100644
--- a/docs/cygwin_dll_remapping_failure.md
+++ b/docs/cygwin_dll_remapping_failure.md
@@ -1,16 +1,15 @@
-Handling repeated failures of rebaseall to allow cygwin remaps
-
-# Introduction
+# Handling repeated failures of rebaseall to allow cygwin remaps
Sometimes DLLs over which cygwin has no control get mapped into cygwin
processes at locations that cygwin has chosen for its libraries.
-This has been seen primarily with anti-virus DLLs. When this occurs,
+This has been seen primarily with anti-virus DLLs. When this occurs,
cygwin must be instructed during the rebase to avoid the area of
memory where that DLL is mapped.
-# Background
+## Background
-Some background for this is available on http://www.dont-panic.cc/capi/2007/10/29/git-svn-fails-with-fatal-error-unable-to-remap/
+Some background for this is available on
+http://www.dont-panic.cc/capi/2007/10/29/git-svn-fails-with-fatal-error-unable-to-remap/
Because of unix fork semantics (presumably), cygwin libraries must be
mapped in the same location in both parent and child of a fork. All
@@ -34,22 +33,26 @@
non-cygwin library is, where it is in the address space, and do the
rebase all so that no cygwin hints map libraries to that location.
-# Details
+## Details
-<ul>
-<li>Download the ListDLLs executable from sysinternals<br>
-(<a href='http://technet.microsoft.com/en-us/sysinternals/bb896656.aspx'>http://technet.microsoft.com/en-us/sysinternals/bb896656.aspx</a>)</li>
-<li>Run it as administrator while some cygwin commands are running.</li>
-<li>Scan the output for the cygwin process (identifiable by the command) and for DLLs in that process that do not look like cygwin DLLs (like an AV). Note the location of those libraries (there will usually only be the one). Pick an address space location lower than its starting address.</li>
-<li>Quit all cygwin processes.</li>
-<li>Run a windows command shell as administrator</li>
-<li>cd in \cygwin\bin</li>
-<li>Run "ash /usr/bin/rebaseall -b <base address>" (This command can also take a "-v" flag if you want to see the DLL layout.)</li>
-</ul>
-
+* Download the ListDLLs executable from
+ [sysinternals](http://technet.microsoft.com/en-us/sysinternals/bb896656.aspx)
+* Run it as administrator while some cygwin commands are running.
+* Scan the output for the cygwin process (identifiable by the command) and for
+ DLLs in that process that do not look like cygwin DLLs (like an AV). Note
+ the location of those libraries (there will usually only be the one).
+* Pick an address space location lower than its starting address.
+* Quit all cygwin processes.
+* Run a windows command shell as administrator
+* cd in \cygwin\bin
+* Run `ash /usr/bin/rebaseall -b <base address>` (This command can also take a
+ `-v` flag if you want to see the DLL layout.)
That should fix the problem.
-# Failed rebaseall
+## Failed rebaseall
-If you pick a base address that is too low, you may end up with a broken cygwin install. You can reinstall it by running cygwin's setup.exe again, and on the package selection page, clicking the "All" entry to Reinstall. You may have to do this twice, as you may get errors on the first reinstall pass.
\ No newline at end of file
+If you pick a base address that is too low, you may end up with a broken cygwin
+install. You can reinstall it by running cygwin's setup.exe again, and on the
+package selection page, clicking the "All" entry to Reinstall. You may have to
+do this twice, as you may get errors on the first reinstall pass.
