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

add documentation for eb --extended-dry-run #159

Merged
merged 29 commits into from
Oct 28, 2015

Conversation

boegel
Copy link
Member

@boegel boegel commented Oct 5, 2015

see easybuilders/easybuild-framework#1388

preview available at http://boegel-eb.readthedocs.org/en/extended_dry_run/Extended_dry_run.html

should be fleshed out a bit more, including:

  • mentioning --disable-extended-dry-run-ignore-errors
  • more details about simulating of module load of missing modules (esp. the toolchain module)
  • guidelines for making easyblocks fully compatible with --extended-dry-run

@boegel boegel changed the title initial draft of documentation for --extended-dry-run (WIP) add documentation for eb --extended-dry-run Oct 28, 2015
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Any errors that occur are ignored, and are reported with a clear warning message.
This is done because it is not unlikely that these errors occur because of the dry run mechanism.
Copy link
Contributor

Choose a reason for hiding this comment

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

double negative is harder to read. Perhaps change to "likely" or "possible" or "probable"

Copy link
Member Author

Choose a reason for hiding this comment

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

ok, thanks

Extended dry run
================

Using ``--extended-dry-run`` or ``-x`` (supported since EasyBuild v2.4.0), a detailed overview of the build and install
Copy link
Contributor

Choose a reason for hiding this comment

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

Do we link to the changelog here?

Copy link
Member Author

Choose a reason for hiding this comment

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

You mean release notes?

I can, but they still need to be fleshed out for the upcoming v2.4.0.

I can get them started and only include an entry for easybuilders/easybuild-framework#1388 though, so I will, and include a reference here.

@rjeschmi
Copy link
Contributor

looks fine, some typos.

I think the apply_regex_substitutions is an important feature to highlight, since it will probably become our "best practice" rather than one line patch files...

@boegel
Copy link
Member Author

boegel commented Oct 28, 2015

Good to go now easybuilders/easybuild-framework#1388 is merged in.

Thanks for the review @rjeschmi

boegel added a commit that referenced this pull request Oct 28, 2015
add documentation for eb --extended-dry-run
@boegel boegel merged commit 8d2af9c into easybuilders:develop Oct 28, 2015
@boegel boegel deleted the extended_dry_run branch October 28, 2015 23:40
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.

2 participants