F9535: Update Manual.rst

Documentation/Manual.rst

@@ -6434,6 +6434,10 @@ Column: _Paged
 Column: _vertical
 ^^^^^^^^^^^^^^^^^
 
+Use instead `vertical-column-title`_
+
+.. warning:: The '... AS _vertical' is deprecated - do not use it anymore.
+
 Render text vertically. This is useful for tables with limited column width. The vertical rendering is achieved via CSS tranformations
 (rotation) defined in the style attribute of the wrapping tag. You can optionally specify the rotation angle.
 
@@ -6443,13 +6447,13 @@ Render text vertically. This is useful for tables with limited column width. The
 
 ..
 
-+-------------+-------------------------------------------------------------------------------------------------------+-----------------+
-|**Parameter**|**Description**                                                                                        |**Default value**|
-+=============+=======================================================================================================+=================+
-|<text>       |The string that should be rendered vertically.                                                         |none             |
-+-------------+-------------------------------------------------------------------------------------------------------+-----------------+
-|<angle>      |How many degrees should the text be rotated? The angle is measured clockwise from baseline of the text.|*270*            |
-+-------------+-------------------------------------------------------------------------------------------------------+-----------------+
++-------------+--------------------------------------------------------------------------------------------------------+-----------------+
+|**Parameter**| **Description**                                                                                        |**Default value**|
++=============+========================================================================================================+=================+
+|<text>       | The string that should be rendered vertically.                                                         |none             |
++-------------+--------------------------------------------------------------------------------------------------------+-----------------+
+|<angle>      | How many degrees should the text be rotated? The angle is measured clockwise from baseline of the text.|*270*            |
++-------------+--------------------------------------------------------------------------------------------------------+-----------------+
 
 The text is surrounded by some HTML tags in an effort to make other elements position appropriately around it.
 This works best for angles close to 270 or 90.
@@ -8078,6 +8082,37 @@ FormElement) forms::
     rsep = ,&ensp;
   }
 
+.. _`vertical-column-title`:
+
+Table: vertical column title
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+To orientate a column title vertical, use the QFQ CSS classe `qfq-vertical` in td|th and `qfq-vertical-text` around the text.
+
+HTML example (second column title is vertical)::
+
+  <table><thead>
+    <tr>
+      <th>horizontal</th>
+      <th class="qfq-vertical"><span class="qfq-vertical-text">text vertical</span></th>
+    </tr>
+  </thead></table>
+
+
+QFQ example::
+
+  10 {
+    sql = SELECT title FROM Settings ORDER BY title
+    fbeg = <th class="qfq-vertical"><span class="qfq-vertical-text">
+    fend = </span></th>
+    head = <table><thead><tr>
+    rend = </tr></thead>
+    tail = </table>
+
+    20.sql = SELECT ...
+  }
+
+
 .. _`store_user_examples`:
 
 STORE_USER examples