TurtleGit for Mac

View Markdown source ↗

TurtleGit documentation

The published documentation provides local search and section navigation for these guides and source audits.

Start with Getting started for the first native workflows, or the project README for build instructions and current limits. The manual plan tracks the remaining user-guide chapters.

Parity documents compare implementation against the pinned TortoiseGit source. They contain checkpoint evidence and explicit gaps; an implemented command or passing receiver is not proof of complete dialog, physical UI or signed sandbox parity. Dated machine-readable evidence is in qa. Historical test counts describe the checkpoint at which they were recorded.

The file inventory, dialog inventory and control inventory track source review. Inventory entries are not completion counts. See Port tracking for baseline and update rules.

Guides and project status

Build, distribution and verification

Working files and commits

History and repository browsing

Repositories, branches and remote operations

Rebase

Comparison, merge and submodules

Finder integration

Settings, artwork and helpers

Inventory maintenance

The upstream checkout is ignored, not vendored. To prepare the pinned baseline:

git clone --depth 1 https://github.com/TortoiseGit/TortoiseGit.git .upstream/TortoiseGit
git -C .upstream/TortoiseGit fetch origin 7338078f8ddd924b8cddee35f512f2286072136d
git -C .upstream/TortoiseGit checkout 7338078f8ddd924b8cddee35f512f2286072136d
python3 scripts/inventory-upstream.py

Regeneration reads the commit in upstream.json, including resource contents, independently of checkout HEAD or uncommitted edits. To review a new upstream revision, explicitly run python3 scripts/inventory-upstream.py --ref <commit> and regenerate controls with python3 scripts/inventory-dialog-controls.py. Changed blobs, dialog resources and control declarations require renewed review. External libraries and gitlinks are inventoried, but their nested repositories are not recursively audited.

Merge regex filters: native list/editor, ECMAScript comparison keys and filtered-row colors; remaining three-pane and acceptance work.

Subversion merge engine: bundled diff2/diff3 adapter and original-text source mapping and native pane integration; full source acceptance remains open.

Merge comparison options: whitespace/case/EOL controls and saved source defaults; full acceptance remains open.

Comment comparison: pinned language profiles and source heuristic in both viewers; native profile editing/overrides are implemented; complete acceptance remains open.

Merge locator bar: native colored overview, shared/pane-local word marking, Find bands, viewport/navigation and saved view settings in both editors, with reviewed light/dark component captures.

Merge save workflows: Backup original file, empty-result Delete/Keep, deleted-file recreation and exact deletion resolution retry.

External-source reload: delayed activation checks, Load/Ignore/Cancel, retained source copies, independent result Save As and owned close/Open/Quit drain.

CI runtime reuse: exact prepared dependency caches with mandatory validation; hosted timing/hits remain pending.

Merge whitespace display: source space/tab/EOL shapes and original ending icons in both viewers, with saved View/Settings controls.

Merge General settings: native font preview/live metrics, configurable inline bound and source load-jump flags.

Merge Colors settings: source palette rows, independent light/dark drafts, Restore Default and live renderer integration.

Native About dialog family: app and tool About windows, bundled runtime reports, original attribution and local license access.

Finder context now shares normalized selections, nearest repository ownership and explicit ignore inheritance; see selection context.

Native Compare/Merge toolbar: original artwork, live commands and dropdowns, independent saved layouts, replacement ownership and reviewed full-window light/dark captures.

History navigation, deletion and child-submodule inspection records the connected source7/12 continuation and acceptance scope.

Compressed EMF+ path playback covers shared drawing, clipping, region, custom-cap and accepted gradient-boundary decoding.

Positioned metafile text tracks the connected driver-string, glyph-index and classic text-spacing implementation and its remaining acceptance.

Classic WMF/EMF raster operations records Boolean playback, device brushes and remaining format restrictions.

Presentation comment and thread review records classic and modern comment decisions, authors, anchors and coherent editable export.

Embedded metafile images and textures records nested WMF/EMF/EMF+ playback, affine placement and Windows-reference limits.

External tool configuration covers literal commands, association routing and owned native settings editors/choosers.

Backend metadata reads covers source-selected reference catalogs, labels, tag objects and batched History/Sync actions.

Compressed metafile rasters records GIF/TIFF/EXIF image and brush playback, classic stretched transfers and Windows reference differences.

Revision and reference validation covers typed object resolution, exact branch/tag collisions and accepted backend ownership through creation, Switch, Push, Fetch and Synchronization continuations.

Historical navigation covers Browser revision and comparison targets, literal submodule pins, reference deletion receipts and owned Log/Rebase/Bisect handoffs.

Reference metadata text and literal namespaces records legacy commit display, exact scoped catalogs and the hosted-failure repair checkpoint.