clojure / clojure/clojure-site

getting_started - custom location - wrong MANPATH

Open
#493 1 comment 0 reactions 1 assignee View on GitHub

@puredanger is already working on this.

Since Jun 8, 2021.

Dominant language
HTML
Stars
259
Forks
275
PR merge metrics
No merged PRs in 30d

Description

The getting_started page's Custom Location section gives the following example:

MANPATH_MAP /opt/infrastructure/clojure/bin /opt/infrastructure/clojure/man

Allowing for a different prefix that I gave the installer, the second location does not exist. I think the second location's "/man" should be "/share/man".

The long story is that, to avoid sudo, I could not follow the instructions precisely. Here's what I did to run into the problem and how I resolved it. I suppose that the resolution also applies to the sudo-related case illustrated on getting_started.

mkdir ${HOME}/opt
./linux-install-1.10.1.739.sh --prefix ${HOME}/opt/clojure

Instead of changing a man-related configuration in /etc, I added the following line to .bash_profile:

export MANPATH=":${HOME}/opt/clojure/bin:${HOME}/opt/clojure/man"

(Initial colon important to indicate that this is an addendum to system locations.) I activated the new MANPATH with source .bash_profile. But man -u clj did not yield any results.

After changing to

export MANPATH=":${HOME}/opt/clojure/bin:${HOME}/opt/clojure/share/man"

the man -u clj command worked.

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.

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.