doc: use Doxygen subpages for top-level groupings

This results in a much cleaner tree hierarchy in the
left navigation pane.

Signed-off-by: Jim Harris <james.r.harris@intel.com>
Change-Id: Ic3c0f8b70398589f9dbc80609c96226c6f3bff8f
Reviewed-on: https://review.gerrithub.io/415085
Tested-by: SPDK Automated Test System <sys_sgsw@intel.com>
Reviewed-by: Daniel Verkamp <daniel.verkamp@intel.com>
Reviewed-by: Ben Walker <benjamin.walker@intel.com>

doc/Doxyfile

@@ -782,6 +782,18 @@ WARN_LOGFILE           =
 
 INPUT                  = ../include/spdk \
                          index.md \
+                         \
+                         intro.md \
+                         concepts.md \
+                         user_guides.md \
+                         prog_guides.md \
+                         general.md \
+                         misc.md \
+                         modules.md \
+                         tools.md \
+                         experimental_tools.md \
+                         performance_reports.md \
+                         \
                          about.md \
                          changelog.md \
                          concurrency.md \

doc/concepts.md

@@ -0,0 +1,8 @@
+# Concepts {#concepts}
+
+- @subpage userspace
+- @subpage memory
+- @subpage concurrency
+- @subpage ssd_internals
+- @subpage vhost_processing
+- @subpage porting

doc/experimental_tools.md

@@ -0,0 +1,3 @@
+# Experimental Tools {#experimental_tools}
+
+- @subpage spdkcli

doc/general.md

@@ -0,0 +1,6 @@
+# General Information {#general}
+
+- @subpage directory_structure
+- [Public API header files](files.html)
+- @subpage event
+- @subpage logical_volumes

doc/index.md

@@ -1,63 +1,31 @@
 # Storage Performance Development Kit {#index}
 
-# Introduction {#intro}
+# Introduction
+@copydoc intro
 
-- @ref about
-- @ref getting_started
-- @ref vagrant
-- @ref changelog
-- [Source Code (GitHub)](https://github.com/spdk/spdk/)
+# Concepts
+@copydoc concepts
 
-# Concepts {#concepts}
+# User Guides
+@copydoc user_guides
 
-- @ref userspace
-- @ref memory
-- @ref concurrency
-- @ref ssd_internals
-- @ref vhost_processing
-- @ref porting
+# Programmer Guides
+@copydoc prog_guides
 
-# User Guides {#user_guides}
+# General Information
+@copydoc general
 
-- @ref iscsi
-- @ref nvmf
-- @ref vhost
-- @ref bdev
-- @ref blobfs
-- @ref jsonrpc
+# Miscellaneous
+@copydoc misc
 
-# Programmer Guides {#prog_guides}
+# Modules
+@copydoc modules
 
-- @ref blob
-- @ref bdev_pg
-- @ref bdev_module
-- @ref nvmf_tgt_pg
+# Tools
+@copydoc tools
 
-# General Information {#general}
+# Experimental Tools
+@copydoc experimental_tools
 
-- @ref directory_structure
-- [Public API header files](files.html)
-- @ref event
-- @ref logical_volumes
-
-# Miscellaneous {#misc}
-
-- @ref peer_2_peer
-
-# Modules {#modules}
-
-- @ref nvme
-- @ref ioat
-- @ref virtio
-
-# Tools {#tools}
-
-- @ref nvme-cli
-
-# Experimental Tools {#experimental_tools}
-
-- @ref spdkcli
-
-# Performance Reports {#performancereports}
-
-- [SPDK 17.07 vhost-scsi Performance Report](https://ci.spdk.io/download/performance-reports/SPDK17_07_vhost_scsi_performance_report.pdf)
+# Performance Reports
+@copydoc performance_reports

doc/intro.md

@@ -0,0 +1,7 @@
+# Introduction {#intro}
+
+- @subpage about
+- @subpage getting_started
+- @subpage vagrant
+- @subpage changelog
+- [Source Code (GitHub)](https://github.com/spdk/spdk)

doc/misc.md

@@ -0,0 +1,3 @@
+# Miscellaneous {#misc}
+
+- @subpage peer_2_peer

doc/modules.md

@@ -0,0 +1,5 @@
+# Modules {#modules}
+
+- @subpage nvme
+- @subpage ioat
+- @subpage virtio

doc/performance_reports.md

@@ -0,0 +1,3 @@
+# Performance Reports {#performance_reports}
+
+- [SPDK 17.07 vhost-scsi Performance Report](https://ci.spdk.io/download/performance-reports/SPDK17_07_vhost_scsi_performance_report.pdf)

doc/prog_guides.md

@@ -0,0 +1,6 @@
+# Programmer Guides {#prog_guides}
+
+- @subpage blob
+- @subpage bdev_pg
+- @subpage bdev_module
+- @subpage nvmf_tgt_pg

doc/tools.md

@@ -0,0 +1,3 @@
+# Tools {#tools}
+
+- @subpage nvme-cli

doc/user_guides.md

@@ -0,0 +1,8 @@
+# User Guides {#user_guides}
+
+- @subpage iscsi
+- @subpage nvmf
+- @subpage vhost
+- @subpage bdev
+- @subpage blobfs
+- @subpage jsonrpc