vagrant

https://github.com/mitchellh/vagrant

Ruby

Vagrant is a tool for building and distributing development environments.

Vagrant::Plugin::V1::Guest#halt

Halt the machine. This method should gracefully shut down the
operating system. This method will cause `vagrant halt` and associated
commands to _block_, meaning that if the machine doesn't halt
in a reasonable amount of time, this method should just return.

If when this method returns, the machine's state isn't "powered_off,"
Vagrant will proceed to forcefully shut the machine down.

Source | Google | Stack overflow

Edit

git clone [email protected]:mitchellh/vagrant.git

cd vagrant

open lib/vagrant/plugin/v1/guest.rb

Contribute

# Make a new branch

git checkout -b -your-name--update-docs-Vagrant--Plugin--V1--Guest-halt-for-pr

# Commit to git

git add lib/vagrant/plugin/v1/guest.rbgit commit -m "better docs for Vagrant::Plugin::V1::Guest#halt"

# Open pull request

gem install hub # on a mac you can `brew install hub`

hub fork

git push <your name> -your-name--update-docs-Vagrant--Plugin--V1--Guest-halt-for-pr

hub pull-request

# Celebrate!