Documentation Source Text

Check-in [5f5f7776fc]
Login

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

Overview
Comment:Generate the "toc.db" database containing all interfaces with links to their documentation.
Downloads: Tarball | ZIP archive
Timelines: family | ancestors | descendants | both | trunk
Files: files | file ages | folders
SHA1: 5f5f7776fcf7162a30e2c1317b13413fd6c8f216
User & Date: drh 2015-04-10 14:08:25.204
Context
2015-04-10
14:39
Add a brief comment describing what the toc.db build logic is used for and why it is important. (check-in: c7671e4258 user: drh tags: trunk)
14:08
Generate the "toc.db" database containing all interfaces with links to their documentation. (check-in: 5f5f7776fc user: drh tags: trunk)
2015-04-08
14:12
Add the checksum and source-ids for version 3.8.9 to the changelog. Update the release date to the 8th. (check-in: bed24cae9a user: dan tags: trunk)
Changes
Side-by-Side Diff Ignore Whitespace Patch
Changes to pages/capi3ref.in.
360
361
362
363
364
365
366























367
368
369
370
371
372
373
374
375
376
377
378
379



380
381
382
383
384
385
386
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412







+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+













+
+
+







be removed in some future release.</li>
</ul>

<tcl>
hd_close_aux
hd_puts {<hr>}

sqlite3 dbtoc doc/toc.db
dbtoc eval {
BEGIN;
DROP TABLE IF EXISTS toc;
CREATE TABLE toc(
  name TEXT,  -- Name of interface
  type TEXT,  -- 'object', 'constant', or 'function'
  status INT, -- 0=normal, 1=experimental, 2=deprecated
  title TEXT, -- Documentation page title
  uri TEXT    -- Path to the documentation
);
}
proc convert_keyword_to_uri {key} {
  global glink hd
  if {[info exists glink($key)]} {
    set x $hd(rootpath-aux)$glink($key)
    regsub {^\.\./} $x {} x
    return $x
  } else {
    return unknown?key=$key
  }
}


# Do a table of contents for objects
#
set objlist {}
foreach c $content {
  foreach {key title type keywords body code} $c break
  if {$type!="datatype"} continue
  set keywords [lsort -nocase $keywords]
  set k [preferred_keyword $keywords]
  set s $supported($k)
  foreach kw $keywords {
    if {[regexp {^sqlite} $kw]} {
      lappend objlist [list $k $kw $s]
      set uri [convert_keyword_to_uri $k]
      dbtoc eval {INSERT INTO toc(name,type,status,title,uri)
                   VALUES($kw,'object',$s,$title,$uri)}
    }
  }
}
hd_open_aux c3ref/objlist.html
hd_header {List Of SQLite Objects}
hd_enable_main 0
hd_putsnl {<a href="intro.html"><h2>SQLite C Interface</h2></a>}
406
407
408
409
410
411
412



413
414
415
416
417
418
419
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448







+
+
+







  if {$type!="constant"} continue
  set keywords [lsort $keywords]
  set k [preferred_keyword $keywords]
  set s $supported($k)
  foreach kw $keywords {
    if {[regexp {^SQLITE_} $kw] && ![regexp {[^A-Z_0-9]} $kw]} {
      lappend clist [list $kw $kw $s]
      set uri [convert_keyword_to_uri $kw]
      dbtoc eval {INSERT INTO toc(name,type,status,title,uri)
                   VALUES($kw,'constant',$s,$title,$uri)}
    }
  }
}
hd_open_aux c3ref/constlist.html
hd_header {List Of SQLite Constants}
hd_enable_main 0
hd_putsnl {<a href="intro.html"><h2>SQLite C Interface</h2></a>}
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448



449
450
451
452
453
454
455
458
459
460
461
462
463
464

465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486







-












+
+
+







<a href="objlist.html">Objects</a> and
<a href="funclist.html">Functions</a> and
<a href="../rescode.html">Result Codes</a>.</p>}
hd_enable_main 1
hd_close_aux
hd_putsnl {<hr>}


# Do a table of contents for functions
#
set funclist {}
foreach c $content {
  foreach {key title type keywords body code} $c break
  if {$type!="function"} continue
  set keywords [lsort $keywords]
  set k [preferred_keyword $keywords]
  set s $supported($k)
  foreach kw $keywords {
    if {[regexp {^sqlite} $kw]} {
      lappend funclist [list $k $kw $s]
      set uri [convert_keyword_to_uri $k]
      dbtoc eval {INSERT INTO toc(name,type,status,title,uri)
                   VALUES($kw,'function',$s,$title,$uri)}
    }
  }
}
hd_open_aux c3ref/funclist.html
hd_header {List Of SQLite Functions}
hd_keywords *capi3ref_funclist {C-API function list}
hd_enable_main 0
467
468
469
470
471
472
473


474
475
476
477
478
479
480
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513







+
+







hd_putsnl {<p>Other lists:
<a href="constlist.html">Constants</a> and
<a href="objlist.html">Objects</a> and
<a href="../rescode.html">Result Codes</a></p>}
hd_enable_main 1
hd_close_aux
hd_putsnl {<hr>}
dbtoc eval COMMIT
dbtoc close

# Convert a fragment text label into a fragment name
#
proc hd_fragname {lbl} {
  regsub -all {[^a-z0-9]} [string tolower $lbl] {} lbl2
  return $lbl2
}