shuffle comments

diff --git a/src/openpower/sv/svp64.py b/src/openpower/sv/svp64.py
index b57ce7808070c06ecc361dbefeb71a7186b7bcc6..634687e28e6f9dbb2a0b1db89878f620be345e7c 100644 (file)
--- a/src/openpower/sv/svp64.py
+++ b/src/openpower/sv/svp64.py
@@ -1,25 +1,29 @@
 # SPDX-License-Identifier: LGPLv3+
 # Copyright (C) 2021 Luke Kenneth Casson Leighton <lkcl@lkcl.net>
 # Funded by NLnet http://nlnet.nl
-"""SVP64 RM (Remap) Record.
+"""SVP64 Data Structures
 
-https://libre-soc.org/openpower/sv/svp64/
-
-| Field Name  | Field bits | Description                            |
-|-------------|------------|----------------------------------------|
-| MASKMODE    | `0`        | Execution (predication) Mask Kind      |
-| MASK        | `1:3`      | Execution Mask                         |
-| ELWIDTH     | `4:5`      | Element Width                          |
-| ELWIDTH_SRC | `6:7`      | Element Width for Source               |
-| SUBVL       | `8:9`      | Sub-vector length                      |
-| EXTRA       | `10:18`    | context-dependent extra                |
-| MODE        | `19:23`    | changes Vector behaviour               |
+For full spec see https://libre-soc.org/openpower/sv/
 """
 
 from nmigen import Record
 
 # in nMigen, Record begins at the LSB and fills upwards
 class SVP64Rec(Record):
+    """SVP64 RM (Remap) Record.
+
+    https://libre-soc.org/openpower/sv/svp64/
+
+    | Field Name  | Field bits | Description                            |
+    |-------------|------------|----------------------------------------|
+    | MASKMODE    | `0`        | Execution (predication) Mask Kind      |
+    | MASK        | `1:3`      | Execution Mask                         |
+    | ELWIDTH     | `4:5`      | Element Width                          |
+    | ELWIDTH_SRC | `6:7`      | Element Width for Source               |
+    | SUBVL       | `8:9`      | Sub-vector length                      |
+    | EXTRA       | `10:18`    | context-dependent extra                |
+    | MODE        | `19:23`    | changes Vector behaviour               |
+    """
     def __init__(self, name=None):
         Record.__init__(self, layout=[("mode"    , 5),
                                       ("extra"   , 9),