Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Configure documentation inconsistent with behavior for --prefix? #26107

Open
lydia-duncan opened this issue Oct 17, 2024 · 6 comments · May be fixed by #26112
Open

Configure documentation inconsistent with behavior for --prefix? #26107

lydia-duncan opened this issue Oct 17, 2024 · 6 comments · May be fixed by #26112

Comments

@lydia-duncan
Copy link
Member

I've been trying to use configure when setting up distribution of a Chapel library compiled into a Python package. In the documentation for configure, it says:

--prefix=/dir/for/install/ causes the Chapel compiler, libraries, and supporting code to be installed into the directories:

`/dir/for/install/bin`

`/dir/for/install/lib`

`/dir/for/install/share`

This technique is designed to install Chapel using a standard directory structure for the purposes of integrating it into a standard location that is already in your path, such as /usr/local/ or ~/.

To me, this indicated that ~/ was a valid value to use. But if I use ./configure --prefix=~/, then I get the following message:

error: expected an absolute directory name for --prefix: ~/

Was that an incorrect expectation to have? Is this a bug? Or is this a sign we should adjust our documentation to not imply that?

@jabraham17
Copy link
Member

This is possibly a bug introduced by #23576, where it looks like the code that explicitly handled ~/ was removed?

@lydia-duncan
Copy link
Member Author

Hmm, following that trail, it might even be intentional: #23271 (comment)

@jabraham17
Copy link
Member

I guess that makes it clear we should address this by fixing the docs, not changing configure

@mppf
Copy link
Member

mppf commented Oct 18, 2024

From #23271 (comment)

Ah, yes, ./configure --prefix ~/tmp/foo does expand it, because the shell handles it on the way in to configure. Presumably something about ./configure --prefix=~/tmp/foo leads the shell not to expand it.

So, the documentation could suggest ./configure --prefix ~/.

(BTW, I would myself not use ~/ as a prefix; instead I would use something like ~/sw; but this is a matter of personal preference).

@lydia-duncan
Copy link
Member Author

I was not having luck with --prefix ~/ (it gave me help output, oddly enough), so I think I'll just remove the mention of ~ and leave it at that

@lydia-duncan
Copy link
Member Author

PR is here, if I could get a review for it :)

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging a pull request may close this issue.

3 participants