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

[Documentation] Document how to access the config.log #2584

Open
ShalokShalom opened this issue Jun 13, 2017 · 12 comments
Open

[Documentation] Document how to access the config.log #2584

ShalokShalom opened this issue Jun 13, 2017 · 12 comments
Labels
Documentation Flags an issue / PR for attention by the technical documentation team Stale Type: Chore Issues for general code and infrastructure maintenance Type:Hackathon
Milestone

Comments

@ShalokShalom
Copy link

ShalokShalom commented Jun 13, 2017

Currently, the error message "look into the config.log" leaves you without any hint, where this file is and how to open it. Maybe add a prompt which directly asks the user to do that, like:

Do you want to open the config.log? (Export as text file to ..?)

@eeyun
Copy link
Contributor

eeyun commented Jun 20, 2017

@ShalokShalom can you update this issue with some context on where you're seeing this error? In the meantime i'll search for that output but I want to make sure this gets triaged into the apropriate bucket!
Thanks!

@ShalokShalom
Copy link
Author

I think i can show it to you the next time i run into it.

The error output was "See `config.log' for more details on an error message"

And ssd means:

If you are talking about the output of running ./configure during some build, that will usually be in the src dir in the hab cache

/hab/cache/src/DIR_FOR_YOUR_SOFTWARE/

I think that each and every possible case, where a text document contains information, should get covered by the documentation. I think a prompt like: Do you want to read the config.log Y/N is nice. :)

@nellshamrell
Copy link
Contributor

This is not directly a result of Habitat, it is related to ./configure (autoconf and automake tools), it may be good to link to external documentation around these tools.

@nellshamrell nellshamrell added this to the Help Wanted milestone Jun 27, 2017
@ShalokShalom
Copy link
Author

When you are in Habitat, is the usage of an editor etc different as in a casual shell, right?
And this config.log is placed in Habitats studio chroot, yes? So what is the real issue, to write something simple like a short documentation page, which describes how to access this log in Habitats special case?

What is the challenge to ask the user with the help of a simple Y/N prompt question, if he/she likes to read this log? Can we export this log maybe (on question) into the home directory of the user?

@eeyun
Copy link
Contributor

eeyun commented Jun 28, 2017

@ShalokShalom would it be good to have a blog-post/series on building from these toolchains inside habitat?

To answer your second paragraph. It's not so simple as to provide a Y/N prompt question, it would require some way to run ALL commands inside of studio builds with expects and since this is a single toolchain of which habitat supports many we likely cannot safely make an assumption like that. The log location for this is set by the toolchain generating the log, not hab so in that regard it again comes down to needing to have an idea of the toolchain and the software you're building and not explicitly habitat.

@ShalokShalom
Copy link
Author

Ok, well explained, thanks a lot

If there is no other way to offer this as an optional choice, i think we can close this.

What do you think in general, about forks who implement specific error and solution outputs, like that one i described? As an example: Find the config log here: /path/whatsover/package_name and so on? :)

@ShalokShalom
Copy link
Author

ShalokShalom commented Jun 29, 2017

About the toolchains: IMHO is Habitat with that current solution a caveman with a cloak of invisibility.
So, a mixture of something new and shiny with something outdated.

I know, most of you core maintainers like it to be so (why ever) and i think, that this is not compatible with the very own goals of Habitat itself:

2017-06-29 13_51_26-greenshot

The second thing is, that even very outdated package managers like "place in what ever you like" offer support for all this stuff and i am very fine with a solution, that abstracts the autotool stuff away from me.

Such things get again and again refused with generic answers like "it adds abstraction" and "i think that most users will not use it", which is both in my opinion something with less validity and sense behind.

Habitat IS ALL ABOUT a high(er) level of deployment, it is an abstraction layer by ITSELF.

It might be that i do not see the difference between abstraction and abstraction yet.
I welcome clearance, if that is the case.

One more thing to say about it:

