Prose sentences are better written as normal paragraph instead of using bullet lists. Also, use bullet list for list of riscv_v_default_allow values. Fixes: 412c68cfeeb178 ("riscv: Add documentation for Vector") Signed-off-by: Bagas Sanjaya <bagasdotme@xxxxxxxxx> --- Documentation/riscv/vector.rst | 27 +++++++++++++-------------- 1 file changed, 13 insertions(+), 14 deletions(-) diff --git a/Documentation/riscv/vector.rst b/Documentation/riscv/vector.rst index 4624e5b9bef4cc..f752826871b0e2 100644 --- a/Documentation/riscv/vector.rst +++ b/Documentation/riscv/vector.rst @@ -102,25 +102,24 @@ status for the use of Vector in userspace: 2. System runtime configuration (sysctl) ----------------------------------------- - * To mitigate the ABI impact of expansion of the signal stack, a - policy mechanism is provided to the administrators, distro maintainers, and - developers to control the default Vector enablement status for userspace - processes: +To mitigate the ABI impact of expansion of the signal stack, a +policy mechanism is provided to the administrators, distro maintainers, and +developers to control the default Vector enablement status for userspace +processes in form of sysctl knob: -/proc/sys/abi/riscv_v_default_allow +* /proc/sys/abi/riscv_v_default_allow Writing the text representation of 0 or 1 to this file sets the default - system enablement status for new starting userspace programs. A valid value - should be: + system enablement status for new starting userspace programs. Valid values + are: - 0: Do not allow Vector code to be executed as the default for new processes. - - 1: Allow Vector code to be executed as the default for new processes. + * 0: Do not allow Vector code to be executed as the default for new processes. + * 1: Allow Vector code to be executed as the default for new processes. Reading this file returns the current system default enablement status. -* At every execve() call, a new enablement status of the new process is set to - the system default, unless: + At every execve() call, a new enablement status of the new process is set to + the system default, unless: * PR_RISCV_V_VSTATE_CTRL_INHERIT is set for the calling process, and the setting in PR_RISCV_V_VSTATE_CTRL_NEXT_MASK is not @@ -129,5 +128,5 @@ status for the use of Vector in userspace: * The setting in PR_RISCV_V_VSTATE_CTRL_NEXT_MASK is not PR_RISCV_V_VSTATE_CTRL_DEFAULT. -* Modifying the system default enablement status does not affect the enablement - status of any existing process of thread that do not make an execve() call. + Modifying the system default enablement status does not affect the enablement + status of any existing process of thread that do not make an execve() call. -- An old man doll... just what I always wanted! - Clara