Fossil

Hex Artifact Content
Login

Artifact 94bb41e1c0da5b1a5c7623fc0cd15e5d17f3dbe98632e6a3f30f17932d462e36:

Wiki page [Release Build How-To] by danield 2024-11-13 17:31:43.
0000: 44 20 32 30 32 34 2d 31 31 2d 31 33 54 31 37 3a  D 2024-11-13T17:
0010: 33 31 3a 34 33 2e 36 30 33 0a 4c 20 52 65 6c 65  31:43.603.L Rele
0020: 61 73 65 5c 73 42 75 69 6c 64 5c 73 48 6f 77 2d  ase\sBuild\sHow-
0030: 54 6f 0a 4e 20 74 65 78 74 2f 78 2d 6d 61 72 6b  To.N text/x-mark
0040: 64 6f 77 6e 0a 50 20 38 32 38 64 64 32 65 32 31  down.P 828dd2e21
0050: 39 38 30 34 34 64 61 65 62 38 33 34 38 35 66 30  98044daeb83485f0
0060: 31 61 36 63 38 39 31 39 65 30 30 36 33 32 63 30  1a6c8919e00632c0
0070: 64 66 32 62 34 39 35 30 61 32 63 63 38 61 64 38  df2b4950a2cc8ad8
0080: 35 39 66 64 66 39 36 0a 55 20 64 61 6e 69 65 6c  59fdf96.U daniel
0090: 64 0a 57 20 37 33 32 30 0a 23 20 4e 6f 74 65 73  d.W 7320.# Notes
00a0: 20 6f 6e 20 68 6f 77 20 46 6f 73 73 69 6c 20 64   on how Fossil d
00b0: 65 6c 69 76 65 72 61 62 6c 65 73 20 61 72 65 20  eliverables are 
00c0: 62 75 69 6c 74 20 61 6e 64 20 75 70 6c 6f 61 64  built and upload
00d0: 65 64 0d 0a 0d 0a 20 20 2a 20 20 41 6c 6c 20 62  ed....  *  All b
00e0: 75 69 6c 64 73 20 61 72 65 20 73 74 61 74 69 63  uilds are static
00f0: 61 6c 6c 79 20 6c 69 6e 6b 20 61 67 61 69 6e 73  ally link agains
0100: 74 20 4f 70 65 6e 53 53 4c 2c 20 77 68 69 63 68  t OpenSSL, which
0110: 20 69 73 20 61 20 6c 69 62 72 61 72 79 20 74 68   is a library th
0120: 61 74 20 69 73 0d 0a 20 20 20 20 20 6f 66 74 65  at is..     ofte
0130: 6e 20 6d 69 73 73 69 6e 67 20 66 72 6f 6d 20 73  n missing from s
0140: 79 73 74 65 6d 73 20 6f 6e 20 77 68 69 63 68 20  ystems on which 
0150: 46 6f 73 73 69 6c 20 6d 69 67 68 74 20 62 65 20  Fossil might be 
0160: 69 6e 73 74 61 6c 6c 65 64 2e 20 20 42 79 20 73  installed.  By s
0170: 74 61 74 69 63 61 6c 6c 79 0d 0a 20 20 20 20 20  tatically..     
0180: 6c 69 6e 6b 69 6e 67 20 77 69 74 68 20 4f 70 65  linking with Ope
0190: 6e 53 53 4c 2c 20 74 68 65 20 64 65 70 65 6e 64  nSSL, the depend
01a0: 65 6e 63 79 20 6f 6e 20 4f 70 65 6e 53 53 4c 20  ency on OpenSSL 
01b0: 69 73 20 6f 6d 69 74 74 65 64 2c 20 6d 61 6b 69  is omitted, maki
01c0: 6e 67 20 74 68 65 0d 0a 20 20 20 20 20 70 72 65  ng the..     pre
01d0: 63 6f 6d 70 69 6c 65 64 20 62 69 6e 61 72 69 65  compiled binarie
01e0: 73 20 6d 6f 72 65 20 70 6f 72 74 61 62 6c 65 2e  s more portable.
01f0: 0d 0a 20 20 2a 20 20 54 68 65 20 6c 61 74 65 73  ..  *  The lates
0200: 74 20 76 65 72 73 69 6f 6e 20 6f 66 20 4f 70 65  t version of Ope
0210: 6e 53 53 4c 20 69 73 20 75 73 65 64 20 66 6f 72  nSSL is used for
0220: 20 6e 65 77 20 62 75 69 6c 64 73 2e 0d 0a 20 20   new builds...  
0230: 20 20 20 41 73 20 6f 66 20 32 30 32 34 2d 31 31     As of 2024-11
0240: 2d 30 36 2c 20 4f 70 65 6e 53 53 4c 20 33 2e 34  -06, OpenSSL 3.4
0250: 2e 30 20 69 73 20 62 65 69 6e 67 20 75 73 65 64  .0 is being used
0260: 2e 20 20 55 73 65 20 74 68 65 0d 0a 20 20 20 20  .  Use the..    
0270: 20 5b 66 6f 73 73 69 6c 20 76 65 72 73 69 6f 6e   [fossil version
0280: 20 2d 76 5d 28 2f 68 65 6c 70 3f 63 6d 64 3d 76   -v](/help?cmd=v
0290: 65 72 73 69 6f 6e 29 20 74 6f 20 66 69 6e 64 20  ersion) to find 
02a0: 6f 75 74 20 77 68 69 63 68 20 76 65 72 73 69 6f  out which versio
02b0: 6e 20 6f 66 0d 0a 20 20 20 20 20 4f 70 65 6e 53  n of..     OpenS
02c0: 53 4c 20 79 6f 75 72 20 76 65 72 73 69 6f 6e 20  SL your version 
02d0: 6f 66 20 46 6f 73 73 69 6c 20 69 73 20 6c 69 6e  of Fossil is lin
02e0: 6b 65 64 20 61 67 61 69 6e 73 74 2e 0d 0a 0d 0a  ked against.....
02f0: 23 20 50 72 65 2d 52 65 6c 65 61 73 65 20 43 68  # Pre-Release Ch
0300: 65 63 6b 6c 69 73 74 0d 0a 0d 0a 20 20 2a 20 20  ecklist....  *  
0310: 49 66 20 60 70 69 6b 63 68 72 2e 63 60 20 68 61  If `pikchr.c` ha
0320: 73 20 62 65 65 6e 20 75 70 64 61 74 65 64 20 73  s been updated s
0330: 69 6e 63 65 20 74 68 65 20 6c 61 73 74 20 72 65  ince the last re
0340: 6c 65 61 73 65 2c 20 62 65 20 73 75 72 65 20 74  lease, be sure t
0350: 68 61 74 20 69 74 73 20 57 41 53 4d 0d 0a 20 20  hat its WASM..  
0360: 20 20 20 62 75 69 6c 64 20 69 73 20 75 70 2d 74     build is up-t
0370: 6f 2d 64 61 74 65 2c 20 5b 61 73 20 64 6f 63 75  o-date, [as docu
0380: 6d 65 6e 74 65 64 20 69 6e 20 62 75 69 6c 64 2e  mented in build.
0390: 77 69 6b 69 5d 28 2f 64 6f 63 2f 74 72 75 6e 6b  wiki](/doc/trunk
03a0: 2f 77 77 77 2f 62 75 69 6c 64 2e 77 69 6b 69 23  /www/build.wiki#
03b0: 77 61 73 6d 29 2e 0d 0a 20 20 20 20 20 54 68 65  wasm)...     The
03c0: 20 65 61 73 69 65 73 74 20 61 70 70 72 6f 61 63   easiest approac
03d0: 68 20 69 73 20 73 69 6d 70 6c 79 20 74 6f 20 73  h is simply to s
03e0: 65 65 20 69 66 20 62 6f 74 68 20 5b 5d 28 2f 66  ee if both [](/f
03f0: 69 6e 66 6f 2f 65 78 74 73 72 63 2f 70 69 6b 63  info/extsrc/pikc
0400: 68 72 2e 63 29 20 61 6e 64 0d 0a 20 20 20 20 20  hr.c) and..     
0410: 5b 5d 28 2f 66 69 6e 66 6f 2f 65 78 74 73 72 63  [](/finfo/extsrc
0420: 2f 70 69 6b 63 68 72 2e 77 61 73 6d 29 20 68 61  /pikchr.wasm) ha
0430: 76 65 20 74 68 65 20 73 61 6d 65 20 63 68 65 63  ve the same chec
0440: 6b 69 6e 20 74 69 6d 65 2e 20 49 66 20 74 68 65  kin time. If the
0450: 20 57 41 53 4d 20 62 75 69 6c 64 20 69 73 20 6f   WASM build is o
0460: 75 74 0d 0a 20 20 20 20 20 6f 66 20 64 61 74 65  ut..     of date
0470: 2c 20 74 68 65 20 2f 70 69 6b 63 68 72 73 68 6f  , the /pikchrsho
0480: 77 20 61 70 70 20 77 69 6c 6c 20 62 65 20 75 73  w app will be us
0490: 69 6e 67 20 61 20 64 69 66 66 65 72 65 6e 74 20  ing a different 
04a0: 70 69 6b 63 68 72 20 76 65 72 73 69 6f 6e 20 74  pikchr version t
04b0: 68 61 6e 20 74 68 65 20 72 65 73 74 20 6f 66 0d  han the rest of.
04c0: 0a 20 20 20 20 20 66 6f 73 73 69 6c 2e 0d 0a 0d  .     fossil....
04d0: 0a 23 23 20 41 66 74 65 72 2d 52 65 6c 65 61 73  .## After-Releas
04e0: 65 20 43 68 65 63 6b 6c 69 73 74 20 28 54 68 69  e Checklist (Thi
04f0: 73 20 73 65 63 74 69 6f 6e 20 69 73 20 74 6f 20  s section is to 
0500: 6a 6f 67 20 74 68 65 20 6d 65 6d 6f 72 79 20 6f  jog the memory o
0510: 66 20 74 68 65 20 72 65 6c 65 61 73 65 20 6d 61  f the release ma
0520: 6e 61 67 65 72 29 0d 0a 0d 0a 20 20 31 2e 20 20  nager)....  1.  
0530: 56 65 72 69 66 79 20 74 68 61 74 20 61 6c 6c 20  Verify that all 
0540: 69 74 65 6d 73 20 6f 6e 20 74 68 65 20 5b 42 65  items on the [Be
0550: 66 6f 72 65 2d 52 65 6c 65 61 73 65 20 43 68 65  fore-Release Che
0560: 63 6b 6c 69 73 74 5d 28 2f 64 6f 63 2f 74 72 75  cklist](/doc/tru
0570: 6e 6b 2f 74 65 73 74 2f 72 65 6c 65 61 73 65 2d  nk/test/release-
0580: 63 68 65 63 6b 6c 69 73 74 2e 77 69 6b 69 29 0d  checklist.wiki).
0590: 0a 20 20 20 20 20 20 68 61 76 65 20 62 65 65 6e  .      have been
05a0: 20 72 75 6e 0d 0a 20 20 32 2e 20 20 55 70 64 61   run..  2.  Upda
05b0: 74 65 20 74 68 65 20 76 65 72 73 69 6f 6e 20 6e  te the version n
05c0: 75 6d 62 65 72 20 61 6e 64 20 72 65 6c 61 74 65  umber and relate
05d0: 64 20 6c 69 6e 6b 73 20 6f 6e 20 74 68 65 20 68  d links on the h
05e0: 6f 6d 65 70 61 67 65 2e 0d 0a 20 20 33 2e 20 20  omepage...  3.  
05f0: 60 66 6f 73 73 69 6c 20 75 76 20 65 64 69 74 20  `fossil uv edit 
0600: 64 6f 77 6e 6c 6f 61 64 2e 6a 73 60 0d 0a 20 20  download.js`..  
0610: 34 2e 20 20 45 64 69 74 20 74 68 65 20 22 72 65  4.  Edit the "re
0620: 6c 65 61 73 65 73 22 20 76 61 72 69 61 62 6c 65  leases" variable
0630: 20 69 6e 20 74 68 65 20 6a 61 76 61 73 63 72 69   in the javascri
0640: 70 74 0d 0a 20 20 20 20 20 20 74 6f 20 61 64 64  pt..      to add
0650: 20 74 68 65 20 6e 65 77 20 72 65 6c 65 61 73 65   the new release
0660: 20 6e 75 6d 62 65 72 20 61 6e 64 20 74 69 74 6c   number and titl
0670: 65 20 61 6e 64 20 76 61 72 69 6f 75 73 0d 0a 20  e and various.. 
0680: 20 20 20 20 20 68 79 70 65 72 6c 69 6e 6b 73 2e       hyperlinks.
0690: 20 20 50 65 72 68 61 70 73 20 61 6c 73 6f 20 72    Perhaps also r
06a0: 65 6d 6f 76 65 20 6f 6c 64 65 72 20 72 65 6c 65  emove older rele
06b0: 61 73 65 73 2e 0d 0a 20 20 35 2e 20 20 52 65 6d  ases...  5.  Rem
06c0: 6f 76 65 20 6f 62 73 6f 6c 65 74 65 20 62 75 69  ove obsolete bui
06d0: 6c 64 20 70 72 6f 64 75 63 74 73 3a 20 60 66 6f  ld products: `fo
06e0: 73 73 69 6c 20 75 76 20 72 6d 20 2d 2d 67 6c 6f  ssil uv rm --glo
06f0: 62 20 24 50 41 54 54 45 52 4e 60 0d 0a 20 20 36  b $PATTERN`..  6
0700: 2e 20 20 60 66 6f 73 73 69 6c 20 75 76 20 65 64  .  `fossil uv ed
0710: 69 74 20 6c 61 74 65 73 74 2d 72 65 6c 65 61 73  it latest-releas
0720: 65 2e 6d 64 60 0d 0a 20 20 37 2e 20 20 55 70 64  e.md`..  7.  Upd
0730: 61 74 65 20 74 68 65 20 6c 61 74 65 73 74 20 72  ate the latest r
0740: 65 73 75 6c 74 20 74 61 72 62 61 6c 6c 20 6c 69  esult tarball li
0750: 6e 6b 0d 0a 20 20 38 2e 20 20 60 66 6f 73 73 69  nk..  8.  `fossi
0760: 6c 20 75 76 20 65 64 69 74 20 72 65 6c 65 61 73  l uv edit releas
0770: 65 73 2e 6d 64 60 0d 0a 20 20 39 2e 20 20 55 70  es.md`..  9.  Up
0780: 64 61 74 65 20 74 68 65 20 6c 69 73 74 20 6f 66  date the list of
0790: 20 72 65 6c 65 61 73 65 73 20 61 6e 64 20 6d 6f   releases and mo
07a0: 76 65 20 74 68 65 20 22 28 6c 61 74 65 73 74 29  ve the "(latest)
07b0: 22 20 73 75 66 66 69 78 20 74 6f 0d 0a 20 20 20  " suffix to..   
07c0: 20 20 20 6e 65 77 20 74 6f 70 2d 6d 6f 73 74 20     new top-most 
07d0: 65 6e 74 72 79 2e 0d 0a 20 20 31 30 2e 20 60 66  entry...  10. `f
07e0: 6f 73 73 69 6c 20 75 76 20 73 79 6e 63 60 0d 0a  ossil uv sync`..
07f0: 0d 0a 23 23 20 4c 69 6e 75 78 0d 0a 0d 0a 20 20  ..## Linux....  
0800: 2a 20 20 42 75 69 6c 64 20 74 68 65 20 69 6e 2d  *  Build the in-
0810: 74 72 65 65 20 4f 70 65 6e 53 53 4c 20 6c 69 62  tree OpenSSL lib
0820: 72 61 72 79 3a 0d 0a 20 20 20 20 20 3c 75 6c 3e  rary:..     <ul>
0830: 0d 0a 20 20 20 20 20 3c 6c 69 3e 20 44 6f 77 6e  ..     <li> Down
0840: 6c 6f 61 64 20 74 68 65 20 4f 70 65 6e 53 53 4c  load the OpenSSL
0850: 20 74 61 72 62 61 6c 6c 20 61 6e 64 20 75 6e 70   tarball and unp
0860: 61 63 6b 20 69 74 20 69 6e 74 6f 20 60 63 6f 6d  ack it into `com
0870: 70 61 74 2f 6f 70 65 6e 73 73 6c 60 0d 0a 20 20  pat/openssl`..  
0880: 20 20 20 3c 6c 69 3e 20 60 63 64 60 20 69 6e 74     <li> `cd` int
0890: 6f 20 74 68 65 20 60 63 6f 6d 70 61 74 2f 6f 70  o the `compat/op
08a0: 65 6e 73 73 6c 60 20 64 69 72 65 63 74 6f 72 79  enssl` directory
08b0: 0d 0a 20 20 20 20 20 3c 6c 69 3e 20 60 2e 2f 63  ..     <li> `./c
08c0: 6f 6e 66 69 67 20 6e 6f 2d 73 73 6c 33 20 6e 6f  onfig no-ssl3 no
08d0: 2d 77 65 61 6b 2d 73 73 6c 2d 63 69 70 68 65 72  -weak-ssl-cipher
08e0: 73 20 6e 6f 2d 73 68 61 72 65 64 20 6e 6f 2d 74  s no-shared no-t
08f0: 68 72 65 61 64 73 20 2d 2d 6f 70 65 6e 73 73 6c  hreads --openssl
0900: 64 69 72 3d 2f 75 73 72 2f 6c 69 62 2f 73 73 6c  dir=/usr/lib/ssl
0910: 60 0d 0a 20 20 20 20 20 3c 6c 69 3e 20 60 43 46  `..     <li> `CF
0920: 4c 41 47 53 3d 2d 4f 73 20 6d 61 6b 65 20 2d 65  LAGS=-Os make -e
0930: 60 0d 0a 20 20 20 20 20 3c 2f 75 6c 3e 0d 0a 20  `..     </ul>.. 
0940: 20 2a 20 20 60 2e 2f 63 6f 6e 66 69 67 75 72 65   *  `./configure
0950: 20 2d 2d 77 69 74 68 2d 6f 70 65 6e 73 73 6c 3d   --with-openssl=
0960: 74 72 65 65 20 2d 2d 64 69 73 61 62 6c 65 2d 66  tree --disable-f
0970: 75 73 65 66 73 60 0d 0a 20 20 2a 20 20 49 66 20  usefs`..  *  If 
0980: 74 68 65 20 4d 61 6b 65 66 69 6c 65 20 63 6f 6e  the Makefile con
0990: 74 61 69 6e 73 20 61 20 72 65 66 65 72 65 6e 63  tains a referenc
09a0: 65 20 74 6f 20 60 2d 6c 70 74 68 72 65 61 64 60  e to `-lpthread`
09b0: 2c 20 72 65 6d 6f 76 65 20 69 74 2e 0d 0a 20 20  , remove it...  
09c0: 2a 20 20 60 43 46 4c 41 47 53 3d 22 2d 4f 73 22  *  `CFLAGS="-Os"
09d0: 20 6d 61 6b 65 20 2d 65 20 63 6c 65 61 6e 20 66   make -e clean f
09e0: 6f 73 73 69 6c 60 0d 0a 20 20 2a 20 20 60 73 74  ossil`..  *  `st
09f0: 72 69 70 20 66 6f 73 73 69 6c 60 0d 0a 20 20 2a  rip fossil`..  *
0a00: 20 20 56 65 72 69 66 79 20 64 65 70 65 6e 64 65    Verify depende
0a10: 6e 63 69 65 73 20 75 73 69 6e 67 20 22 60 6c 64  ncies using "`ld
0a20: 64 20 2e 2f 66 6f 73 73 69 6c 60 22 0d 0a 20 20  d ./fossil`"..  
0a30: 2a 20 20 60 74 61 72 20 63 7a 66 20 66 6f 73 73  *  `tar czf foss
0a40: 69 6c 2d 6c 69 6e 75 78 2d 78 36 34 2d 24 56 45  il-linux-x64-$VE
0a50: 52 53 49 4f 4e 2e 74 61 72 2e 67 7a 20 66 6f 73  RSION.tar.gz fos
0a60: 73 69 6c 60 0d 0a 20 20 2a 20 20 60 66 6f 73 73  sil`..  *  `foss
0a70: 69 6c 20 75 76 20 61 64 64 20 66 6f 73 73 69 6c  il uv add fossil
0a80: 2d 6c 69 6e 75 78 2d 78 36 34 2d 24 56 45 52 53  -linux-x64-$VERS
0a90: 49 4f 4e 2e 74 61 72 2e 67 7a 60 0d 0a 20 20 2a  ION.tar.gz`..  *
0aa0: 20 20 60 66 6f 73 73 69 6c 20 75 76 20 73 79 6e    `fossil uv syn
0ab0: 63 60 0d 0a 0d 0a 23 23 20 4d 61 63 0d 0a 0d 0a  c`....## Mac....
0ac0: 20 20 2a 20 20 50 75 62 6c 69 73 68 65 64 20 46    *  Published F
0ad0: 6f 73 73 69 6c 20 62 75 69 6c 64 73 20 75 73 65  ossil builds use
0ae0: 20 74 68 65 20 6c 65 61 64 20 64 65 76 65 6c 6f   the lead develo
0af0: 70 65 72 27 73 20 32 30 31 30 20 4d 61 63 62 6f  per's 2010 Macbo
0b00: 6f 6b 20 41 69 72 20 72 75 6e 6e 69 6e 67 20 4d  ok Air running M
0b10: 61 63 4f 53 20 31 30 2e 31 33 2e 36 20 66 6f 72  acOS 10.13.6 for
0b20: 20 78 36 34 0d 0a 20 20 20 20 20 61 6e 64 20 74   x64..     and t
0b30: 68 65 20 6c 65 61 64 20 64 65 76 6c 6f 70 65 72  he lead devloper
0b40: 27 73 20 6d 69 6e 69 6d 61 63 20 72 75 6e 6e 69  's minimac runni
0b50: 6e 67 20 4d 61 63 4f 53 20 31 32 2e 30 2e 31 20  ng MacOS 12.0.1 
0b60: 66 6f 72 20 61 72 6d 2e 20 20 42 69 6e 61 72 69  for arm.  Binari
0b70: 65 73 20 61 72 65 20 73 69 67 6e 65 64 20 6f 6e  es are signed on
0b80: 20 74 68 65 20 6c 65 61 64 0d 0a 20 20 20 20 20   the lead..     
0b90: 64 65 76 65 6c 6f 70 65 72 27 73 20 32 30 31 37  developer's 2017
0ba0: 20 69 4d 61 63 2e 20 20 41 6c 6c 20 74 68 61 74   iMac.  All that
0bb0: 20 73 61 69 64 2c 20 74 68 65 20 66 6f 6c 6c 6f   said, the follo
0bc0: 77 69 6e 67 20 70 72 6f 63 65 64 75 72 65 20 73  wing procedure s
0bd0: 68 6f 75 6c 64 20 77 6f 72 6b 20 6f 6e 20 2a 61  hould work on *a
0be0: 6e 79 2a 20 4d 61 63 2e 0d 0a 20 20 2a 20 20 42  ny* Mac...  *  B
0bf0: 75 69 6c 64 20 74 68 65 20 69 6e 2d 74 72 65 65  uild the in-tree
0c00: 20 4f 70 65 6e 53 53 4c 20 6c 69 62 72 61 72 79   OpenSSL library
0c10: 3a 0d 0a 20 20 20 20 20 3c 75 6c 3e 0d 0a 20 20  :..     <ul>..  
0c20: 20 20 20 3c 6c 69 3e 20 44 6f 77 6e 6c 6f 61 64     <li> Download
0c30: 20 74 68 65 20 4f 70 65 6e 53 53 4c 20 74 61 72   the OpenSSL tar
0c40: 62 61 6c 6c 20 61 6e 64 20 75 6e 70 61 63 6b 20  ball and unpack 
0c50: 69 74 20 69 6e 74 6f 20 60 63 6f 6d 70 61 74 2f  it into `compat/
0c60: 6f 70 65 6e 73 73 6c 60 0d 0a 20 20 20 20 20 3c  openssl`..     <
0c70: 6c 69 3e 20 60 63 64 60 20 69 6e 74 6f 20 74 68  li> `cd` into th
0c80: 65 20 60 63 6f 6d 70 61 74 2f 6f 70 65 6e 73 73  e `compat/openss
0c90: 6c 60 20 64 69 72 65 63 74 6f 72 79 0d 0a 20 20  l` directory..  
0ca0: 20 20 20 3c 6c 69 3e 20 60 2e 2f 63 6f 6e 66 69     <li> `./confi
0cb0: 67 20 6e 6f 2d 73 73 6c 33 20 6e 6f 2d 77 65 61  g no-ssl3 no-wea
0cc0: 6b 2d 73 73 6c 2d 63 69 70 68 65 72 73 20 6e 6f  k-ssl-ciphers no
0cd0: 2d 73 68 61 72 65 64 20 6e 6f 2d 74 68 72 65 61  -shared no-threa
0ce0: 64 73 20 6e 6f 2d 61 73 6d 20 2d 2d 6f 70 65 6e  ds no-asm --open
0cf0: 73 73 6c 64 69 72 3d 2f 65 74 63 2f 73 73 6c 60  ssldir=/etc/ssl`
0d00: 0d 0a 20 20 20 20 20 3c 6c 69 3e 20 60 43 46 4c  ..     <li> `CFL
0d10: 41 47 53 3d 2d 4f 73 20 6d 61 6b 65 20 2d 65 60  AGS=-Os make -e`
0d20: 0d 0a 20 20 20 20 20 3c 2f 75 6c 3e 0d 0a 20 20  ..     </ul>..  
0d30: 2a 20 20 60 2e 2f 63 6f 6e 66 69 67 75 72 65 20  *  `./configure 
0d40: 2d 2d 77 69 74 68 2d 6f 70 65 6e 73 73 6c 3d 74  --with-openssl=t
0d50: 72 65 65 60 0d 0a 20 20 2a 20 20 60 43 46 4c 41  ree`..  *  `CFLA
0d60: 47 53 3d 2d 4f 73 20 6d 61 6b 65 20 2d 65 20 63  GS=-Os make -e c
0d70: 6c 65 61 6e 20 66 6f 73 73 69 6c 60 0d 0a 20 20  lean fossil`..  
0d80: 2a 20 20 56 65 72 69 66 79 20 6e 6f 20 73 68 61  *  Verify no sha
0d90: 72 65 64 20 6c 69 62 72 61 72 79 20 64 65 70 65  red library depe
0da0: 6e 64 65 6e 63 69 65 73 20 75 73 69 6e 67 3a 20  ndencies using: 
0db0: 20 60 6f 74 6f 6f 6c 20 2d 4c 20 2e 2f 66 6f 73   `otool -L ./fos
0dc0: 73 69 6c 60 0d 0a 20 20 2a 20 20 60 73 74 72 69  sil`..  *  `stri
0dd0: 70 20 66 6f 73 73 69 6c 60 0d 0a 20 20 2a 20 20  p fossil`..  *  
0de0: 4f 70 74 69 6f 6e 61 6c 3a 20 60 63 6f 64 65 73  Optional: `codes
0df0: 69 67 6e 20 2d 73 20 64 72 68 40 73 71 6c 69 74  ign -s drh@sqlit
0e00: 65 2e 6f 72 67 20 66 6f 73 73 69 6c 60 20 74 68  e.org fossil` th
0e10: 65 6e 20 76 65 72 69 66 79 20 74 68 65 20 73 69  en verify the si
0e20: 67 6e 61 74 75 72 65 20 75 73 69 6e 67 0d 0a 20  gnature using.. 
0e30: 20 20 20 20 60 63 6f 64 65 73 69 67 6e 20 2d 64      `codesign -d
0e40: 20 2d 76 20 66 6f 73 73 69 6c 60 0d 0a 20 20 2a   -v fossil`..  *
0e50: 20 20 60 74 61 72 20 63 7a 66 20 66 6f 73 73 69    `tar czf fossi
0e60: 6c 2d 6d 61 63 2d 41 52 43 48 2d 56 45 52 53 49  l-mac-ARCH-VERSI
0e70: 4f 4e 2e 74 61 72 2e 67 7a 20 66 6f 73 73 69 6c  ON.tar.gz fossil
0e80: 60 20 77 68 65 72 65 20 41 52 43 48 20 69 73 20  ` where ARCH is 
0e90: 65 69 74 68 65 72 20 78 36 34 20 6f 72 20 61 72  either x64 or ar
0ea0: 6d 36 34 2e 0d 0a 20 20 2a 20 20 60 66 6f 73 73  m64...  *  `foss
0eb0: 69 6c 20 75 76 20 61 64 64 20 66 6f 73 73 69 6c  il uv add fossil
0ec0: 2d 6d 61 63 2d 41 52 43 48 2d 56 45 52 53 49 4f  -mac-ARCH-VERSIO
0ed0: 4e 2e 74 61 72 2e 67 7a 60 0d 0a 20 20 2a 20 20  N.tar.gz`..  *  
0ee0: 60 66 6f 73 73 69 6c 20 75 76 20 73 79 6e 63 60  `fossil uv sync`
0ef0: 0d 0a 0d 0a 23 23 20 52 61 73 70 62 65 72 72 79  ....## Raspberry
0f00: 20 50 69 0d 0a 0d 0a 20 20 2a 20 20 42 75 69 6c   Pi....  *  Buil
0f10: 64 20 74 68 65 20 69 6e 2d 74 72 65 65 20 4f 70  d the in-tree Op
0f20: 65 6e 53 53 4c 20 6c 69 62 72 61 72 79 3a 0d 0a  enSSL library:..
0f30: 20 20 20 20 20 3c 75 6c 3e 0d 0a 20 20 20 20 20       <ul>..     
0f40: 3c 6c 69 3e 20 44 6f 77 6e 6c 6f 61 64 20 74 68  <li> Download th
0f50: 65 20 4f 70 65 6e 53 53 4c 20 74 61 72 62 61 6c  e OpenSSL tarbal
0f60: 6c 20 61 6e 64 20 75 6e 70 61 63 6b 20 69 74 20  l and unpack it 
0f70: 69 6e 74 6f 20 60 63 6f 6d 70 61 74 2f 6f 70 65  into `compat/ope
0f80: 6e 73 73 6c 60 0d 0a 20 20 20 20 20 3c 6c 69 3e  nssl`..     <li>
0f90: 20 60 63 64 60 20 69 6e 74 6f 20 74 68 65 20 60   `cd` into the `
0fa0: 63 6f 6d 70 61 74 2f 6f 70 65 6e 73 73 6c 60 20  compat/openssl` 
0fb0: 64 69 72 65 63 74 6f 72 79 0d 0a 20 20 20 20 20  directory..     
0fc0: 3c 6c 69 3e 20 60 2e 2f 43 6f 6e 66 69 67 75 72  <li> `./Configur
0fd0: 65 20 6c 69 6e 75 78 2d 67 65 6e 65 72 69 63 33  e linux-generic3
0fe0: 32 20 6e 6f 2d 73 73 6c 33 20 6e 6f 2d 77 65 61  2 no-ssl3 no-wea
0ff0: 6b 2d 73 73 6c 2d 63 69 70 68 65 72 73 20 6e 6f  k-ssl-ciphers no
1000: 2d 73 68 61 72 65 64 20 6e 6f 2d 74 68 72 65 61  -shared no-threa
1010: 64 73 20 6e 6f 2d 61 73 6d 20 2d 2d 6f 70 65 6e  ds no-asm --open
1020: 73 73 6c 64 69 72 3d 2f 75 73 72 2f 6c 69 62 2f  ssldir=/usr/lib/
1030: 73 73 6c 60 0d 0a 20 20 20 20 20 3c 6c 69 3e 20  ssl`..     <li> 
1040: 60 43 46 4c 41 47 53 3d 2d 4f 73 20 6d 61 6b 65  `CFLAGS=-Os make
1050: 20 2d 65 60 0d 0a 20 20 20 20 20 3c 2f 75 6c 3e   -e`..     </ul>
1060: 0d 0a 20 20 2a 20 20 60 2e 2f 63 6f 6e 66 69 67  ..  *  `./config
1070: 75 72 65 20 2d 2d 77 69 74 68 2d 6f 70 65 6e 73  ure --with-opens
1080: 73 6c 3d 74 72 65 65 20 2d 2d 73 74 61 74 69 63  sl=tree --static
1090: 60 0d 0a 20 20 2a 20 20 60 43 46 4c 41 47 53 3d  `..  *  `CFLAGS=
10a0: 22 2d 4f 73 22 20 6d 61 6b 65 20 2d 65 20 63 6c  "-Os" make -e cl
10b0: 65 61 6e 20 66 6f 73 73 69 6c 20 26 26 20 73 74  ean fossil && st
10c0: 72 69 70 20 66 6f 73 73 69 6c 60 0d 0a 20 20 2a  rip fossil`..  *
10d0: 20 20 60 74 61 72 20 63 7a 66 20 66 6f 73 73 69    `tar czf fossi
10e0: 6c 2d 70 69 2d 24 56 45 52 53 49 4f 4e 2e 74 61  l-pi-$VERSION.ta
10f0: 72 2e 67 7a 20 66 6f 73 73 69 6c 60 0d 0a 20 20  r.gz fossil`..  
1100: 2a 20 20 60 66 6f 73 73 69 6c 20 75 76 20 61 64  *  `fossil uv ad
1110: 64 20 66 6f 73 73 69 6c 2d 70 69 2d 24 56 45 52  d fossil-pi-$VER
1120: 53 49 4f 4e 2e 74 61 72 2e 67 7a 60 0d 0a 20 20  SION.tar.gz`..  
1130: 2a 20 20 60 66 6f 73 73 69 6c 20 75 76 20 73 79  *  `fossil uv sy
1140: 6e 63 60 0d 0a 0d 0a 23 23 20 57 69 6e 64 6f 77  nc`....## Window
1150: 73 20 33 32 2d 62 69 74 20 75 73 69 6e 67 20 4d  s 32-bit using M
1160: 53 56 43 0d 0a 0d 0a 20 20 2a 20 20 52 75 6e 20  SVC....  *  Run 
1170: 61 6c 6c 20 6f 66 20 74 68 65 20 66 6f 6c 6c 6f  all of the follo
1180: 77 69 6e 67 20 66 72 6f 6d 20 61 20 22 78 33 32  wing from a "x32
1190: 20 4e 61 74 69 76 65 20 54 6f 6f 6c 73 20 43 6f   Native Tools Co
11a0: 6d 6d 61 6e 64 20 50 72 6f 6d 70 74 22 0d 0a 20  mmand Prompt".. 
11b0: 20 2a 20 20 42 75 69 6c 64 20 74 68 65 20 69 6e   *  Build the in
11c0: 2d 74 72 65 65 20 4f 70 65 6e 53 53 4c 20 6c 69  -tree OpenSSL li
11d0: 62 72 61 72 79 3a 0d 0a 20 20 20 20 20 3c 75 6c  brary:..     <ul
11e0: 3e 0d 0a 20 20 20 20 20 3c 6c 69 3e 20 49 6e 73  >..     <li> Ins
11f0: 74 61 6c 6c 20 53 74 72 61 77 62 65 72 72 79 2d  tall Strawberry-
1200: 50 65 72 6c 20 28 6f 72 20 73 69 6d 69 6c 61 72  Perl (or similar
1210: 29 20 69 66 20 69 74 20 69 73 20 6e 6f 74 20 61  ) if it is not a
1220: 6c 72 65 61 64 79 20 69 6e 73 74 61 6c 6c 65 64  lready installed
1230: 2e 20 20 50 65 72 6c 20 69 73 20 6e 65 65 64 65  .  Perl is neede
1240: 64 20 74 6f 20 72 75 6e 20 74 68 65 0d 0a 20 20  d to run the..  
1250: 20 20 20 20 20 20 20 20 4f 70 65 6e 53 53 4c 20          OpenSSL 
1260: 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 73 63  configuration sc
1270: 72 69 70 74 20 70 72 69 6f 72 20 74 6f 20 62 75  ript prior to bu
1280: 69 6c 64 69 6e 67 20 4f 70 65 6e 53 53 4c 20 66  ilding OpenSSL f
1290: 72 6f 6d 20 73 6f 75 72 63 65 73 2e 20 20 46 6f  rom sources.  Fo
12a0: 73 73 69 6c 20 69 74 73 65 6c 66 20 64 6f 65 73  ssil itself does
12b0: 20 6e 6f 74 20 75 73 65 20 50 65 72 6c 2e 0d 0a   not use Perl...
12c0: 20 20 20 20 20 3c 6c 69 3e 20 44 6f 77 6e 6c 6f       <li> Downlo
12d0: 61 64 20 74 68 65 20 4f 70 65 6e 53 53 4c 20 74  ad the OpenSSL t
12e0: 61 72 62 61 6c 6c 20 61 6e 64 20 75 6e 70 61 63  arball and unpac
12f0: 6b 20 75 6e 64 65 72 20 60 63 6f 6d 70 61 74 2f  k under `compat/
1300: 6f 70 65 6e 73 73 6c 60 2e 20 4e 6f 74 65 20 74  openssl`. Note t
1310: 68 61 74 20 74 68 65 20 4f 70 65 6e 53 53 4c 20  hat the OpenSSL 
1320: 74 61 72 62 61 6c 6c 20 77 69 6c 6c 0d 0a 20 20  tarball will..  
1330: 20 20 20 20 20 20 20 20 75 6e 70 61 63 6b 20 69          unpack i
1340: 6e 74 6f 20 60 6f 70 65 6e 73 73 6c 2d 33 2e 58  nto `openssl-3.X
1350: 2e 59 60 2e 20 20 59 6f 75 20 77 69 6c 6c 20 6e  .Y`.  You will n
1360: 65 65 64 20 74 6f 20 72 65 6e 61 6d 65 20 74 68  eed to rename th
1370: 61 74 20 66 6f 6c 64 65 72 20 74 6f 20 6a 75 73  at folder to jus
1380: 74 20 60 6f 70 65 6e 73 73 6c 60 2e 0d 0a 20 20  t `openssl`...  
1390: 20 20 20 3c 6c 69 3e 20 60 63 64 60 20 69 6e 74     <li> `cd` int
13a0: 6f 20 74 68 65 20 4f 70 65 6e 53 53 4c 20 73 6f  o the OpenSSL so
13b0: 75 72 63 65 20 64 69 72 65 63 74 6f 72 79 2c 20  urce directory, 
13c0: 60 6f 70 65 6e 73 73 6c 60 2e 0d 0a 20 20 20 20  `openssl`...    
13d0: 20 3c 6c 69 3e 20 60 43 3a 2f 53 74 72 61 77 62   <li> `C:/Strawb
13e0: 65 72 72 79 2f 70 65 72 6c 2f 62 69 6e 2f 70 65  erry/perl/bin/pe
13f0: 72 6c 20 43 6f 6e 66 69 67 75 72 65 20 56 43 2d  rl Configure VC-
1400: 57 49 4e 33 32 20 6e 6f 2d 61 73 6d 20 6e 6f 2d  WIN32 no-asm no-
1410: 73 73 6c 33 20 6e 6f 2d 77 65 61 6b 2d 73 73 6c  ssl3 no-weak-ssl
1420: 2d 63 69 70 68 65 72 73 20 6e 6f 2d 73 68 61 72  -ciphers no-shar
1430: 65 64 20 2f 44 5f 57 49 4e 33 32 5f 57 49 4e 4e  ed /D_WIN32_WINN
1440: 54 3d 30 78 30 35 30 31 60 0d 0a 20 20 20 20 20  T=0x0501`..     
1450: 3c 75 6c 3e 3c 6c 69 3e 0d 0a 20 20 20 20 20 54  <ul><li>..     T
1460: 68 65 20 5f 57 49 4e 33 32 5f 57 49 4e 54 20 64  he _WIN32_WINT d
1470: 65 66 69 6e 69 74 69 6f 6e 20 6f 6e 20 74 68 65  efinition on the
1480: 20 60 70 65 72 6c 20 43 6f 6e 66 69 67 75 72 65   `perl Configure
1490: 60 20 63 6f 6d 6d 61 6e 64 2c 20 61 6e 64 20 74  ` command, and t
14a0: 68 65 20 46 4f 53 53 49 4c 5f 45 4e 41 42 4c 45  he FOSSIL_ENABLE
14b0: 5f 57 49 4e 58 50 3d 31 20 74 65 72 6d 20 6f 6e  _WINXP=1 term on
14c0: 0d 0a 20 20 20 20 20 74 68 65 20 73 65 63 6f 6e  ..     the secon
14d0: 64 20 60 6e 6d 61 6b 65 60 20 63 6f 6d 6d 61 6e  d `nmake` comman
14e0: 64 20 62 65 6c 6f 77 2c 20 61 72 65 20 6e 65 63  d below, are nec
14f0: 65 73 73 61 72 79 20 69 6e 20 6f 72 64 65 72 20  essary in order 
1500: 66 6f 72 20 74 68 69 73 20 62 75 69 6c 64 20 74  for this build t
1510: 6f 20 77 6f 72 6b 20 6f 6e 20 6f 6c 64 65 72 0d  o work on older.
1520: 0a 20 20 20 20 20 57 69 6e 64 6f 77 73 58 50 20  .     WindowsXP 
1530: 6d 61 63 68 69 6e 65 73 2e 20 20 53 65 65 20 5b  machines.  See [
1540: 66 6f 72 75 6d 20 74 68 72 65 61 64 20 36 36 66  forum thread 66f
1550: 31 30 36 31 39 35 61 61 66 32 38 39 65 5d 28 66  106195aaf289e](f
1560: 6f 72 75 6d 3a 2f 66 6f 72 75 6d 70 6f 73 74 2f  orum:/forumpost/
1570: 36 36 66 31 30 36 31 39 35 61 61 66 32 38 39 65  66f106195aaf289e
1580: 29 2e 3c 2f 75 6c 3e 0d 0a 20 20 20 20 20 3c 6c  ).</ul>..     <l
1590: 69 3e 20 60 6e 6d 61 6b 65 20 2f 66 20 6d 61 6b  i> `nmake /f mak
15a0: 65 66 69 6c 65 60 0d 0a 20 20 20 20 20 3c 2f 75  efile`..     </u
15b0: 6c 3e 0d 0a 20 20 2a 20 20 60 63 64 60 20 69 6e  l>..  *  `cd` in
15c0: 74 6f 20 74 68 65 20 60 77 69 6e 2f 60 20 73 75  to the `win/` su
15d0: 62 66 6f 6c 64 65 72 20 6f 66 20 74 68 65 20 46  bfolder of the F
15e0: 6f 73 73 69 6c 20 73 6f 75 72 63 65 20 74 72 65  ossil source tre
15f0: 65 2e 0d 0a 20 20 2a 20 20 60 6e 6d 61 6b 65 20  e...  *  `nmake 
1600: 2f 66 20 4d 61 6b 65 66 69 6c 65 2e 6d 73 63 20  /f Makefile.msc 
1610: 46 4f 53 53 49 4c 5f 45 4e 41 42 4c 45 5f 53 53  FOSSIL_ENABLE_SS
1620: 4c 3d 31 20 46 4f 53 53 49 4c 5f 45 4e 41 42 4c  L=1 FOSSIL_ENABL
1630: 45 5f 57 49 4e 58 50 3d 31 20 4f 50 54 49 4d 49  E_WINXP=1 OPTIMI
1640: 5a 41 54 49 4f 4e 53 3d 34 20 63 6c 65 61 6e 20  ZATIONS=4 clean 
1650: 66 6f 73 73 69 6c 2e 65 78 65 60 0d 0a 20 20 20  fossil.exe`..   
1660: 20 20 3c 75 6c 3e 3c 6c 69 3e 0d 0a 20 20 20 20    <ul><li>..    
1670: 20 54 68 65 20 70 72 65 76 69 6f 75 73 20 73 74   The previous st
1680: 65 70 20 62 75 69 6c 64 73 20 74 68 65 20 73 74  ep builds the st
1690: 61 6e 64 2d 61 6c 6f 6e 65 20 46 6f 73 73 69 6c  and-alone Fossil
16a0: 20 62 69 6e 61 72 79 2e 20 20 49 66 20 74 68 61   binary.  If tha
16b0: 74 20 69 73 20 61 6c 6c 20 79 6f 75 20 77 61 6e  t is all you wan
16c0: 74 20 74 6f 20 61 63 63 6f 6d 70 6c 69 73 68 2c  t to accomplish,
16d0: 20 79 6f 75 20 63 61 6e 0d 0a 20 20 20 20 20 73   you can..     s
16e0: 74 6f 70 20 68 65 72 65 2e 20 20 54 68 65 20 72  top here.  The r
16f0: 65 6d 61 69 6e 69 6e 67 20 73 74 65 70 73 20 64  emaining steps d
1700: 65 73 63 72 69 62 65 20 68 6f 77 20 74 68 65 20  escribe how the 
1710: 73 74 61 6e 64 2d 61 6c 6f 6e 65 20 46 6f 73 73  stand-alone Foss
1720: 69 6c 20 62 69 6e 61 72 79 20 69 73 20 70 75 62  il binary is pub
1730: 6c 69 73 68 65 64 2e 3c 2f 75 6c 3e 0d 0a 20 20  lished.</ul>..  
1740: 2a 20 20 56 65 72 69 66 79 20 64 65 70 65 6e 64  *  Verify depend
1750: 65 6e 63 69 65 73 3a 20 60 64 75 6d 70 62 69 6e  encies: `dumpbin
1760: 20 2f 64 65 70 65 6e 64 65 6e 74 73 20 66 6f 73   /dependents fos
1770: 73 69 6c 2e 65 78 65 60 0d 0a 20 20 2a 20 20 60  sil.exe`..  *  `
1780: 7a 69 70 20 66 6f 73 73 69 6c 2d 77 33 32 2d 24  zip fossil-w32-$
1790: 56 45 52 53 49 4f 4e 2e 7a 69 70 20 66 6f 73 73  VERSION.zip foss
17a0: 69 6c 2e 65 78 65 60 0d 0a 20 20 2a 20 20 60 66  il.exe`..  *  `f
17b0: 6f 73 73 69 6c 20 75 76 20 61 64 64 20 66 6f 73  ossil uv add fos
17c0: 73 69 6c 2d 77 33 32 2d 24 56 45 52 53 49 4f 4e  sil-w32-$VERSION
17d0: 2e 7a 69 70 60 0d 0a 20 20 2a 20 20 60 66 6f 73  .zip`..  *  `fos
17e0: 73 69 6c 20 75 76 20 73 79 6e 63 60 0d 0a 0d 0a  sil uv sync`....
17f0: 0d 0a 23 23 20 57 69 6e 64 6f 77 73 20 36 34 2d  ..## Windows 64-
1800: 62 69 74 20 75 73 69 6e 67 20 4d 53 56 43 0d 0a  bit using MSVC..
1810: 0d 0a 20 20 2a 20 20 52 75 6e 20 61 6c 6c 20 6f  ..  *  Run all o
1820: 66 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20  f the following 
1830: 66 72 6f 6d 20 61 20 22 78 36 34 20 4e 61 74 69  from a "x64 Nati
1840: 76 65 20 54 6f 6f 6c 73 20 43 6f 6d 6d 61 6e 64  ve Tools Command
1850: 20 50 72 6f 6d 70 74 22 0d 0a 20 20 2a 20 20 42   Prompt"..  *  B
1860: 75 69 6c 64 20 74 68 65 20 69 6e 2d 74 72 65 65  uild the in-tree
1870: 20 4f 70 65 6e 53 53 4c 20 6c 69 62 72 61 72 79   OpenSSL library
1880: 3a 0d 0a 20 20 20 20 20 3c 75 6c 3e 0d 0a 20 20  :..     <ul>..  
1890: 20 20 20 3c 6c 69 3e 20 49 6e 73 74 61 6c 6c 20     <li> Install 
18a0: 53 74 72 61 77 62 65 72 72 79 2d 50 65 72 6c 20  Strawberry-Perl 
18b0: 28 6f 72 20 73 69 6d 69 6c 61 72 29 20 69 66 20  (or similar) if 
18c0: 69 74 20 69 73 20 6e 6f 74 20 61 6c 72 65 61 64  it is not alread
18d0: 79 20 69 6e 73 74 61 6c 6c 65 64 2e 20 20 50 65  y installed.  Pe
18e0: 72 6c 20 69 73 20 6e 65 65 64 65 64 20 74 6f 20  rl is needed to 
18f0: 72 75 6e 20 74 68 65 0d 0a 20 20 20 20 20 20 20  run the..       
1900: 20 20 20 4f 70 65 6e 53 53 4c 20 63 6f 6e 66 69     OpenSSL confi
1910: 67 75 72 61 74 69 6f 6e 20 73 63 72 69 70 74 20  guration script 
1920: 70 72 69 6f 72 20 74 6f 20 62 75 69 6c 64 69 6e  prior to buildin
1930: 67 20 4f 70 65 6e 53 53 4c 20 66 72 6f 6d 20 73  g OpenSSL from s
1940: 6f 75 72 63 65 73 2e 20 20 46 6f 73 73 69 6c 20  ources.  Fossil 
1950: 69 74 73 65 6c 66 20 64 6f 65 73 20 6e 6f 74 20  itself does not 
1960: 75 73 65 20 50 65 72 6c 2e 0d 0a 20 20 20 20 20  use Perl...     
1970: 3c 6c 69 3e 20 44 6f 77 6e 6c 6f 61 64 20 74 68  <li> Download th
1980: 65 20 4f 70 65 6e 53 53 4c 20 74 61 72 62 61 6c  e OpenSSL tarbal
1990: 6c 20 61 6e 64 20 75 6e 70 61 63 6b 20 75 6e 64  l and unpack und
19a0: 65 72 20 60 63 6f 6d 70 61 74 2f 6f 70 65 6e 73  er `compat/opens
19b0: 73 6c 60 2e 20 20 4e 6f 74 65 20 74 68 61 74 20  sl`.  Note that 
19c0: 74 68 65 20 4f 70 65 6e 53 53 4c 20 74 61 72 62  the OpenSSL tarb
19d0: 61 6c 6c 20 77 69 6c 6c 0d 0a 20 20 20 20 20 20  all will..      
19e0: 20 20 20 20 75 6e 70 61 63 6b 20 69 6e 74 6f 20      unpack into 
19f0: 60 6f 70 65 6e 73 73 6c 2d 33 2e 58 2e 59 60 2e  `openssl-3.X.Y`.
1a00: 20 20 59 6f 75 20 77 69 6c 6c 20 6e 65 65 64 20    You will need 
1a10: 74 6f 20 72 65 6e 61 6d 65 20 74 68 61 74 20 66  to rename that f
1a20: 6f 6c 64 65 72 20 74 6f 20 6a 75 73 74 20 60 6f  older to just `o
1a30: 70 65 6e 73 73 6c 60 2e 0d 0a 20 20 20 20 20 3c  penssl`...     <
1a40: 6c 69 3e 20 60 63 64 60 20 69 6e 74 6f 20 74 68  li> `cd` into th
1a50: 65 20 4f 70 65 6e 53 53 4c 20 73 6f 75 72 63 65  e OpenSSL source
1a60: 20 64 69 72 65 63 74 6f 72 79 2c 20 60 6f 70 65   directory, `ope
1a70: 6e 73 73 6c 60 2e 0d 0a 20 20 20 20 20 3c 6c 69  nssl`...     <li
1a80: 3e 20 60 43 3a 2f 53 74 72 61 77 62 65 72 72 79  > `C:/Strawberry
1a90: 2f 70 65 72 6c 2f 62 69 6e 2f 70 65 72 6c 20 43  /perl/bin/perl C
1aa0: 6f 6e 66 69 67 75 72 65 20 56 43 2d 57 49 4e 36  onfigure VC-WIN6
1ab0: 34 41 20 6e 6f 2d 61 73 6d 20 6e 6f 2d 73 73 6c  4A no-asm no-ssl
1ac0: 33 20 6e 6f 2d 77 65 61 6b 2d 73 73 6c 2d 63 69  3 no-weak-ssl-ci
1ad0: 70 68 65 72 73 20 6e 6f 2d 73 68 61 72 65 64 60  phers no-shared`
1ae0: 0d 0a 20 20 20 20 20 3c 6c 69 3e 20 60 6e 6d 61  ..     <li> `nma
1af0: 6b 65 20 2f 66 20 6d 61 6b 65 66 69 6c 65 60 0d  ke /f makefile`.
1b00: 0a 20 20 20 20 20 3c 2f 75 6c 3e 0d 0a 20 20 2a  .     </ul>..  *
1b10: 20 20 60 63 64 60 20 69 6e 74 6f 20 74 68 65 20    `cd` into the 
1b20: 60 77 69 6e 2f 60 20 73 75 62 66 6f 6c 64 65 72  `win/` subfolder
1b30: 20 6f 66 20 74 68 65 20 46 6f 73 73 69 6c 20 73   of the Fossil s
1b40: 6f 75 72 63 65 20 74 72 65 65 2e 0d 0a 20 20 2a  ource tree...  *
1b50: 20 20 60 6e 6d 61 6b 65 20 2f 66 20 4d 61 6b 65    `nmake /f Make
1b60: 66 69 6c 65 2e 6d 73 63 20 46 4f 53 53 49 4c 5f  file.msc FOSSIL_
1b70: 45 4e 41 42 4c 45 5f 53 53 4c 3d 31 20 4f 50 54  ENABLE_SSL=1 OPT
1b80: 49 4d 49 5a 41 54 49 4f 4e 53 3d 34 20 63 6c 65  IMIZATIONS=4 cle
1b90: 61 6e 20 66 6f 73 73 69 6c 2e 65 78 65 60 0d 0a  an fossil.exe`..
1ba0: 20 20 20 20 20 3c 75 6c 3e 3c 6c 69 3e 0d 0a 20       <ul><li>.. 
1bb0: 20 20 20 20 54 68 65 20 70 72 65 76 69 6f 75 73      The previous
1bc0: 20 73 74 65 70 20 62 75 69 6c 64 73 20 74 68 65   step builds the
1bd0: 20 73 74 61 6e 64 2d 61 6c 6f 6e 65 20 46 6f 73   stand-alone Fos
1be0: 73 69 6c 20 62 69 6e 61 72 79 2e 20 20 49 66 20  sil binary.  If 
1bf0: 74 68 61 74 20 69 73 20 61 6c 6c 20 79 6f 75 20  that is all you 
1c00: 77 61 6e 74 20 74 6f 20 61 63 63 6f 6d 70 6c 69  want to accompli
1c10: 73 68 2c 20 79 6f 75 20 63 61 6e 0d 0a 20 20 20  sh, you can..   
1c20: 20 20 73 74 6f 70 20 68 65 72 65 2e 20 20 54 68    stop here.  Th
1c30: 65 20 72 65 6d 61 69 6e 69 6e 67 20 73 74 65 70  e remaining step
1c40: 73 20 64 65 73 63 72 69 62 65 20 68 6f 77 20 74  s describe how t
1c50: 68 65 20 73 74 61 6e 64 2d 61 6c 6f 6e 65 20 46  he stand-alone F
1c60: 6f 73 73 69 6c 20 62 69 6e 61 72 79 20 69 73 20  ossil binary is 
1c70: 70 75 62 6c 69 73 68 65 64 2e 3c 2f 75 6c 3e 0d  published.</ul>.
1c80: 0a 20 20 2a 20 20 56 65 72 69 66 79 20 64 65 70  .  *  Verify dep
1c90: 65 6e 64 65 6e 63 69 65 73 3a 20 60 64 75 6d 70  endencies: `dump
1ca0: 62 69 6e 20 2f 64 65 70 65 6e 64 65 6e 74 73 20  bin /dependents 
1cb0: 66 6f 73 73 69 6c 2e 65 78 65 60 0d 0a 20 20 2a  fossil.exe`..  *
1cc0: 20 20 60 7a 69 70 20 66 6f 73 73 69 6c 2d 77 36    `zip fossil-w6
1cd0: 34 2d 24 56 45 52 53 49 4f 4e 2e 7a 69 70 20 66  4-$VERSION.zip f
1ce0: 6f 73 73 69 6c 2e 65 78 65 60 0d 0a 20 20 2a 20  ossil.exe`..  * 
1cf0: 20 60 66 6f 73 73 69 6c 20 75 76 20 61 64 64 20   `fossil uv add 
1d00: 66 6f 73 73 69 6c 2d 77 36 34 2d 24 56 45 52 53  fossil-w64-$VERS
1d10: 49 4f 4e 2e 7a 69 70 60 0d 0a 20 20 2a 20 20 60  ION.zip`..  *  `
1d20: 66 6f 73 73 69 6c 20 75 76 20 73 79 6e 63 60 0d  fossil uv sync`.
1d30: 0a 0a 5a 20 34 31 62 30 63 33 33 33 38 36 34 66  ..Z 41b0c333864f
1d40: 36 39 31 62 66 65 34 61 32 30 66 35 30 32 38 37  691bfe4a20f50287
1d50: 35 35 31 38 0a                                   5518.