I think it would be useful to mention somewhere, that when invoking mongrel_rails restart with -P option pointing to a pid file, upon restart mongrel will write it's new pid to file which name was given when starting mongrel for first time, not the one given with restart command.
---
mongrel_rails start # created log/mongrel.pid
mv log/mongrel.pid log/mongrel.8010.pid
mongrel_rails restart -P log/mongrel.8010.pid # creates new log/mongrel.pid, leaving old invalid
pid in log/mongrel.8010.pid
I think it would be nice to mention this somewhere in: mongrel_rails restart --help