microsoft/edit: We all edit.

Edit

A simple editor for simple needs.

This editor pays homage to the classic MS-DOS Editor, but with a modern interface and input controls similar to VS Code. The goal is to provide an accessible editor that even users largely unfamiliar with terminals can easily use.

Installation

You can also download binaries from our Releases page.

Windows

You can install the latest version with WinGet:

winget install Microsoft.Edit

Build Instructions

• Install Rust
• Install the nightly toolchain: rustup install nightly
  • Alternatively, set the environment variable RUSTC_BOOTSTRAP=1
• Clone the repository
• For a release build, run:
  • Rust 1.90 or earlier: cargo build --config .cargo/release.toml --release
    • otherwise: cargo build --config .cargo/release-nightly.toml --release

Build Configuration

During compilation you can set various environment variables to configure the build. The following table lists the available configuration options:

Notes to Package Maintainers

Package Naming

The canonical executable name is “edit” and the alternative name is “msedit”. We’re aware of the potential conflict of “edit” with existing commands and recommend alternatively naming packages and executables “msedit”. Names such as “ms-edit” should be avoided. Assigning an “edit” alias is recommended, if possible.

ICU library name (SONAME)

This project optionally depends on the ICU library for its Search and Replace functionality. By default, the project will look for a SONAME without version suffix:

• Windows: icuuc.dll
• macOS: libicuuc.dylib
• UNIX, and other OS: libicuuc.so

If your installation uses a different SONAME, please set the following environment variable at build time:

• EDIT_CFG_ICUUC_SONAME: For instance, libicuuc.so.76.
• EDIT_CFG_ICUI18N_SONAME: For instance, libicui18n.so.76.

Additionally, this project assumes that the ICU exports are exported without _ prefix and without version suffix, such as u_errorName. If your installation uses versioned exports, please set:

• EDIT_CFG_ICU_CPP_EXPORTS: If set to true, it’ll look for C++ symbols such as _u_errorName. Enabled by default on macOS.
• EDIT_CFG_ICU_RENAMING_VERSION: If set to a version number, such as 76, it’ll look for symbols such as u_errorName_76.

Finally, you can set the following environment variables:

• EDIT_CFG_ICU_RENAMING_AUTO_DETECT: If set to true, the executable will try to detect the EDIT_CFG_ICU_RENAMING_VERSION value at runtime. The way it does this is not officially supported by ICU and as such is not recommended to be relied upon. Enabled by default on UNIX (excluding macOS) if no other options are set.

To test your settings, run cargo test again but with the --ignored flag. For instance:

cargo test -- --ignored