Fossil SCM

Documentation improvements for /forumthread and /forumpost.

drh 2026-08-28 11:49 UTC trunk
Commit d04ad10377c872ae8ecf78c6c269e621d8048140f859178740936cc7073d0f0e
1 file changed +8 -6
+8 -6
--- src/forum.c
+++ src/forum.c
@@ -1554,21 +1554,22 @@
15541554
** <div class='forumSel'>...</div>. Javascript is used to move the
15551555
** selected posting into view after the page loads.
15561556
**
15571557
** Query parameters:
15581558
**
1559
-** name=X REQUIRED. The hash of the post to display.
1559
+** name=NAME Required. The NAME value is a hash prefix or timestamp
1560
+** for the post to be displayed.
15601561
** t=a Automatic display mode, i.e. hierarchical for
15611562
** desktop and chronological for mobile. This is the
15621563
** default if the "t" query parameter is omitted.
15631564
** t=c Show posts in the order they were written.
15641565
** t=h Show posts using hierarchical indenting.
15651566
** t=s Show only the post specified by "name=X".
1566
-** t=r Alias for "t=c&unf&hist".
1567
-** t=y Alias for "t=s&unf&hist".
1568
-** raw Alias for "t=s&unf". Additionally, omit the border
1569
-** around the post, and ignore "t" and "hist".
1567
+** t=r Alias for "t=c" with "unf" and "hist".
1568
+** t=y Alias for "t=s" with "unf" and "hist".
1569
+** raw Alias for "t=s" with "unf". Additionally, omit
1570
+** the border around the post, and ignore "t" and "hist".
15701571
** unf Show the original, unformatted source text.
15711572
** hist Show edit history in addition to current posts.
15721573
*/
15731574
void forumpost_page(void){
15741575
forumthread_page();
@@ -1581,11 +1582,12 @@
15811582
** The result is basically the same as /forumpost except that none of
15821583
** the postings in the thread are selected.
15831584
**
15841585
** Query parameters:
15851586
**
1586
-** name=X REQUIRED. The hash of any post of the thread.
1587
+** name=NAME Required. The NAME value is a hash prefix or timestamp
1588
+** for one of the posts in the thread.
15871589
** t=a Automatic display mode, i.e. hierarchical for
15881590
** desktop and chronological for mobile. This is the
15891591
** default if the "t" query parameter is omitted.
15901592
** t=c Show posts in the order they were written.
15911593
** t=h Show posts using hierarchical indenting.
15921594
--- src/forum.c
+++ src/forum.c
@@ -1554,21 +1554,22 @@
1554 ** <div class='forumSel'>...</div>. Javascript is used to move the
1555 ** selected posting into view after the page loads.
1556 **
1557 ** Query parameters:
1558 **
1559 ** name=X REQUIRED. The hash of the post to display.
 
1560 ** t=a Automatic display mode, i.e. hierarchical for
1561 ** desktop and chronological for mobile. This is the
1562 ** default if the "t" query parameter is omitted.
1563 ** t=c Show posts in the order they were written.
1564 ** t=h Show posts using hierarchical indenting.
1565 ** t=s Show only the post specified by "name=X".
1566 ** t=r Alias for "t=c&unf&hist".
1567 ** t=y Alias for "t=s&unf&hist".
1568 ** raw Alias for "t=s&unf". Additionally, omit the border
1569 ** around the post, and ignore "t" and "hist".
1570 ** unf Show the original, unformatted source text.
1571 ** hist Show edit history in addition to current posts.
1572 */
1573 void forumpost_page(void){
1574 forumthread_page();
@@ -1581,11 +1582,12 @@
1581 ** The result is basically the same as /forumpost except that none of
1582 ** the postings in the thread are selected.
1583 **
1584 ** Query parameters:
1585 **
1586 ** name=X REQUIRED. The hash of any post of the thread.
 
1587 ** t=a Automatic display mode, i.e. hierarchical for
1588 ** desktop and chronological for mobile. This is the
1589 ** default if the "t" query parameter is omitted.
1590 ** t=c Show posts in the order they were written.
1591 ** t=h Show posts using hierarchical indenting.
1592
--- src/forum.c
+++ src/forum.c
@@ -1554,21 +1554,22 @@
1554 ** <div class='forumSel'>...</div>. Javascript is used to move the
1555 ** selected posting into view after the page loads.
1556 **
1557 ** Query parameters:
1558 **
1559 ** name=NAME Required. The NAME value is a hash prefix or timestamp
1560 ** for the post to be displayed.
1561 ** t=a Automatic display mode, i.e. hierarchical for
1562 ** desktop and chronological for mobile. This is the
1563 ** default if the "t" query parameter is omitted.
1564 ** t=c Show posts in the order they were written.
1565 ** t=h Show posts using hierarchical indenting.
1566 ** t=s Show only the post specified by "name=X".
1567 ** t=r Alias for "t=c" with "unf" and "hist".
1568 ** t=y Alias for "t=s" with "unf" and "hist".
1569 ** raw Alias for "t=s" with "unf". Additionally, omit
1570 ** the border around the post, and ignore "t" and "hist".
1571 ** unf Show the original, unformatted source text.
1572 ** hist Show edit history in addition to current posts.
1573 */
1574 void forumpost_page(void){
1575 forumthread_page();
@@ -1581,11 +1582,12 @@
1582 ** The result is basically the same as /forumpost except that none of
1583 ** the postings in the thread are selected.
1584 **
1585 ** Query parameters:
1586 **
1587 ** name=NAME Required. The NAME value is a hash prefix or timestamp
1588 ** for one of the posts in the thread.
1589 ** t=a Automatic display mode, i.e. hierarchical for
1590 ** desktop and chronological for mobile. This is the
1591 ** default if the "t" query parameter is omitted.
1592 ** t=c Show posts in the order they were written.
1593 ** t=h Show posts using hierarchical indenting.
1594

Keyboard Shortcuts

Open search /
Next entry (timeline) j
Previous entry (timeline) k
Open focused entry Enter
Show this help ?
Toggle theme Top nav button