Documentation Source Text

Check-in [0dc4a0b22a]
Login

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

Overview
Comment:Merge the download page improvements that have been taking place over on the 3.7.17 branch.
Timelines: family | ancestors | descendants | both | trunk
Files: files | file ages | folders
SHA1:0dc4a0b22aa2835d42f01e497c56e0d990d64237
User & Date: drh 2013-07-23 13:48:20
Context
2013-08-01
17:48
Fix the description of COLLATE operator precedence so that it is aligned with the implementation. check-in: 52366f9588 user: drh tags: trunk
2013-07-23
13:48
Merge the download page improvements that have been taking place over on the 3.7.17 branch. check-in: 0dc4a0b22a user: drh tags: trunk
13:45
Add a missing "not" to the text in the download page. check-in: 53bc857d09 user: drh tags: 3.7.17
2013-07-17
15:39
Omit the newline from the default root name in standalone mode in althttpd. check-in: 6df9c92bc9 user: drh tags: trunk
Changes
Hide Diffs Side-by-Side Diffs Ignore Whitespace Patch

Changes to pages/download.in.

     1      1   <title>SQLite Download Page</title>
     2      2   
     3      3   <h2>SQLite Download Page</h2>
     4         -<table width="100%" cellpadding="5">
            4  +<table width="100%" cellpadding="5" cellspacing="0">
     5      5   
     6      6   <tcl>
     7      7   hd_keywords {download page}
     8      8   set nDownload 0
            9  +set BG {}
     9     10   proc Product {pattern desc {frag {}}} {
    10     11     regsub VVV $pattern {*} p3
    11     12     regsub DATE $p3 {20*} p3
    12     13     regsub YEAR $p3 {20[134][0-9]} p3
    13     14     regsub VVV $pattern {(30\d{5})} pattern
    14     15     regsub DATE $pattern {(\d{12})} pattern
    15     16     regsub YEAR $pattern {\d{4}} pattern
................................................................................
    36     37       if {$size>1024*1024} {
    37     38         set size [format %.2f [expr {$size/(1024.0*1024.0)}]]
    38     39         set units MiB
    39     40       } elseif {$size>1024} {
    40     41         set size [format %.2f [expr {$size/(1024.0)}]]
    41     42         set units KiB
    42     43       }
    43         -    global pending_heading pending_tag
           44  +    global pending_heading pending_tag BG
           45  +    if {$BG!=""} {
           46  +      set tr "<tr bgcolor=\"$BG\">"
           47  +    } else {
           48  +      set tr "<tr>"
           49  +    }
    44     50       if {$pending_heading!=""} {
    45     51         if {$pending_tag!=""} {
    46     52           set tg "<a name=\"$pending_tag\"></a>"
    47     53           set pending_tag {}
    48     54         } else {
    49     55           set tg ""
    50     56         }
    51         -      hd_puts "<tr><td colspan=\"4\">$tg<b>$pending_heading</b></td></tr>\n"
           57  +      hd_puts "$tr<td colspan=\"4\">$tg<b>$pending_heading</b></td></tr>\n"
    52     58         set pending_heading {}
    53     59       }
    54         -    hd_puts "<tr><td width=\"10\"></td>"
           60  +    hd_puts "$tr<td width=\"10\"></td>"
    55     61       hd_puts "<td valign=\"top\" align=\"right\">"
    56     62       if {$frag!=""} {
    57     63         eval hd_fragment $frag
    58     64         set frag {}
    59     65       }
    60     66       hd_puts "<a href=\"$file\">[file tail $file]</a><br>($size $units)</td>\n"
    61     67       hd_puts "<td width=\"5\"></td>"
................................................................................
    67     73     }
    68     74     if {$frag!=""} {
    69     75       eval hd_keywords [lrange $frag 1 end]
    70     76     }
    71     77   }
    72     78   cd $::DEST
    73     79   
    74         -proc Heading {title {tag {}}} {
           80  +proc Heading {title {tag {}} {bgcolor {}}} {
    75     81     set ::pending_heading $title
    76     82     set ::pending_tag $tag
           83  +  set ::BG $bgcolor
    77     84     # hd_puts "<tr><td colspan=4><big><b>$title</b></big></td></tr>"
    78     85   }
    79     86   
    80         -Heading {Pre-release Source Code Snapshots}
           87  +set Caution #fff1c8
           88  +
           89  +Heading {Pre-release Snapshots} {} $Caution
    81     90   
    82     91   
    83     92   Product {snapshot/sqlite-amalgamation-DATE.zip} {
    84     93     This is a snapshot (as of VERSION) of the current SQLite code under 
    85     94     development.  Use this snapshot for testing only.  This is not a release.
    86     95     This ZIP archive contains all preprocessed C code combined into a
    87     96     single source file (the [amalgamation]).
................................................................................
   104    113     shell program for 32-bit windows.
   105    114   }
   106    115   Product {snapshot/sqlite-shell-win64-x64-DATE.zip} {
   107    116     This is a snapshot (as of VERSION) build of the 
   108    117     <a href="sqlite.html">sqlite3.exe command-line shell</a>
   109    118     shell program for 64-bit windows.
   110    119   }
          120  +
          121  +Product {snapshot/sqlite-winrt81-DATE.vsix} {
          122  +  This is a snapshot (as of VERSION) for
          123  +  a complete VSIX package with an extension SDK and all other components
          124  +  needed to use SQLite for WinRT 8.1 application development with Visual Studio
          125  +  2013.  This is not a release.
          126  +}
   111    127   
   112    128   
   113    129   Heading {Source Code}
   114    130   
   115    131   Product {YEAR/sqlite-amalgamation-VVV.zip} {
   116    132     This ZIP archive contains all C source code for SQLite VERSION
   117    133     combined into a
................................................................................
   216    232   Product YEAR/sqlite-wp80-winrt-DATE.vsix {
   217    233     A complete VSIX package with an extension SDK and all other components
   218    234     needed to use SQLite for application development with Visual Studio
   219    235     2012 targeting Windows Phone 8.0.
   220    236     This particular VSIX uses a snapshot of SQLite as of VERSION.
   221    237   }
   222    238   
   223         -
   224    239   Heading {Precompiled Binaries for Windows Runtime} winrt
   225    240   
   226    241   Product YEAR/sqlite-dll-winrt-x86-VVV.zip {
   227    242     This ZIP archive contains a DLL for the SQLite library version VERSION for
   228    243     32-bit x86 processors using the WinRT API.
   229    244   }
   230    245   
................................................................................
   275    290     <u>not</u> recommended.  Use one of the amalgamation packages above
   276    291     unless you have a compelling reason not to.
   277    292   }
   278    293   
   279    294   
   280    295   </tcl>
   281    296   </table>
          297  +<hr>
   282    298   
   283    299   <tcl>hd_fragment encoding {build product names}</tcl>
   284    300   <h3>Build Product Names</h3>
   285    301   
   286         -<p>Beginning with SQLite [version 3.7.4], the names of the build products
   287         -have changed to be more consistent.  (Prior to version 3.7.4, the
   288         -names of build products were seemingly random.)  Build products are named
   289         -using one of the following templates:
          302  +<p>
          303  +Build products are named using one of the following templates:
   290    304   
   291    305   <ol>
   292    306   <li> <b>sqlite-</b>product<b>-</b>version<b>.zip</b>
   293    307   <li> <b>sqlite-</b>product<b>-</b>version<b>.tar.gz</b>
   294    308   <li> <b>sqlite-</b>product<b>-</b>os<b>-</b>cpu<b>-</b>version<b>.zip</b>
   295    309   <li> <b>sqlite-</b>product<b>-</b>date<b>.zip</b>
   296    310   </ol>
................................................................................
   306    320   filename encoding is 3XXYY00.  For branch version 3.X.Y.Z, the encoding is
   307    321   3XXYYZZ.
   308    322   
   309    323   <p>The <i>date</i> in template (4) is of the form: YYYYMMDDHHMM
   310    324   
   311    325   <a name="cvs"></a>
   312    326   <a name="fossil"></a>
   313         -<h3>Canonical Source Code</h3>
          327  +<h3>Source Code Repositories</h3>
   314    328   
   315    329   <p>
   316         -The canonical SQLite source code is maintained in three self-synchronizing
          330  +The SQLite source code is maintained in three geographically-dispersed
          331  +self-synchronizing
   317    332   [http://www.fossil-scm.org/ | Fossil] repositories that are
   318    333   available for anonymous read-only access.  Anyone can 
   319    334   view the repository contents and download historical versions
   320    335   of individual files or ZIP archives of historical check-ins.</p>
   321    336   
   322    337   <p>Note that a unix-like development environment, including a recent
   323    338   version of <a href="http://www.tcl.tk/">Tcl</a>, is required in order to
   324         -build from the canonical sources.</p>
          339  +build from the repository sources.  The [amalgamation] source code files
          340  +(the "sqlite3.c" and "sqlite3.h" files) are not contained in
          341  +the repository.</p>
   325    342   
   326    343   <blockquote>
   327    344   <a href="http://www.sqlite.org/cgi/src">http://www.sqlite.org/cgi/src</a> (Dallas)<br>
   328    345   <a href="http://www2.sqlite.org/cgi/src">http://www2.sqlite.org/cgi/src</a> (Newark)<br>
   329    346   <a href="http://www3.sqlite.org/cgi/src">http://www3.sqlite.org/cgi/src</a> (Fremont)<br>
   330    347   </blockquote>
   331    348