Convert the PM documents to ReST, in order to allow them to build with Sphinx. The conversion is actually: - add blank lines and indentation in order to identify paragraphs; - fix tables markups; - add some lists markups; - mark literal blocks; - adjust title markups. At its new index.rst, let's add a :orphan: while this is not linked to the main index.rst file, in order to avoid build warnings.
Showing the changes to include/linux (3 of 51 files). Show all
Unified · Split
| @@ -52,7 +52,7 @@ · 51 unmodified lines | ||
| 52 | 52 | * irq line disabled until the threaded handler has been run. |
| 53 | 53 | * IRQF_NO_SUSPEND - Do not disable this IRQ during suspend. Does not guarantee |
| 54 | 54 | * that this interrupt will wake the system from a suspended |
| 55 | − * state. See Documentation/power/suspend-and-interrupts.txt | |
| 55 | + * state. See Documentation/power/suspend-and-interrupts.rst | |
| 56 | 56 | * IRQF_FORCE_RESUME - Force enable it on resume even if IRQF_NO_SUSPEND is set |
| 57 | 57 | * IRQF_NO_THREAD - Interrupt cannot be threaded |
| 58 | 58 | * IRQF_EARLY_RESUME - Resume IRQ early during syscore instead of at device |
| @@ -807,7 +807,7 @@ struct module; · 806 unmodified lines | ||
| 807 | 807 | * @suspend_late: Put device into low power state. |
| 808 | 808 | * @resume_early: Wake device from low power state. |
| 809 | 809 | * @resume: Wake device from low power state. |
| 810 | − * (Please see Documentation/power/pci.txt for descriptions | |
| 810 | + * (Please see Documentation/power/pci.rst for descriptions | |
| 811 | 811 | * of PCI Power Management and the related functions.) |
| 812 | 812 | * @shutdown: Hook into reboot_notifier_list (kernel/sys.c). |
| 813 | 813 | * Intended to stop any idling DMA operations. |
| @@ -284,7 +284,7 @@ typedef struct pm_message { · 283 unmodified lines | ||
| 284 | 284 | * actions to be performed by a device driver's callbacks generally depend on |
| 285 | 285 | * the platform and subsystem the device belongs to. |
| 286 | 286 | * |
| 287 | − * Refer to Documentation/power/runtime_pm.txt for more information about the | |
| 287 | + * Refer to Documentation/power/runtime_pm.rst for more information about the | |
| 288 | 288 | * role of the @runtime_suspend(), @runtime_resume() and @runtime_idle() |
| 289 | 289 | * callbacks in device runtime power management. |
| 290 | 290 | */ |