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

Fix build and usage instructions in README.md #271

Merged
merged 6 commits into from
Jun 6, 2017

Conversation

mtrmac
Copy link
Collaborator

@mtrmac mtrmac commented May 12, 2017

  • Add a “command-line usage” heading and section
  • Enhance the dependencies subsection
  • Move the “when developing this library” sentence into a “Contributing” section
  • Add another skopeo pointer to the “building” subsection
  • Fix the actual building instructions
  • Document the gpgme dependency and how to install it

See the individual commit messages for details.

This should help with #268, and fixes #270.

(Re: #270, this completely removes any mention of go build ./... without replacement; as #268 shows, ./... is undesirable because it includes all depdendencies, and go build $(PACKAGES) in Makefile is unnecessary because go test $(PACKAGES) builds all of the named subpackages, even those which don’t have any tests.)

@hferentschik is this sufficient? (The containers/storage build failure will be fixed separately.)

@mtrmac mtrmac force-pushed the fix-and-doc-build branch 2 times, most recently from b178595 to fe25008 Compare May 17, 2017 20:40
@mtrmac mtrmac force-pushed the fix-and-doc-build branch 3 times, most recently from 0170e1c to 3185f97 Compare May 30, 2017 17:55
@mtrmac mtrmac force-pushed the fix-and-doc-build branch 2 times, most recently from 87e755a to 66f8fa5 Compare June 6, 2017 14:38
@mtrmac
Copy link
Collaborator Author

mtrmac commented Jun 6, 2017

@runcom PTAL

@runcom
Copy link
Member

runcom commented Jun 6, 2017

LGTM

Approved with PullApprove

This is not really a new content, just emphasizing the existence of
skopeo as a starting point—and highlights `copy.Image`.

Signed-off-by: Miloslav Trmač <[email protected]>
Be a bit more explicit about the lack of “vendor” subdirectory.

… and use a file name instead of “here” as a link title to make it
easier to see what it points to.

Signed-off-by: Miloslav Trmač <[email protected]>
…” section

It is not something people just wanting to use the project care about,
and we want to make the containers_image_openpgp tag clearly related.

Signed-off-by: Miloslav Trmač <[email protected]>
Some people asking “how to build this” really shouldn't.

Signed-off-by: Miloslav Trmač <[email protected]>
(go build ./...) is entirely useless when not developing this project:
per (go help build):
> When compiling multiple packages or a single non-main package,
> build compiles the packages but discards the resulting object,
> serving only as a check that the packages can be built.

Instead, add a starting point for integrating the library into a user.

Signed-off-by: Miloslav Trmač <[email protected]>
… instead of just documenting how to avoid it.

And move the (make BUILDTAGS=…) variant into the “Contributing”
subsection, it is not useful when integrating this into another project.

Signed-off-by: Miloslav Trmač <[email protected]>
@mtrmac
Copy link
Collaborator Author

mtrmac commented Jun 6, 2017

👍

Approved with PullApprove

@mtrmac mtrmac merged commit 01167c2 into containers:master Jun 6, 2017
@mtrmac mtrmac deleted the fix-and-doc-build branch June 6, 2017 16:37
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Wrong build instructions in README
2 participants