The very most of your core maintainers seem to be focused on the internet and its tools.

I use it for OS packaging and think that Habitat is suitable - until such lacking abstraction - to revolutionize the scene and get used for all kinds of distributions.

openSUSE struggles to find a place between the others when it comes to release cycles and Habitat offers the option to ship LTS editions with optional rolling apps, which offers a massive benefit, IMHO.

This is something revolutionizing in the package management of Linux distros, while completely standard in Windows and OS X, right?

All i ask you is this:

Why should one packager, who work since a decade with a tool that abstracts the autotools, change to another one which cant do this?

This looks like Habitat is in an very early state of its development, while its already pretty usable, yes?

Thanks a lot for all your help and support Ian. 👍

@eeyun
Copy link
Contributor

eeyun commented Jun 29, 2017

I don't think we need to close the issue here because I think we SHOULD document how to access this log. I'm just not sure implementation wise how we could tighten control over those behaviors/errors. That is to say if someone on the team or in the community writes a PR that makes sense I don't imagine there'd be too many concerns about merging a feature like that.

@ShalokShalom
Copy link
Author

ShalokShalom commented Jun 29, 2017

While i welcome this very much, since i still think it makes a lot of sense, changed my view on this one a bit in the past days: Together with this log, comes another message, namely the ./configure issue in this case.

I opened that issue here 16 days ago, now in the meanwhile i am aware of the reason for its fail.
The nub of matter is for me: Neither the ./configure related error message, nor the config.log can provide me any senseful input. Without the community, i would be lost.

Here are 2 issues with that: The community wont help again and again with the same basic questions.
This is why we implement documentation. The second one is of course, that the very most people are too ashamed to ask in the chat, or they simply dont even this about the possibility in this moment.

Google shows a lot of different similar issues, while of course no one in practice specifically for Habitat.

My solution for this is:

This is a list of potential solutions:

  1. Check your pkg_build_deps "core/make" is an essential package for the most cases.
  2. Check if the file name is exactly the same as in pkg_name (Case sensitivity)
  3. Check if autogen.sh can help (Link to the specific wiki page)

At least the both first cases would be redundant with a imho sane abstraction, which means such issues drive in circles. I already hit a couple of them in a row, all connected with each other.

I know this is something very obvious for you and everyone else in this business.
For us, as beginners, is it very helpful.
And we can make this one with each and every issue as well.
Its possible to us, to use specific versions with own patches of the tools who call those errors.

I am really stunned, that after 30 years of development of such tools is something like that still exotic.

@stale
Copy link

stale bot commented Apr 3, 2020

This issue has been automatically marked as stale because it has not had recent activity. It will be closed if no further activity occurs. We value your input and contribution. Please leave a comment if this issue still affects you.

@stale stale bot added the Stale label Apr 3, 2020
@christophermaier christophermaier added Type: Chore Issues for general code and infrastructure maintenance and removed C-chore labels Jul 24, 2020
@stale stale bot removed the Stale label Jul 24, 2020
@christophermaier christophermaier added Documentation Flags an issue / PR for attention by the technical documentation team and removed A-documentation labels Aug 18, 2020
@rahulgoel1 rahulgoel1 removed the E-easy label Jul 23, 2021
@stale
Copy link

stale bot commented Aug 12, 2022

This issue has been automatically marked as stale because it has not had recent activity. It will be closed if no further activity occurs. We value your input and contribution. Please leave a comment if this issue still affects you.

1 similar comment
@stale
Copy link

stale bot commented Aug 12, 2023

This issue has been automatically marked as stale because it has not had recent activity. It will be closed if no further activity occurs. We value your input and contribution. Please leave a comment if this issue still affects you.

@stale stale bot added the Stale label Aug 12, 2023
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Documentation Flags an issue / PR for attention by the technical documentation team Stale Type: Chore Issues for general code and infrastructure maintenance Type:Hackathon
Projects
None yet
Development

No branches or pull requests

6 participants