### Install Unison

Source: https://github.com/bcpierce00/unison/blob/master/INSTALL.md

After building, use this command to install Unison. Environment variables like `$PREFIX` and `$DESTDIR` can be set to customize the installation path.

```shell
make install
```

--------------------------------

### Build Unison from Source

Source: https://github.com/bcpierce00/unison/blob/master/INSTALL.md

Execute this command in the Unison source directory to build the project. Ensure all prerequisites are installed beforehand.

```shell
make
```

--------------------------------

### Cross-compile Unison for Windows

Source: https://github.com/bcpierce00/unison/blob/master/INSTALL.md

Example of cross-compiling Unison for a native Windows 64-bit executable using the MinGW toolchain. Ensure the toolchain is installed and in your PATH.

```shell
make TOOL_PREFIX=x86_64-w64-mingw32-
```

--------------------------------

### Unison Relocation Command Example

Source: https://github.com/bcpierce00/unison/blob/master/src/TODO.txt

An alternative syntax for relocating Unison archives, emphasizing the canonization of hosts and paths. This command facilitates moving archives between specified locations.

```bash
unison -relocate //old-host1//path1 //old-host2//path2 \
                     //new-host1//path1 //new-host2//path2
```

--------------------------------

### Build Unison TUI Only

Source: https://github.com/bcpierce00/unison/blob/master/INSTALL.md

Use this command to build only the text-based user interface component of Unison, provided lablgtk3 is installed.

```shell
make tui
```

--------------------------------

### Static Linking Flags for GCC/Clang

Source: https://github.com/bcpierce00/unison/blob/master/INSTALL.md

Examples of LDFLAGS values to enable static linking for GCC or Clang. Note that static linking may not be fully supported by all libraries.

```shell
-static
```

```shell
-Wl,-static
```

--------------------------------

### Create and Run Docker Container with Volume Mount

Source: https://github.com/bcpierce00/unison/wiki/Building-Windows-binary-with-MSVC-Ocaml-4.12-Using-Docker-Container

Create a new Docker container from the OCaml/opam image, mounting a local Windows directory into the container. This allows for persistent storage and easy file exchange between the host and the container.

```bash
>docker run -it -v C:\Users\Your_Username\Downloads:C:\cygwin64\home\opam\WinFolder ocaml/opam:windows-msvc-ocaml-4.12 ocaml-env exec --64 --ms=vs2019 -- cmd.exe
```

--------------------------------

### List Docker Images

Source: https://github.com/bcpierce00/unison/wiki/Building-Windows-binary-with-MSVC-Ocaml-4.12-Using-Docker-Container

Verify that the Docker image has been successfully downloaded by listing all available images. This command helps confirm the image's presence and details.

```bash
>docker images
REPOSITORY   TAG                       IMAGE ID       CREATED        SIZE
ocaml/opam   windows-msvc-ocaml-4.12   e69ba8b6bde7   3 months ago   23.5GB
```

--------------------------------

### Check DLL Dependencies on Windows

Source: https://github.com/bcpierce00/unison/blob/master/INSTALL.md

After building Unison with MinGW, use these commands to check the DLLs required by the built binary. This is useful for ensuring all necessary runtime components are available.

```shell
cygcheck src/unison.exe
```

```shell
ldd src/unison.exe
```

--------------------------------

### Build Unison Binary

Source: https://github.com/bcpierce00/unison/wiki/Building-Windows-binary-with-MSVC-Ocaml-4.12-Using-Docker-Container

Compile the Unison project from source code using the 'make' command within the Docker container. This command builds the Windows 64-bit unison.exe and unison-fsmonitor.exe binaries using MSVC OCaml-4.12.

```bash
>cd unison
>make OSTYPE=cygwin
```

--------------------------------

### Build Unison with OPAM

Source: https://github.com/bcpierce00/unison/blob/master/INSTALL.md

If using OPAM, this command may be necessary to set up the correct environment for building Unison.

```shell
opam exec -- make
```

--------------------------------

### Build Unison with Native=false

Source: https://github.com/bcpierce00/unison/blob/master/INSTALL.md

Use this option when compiling a native binary is not possible. It embeds the OCaml runtime and Unison bytecode into a single executable.

```shell
nmake NATIVE=false
```

--------------------------------

### Build Unison with MSVC

Source: https://github.com/bcpierce00/unison/blob/master/INSTALL.md

Execute this command in the Unison source code directory to build the project using NMAKE. Ensure MSVC build tools are in your PATH.

```shell
nmake
```

--------------------------------

### List Unison Executables

Source: https://github.com/bcpierce00/unison/wiki/Building-Windows-binary-with-MSVC-Ocaml-4.12-Using-Docker-Container

Lists the generated Unison executables in the src directory. These are the binaries that will be deployed.

