tj / tj/git-extras

Want an updated Makefile for BSD/Homebrew/non-root?

Open
#463 4 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
Shell
Stars
18.1k
Forks
1.2k
Avg merge
5d 17h
Merged PRs (30d)
1

Description

Hi folks,

I've just discovered git-extras through my work with Oh My Zsh and Homebrew and I'm digging it; I'd like to start using it regularly. I'm mainly an OS X/Homebrew user with a multi-user, multi-machine setup, and I'm running in to a few issues on this platform. I've got space for a weekend project. Would you be interested in a PR(s) that updated the Makefile and build process to do some or all of:

  • Make sure the whole build, including doco generation, works under BSD/OS X
  • Support relocating etc (#237)
  • Support disabling selected commands and suppressing prompting for alias conflicts (#442, #228)
    • (would make fully unattended, repeatable installs possible)
    • Remove man & doco for disabled commands, just to be tidy
  • Split the build and install into two steps, so you could build the commands (slurping in the library files) and run them inside the local source tree without having to install to the final destination (useful for iterating development)
  • Install the HTML and other format docs under /usr/share/doc (right now it looks like they're going under man, which should really only be for man-formatted stuff)
  • Unify makefile.msys with the main Makefile (#427)

Regardless, cheers for the good work.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Read the Makefile and makefile.msys first, then review the referenced issues #237, #442, #228, and #427 to narrow the requested scope. Done would require an agreed subset of the BSD/OS X, non-root build and installation goals to work, with documentation and disabled-command behavior verified where applicable.

Written by the indexing model from the issue text.

Assessment

Tech stack
git, macos, shell
Domain
build-system, cli, documentation
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Stale
Clarity
Needs clarification
Newbie friendliness
25/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.