UseSWIG: Revise and clarify documentation
The SWIG_OUTFILE_DIR
variable provides the option to specify an output
directory location. This commit removes portion stating that this is
equal to the swig -o
option since it does not set the output filename.
While at it, improve the documentation markup.
Fixes: #17703 (closed)
Topic-rename: UseSWIG-doc-clarify