nnn/patches/README.md

User Patch Framework

This directory contains sizable user submitted patches that were rejected from mainline as they tend to be more subjective in nature.

The patches will be adapted on each release when necessary (v4.1 onwards). Each patch can be applied through its respective make variable during compilation. In case inter-patch merge conflicts occur, a compatability patch is provided and will automatically be applied.

List of patches

Patch (a-z)	Description	Make var
bookmarknav	Enter/leave type-to-nav mode when entering/leaving bookmark and plugin dir.	O_GITSTATUS
gitstatus	Add git status column to the detail view. Provides command line flag -G to show column in normal mode.	O_GITSTATUS
namefirst	Print filenames first in the detail view. Print user/group columns when a directory contains different users/groups.	O_NAMEFIRST
restorepreview	Add pipe to close and restore preview-tui for internal undetached edits (e key)	O_RESTOREPREVIEW

To apply a patch, use the corresponding make variable, e.g.:

make O_NAMEFIRST=1

Resolving patch conflicts

Whenever patch conflicts occur on the latest master, pull requests resolving them are welcome. Let's say a conflict occurs in the restorepreview patch. The best way to resolve this conflict would be something along the lines of:

• Ensure you're on latest master and run cp src/nnn.c src/nnn.c.orig && PATCH_OPTS="--merge" make O_RESTOREPREVIEW=1. This will save a copy of the source from master in src/nnn.c.orig and generate conflict markers in src/nnn.c.
• Next edit src.nnn, resolve all the conflicts around the conflict markers(<<<<<<<), and save.
• Then run diff -u src/nnn.c.orig src/nnn.c > patch.diff to generate the new patch file and copy the contents to patches/restorepreview/mainline.diff (keeping the description comment at the start of the file).