[dpdk-dev] doc: add missing API headers

Message ID 1439310597-23870-1-git-send-email-thomas.monjalon@6wind.com (mailing list archive)
State Accepted, archived
Headers

Commit Message

Thomas Monjalon Aug. 11, 2015, 4:29 p.m. UTC
  Some libraries were not included in doxygen documentation.
Other ones were included but not listed in the index.

The malloc library is now included in EAL.

The libraries compat and jobstats are added but not doxygen compliant.

Signed-off-by: Thomas Monjalon <thomas.monjalon@6wind.com>
---
 doc/api/doxy-api-index.md | 16 ++++++++++++++--
 doc/api/doxy-api.conf     |  4 +++-
 2 files changed, 17 insertions(+), 3 deletions(-)
  

Comments

Thomas Monjalon Aug. 11, 2015, 6:03 p.m. UTC | #1
> Some libraries were not included in doxygen documentation.
> Other ones were included but not listed in the index.
> 
> The malloc library is now included in EAL.
> 
> The libraries compat and jobstats are added but not doxygen compliant.
> 
> Signed-off-by: Thomas Monjalon <thomas.monjalon@6wind.com>

Applied
  

Patch

diff --git a/doc/api/doxy-api-index.md b/doc/api/doxy-api-index.md
index 6958f8f..72ac3c4 100644
--- a/doc/api/doxy-api-index.md
+++ b/doc/api/doxy-api-index.md
@@ -36,7 +36,9 @@  API {#index}
 There are many libraries, so their headers may be grouped by topics:
 
 - **device**:
+  [dev]                (@ref rte_dev.h),
   [ethdev]             (@ref rte_ethdev.h),
+  [ethctrl]            (@ref rte_eth_ctrl.h),
   [devargs]            (@ref rte_devargs.h),
   [bond]               (@ref rte_eth_bond.h),
   [vhost]              (@ref rte_virtio_net.h),
@@ -76,12 +78,15 @@  There are many libraries, so their headers may be grouped by topics:
 
 - **layers**:
   [ethernet]           (@ref rte_ether.h),
+  [ARP]                (@ref rte_arp.h),
+  [ICMP]               (@ref rte_icmp.h),
   [IP]                 (@ref rte_ip.h),
   [SCTP]               (@ref rte_sctp.h),
   [TCP]                (@ref rte_tcp.h),
   [UDP]                (@ref rte_udp.h),
   [frag/reass]         (@ref rte_ip_frag.h),
-  [LPM route]          (@ref rte_lpm.h),
+  [LPM IPv4 route]     (@ref rte_lpm.h),
+  [LPM IPv6 route]     (@ref rte_lpm6.h),
   [ACL]                (@ref rte_acl.h)
 
 - **QoS**:
@@ -92,6 +97,7 @@  There are many libraries, so their headers may be grouped by topics:
 - **hashes**:
   [hash]               (@ref rte_hash.h),
   [jhash]              (@ref rte_jhash.h),
+  [thash]              (@ref rte_thash.h),
   [FBK hash]           (@ref rte_fbk_hash.h),
   [CRC hash]           (@ref rte_hash_crc.h)
 
@@ -99,8 +105,10 @@  There are many libraries, so their headers may be grouped by topics:
   [mbuf]               (@ref rte_mbuf.h),
   [ring]               (@ref rte_ring.h),
   [distributor]        (@ref rte_distributor.h),
+  [reorder]            (@ref rte_reorder.h),
   [tailq]              (@ref rte_tailq.h),
-  [bitmap]             (@ref rte_bitmap.h)
+  [bitmap]             (@ref rte_bitmap.h),
+  [ivshmem]            (@ref rte_ivshmem.h)
 
 - **packet framework**:
   * [port]             (@ref rte_port.h):
@@ -122,10 +130,13 @@  There are many libraries, so their headers may be grouped by topics:
 - **basic**:
   [approx fraction]    (@ref rte_approx.h),
   [random]             (@ref rte_random.h),
+  [config file]        (@ref rte_cfgfile.h),
   [key/value args]     (@ref rte_kvargs.h),
   [string]             (@ref rte_string_fns.h)
 
 - **debug**:
+  [jobstats]           (@ref rte_jobstats.h),
+  [hexdump]            (@ref rte_hexdump.h),
   [debug]              (@ref rte_debug.h),
   [log]                (@ref rte_log.h),
   [warnings]           (@ref rte_warnings.h),
@@ -134,4 +145,5 @@  There are many libraries, so their headers may be grouped by topics:
 - **misc**:
   [EAL config]         (@ref rte_eal.h),
   [common]             (@ref rte_common.h),
+  [ABI compat]         (@ref rte_compat.h),
   [version]            (@ref rte_version.h)
diff --git a/doc/api/doxy-api.conf b/doc/api/doxy-api.conf
index de32af1..cfb4627 100644
--- a/doc/api/doxy-api.conf
+++ b/doc/api/doxy-api.conf
@@ -34,16 +34,18 @@  INPUT                   = doc/api/doxy-api-index.md \
                           lib/librte_eal/common/include \
                           lib/librte_eal/common/include/generic \
                           lib/librte_acl \
+                          lib/librte_cfgfile \
                           lib/librte_cmdline \
+                          lib/librte_compat \
                           lib/librte_distributor \
                           lib/librte_ether \
                           lib/librte_hash \
                           lib/librte_ip_frag \
+                          lib/librte_ivshmem \
                           lib/librte_jobstats \
                           lib/librte_kni \
                           lib/librte_kvargs \
                           lib/librte_lpm \
-                          lib/librte_malloc \
                           lib/librte_mbuf \
                           lib/librte_mempool \
                           lib/librte_meter \