# Notes on how Fossil deliverables are built and uploaded

## Download Page

  *  `fossil uv edit download.js`
  *  Edit the "releases" variable in the javascript
     to add the new release number and title and various
     hyperlinks.  Perhaps also remove older releases.
  *  Remove obsolete build products: `fossil uv rm --glob $PATTERN`
  *  `fossil uv sync`

## Linux

  *  Set up in-tree OpenSSL:
     <ul>
     <li> Download the OpenSSL tarball and unpack it into `compat/openssl`
     <li> `cd` into the `compat/openssl` directory
     <li> `./config no-ssl3 no-weak-ssl-ciphers no-shared no-threads
     <li> `make`
     </ul>
  *  `./configure --with-openssl=tree --disable-fusefs`
  *  Edit the Makefile to move `-lpthread`
  *  `CFLAGS="-Os" make -e clean fossil`
  *  `strip fossil`
  *  Verify dependencies using "`ldd ./fossil`"
  *  `tar czf fossil-linux-x64-$VERSION.tar.gz fossil`
  *  `fossil uv add fossil-linux-x64-$VERSION.tar.gz`
  *  `fossil uv sync`

## Linux (alternative procedures)

  *  Log into
  *  cd to
  *  Run the script ./rebuild.sh
  *  Logout
  *  Download the file
  *  `strip fossil`
  *  `tar czf fossil-linux-x64-$VERSION.tar.gz fossil`
  *  `fossil uv add fossil-linux-x64-$VERSION.tar.gz`
  *  `fossil uv sync`

## Mac

  *  `./configure`
  *  Edit the Makefile to specify
     and in place of
     -lcrypto and -lssl, and to add -liconv at the end
  *  `CFLAGS="-Os" make -e clean fossil`
  *  Verify no shared library dependencies using:  `otool -L ./fossil`
  *  `strip fossil`
  *  `codesign -s fossil`
  *  Verify the signature using: `codesign -d -v fossil`
  *  `tar czf fossil-macosx-$VERSION.tar.gz fossil`
  *  `fossil uv add fossil-macosx-$VERSION.tar.gz`
  *  `fossil uv sync`

## Raspberry Pi

  *  `./configure`
  *  Edit Makefile so that instead of -lssl and -lcrypto
     there are complete paths to the libssl.a and
     libcrypto.a files: <ul>
     <li>
     <li>
  *  `CFLAGS="-Os" make -e clean fossil && strip fossil`
  *  `tar czf fossil-pi-$VERSION.tar.gz fossil`
  *  `fossil uv add fossil-pi-$VERSION.tar.gz`
  *  `fossil uv sync`

## Source Tarball

  *  `fossil tarball --name fossil-$VERSION version-$VERSION fossil-src-$VERSION.tar.gz`
  *  `fossil uv add fossil-src-$VERSION.tar.gz`
  *  `fossil uv sync`

## Windows 32-bit using MINGW


  *  On the Windows 10 laptop in a MinGW shell in
  *  `fossil clean`
  *  `make -f win/makefile.mingw FOSSIL_ENABLE_SSL=1
  *  **OR:** `tclsh ../mkfossil.tcl`
  *  Verify dependences: `dumpbin /dependents fossil.exe`
  *  `zip fossil-w32-$VERSION.zip fossil.exe`
  *  `fossil uv add fossil-w32-$VERSION.zip`
  *  `fossil uv sync`

## Windows 64-bit using MSVC

  *  Run all of the following from a "x64 Native Tools Command Prompt"
  *  Set up in-tree OpenSSL:
     <ul>
     <li> Install Strawberry-Perl if it is not already installed
     <li> Download the OpenSSL tarball and unpack under `compat/`
     <li> `cd` into the OpenSSL source directory
     <li> Configure VC-WIN64A no-asm no-ssl3 no-weak-ssl-ciphers no-shared`
     <li> `nmake /f makefile`
     </ul>
  *  `cd` into the `win/` subfolder of the Fossil source tree.
  *  `nmake /f Makefile.msc FOSSIL_ENABLE_SSL=1 clean fossil.exe`
  *  Verify dependences: `dumpbin /dependents fossil.exe`
  *  `zip fossil-w64-$VERSION.zip fossil.exe`
  *  `fossil uv add fossil-w64-$VERSION.zip`
  *  `fossil uv sync`