Fossil

Check-in [1f78e794d3]
Login

Many hyperlinks are disabled.
Use anonymous login to enable hyperlinks.

Overview
Comment:Add documentation for various settings that influence the display of timelines, but only display them if their values are different from the default.
Downloads: Tarball | ZIP archive
Timelines: family | ancestors | descendants | both | trunk
Files: files | file ages | folders
SHA3-256: 1f78e794d35e4e651b2fa3d5a5e11094f69a6a855f7828ae70b3cf82ee6f863b
User & Date: drh 2025-03-19 11:21:44.062
Context
2025-03-19
11:31
Simplify the command property of "abbreviated-subcommands" to just "abbrv-subcom" and the setting property of "show-only-if-changed" to just "if-chng". check-in: 3e7c7e2277 user: drh tags: trunk
11:21
Add documentation for various settings that influence the display of timelines, but only display them if their values are different from the default. check-in: 1f78e794d3 user: drh tags: trunk
11:08
Add "jove" to the list of text editors that Fossil searches for if the "editor" setting and the VISUAL and EDITOR environment variables are not available. check-in: 486f81b931 user: drh tags: trunk
2025-03-14
10:22
Add documentation for various settings that influence the display of timelines. check-in: 7d67724653 user: drh tags: comment-markdown-links
Changes
Unified Diff Ignore Whitespace Patch
Changes to src/printf.c.
237
238
239
240
241
242
243

























244
245
246
247
248
249
250
#else
static int StrNLen32(const char *z, int N){
  int n = 0;
  while( (N-- != 0) && *(z++)!=0 ){ n++; }
  return n;
}
#endif


























/*
** Return an appropriate set of flags for wiki_convert() for displaying
** comments on a timeline.  These flag settings are determined by
** configuration parameters.
**
** The altForm2 argument is true for "%!W" (with the "!" alternate-form-2







>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>







237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
#else
static int StrNLen32(const char *z, int N){
  int n = 0;
  while( (N-- != 0) && *(z++)!=0 ){ n++; }
  return n;
}
#endif

/*
** SETTING: timeline-plaintext         boolean default=off show-only-if-changed
**
** If enabled, no wiki-formatting is done for timeline comment messages.
** Hyperlinks are activated, but they show up on screen using the 
** complete input text, not just the display text.  No other formatting
** is done.
*/
/*
** SETTING: timeline-block-markup      boolean default=off show-only-if-changed
**
** If enabled, block markup (paragraph brakes, tables, lists, headings, etc)
** is enabled while rendering check-in comment message on the timeline.
** This is disabled by default, because the timeline works best if the
** check-in comments are short and do not take up too much vertical space.
*/
/*
** SETTING: timeline-hard-newlines     boolean default=off show-only-if-changed
**
** If enabled, the timeline honors newline characters in check-in comments.
** In other words, newlines are coverted into <br> for HTML display.
** The default behavior, when this setting is off, is that newlines are
** treated like any other whitespace character.
*/

/*
** Return an appropriate set of flags for wiki_convert() for displaying
** comments on a timeline.  These flag settings are determined by
** configuration parameters.
**
** The altForm2 argument is true for "%!W" (with the "!" alternate-form-2
Changes to src/timeline.c.
219
220
221
222
223
224
225








226









227
228
229
230
231
232
233

  if( cgi_is_loopback(g.zIpAddr) && db_open_local(0) ){
    vid = db_lget_int("checkout", 0);
  }
  zPrevDate[0] = 0;
  mxWikiLen = db_get_int("timeline-max-comment", 0);
  dateFormat = db_get_int("timeline-date-format", 0);








  bCommentGitStyle = db_get_int("timeline-truncate-at-blank", 0);









  bTimestampLinksToInfo = db_get_boolean("timeline-tslink-info", 0);
  if( (tmFlags & TIMELINE_VIEWS)==0 ){
    tmFlags |= timeline_ss_cookie();
  }
  if( tmFlags & TIMELINE_COLUMNAR ){
    zStyle = "Columnar";
  }else if( tmFlags & TIMELINE_COMPACT ){







>
>
>
>
>
>
>
>

>
>
>
>
>
>
>
>
>







219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250

  if( cgi_is_loopback(g.zIpAddr) && db_open_local(0) ){
    vid = db_lget_int("checkout", 0);
  }
  zPrevDate[0] = 0;
  mxWikiLen = db_get_int("timeline-max-comment", 0);
  dateFormat = db_get_int("timeline-date-format", 0);
  /*
  ** SETTING: timeline-truncate-at-blank  boolean default=off show-only-if-changed
  **
  ** If enabled, check-in comments displayed on the timeline are truncated
  ** at the first blank line of the comment text.  The comment text after
  ** the first blank line is only seen in the /info or similar pages that
  ** show details about the check-in.
  */
  bCommentGitStyle = db_get_int("timeline-truncate-at-blank", 0);
  /*
  ** SETTING: timeline-tslink-info       boolean default=off show-only-if-changed
  **
  ** The hyperlink on the timestamp associated with each timeline entry,
  ** on the far left-hand side of the screen, normally targets another
  ** /timeline page that shows the entry in context.  However, if this
  ** option is turned on, that hyperlink targets the /info page showing
  ** the details of the entry.
  */
  bTimestampLinksToInfo = db_get_boolean("timeline-tslink-info", 0);
  if( (tmFlags & TIMELINE_VIEWS)==0 ){
    tmFlags |= timeline_ss_cookie();
  }
  if( tmFlags & TIMELINE_COLUMNAR ){
    zStyle = "Columnar";
  }else if( tmFlags & TIMELINE_COMPACT ){