From 93ab7c31e45be1c2601b957ce0145adad3e4e218 Mon Sep 17 00:00:00 2001
From: Daniel Verkamp <daniel.verkamp@intel.com>
Date: Tue, 17 Jan 2017 16:23:28 -0700
Subject: [PATCH] doc: move porting guide into doc/ and add to index

This moves all the documentation under the doc/ tree for consistency.

Replace the link to include/spdk/env.h to raw text - the Doxygen
Markdown parser will automatically turn it into a link since it is a
Doxygen input file.

Change-Id: If6bde1cfc965cada2c741acd5505026545ad4cf7
Signed-off-by: Daniel Verkamp <daniel.verkamp@intel.com>
---
 CHANGELOG.md                 | 2 +-
 README.md                    | 2 +-
 doc/Doxyfile                 | 1 +
 doc/index.md                 | 1 +
 PORTING.md => doc/porting.md | 5 ++---
 5 files changed, 6 insertions(+), 5 deletions(-)
 rename PORTING.md => doc/porting.md (90%)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index f2806c045..5f6444286 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -73,7 +73,7 @@ by the NVMe library.
 The `env` environment abstraction library has been introduced, and a default
 DPDK-based implementation is provided as part of SPDK.  The goal of the `env`
 layer is to enable use of alternate user-mode memory allocation and PCI access
-libraries.  See `PORTING.md` for more details.
+libraries.  See `doc/porting.md` for more details.
 
 The build process has been modified to produce all of the library files in the
 `build/lib` directory.  This is intended to simplify the use of SPDK from external
diff --git a/README.md b/README.md
index 83bb6175f..4d7da95cf 100644
--- a/README.md
+++ b/README.md
@@ -24,7 +24,7 @@ Documentation
 =============
 
 [Doxygen API documentation](http://www.spdk.io/doc/) is available, as
-well as a [Porting Guide](PORTING.md) for porting SPDK to different frameworks
+well as a [Porting Guide](http://www.spdk.io/doc/porting.html) for porting SPDK to different frameworks
 and operating systems.
 
 Many examples are available in the `examples` directory.
diff --git a/doc/Doxyfile b/doc/Doxyfile
index a2444531c..444a9e33f 100644
--- a/doc/Doxyfile
+++ b/doc/Doxyfile
@@ -761,6 +761,7 @@ WARN_LOGFILE           =
 INPUT                  = ../include/spdk \
                          index.md \
                          directory_structure.md \
+                         porting.md \
                          ioat/index.md \
                          nvme/index.md \
                          nvme/async_completion.md \
diff --git a/doc/index.md b/doc/index.md
index 0e4a6c0d6..7c9429a53 100644
--- a/doc/index.md
+++ b/doc/index.md
@@ -14,6 +14,7 @@ which avoids kernel context switches and eliminates interrupt handling overhead.
 ## General Information {#general}
 
  - @ref directory_structure
+ - @ref porting
 
 ## Modules {#modules}
 
diff --git a/PORTING.md b/doc/porting.md
similarity index 90%
rename from PORTING.md
rename to doc/porting.md
index b595c85f7..b6872bef1 100644
--- a/PORTING.md
+++ b/doc/porting.md
@@ -1,12 +1,11 @@
-SPDK Porting Guide
-==================
+# SPDK Porting Guide {#porting}
 
 SPDK is ported to new environments by implementing the *env*
 library interface.  The *env* interface provides APIs for drivers
 to allocate physically contiguous and pinned memory, perform PCI
 operations (config cycles and mapping BARs), virtual to physical
 address translation and managing memory pools.  The *env* API is
-defined in [include/spdk/env.h](include/spdk/env.h).
+defined in include/spdk/env.h.
 
 SPDK includes a default implementation of the *env* library based
 on the Data Plane Development Kit ([DPDK](http://dpdk.org/)).