fiji_scripts: minor documentation refinements

Doxyfile

@@ -769,7 +769,7 @@ FILE_PATTERNS          = *.pm *.pl
 # be searched for input files as well.
 # The default value is: NO.
 
-RECURSIVE              = NO
+RECURSIVE              = yes
 
 # The EXCLUDE tag can be used to specify files and/or directories that should be
 # excluded from the INPUT source files. This way you can easily exclude a

FIJI.pm

-## @file [FIJI.pm]
+## @file
 
-## @class [FIJI]
+## @class FIJI
 #
 # Various constants used in the FIJI packages.
 package FIJI;
 
+use strict;
+use warnings;
+
 # Architecture from http://www.perlmonks.org/?node_id=1072731
 
 # Fields:

FIJI/Connection.pm

-## @file [Connection.pm]
+## @file
 
-## @class [FIJI::Connection]
+## @class FIJI::Connection
 #
 # Instances of this class represent a single serial connection to a FIJI-compatible DUT.
 # Besides handling all communication-related functions they are also responsible for generating and interpreting the respective payloads.
@@ -8,6 +8,9 @@
 # The implementation relies on AnySerialPort.pm to be cross-platform-compatible.
 package FIJI::Connection;
 
+use strict;
+use warnings;
+
 use Switch;
 
 use Log::Log4perl qw(get_logger);

FIJI/Settings.pm

-## @file [Settings.pm]
+## @file
 
-## @class [FIJI::Settings]
+## @class FIJI::Settings
 #
 # Contains helper functions to deal with FIJI Settings files.
 package FIJI::Settings;
 
+use strict;
+use warnings;
+
 use Log::Log4perl qw(get_logger);
 use Scalar::Util "looks_like_number";
 use Config::Simple;

fiji_download.pl

-## @file [fiji_download.pl]
+## @file
 
 use strict;
 use warnings;