# helm-make

**Repository Path**: bmplay/helm-make

## Basic Information

- **Project Name**: helm-make
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2024-06-19
- **Last Updated**: 2025-12-01

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

 ### Description

A call to `helm-make` will give you a `helm` selection of this directory
Makefile's targets. Selecting a target will call `compile` on it. You can cancel
as usual with `C-g`. Support is provided for the various flavors of Make tools,
as well as the Ninja build tool.

### Install

Just get it from [MELPA](http://melpa.org/).

The functions that this package provides are auto-loaded, so no
additional setup is required. Unless you want to bind the functions to
a key.

### Additional stuff

#### `helm-make-do-save`

If this is set to `t`, the currently visited files from Makefile's
directory will be saved.

#### `helm-make-projectile`

This is a `helm-make` called with `(projectile-project-root)` as base directory.

#### `helm-make-list-target-method`

What method should be used to parse the Makefile. The default value is
`default`, which is a pure elisp solution, but falls a bit short when the
Makefile includes other Makefile's. The second option is `qp`, it is much more
accurate, as it uses the database produced by make to extract the targets. But
could be a bit slower when the database produced by make is large.

#### `helm-make-build-dir`

An additional directory, relative to `projectile-project-root`, where
`helm-make-projectile` will search for a valid Makefile. A valid Makefile is
one that GNU make looks after, i.e. the name of the Makefile must be one of
Makefile, makefile or GNUmakefile to be valid.

#### `helm-make-sort-targets`

If this is set to `t`, sort the targets before calling the completion method.
By default it is set to nil, if you are setting it to `t`, and you encounter
longer delays before the targets are displayed, try to set this back to nil.
This, however, might only be the case, if the Makefile contains thousand of
targets.

#### `helm-make-cache-targets`

If this is set to `t`, cache the targets. Next time when you call
`helm-make(-projectile)` for the same Makefile, and the modification time of
the Makefile has not changed meanwhile, reuse the cached targets.
It is set to `nil` by default.

#### `helm-make-executable`

You can customize executable of make command by changing this variable. Helpful
for implementing remote compiling.

#### `helm-make-ninja-executable`

You can customize executable of ninja command by changing this variable. Helpful
for implementing remote compiling.

#### `helm-make-arguments`

Customizes arguments which are passed to the make executable when building. To
include the universal argument, use `%d`. Default is `-j%d`.

#### `helm-make-named-buffer`

When setting helm-make-named-buffer to `t` all make buffers will be named
based on their make target and `default-directory`. e.g. \*compilation in
~/emacs (all)\* for `make all` in /home/USER/emacs. This is useful if you want
to run multiple compilations at the same time.

#### `helm-make-niceness`

When set to a non-zero value, invocations of make or ninja will run at this
niceness level. Default is 0, i.e. don't nice make commands.


#### `helm-make-comint`

When setting helm-make-comint to `t` helm-make will use Comint mode instead of
Compilation mode. This is useful if you want to interact with the make buffer.

#### `helm-make-fuzzy-matching`

When this variable is non-nil, fuzzy matching will be enabled helm make
targets buffer.

#### `helm-make-nproc`

Number passed to the '-j' flag.

When this variable is set to `0`, we try to automatically retrieve available
number of processing units using `helm--make-get-nproc`.

Regardless of the value of this variable, it can be bypassed by
passing an universal prefix to `helm-make` or `helm-make-projectile`.