Fossil SCM

Improved documentation for the query parameters of /timeline.

drh 2024-12-23 14:56 trunk
Commit 5b141ffffafbfd3f477d9b35c2715dcc099bd9f736adccadf29a338c788505db
1 file changed +7 -4
+7 -4
--- src/timeline.c
+++ src/timeline.c
@@ -1736,12 +1736,12 @@
17361736
** ft=CHECKIN "Forward To": Show decendents forward to CHECKIN
17371737
** d=CX ... from CX up to the time of CHECKIN
17381738
** from=CX ... shortest path from CX up to CHECKIN
17391739
** t=TAG Show only check-ins with the given TAG
17401740
** r=TAG Show check-ins related to TAG, equivalent to t=TAG&rel
1741
-** tl=TAGLIST Shorthand for t=TAGLIST&ms=brlist
1742
-** rl=TAGLIST Shorthand for r=TAGLIST&ms=brlist
1741
+** tl=TAGLIST Same as 't=TAGLIST&ms=brlist'
1742
+** rl=TAGLIST Same as 'r=TAGLIST&ms=brlist'
17431743
** rel Show related check-ins as well as those matching t=TAG
17441744
** mionly Limit rel to show ancestors but not descendants
17451745
** nowiki Do not show wiki associated with branch or tag
17461746
** ms=MATCHSTYLE Set tag match style to EXACT, GLOB, LIKE, REGEXP
17471747
** u=USER Only show items associated with USER
@@ -1755,17 +1755,20 @@
17551755
** nsm Omit the submenu
17561756
** nc Omit all graph colors other than highlights
17571757
** v Show details of files changed
17581758
** vfx Show complete text of forum messages
17591759
** f=CHECKIN Show family (immediate parents and children) of CHECKIN
1760
-** from=CHECKIN Path from...
1760
+** from=CHECKIN Path through common ancestor from...
17611761
** to=CHECKIN ... to this
17621762
** to2=CHECKIN ... backup name if to= doesn't resolve
17631763
** shortest ... show only the shortest path
17641764
** rel ... also show related checkins
17651765
** bt=PRIOR ... path from CHECKIN back to PRIOR
17661766
** ft=LATER ... path from CHECKIN forward to LATER
1767
+** me=CHECKIN Most direct path from...
1768
+** you=CHECKIN ... to this
1769
+** rel ... also show related checkins
17671770
** uf=FILE_HASH Show only check-ins that contain the given file version
17681771
** All qualifying check-ins are shown unless there is
17691772
** also an n= or n1= query parameter.
17701773
** chng=GLOBLIST Show only check-ins that involve changes to a file whose
17711774
** name matches one of the comma-separate GLOBLIST
@@ -1787,11 +1790,11 @@
17871790
** datefmt=N Override the date format: 0=HH:MM, 1=HH:MM:SS,
17881791
** 2=YYYY-MM-DD HH:MM:SS, 3=YYMMDD HH:MM, and 4 means "off".
17891792
** bisect Show the check-ins that are in the current bisect
17901793
** oldestfirst Show events oldest first.
17911794
** showid Show RIDs
1792
-** showsql Show the SQL text
1795
+** showsql Show the SQL used to generate the report
17931796
**
17941797
** p= and d= can appear individually or together. If either p= or d=
17951798
** appear, then u=, y=, a=, and b= are ignored.
17961799
**
17971800
** If both a= and b= appear then both upper and lower bounds are honored.
17981801
--- src/timeline.c
+++ src/timeline.c
@@ -1736,12 +1736,12 @@
1736 ** ft=CHECKIN "Forward To": Show decendents forward to CHECKIN
1737 ** d=CX ... from CX up to the time of CHECKIN
1738 ** from=CX ... shortest path from CX up to CHECKIN
1739 ** t=TAG Show only check-ins with the given TAG
1740 ** r=TAG Show check-ins related to TAG, equivalent to t=TAG&rel
1741 ** tl=TAGLIST Shorthand for t=TAGLIST&ms=brlist
1742 ** rl=TAGLIST Shorthand for r=TAGLIST&ms=brlist
1743 ** rel Show related check-ins as well as those matching t=TAG
1744 ** mionly Limit rel to show ancestors but not descendants
1745 ** nowiki Do not show wiki associated with branch or tag
1746 ** ms=MATCHSTYLE Set tag match style to EXACT, GLOB, LIKE, REGEXP
1747 ** u=USER Only show items associated with USER
@@ -1755,17 +1755,20 @@
1755 ** nsm Omit the submenu
1756 ** nc Omit all graph colors other than highlights
1757 ** v Show details of files changed
1758 ** vfx Show complete text of forum messages
1759 ** f=CHECKIN Show family (immediate parents and children) of CHECKIN
1760 ** from=CHECKIN Path from...
1761 ** to=CHECKIN ... to this
1762 ** to2=CHECKIN ... backup name if to= doesn't resolve
1763 ** shortest ... show only the shortest path
1764 ** rel ... also show related checkins
1765 ** bt=PRIOR ... path from CHECKIN back to PRIOR
1766 ** ft=LATER ... path from CHECKIN forward to LATER
 
 
 
