From 7b1afd916412048d5d9e68a65eafa1f764f2a3cb Mon Sep 17 00:00:00 2001 From: Oliver Tappe Date: Sat, 14 Oct 2006 12:34:39 +0000 Subject: * adjusted POD-texts to our current standards. git-svn-id: http://svn.openslx.org/svn/openslx/trunk@461 95ad53e4-c205-0410-b2fa-d234c58c8868 --- config-db/devel-tools/extractTranslations.pl | 30 ++++++--- config-db/slxconfig-demuxer.pl | 93 ++++++++++++++++------------ config-db/slxsetup-test-data-simple.pl | 90 +++++++++++++++------------ config-db/slxsetup.pl | 24 +++---- 4 files changed, 137 insertions(+), 100 deletions(-) (limited to 'config-db') diff --git a/config-db/devel-tools/extractTranslations.pl b/config-db/devel-tools/extractTranslations.pl index bd16b613..3907a184 100755 --- a/config-db/devel-tools/extractTranslations.pl +++ b/config-db/devel-tools/extractTranslations.pl @@ -9,6 +9,17 @@ # use strict; +my $abstract = q[ +extractTranslations.pl + This script is a tool for OpenSLX developers as it allows to extract + translatable strings from all OpenSLX perl-scripts and modules found + in and below a given path. + + Optionally, all the translatable strings that were found can automatically + be integrated into all existing translation modules. During this process, + any translations already existing in these modules will be preserved. +]; + use File::Find; use Getopt::Long; use Pod::Usage; @@ -33,7 +44,7 @@ GetOptions( 'verbose' => \$verbose, 'version' => \$versionReq, ) or pod2usage(2); -pod2usage(1) if $helpReq; +pod2usage(-msg => $abstract, -verbose => 0, -exitval => 1) if $helpReq; if ($versionReq) { system('slxversion'); exit 1; @@ -183,11 +194,12 @@ all scripts and modules found in and below the given path. extractTranslations.pl [options] path Options: - --help brief help message - --update-path=s update the OpenSLX locale modules in given path - --show show overview of all strings found - --verbose show for each file which strings are found - --version show version + --help brief help message + --update-path= update the OpenSLX locale modules in given + path + --show show overview of all strings found + --verbose show for each file which strings are found + --version show version =head1 OPTIONS @@ -201,7 +213,7 @@ Prints a brief help message and exits. Prints sorted list of all translatable strings that were found. -=item B<--update-path=s> +=item B<--update-path=> Integrates the found translatable strings into all OpenSLX locale modules found in path (which should end in 'Translations'). @@ -219,6 +231,4 @@ Prints the version and exits. =back -=head1 DESCRIPTION - -B can be used to \ No newline at end of file +=cut \ No newline at end of file diff --git a/config-db/slxconfig-demuxer.pl b/config-db/slxconfig-demuxer.pl index 8a6ef1ef..a0557089 100755 --- a/config-db/slxconfig-demuxer.pl +++ b/config-db/slxconfig-demuxer.pl @@ -8,6 +8,21 @@ # use strict; +my $abstract = q[ +slxconfig-demuxer.pl + This script will read information about all systems, clients and + groups from the OpenSLX configuration database, mix & match the individual + configurational attributes and then demultiplex the resulting information + to a set of configuration files. These files are used by any OpenSLX-client + during boot to find out which systems to offer for booting. + + The resulting files will be put into the OpenSLX-tftpboot-path (you can use + the option --tftpboot-path to override the default taken from the OpenSLX + default settings). + + Please use the --man option in order to read the full manual. +]; + use Fcntl qw(:DEFAULT :flock); use File::Basename; use Getopt::Long qw(:config pass_through); @@ -55,7 +70,7 @@ GetOptions( 'man' => \$manReq, 'version' => \$versionReq, ) or pod2usage(2); -pod2usage(1) if $helpReq; +pod2usage(-msg => $abstract, -verbose => 0, -exitval => 1) if $helpReq; pod2usage(-verbose => 2) if $manReq; if ($versionReq) { system('slxversion'); @@ -374,31 +389,31 @@ slxconfig-demuxer.pl - OpenSLX configuration demultiplexer slxconfig-demuxer.pl [options] Script Options: - --dry-run avoids writing anything, for testing + --dry-run avoids writing anything, for testing OpenSLX Options: - --base-path=s basic path to project files - --bin-path=s path to binaries and scripts - --config-path=s path to configuration files - --db-basepath=s basic path to openslx database - --db-datadir=s data folder created under db-basepath - --db-name=s name of database - --db-spec=s full DBI-specification of database - --db-type=s type of database to connect to - --export-path=s path to root of all exported filesystems - --locale=s locale to use for translations - --logfile=s file to write logging output to - --private-path=s path to private data - --public-path=s path to public (client-accesible) data - --share-path=s path to sharable data - --temp-path=s path to temporary data - --tftpboot-path=s path to root of tftp-server - --verbose-level=i level of logging verbosity (0-3) + --base-path= basic path to project files + --bin-path= path to binaries and scripts + --config-path= path to configuration files + --db-basepath= basic path to openslx database + --db-datadir= data folder created under db-basepath + --db-name= name of database + --db-spec= full DBI-specification of database + --db-type= type of database to connect to + --export-path= path to root of all exported filesystems + --locale= locale to use for translations + --logfile= file to write logging output to + --private-path= path to private data + --public-path= path to public (client-accesible) data + --share-path= path to sharable data + --temp-path= path to temporary data + --tftpboot-path= path to root of tftp-server + --verbose-level= level of logging verbosity (0-3) General Options: - --help brief help message - --man full documentation - --version show version + --help brief help message + --man full documentation + --version show version =head1 OPTIONS @@ -417,108 +432,108 @@ you can learn from the logging output what would have been done. =over 8 -=item B<--base-path=s> +=item B<--base-path=> Sets basic path to project files. Default is $SLX_BASE_PATH (usually F). -=item B<--bin-path=s> +=item B<--bin-path=> Sets path to binaries and scripts. Default is $SLX_BASE_PATH/bin (usually F). -=item B<--config-path=s> +=item B<--config-path=> Sets path to configuration files. Default is $SLX_CONFIG_PATH (usually F). -=item B<--db-basepath=s> +=item B<--db-basepath=> Sets basic path to openslx database. Default is $SLX_DB_PATH (usually F). -=item B<--db-datadir=s> +=item B<--db-datadir=> Sets data folder created under db-basepath. Default is $SLX_DB_DATADIR (usually empty as it depends on db-type whether or not such a directory is required at all). -=item B<--db-name=s> +=item B<--db-name=> Gives the name of the database to connect to. Default is $SLX_DB_NAME (usually C). -=item B<--db-spec=s> +=item B<--db-spec=> Gives the full DBI-specification of database to connect to. Content depends on the db-type. Default is $SLX_DB_SPEC (usually empty as it will be built automatically). -=item B<--db-type=s> +=item B<--db-type=> Sets the type of database to connect to (CSV, SQLite, mysql, ...). Default $SLX_DB_TYPE (usually C). -=item B<--export-path=s> +=item B<--export-path=> Sets path to root of all exported filesystems. For each type of export (NFS, NBD, ...) a separate folder will be created in here. Default is $SLX_EXPORT_PATH (usually F. -=item B<--locale=s> +=item B<--locale=> Sets the locale to use for translations. Defaults to the system's standard locale. -=item B<--logfile=s> +=item B<--logfile=> Specifies a file where logging output will be written to. Default is to log to STDERR. -=item B<--private-path=s> +=item B<--private-path=> Sets path to private data, where the config-db, vendor_oses and configurational extensions will be stored. Default is $SLX_PRIVATE_PATH (usually F. -=item B<--public-path=s> +=item B<--public-path=> Sets path to public (client-accesible) data. Default is $SLX_PUBLIC_PATH (usually F. -=item B<--share-path=s> +=item B<--share-path=> Sets path to sharable data, where distro-specs and functionality templates will be stored. Default is $SLX_SHARE_PATH (usually F. -=item B<--temp-path=s> +=item B<--temp-path=> Sets path to temporary data. Default is $SLX_TEMP_PATH (usually F. -=item B<--tftpboot-path=s> +=item B<--tftpboot-path=> Sets path to root of tftp-server from which clients will access their files. Default is $SLX_TFTPBOOT_PATH (usually F. -=item B<--verbose-level=i> +=item B<--verbose-level=> Sets the level of logging verbosity (0-3). diff --git a/config-db/slxsetup-test-data-simple.pl b/config-db/slxsetup-test-data-simple.pl index fa0d6f75..19679498 100755 --- a/config-db/slxsetup-test-data-simple.pl +++ b/config-db/slxsetup-test-data-simple.pl @@ -8,6 +8,15 @@ # use strict; +my $abstract = q[ +slxsetup-test-data-simple.pl + This script will generate a very simple OpenSLX test-dataset, useful for + testing and/or trying things out. + + If the OpenSLX configuration database already contains data, the script + will ask for confirmation before clobbering that database. +]; + use Getopt::Long qw(:config pass_through); use Pod::Usage; @@ -36,7 +45,7 @@ GetOptions( 'man' => \$manReq, 'version' => \$versionReq, ); -pod2usage(1) if $helpReq; +pod2usage(-msg => $abstract, -verbose => 0, -exitval => 1) if $helpReq; pod2usage(-verbose => 2) if $manReq; if ($versionReq) { system('slxversion'); @@ -143,31 +152,31 @@ slxsetup-test-data-simple.pl - Simple OpenSLX test data generator slxsetup-test-data-simple.pl [options] Script Options: - --clobber overwrites config-db without asking + --clobber overwrites config-db without asking OpenSLX Options: - --base-path=s basic path to project files - --bin-path=s path to binaries and scripts - --config-path=s path to configuration files - --db-basepath=s basic path to openslx database - --db-datadir=s data folder created under db-basepath - --db-name=s name of database - --db-spec=s full DBI-specification of database - --db-type=s type of database to connect to - --export-path=s path to root of all exported filesystems - --locale=s locale to use for translations - --logfile=s file to write logging output to - --private-path=s path to private data - --public-path=s path to public (client-accesible) data - --share-path=s path to sharable data - --temp-path=s path to temporary data - --tftpboot-path=s path to root of tftp-server - --verbose-level=i level of logging verbosity (0-3) + --base-path= basic path to project files + --bin-path= path to binaries and scripts + --config-path= path to configuration files + --db-basepath= basic path to openslx database + --db-datadir= data folder created under db-basepath + --db-name= name of database + --db-spec= full DBI-specification of database + --db-type= type of database to connect to + --export-path= path to root of all exported filesystems + --locale= locale to use for translations + --logfile= file to write logging output to + --private-path= path to private data + --public-path= path to public (client-accesible) data + --share-path= path to sharable data + --temp-path= path to temporary data + --tftpboot-path= path to root of tftp-server + --verbose-level= level of logging verbosity (0-3) General Options: - --help brief help message - --man full documentation - --version show version + --help brief help message + --man full documentation + --version show version =head1 OPTIONS @@ -186,108 +195,108 @@ config-db will be wiped!> =over 8 -=item B<--base-path=s> +=item B<--base-path=> Sets basic path to project files. Default is $SLX_BASE_PATH (usually F). -=item B<--bin-path=s> +=item B<--bin-path=> Sets path to binaries and scripts. Default is $SLX_BASE_PATH/bin (usually F). -=item B<--config-path=s> +=item B<--config-path=> Sets path to configuration files. Default is $SLX_CONFIG_PATH (usually F). -=item B<--db-basepath=s> +=item B<--db-basepath=> Sets basic path to openslx database. Default is $SLX_DB_PATH (usually F). -=item B<--db-datadir=s> +=item B<--db-datadir=> Sets data folder created under db-basepath. Default is $SLX_DB_DATADIR (usually empty as it depends on db-type whether or not such a directory is required at all). -=item B<--db-name=s> +=item B<--db-name=> Gives the name of the database to connect to. Default is $SLX_DB_NAME (usually C). -=item B<--db-spec=s> +=item B<--db-spec=> Gives the full DBI-specification of database to connect to. Content depends on the db-type. Default is $SLX_DB_SPEC (usually empty as it will be built automatically). -=item B<--db-type=s> +=item B<--db-type=> Sets the type of database to connect to (CSV, SQLite, mysql, ...). Default $SLX_DB_TYPE (usually C). -=item B<--export-path=s> +=item B<--export-path=> Sets path to root of all exported filesystems. For each type of export (NFS, NBD, ...) a separate folder will be created in here. Default is $SLX_EXPORT_PATH (usually F. -=item B<--locale=s> +=item B<--locale=> Sets the locale to use for translations. Defaults to the system's standard locale. -=item B<--logfile=s> +=item B<--logfile=> Specifies a file where logging output will be written to. Default is to log to STDERR. -=item B<--private-path=s> +=item B<--private-path=> Sets path to private data, where the config-db, vendor_oses and configurational extensions will be stored. Default is $SLX_PRIVATE_PATH (usually F. -=item B<--public-path=s> +=item B<--public-path=> Sets path to public (client-accesible) data. Default is $SLX_PUBLIC_PATH (usually F. -=item B<--share-path=s> +=item B<--share-path=> Sets path to sharable data, where distro-specs and functionality templates will be stored. Default is $SLX_SHARE_PATH (usually F. -=item B<--temp-path=s> +=item B<--temp-path=> Sets path to temporary data. Default is $SLX_TEMP_PATH (usually F. -=item B<--tftpboot-path=s> +=item B<--tftpboot-path=> Sets path to root of tftp-server from which clients will access their files. Default is $SLX_TFTPBOOT_PATH (usually F. -=item B<--verbose-level=i> +=item B<--verbose-level=> Sets the level of logging verbosity (0-3). @@ -319,5 +328,6 @@ B will generate a very simple test-dataset useful for testing and/or trying things out. If the OpenSLX configuration database already contains data, the script -asks for confirmation before clobbering that database. +will ask for confirmation before clobbering that database. +=cut \ No newline at end of file diff --git a/config-db/slxsetup.pl b/config-db/slxsetup.pl index 78ad6b72..4c82be28 100755 --- a/config-db/slxsetup.pl +++ b/config-db/slxsetup.pl @@ -8,6 +8,19 @@ # use strict; +my $abstract = q[ +slxsetup.pl + This script can be used to show or change the local settings for OpenSLX. + + Any cmdline-argument passed to this script will change the local OpenSLX + settings file (usually /etc/opt/openslx/settings.local). + + If you invoke the script without any arguments, it will print the current + settings and exit. + + Please use the --man option in order to read the full manual. +]; + use Getopt::Long qw(:config pass_through); use Pod::Usage; @@ -21,17 +34,6 @@ use lib "$FindBin::RealBin"; use OpenSLX::Basics; -my $abstract = q[ -slxsetup.pl - This script can be used to show or change the local settings for OpenSLX. - - Any cmdline-argument passed to this script will change the local OpenSLX - settings file (usually /etc/opt/openslx/settings.local). - - If you invoke the script without any arguments, it will print the current - settings and exit. -]; - my ( $noShow, $quiet, -- cgit v1.2.3-55-g7522