[PATCH v2 2/3] Documentation: tracing: Add PCI controller event documentation

[kernel test robot]

Hi Shawn,

kernel test robot noticed the following build warnings:

[auto build test WARNING on pci/next]
[also build test WARNING on next-20260109]
[cannot apply to pci/for-linus mani-mhi/mhi-next trace/for-next linus/master v6.19-rc4]
[If your patch is applied to the wrong git tree, kindly drop us a note.
And when submitting patch, we suggest to use '--base' as documented in
https://git-scm.com/docs/git-format-patch#_base_tree_information]

url:    https://github.com/intel-lab-lkp/linux/commits/Shawn-Lin/PCI-trace-Add-PCI-controller-LTSSM-transition-tracepoint/20260109-153843
base:   https://git.kernel.org/pub/scm/linux/kernel/git/pci/pci.git next
patch link:    https://lore.kernel.org/r/1767929389-143957-3-git-send-email-shawn.lin%40rock-chips.com
patch subject: [PATCH v2 2/3] Documentation: tracing: Add PCI controller event documentation
reproduce: (https://download.01.org/0day-ci/archive/20260109/202601092104.0IlUz26P-lkp@intel.com/reproduce)

If you fix the issue in a separate patch/commit (i.e. not just a new version of
the same patch/commit), kindly add following tags
| Reported-by: kernel test robot <lkp at intel.com>
| Closes: https://lore.kernel.org/oe-kbuild-all/202601092104.0IlUz26P-lkp@intel.com/

All warnings (new ones prefixed by >>):

   WARNING: No kernel-doc for file ./include/linux/delay.h
   ERROR: Cannot find file ./include/linux/delay.h
   WARNING: No kernel-doc for file ./include/linux/delay.h
   ERROR: Cannot find file ./include/linux/delay.h
   WARNING: No kernel-doc for file ./include/linux/delay.h
>> Documentation/trace/events-pci-conotroller.rst:21: WARNING: Title underline too short.
--
   ERROR: Cannot find file ./include/linux/mutex.h
   ERROR: Cannot find file ./include/linux/mutex.h
   WARNING: No kernel-doc for file ./include/linux/mutex.h
   ERROR: Cannot find file ./include/linux/fwctl.h
   WARNING: No kernel-doc for file ./include/linux/fwctl.h
>> Documentation/trace/events-pci-conotroller.rst: WARNING: document isn't included in any toctree [toc.not_included]


vim +21 Documentation/trace/events-pci-conotroller.rst

    19	
    20	pcie_ltssm_state_transition
  > 21	-----------------------
    22	
    23	Monitors PCIe LTSSM state transition including state and rate information
    24	::
    25	
    26	    pcie_ltssm_state_transition  "dev: %s state: %s rate: %s\n"
    27	
    28	**Parameters**:
    29	
    30	* ``dev`` - PCIe root port name
    31	* ``state`` - PCIe LTSSM state
    32	* ``rate`` - PCIe bus speed
    33	
    34	**Example Usage**:
    35	
    36	    # Enable the tracepoint
    37	    echo 1 > /sys/kernel/debug/tracing/events/pci/pcie_ltssm_state_transition/enable
    38	
    39	    # Monitor events (the following output is generated when a device is linking)
    40	    cat /sys/kernel/debug/tracing/trace_pipe
  > 41	       kworker/0:0-9       [000] .....     5.600221: pcie_ltssm_state_transition: dev: a40000000.pcie state: RCVRY_EQ2 rate: 8.0 GT/s

-- 
0-DAY CI Kernel Test Service
https://github.com/intel/lkp-tests/wiki