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

misc: modify manual to build dockerfile #1783

Conversation

haileynam
Copy link
Contributor

@haileynam haileynam commented Jul 28, 2023

Currently make install on some Ubuntu versions failed like below:

    GEN      uftrace.1
  pandoc: blocks is null
  CallStack (from HasCallStack):
    error, called at src/Text/Pandoc/Writers/Man.hs:287:47 in pandoc-1.19.2.4-HbfKWUyODESBIy0vGktOwX:Text.Pandoc.Writers.Man
  Makefile:18: recipe for target 'uftrace.1' failed

It's because the description of --task option has incompatible format in
the pandoc syntax. We don't need that part so let's get rid of it.

Fixed: #1766

@honggyukim
Copy link
Collaborator

Please rewrite the commit message with complete sentences so that everyone who reads the message can understand why this change is needed.

doc/uftrace.md Outdated
@@ -356,7 +356,7 @@ record and `replay` internally. Thus, it describes most regular option in detail
: Hide small functions run less than the *TIME*

\--task
: [info]: Print task relationship in a tree form instead of the tracing info.
: [info] Print task relationship in a tree form instead of the tracing info.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I found that the same problem was there and the [info]: part was removed by 5c30743.

This is better to be removed.

Suggested change
: [info] Print task relationship in a tree form instead of the tracing info.
: Print task relationship in a tree form instead of the tracing info.

@honggyukim
Copy link
Collaborator

And it's weird that two different commits have the same commit title. Please rewrite the commit message.

@haileynam haileynam force-pushed the misc--modify-manual-to-build-Dockerfile branch 2 times, most recently from 4ebec8f to 738ca1c Compare July 30, 2023 06:49
@haileynam
Copy link
Contributor Author

@honggyukim I have updated my commit and included your code review. Thank you for your comment.

Copy link
Owner

@namhyung namhyung left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks good. But the commit prefix should be "doc:" instead of "misc:". Also "Modify" has no value in the commit message and we want to know what or why. So the commit message line can be like below:

doc: Fix pandoc error in uftrace.md

Currently make install on some Ubuntu versions failed like below:

    GEN      uftrace.1
  pandoc: blocks is null
  CallStack (from HasCallStack):
    error, called at src/Text/Pandoc/Writers/Man.hs:287:47 in pandoc-1.19.2.4-HbfKWUyODESBIy0vGktOwX:Text.Pandoc.Writers.Man
  Makefile:18: recipe for target 'uftrace.1' failed

It's because the description of --task option has incompatible format in
the pandoc syntax.  We don't need that part so let's get rid of it.

Fixed: #1766

@haileynam haileynam force-pushed the misc--modify-manual-to-build-Dockerfile branch 2 times, most recently from 95c8995 to f9eab45 Compare August 3, 2023 10:21
@honggyukim
Copy link
Collaborator

Hi @haileynam, the change looks good but I would like to ask you to change the commit title from

doc: Modify manual to build dockerfile

to the one @namhyung suggested.

doc: Fix pandoc error in uftrace.md

I'm asking because any kind of commit does modify so modify doesn't provide useful information to the commit message readers. And please let us know when you change the commit.

Currently make install on some Ubuntu versions failed like below:

    GEN      uftrace.1
  pandoc: blocks is null
  CallStack (from HasCallStack):
    error, called at src/Text/Pandoc/Writers/Man.hs:287:47 in pandoc-1.19.2.4-HbfKWUyODESBIy0vGktOwX:Text.Pandoc.Writers.Man
  Makefile:18: recipe for target 'uftrace.1' failed

It's because the description of --task option has incompatible format in
the pandoc syntax.  We don't need that part so let's get rid of it.

Fixed: namhyung#1766

Signed-off-by: Yoojung Nam <haileynam0408@gmail.com>
@haileynam haileynam force-pushed the misc--modify-manual-to-build-Dockerfile branch from f9eab45 to 984281d Compare August 3, 2023 12:24
@haileynam
Copy link
Contributor Author

@honggyukim Sorry for my mistake. I just changed my commit including you and @namhyung suggested. Please check for it.

Copy link
Collaborator

@honggyukim honggyukim left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for the update. LGTM!

@honggyukim honggyukim merged commit 633ddb8 into namhyung:master Aug 7, 2023
3 checks passed
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.

Unable to build docker image of ubuntu
3 participants