Allow for Dockerfile to be named something else.

This is a follow-on to #7995 and #7284.

This PR allows for the Dockerfile to be named something other than `Dockerfile` via a -f/--file option. Aside from the name/path of the Dockerfile being variable, nothing else should change from today's behavior. The location of the Dockerfile MUST be within the build context.

This PR contains the:
- code changes
- docs updates
- testcases

Signed-off-by: Doug Davis <dug@us.ibm.com>
@SvenDowideit yes that should work too.  I added another example with some more text see if that helps. I tried to use a non-. case and elaborated a bit on how the dockerfile needs to be in the context regardless of how we point to it.