```bash
ls -l unison/src/*.exe
-rwxr-xr-x 1 ContainerAdministrator ContainerAdministrator 1428992 Jan 10 22:10 unison/src/unison-fsmonitor.exe
-rwxr-xr-x 1 ContainerAdministrator ContainerAdministrator 3142144 Jan 10 22:10 unison/src/unison.exe
```

--------------------------------

### Build Unison Filesystem Monitor Only

Source: https://github.com/bcpierce00/unison/blob/master/INSTALL.md

Use this command to build only the filesystem monitor component of Unison.

```shell
make fsmonitor
```

--------------------------------

### Build macOS Native GUI

Source: https://github.com/bcpierce00/unison/blob/master/INSTALL.md

Execute this command to build only the macOS native GUI. The built application will be located at src/uimac/build/Default/Unison.app.

```shell
make macui
```

--------------------------------

### Build Unison GUI Only

Source: https://github.com/bcpierce00/unison/blob/master/INSTALL.md

Use this command to build only the graphical user interface component of Unison.

```shell
make gui
```

--------------------------------

### Make Unison-GTK executable on macOS

Source: https://github.com/bcpierce00/unison/wiki/CI-Binary-instructions

The 'unison-gtk' binary on macOS also requires execute permissions. Note its dependency on a specific GTK+ library path.

```shell
chmod +x unison-gtk
```

--------------------------------

### List All Docker Containers

Source: https://github.com/bcpierce00/unison/wiki/Building-Windows-binary-with-MSVC-Ocaml-4.12-Using-Docker-Container

Display all Docker containers, including stopped ones, to retrieve the Container ID. This is necessary for restarting and attaching to a previously used container.

```bash
>docker ps --all --no-trunc
CONTAINER ID                                                       IMAGE                                COMMAND                                                                           CREATED         STATUS                      PORTS     NAMES

eb5a90d15d595b86cfd009a33821a385249448b46ef12d144bde2ef4220eecd0   ocaml/opam:windows-msvc-ocaml-4.12   "ocaml-env exec --64 --ms=vs2019 -- ocaml-env exec --64 --ms=vs2019 -- cmd.exe"   4 minutes ago   Exited (0) 33 seconds ago             silly_mahavira
```

--------------------------------

### Pull OCaml/opam Windows MSVC Docker Image

Source: https://github.com/bcpierce00/unison/wiki/Building-Windows-binary-with-MSVC-Ocaml-4.12-Using-Docker-Container

Download the specific OCaml and opam Docker image for Windows with MSVC support. This image is required for building OCaml applications on Windows using the MSVC toolchain.

```bash
>docker pull ocaml/opam:windows-msvc-ocaml-4.12
```

--------------------------------

### List Files in Container

Source: https://github.com/bcpierce00/unison/wiki/Building-Windows-binary-with-MSVC-Ocaml-4.12-Using-Docker-Container

List files within the Docker container to verify the mounted volume and its contents. This helps confirm that the host directory is accessible inside the container.

```bash
C:\cygwin64\home\opam>ls -l
total 8
drwxr-xr-x+ 1 Administrators SYSTEM        0 Oct  5 17:39 opam-repository
drwx------+ 1 Unknown+User   Unknown+Group 0 Jan  8 08:21 winfolder

C:\cygwin64\home\opam>ls -l winfolder
total 540137
-rwx------+ 1 Unknown+User Unknown+Group 519015312 Jan  1 16:12 'Docker Desktop Installer.exe'
```

--------------------------------

### Relocate Unison Archives

Source: https://github.com/bcpierce00/unison/blob/master/src/TODO.txt

Use this command to relocate Unison archives. Specify old and new host/path pairs for migration. Ensure paths are normalized correctly for the new locations.

```bash
unison -relocate //old-host1//path1 //old-host2//path2 \
                 //new-host1//path1 //new-host2//path2
```

--------------------------------

### Conditional Feature Implementation (Pseudocode)

Source: https://github.com/bcpierce00/unison/blob/master/src/FEATURES.md

Use this pseudocode to guard new code implementations based on feature flags. It ensures that the appropriate algorithm is selected at runtime depending on which features are enabled for a remote connection.

```pseudocode
function hash
  if (feature hash-2 enabled) then
    new algorithm
  else if (feature hash-1 enabled) then
    previous algorithm
  end
```

--------------------------------

### Clone Unison Source Code

Source: https://github.com/bcpierce00/unison/wiki/Building-Windows-binary-with-MSVC-Ocaml-4.12-Using-Docker-Container

Clone the Unison source code repository from GitHub into the current directory within the Docker container. This step downloads the project files needed for compilation.

