improve upon Basic_Usage_and_Command_Line_Options

Signed-off-by: Fotis Georgatos <fotis@cern.ch>
fix references and Basic Usage overall

Signed-off-by: Fotis Georgatos <fotis@cern.ch>