linux/Documentation/driver-api/80211/cfg80211.rst
Mauro Carvalho Chehab efc7d01a9e docs: net: 80211: reduce docs build time
the files under /80211 calls kernel-doc script 207 times, one for each
single function and doc chapter. Due to that, it takes a lot of time
handling it:

	$ touch Documentation/driver-api/80211/*rst && time make SPHINXDIRS=driver-api/80211 htmldocs
...
	real	0m22,928s
	user	0m21,644s
	sys	0m1,334s

Reduce the build time by doing only one kernel-doc call
per functions that belong to the same group. With that, there's now
50 calls to kernel-doc, which makes the build time for those docs
62% faster:

	$ touch Documentation/driver-api/80211/*rst && time make SPHINXDIRS=driver-api/80211 htmldocs
...
	real	0m8,666s
	user	0m8,084s
	sys	0m0,642s

As a side effect, it should now be easier to add newer
functions, as there's no need to repeat the kernel-doc
pattern.

Measurements made on a NUC8i7HNK machine with lots of ram
and a fast SSD disk with Sphinx 3.2.1.

Signed-off-by: Mauro Carvalho Chehab <mchehab+huawei@kernel.org>
Link: https://lore.kernel.org/r/f0085721d85ebc3a77164b457ed948eee48b55df.1601890703.git.mchehab+huawei@kernel.org
Signed-off-by: Johannes Berg <johannes.berg@intel.com>
2020-10-08 10:41:49 +02:00

179 lines
3.6 KiB
ReStructuredText

==================
cfg80211 subsystem
==================
.. kernel-doc:: include/net/cfg80211.h
:doc: Introduction
Device registration
===================
.. kernel-doc:: include/net/cfg80211.h
:doc: Device registration
.. kernel-doc:: include/net/cfg80211.h
:functions:
ieee80211_channel_flags
ieee80211_channel
ieee80211_rate_flags
ieee80211_rate
ieee80211_sta_ht_cap
ieee80211_supported_band
cfg80211_signal_type
wiphy_params_flags
wiphy_flags
wiphy
wireless_dev
wiphy_new
wiphy_read_of_freq_limits
wiphy_register
wiphy_unregister
wiphy_free
wiphy_name
wiphy_dev
wiphy_priv
priv_to_wiphy
set_wiphy_dev
wdev_priv
ieee80211_iface_limit
ieee80211_iface_combination
cfg80211_check_combinations
Actions and configuration
=========================
.. kernel-doc:: include/net/cfg80211.h
:doc: Actions and configuration
.. kernel-doc:: include/net/cfg80211.h
:functions:
cfg80211_ops
vif_params
key_params
survey_info_flags
survey_info
cfg80211_beacon_data
cfg80211_ap_settings
station_parameters
rate_info_flags
rate_info
station_info
monitor_flags
mpath_info_flags
mpath_info
bss_parameters
ieee80211_txq_params
cfg80211_crypto_settings
cfg80211_auth_request
cfg80211_assoc_request
cfg80211_deauth_request
cfg80211_disassoc_request
cfg80211_ibss_params
cfg80211_connect_params
cfg80211_pmksa
cfg80211_rx_mlme_mgmt
cfg80211_auth_timeout
cfg80211_rx_assoc_resp
cfg80211_assoc_timeout
cfg80211_tx_mlme_mgmt
cfg80211_ibss_joined
cfg80211_connect_resp_params
cfg80211_connect_done
cfg80211_connect_result
cfg80211_connect_bss
cfg80211_connect_timeout
cfg80211_roamed
cfg80211_disconnected
cfg80211_ready_on_channel
cfg80211_remain_on_channel_expired
cfg80211_new_sta
cfg80211_rx_mgmt
cfg80211_mgmt_tx_status
cfg80211_cqm_rssi_notify
cfg80211_cqm_pktloss_notify
cfg80211_michael_mic_failure
Scanning and BSS list handling
==============================
.. kernel-doc:: include/net/cfg80211.h
:doc: Scanning and BSS list handling
.. kernel-doc:: include/net/cfg80211.h
:functions:
cfg80211_ssid
cfg80211_scan_request
cfg80211_scan_done
cfg80211_bss
cfg80211_inform_bss
cfg80211_inform_bss_frame_data
cfg80211_inform_bss_data
cfg80211_unlink_bss
cfg80211_find_ie
ieee80211_bss_get_ie
Utility functions
=================
.. kernel-doc:: include/net/cfg80211.h
:doc: Utility functions
.. kernel-doc:: include/net/cfg80211.h
:functions:
ieee80211_channel_to_frequency
ieee80211_frequency_to_channel
ieee80211_get_channel
ieee80211_get_response_rate
ieee80211_hdrlen
ieee80211_get_hdrlen_from_skb
ieee80211_radiotap_iterator
Data path helpers
=================
.. kernel-doc:: include/net/cfg80211.h
:doc: Data path helpers
.. kernel-doc:: include/net/cfg80211.h
:functions:
ieee80211_data_to_8023
ieee80211_amsdu_to_8023s
cfg80211_classify8021d
Regulatory enforcement infrastructure
=====================================
.. kernel-doc:: include/net/cfg80211.h
:doc: Regulatory enforcement infrastructure
.. kernel-doc:: include/net/cfg80211.h
:functions:
regulatory_hint
wiphy_apply_custom_regulatory
freq_reg_info
RFkill integration
==================
.. kernel-doc:: include/net/cfg80211.h
:doc: RFkill integration
.. kernel-doc:: include/net/cfg80211.h
:functions:
wiphy_rfkill_set_hw_state
wiphy_rfkill_start_polling
wiphy_rfkill_stop_polling
Test mode
=========
.. kernel-doc:: include/net/cfg80211.h
:doc: Test mode
.. kernel-doc:: include/net/cfg80211.h
:functions:
cfg80211_testmode_alloc_reply_skb
cfg80211_testmode_reply
cfg80211_testmode_alloc_event_skb
cfg80211_testmode_event