```bash
>pwd
/home/opam

>git clone https://github.com/bcpierce00/unison.git
Cloning into 'unison'...
remote: Enumerating objects: 10301, done.
remote: Counting objects: 100% (799/799), done.
remote: Compressing objects: 100% (361/361), done.
remote: Total 10301 (delta 486), reused 643 (delta 413), pack-reused 9502
Receiving objects: 100% (10301/10301), 16.27 MiB | 1.77 MiB/s, done.
Resolving deltas: 100% (7718/7718), done.

>ls -l
total 4
drwxr-xr-x+ 1 ContainerAdministrator ContainerAdministrator 0 Jan  8 17:23 unison
```

--------------------------------

### List of files in GNU/Linux Unison tarball

Source: https://github.com/bcpierce00/unison/wiki/CI-Binary-instructions

This shows the typical file structure within a Unison tarball for GNU/Linux, including the main executable and documentation files.

```shell
 -rw-r--r--    root/root      35147 LICENSE
 -rw-r--r--    root/root       6916 README.md
 drwxr-xr-x    root/root          0 bin/
 -rwxr-xr-x    root/root    3065536 bin/unison
 -rwxr-xr-x    root/root    1109952 bin/unison-fsmonitor
 -rw-r--r--    root/root     214126 unison-manual.html
 -rw-r--r--    root/root     363952 unison-manual.pdf
 -rw-r--r--    root/root     157212 unison-manual.txt
```

--------------------------------

### OCaml Version Distribution (February 2022 Survey)

Source: https://github.com/bcpierce00/unison/wiki/OCaml-versions

This data represents the distribution of OCaml versions used by Unison users in February 2022. It was used to assess the impact of dropping support for older OCaml versions.

```plaintext
4.13    9
4.12    6
4.11    9       obviously most are on 4.11 or higher: 24 votes
4.10    4
4.09    0       a clue that 4.09 and below have mostly aged out, except for LTS
4.08    6       some kind of LTS?
4.07    1
4.06    1       FreeBSD ports 2022
4.05    4       FreeBSD ports older, RHEL 8 (beta in 2018)
4.02    1
```

--------------------------------

### Make Unison executable on macOS

Source: https://github.com/bcpierce00/unison/wiki/CI-Binary-instructions

After unpacking the Unison tarball on macOS, you need to make the 'unison' executable file runnable.

```shell
chmod +x unison
```

--------------------------------

### Restart and Attach to Docker Container

Source: https://github.com/bcpierce00/unison/wiki/Building-Windows-binary-with-MSVC-Ocaml-4.12-Using-Docker-Container

Restart a stopped Docker container using its short ID and then attach to it to re-enter the container environment. This allows you to resume your work without creating a new container.

```bash
>docker start eb5
eb5
>docker attach eb5
```

--------------------------------

### Locate Required DLL

Source: https://github.com/bcpierce00/unison/wiki/Building-Windows-binary-with-MSVC-Ocaml-4.12-Using-Docker-Container

Finds the location of the msvcp140.dll file within the Docker container. This DLL is required to run the Unison executables on Windows.

```bash
ls -l \BuildTools/VC/Tools/MSVC/14.29.30133/bin/Hostx86/x86/msvcp140.dll
-rwxr-xr-x 1 ContainerAdministrator ContainerAdministrator 436600 Oct  5 17:18 '\BuildTools/VC/Tools/MSVC/14.29.30133/bin/Hostx86/x86/msvcp140.dll'
```

--------------------------------

### Static Linking Flags for MinGW/Cygwin/MSYS2

Source: https://github.com/bcpierce00/unison/blob/master/INSTALL.md

Use these LDFLAGS for static linking with GCC on Windows environments like MinGW, Cygwin, or MSYS2. The '-link' flag is required due to flexlink.

```shell
-link -static
```

--------------------------------

### Configure Docker Data Root

Source: https://github.com/bcpierce00/unison/wiki/Building-Windows-binary-with-MSVC-Ocaml-4.12-Using-Docker-Container

Modify the Docker daemon configuration to change the storage location for Docker images. This is useful for managing disk space on the C: drive.

```json
{
    "experimental": false,
    "data-root": "D:\\DockerRoot"
}
```

--------------------------------

### Unison Core Synchronization Functions

Source: https://github.com/bcpierce00/unison/wiki/Finding-your-way-around-the-Unison-sources

These are the primary functions responsible for the synchronization process. They are called sequentially to determine changes, build reconciliation items, and perform the actual transport of updates.

```ml
Update.findUpdates()
Recon.reconcileAll
Transport.transportItem
```

--------------------------------

### Remove quarantine attribute from macOS app

Source: https://github.com/bcpierce00/unison/wiki/CI-Binary-instructions

To prevent an 'app is damaged' error on macOS, you must remove the quarantine attribute from the Unison.app bundle after unpacking.

```shell
xattr -cr /Applications/Unison.app
```

=== COMPLETE CONTENT === This response contains all available snippets from this library. No additional content exists. Do not make further requests.