1767 ** uf=FILE_HASH Show only check-ins that contain the given file version
1768 ** All qualifying check-ins are shown unless there is
1769 ** also an n= or n1= query parameter.
1770 ** chng=GLOBLIST Show only check-ins that involve changes to a file whose
1771 ** name matches one of the comma-separate GLOBLIST
@@ -1787,11 +1790,11 @@
1787 ** datefmt=N Override the date format: 0=HH:MM, 1=HH:MM:SS,
1788 ** 2=YYYY-MM-DD HH:MM:SS, 3=YYMMDD HH:MM, and 4 means "off".
1789 ** bisect Show the check-ins that are in the current bisect
1790 ** oldestfirst Show events oldest first.
1791 ** showid Show RIDs
1792 ** showsql Show the SQL text
1793 **
1794 ** p= and d= can appear individually or together. If either p= or d=
1795 ** appear, then u=, y=, a=, and b= are ignored.
1796 **
1797 ** If both a= and b= appear then both upper and lower bounds are honored.
1798
--- src/timeline.c
+++ src/timeline.c
@@ -1736,12 +1736,12 @@
1736 ** ft=CHECKIN "Forward To": Show decendents forward to CHECKIN
1737 ** d=CX ... from CX up to the time of CHECKIN
1738 ** from=CX ... shortest path from CX up to CHECKIN
1739 ** t=TAG Show only check-ins with the given TAG
1740 ** r=TAG Show check-ins related to TAG, equivalent to t=TAG&rel
1741 ** tl=TAGLIST Same as 't=TAGLIST&ms=brlist'
1742 ** rl=TAGLIST Same as 'r=TAGLIST&ms=brlist'
1743 ** rel Show related check-ins as well as those matching t=TAG
1744 ** mionly Limit rel to show ancestors but not descendants
1745 ** nowiki Do not show wiki associated with branch or tag
1746 ** ms=MATCHSTYLE Set tag match style to EXACT, GLOB, LIKE, REGEXP
1747 ** u=USER Only show items associated with USER
@@ -1755,17 +1755,20 @@
1755 ** nsm Omit the submenu
1756 ** nc Omit all graph colors other than highlights
1757 ** v Show details of files changed
1758 ** vfx Show complete text of forum messages
1759 ** f=CHECKIN Show family (immediate parents and children) of CHECKIN
1760 ** from=CHECKIN Path through common ancestor from...
1761 ** to=CHECKIN ... to this
1762 ** to2=CHECKIN ... backup name if to= doesn't resolve
1763 ** shortest ... show only the shortest path
1764 ** rel ... also show related checkins
1765 ** bt=PRIOR ... path from CHECKIN back to PRIOR
1766 ** ft=LATER ... path from CHECKIN forward to LATER
1767 ** me=CHECKIN Most direct path from...
1768 ** you=CHECKIN ... to this
1769 ** rel ... also show related checkins
1770 ** uf=FILE_HASH Show only check-ins that contain the given file version
1771 ** All qualifying check-ins are shown unless there is
1772 ** also an n= or n1= query parameter.
1773 ** chng=GLOBLIST Show only check-ins that involve changes to a file whose
1774 ** name matches one of the comma-separate GLOBLIST
@@ -1787,11 +1790,11 @@
1790 ** datefmt=N Override the date format: 0=HH:MM, 1=HH:MM:SS,
1791 ** 2=YYYY-MM-DD HH:MM:SS, 3=YYMMDD HH:MM, and 4 means "off".
1792 ** bisect Show the check-ins that are in the current bisect
1793 ** oldestfirst Show events oldest first.
1794 ** showid Show RIDs
1795 ** showsql Show the SQL used to generate the report
1796 **
1797 ** p= and d= can appear individually or together. If either p= or d=
1798 ** appear, then u=, y=, a=, and b= are ignored.
1799 **
1800 ** If both a= and b= appear then both upper and lower bounds are honored.
1801

Keyboard Shortcuts

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