Fixed #21832

1st commit: Updates code, tests and docs.
2nd commit: Way to create fk instance at command line.
shorten line (rule of thumb I'm using is ~120 characters so I don't have scroll horizontally in github review)