Permalink
Browse files

podtidy configure files

git-svn-id: https://svn.parrot.org/parrot/trunk@10844 d31e2699-5ff4-0310-a27c-f18f2fbe73fe
  • Loading branch information...
1 parent dc2c536 commit 6f5b5384b493cb15ad65054b89bbc7c3efe89fe8 @jhoblitt jhoblitt committed Jan 2, 2006
View
@@ -12,8 +12,8 @@ =head1 SYNOPSIS
=head1 DESCRIPTION
-This is Parrot's configuration script. It should be run to create the
-necessary system-specific files before building Parrot.
+This is Parrot's configuration script. It should be run to create the necessary
+system-specific files before building Parrot.
=head2 Command-line Options
@@ -31,8 +31,8 @@ =head2 Command-line Options
=item C<--verbose>
-Tells Configure.pl to output extra information about the configuration
-data it is setting.
+Tells Configure.pl to output extra information about the configuration data it
+is setting.
=item C<--verbose=2>
@@ -59,8 +59,8 @@ =head2 Command-line Options
Compile Options
-You can add and remove option values with C<< :rem{<opt>} >> and
-C<< :add{<opt>} >>. For example:
+You can add and remove option values with C<< :rem{<opt>} >> and C<<
+:add{<opt>} >>. For example:
perl Configure.pl --ccflags=":rem{-g} :add{-O2}"
@@ -132,8 +132,8 @@ =head2 Command-line Options
=item C<--define=val1[,val2]>
-Generate "#define PARROT_DEF_VAL1 1" ... entries in has_header.h.
-Currently needed to use inet_aton for systems that lack inet_pton:
+Generate "#define PARROT_DEF_VAL1 1" ... entries in has_header.h. Currently
+needed to use inet_aton for systems that lack inet_pton:
--define=inet_aton
@@ -177,9 +177,8 @@ =head2 Command-line Options
=item C<--gc=(type)>
-Determine the type of garbage collection. The value for C<type> should
-be one of: C<gc>, C<libc>, C<malloc> or C<malloc-trace>. The default is
-C<gc>.
+Determine the type of garbage collection. The value for C<type> should be one
+of: C<gc>, C<libc>, C<malloc> or C<malloc-trace>. The default is C<gc>.
=back
@@ -191,11 +190,11 @@ =head2 Command-line Options
Use the specified icu-config script to determine the necessary ICU options.
-Use --icu-config=none to disable the autodetect feature. Parrot will
-then be build without ICU.
+Use --icu-config=none to disable the autodetect feature. Parrot will then be
+build without ICU.
-B<Note:> If you specify another ICU option than --icu-config, the
-autodetection functionality will be disabled.
+B<Note:> If you specify another ICU option than --icu-config, the autodetection
+functionality will be disabled.
=item C<--icushared=(linkeroption)>
@@ -209,7 +208,7 @@ =head2 Command-line Options
=item C<--icuheaders=(header_dir)>
-Location of ICU header files without the /unicode suffix.
+Location of ICU header files without the /unicode suffix.
E.g.
@@ -223,17 +222,17 @@ =head2 Command-line Options
=item C<--maintainer>
-Use this option if you want imcc's parser and lexer files to be
-generated. Needs a working parser and lexer.
+Use this option if you want imcc's parser and lexer files to be generated.
+Needs a working parser and lexer.
=item C<--miniparrot>
Build parrot assuming only pure ANSI C is available.
=item C<--expnetwork>
-Enable experimental networking. This is an unused option and should
-probably be removed.
+Enable experimental networking. This is an unused option and should probably be
+removed.
=back
@@ -7,8 +7,8 @@ config/auto/antlr - Check whether antlr works
=head1 DESCRIPTION
-Determines wheter antlr exists on the system.
-Is so, then check whether there is support for Python output.
+Determines wheter antlr exists on the system. Is so, then check whether there
+is support for Python output.
When antlr is not found, then something like
View
@@ -7,9 +7,9 @@ config/auto/bc.pm - Check whether GNU bc works
=head1 DESCRIPTION
-Determines whether GNU bc, the basic calculator, exists on the system.
-It is OK when it doesn't exist. Currently GNU bc is only used for doublechecking
-Parrot bc.
+Determines whether GNU bc, the basic calculator, exists on the system. It is OK
+when it doesn't exist. Currently GNU bc is only used for doublechecking Parrot
+bc.
=cut
View
@@ -7,8 +7,8 @@ config/auto/gc.pm - Garbage Collection
=head1 DESCRIPTION
-Checks whether the C<--gc> command-line option was passed to
-F<Configure.pl> and sets the memory allocator accordingly.
+Checks whether the C<--gc> command-line option was passed to F<Configure.pl>
+and sets the memory allocator accordingly.
C<--gc> can take the values:
View
@@ -7,8 +7,8 @@ config/auto/gdbm.pm - Test for GNU dbm (gdbm) library
=head1 DESCRIPTION
-Determines whether the platform supports gdbm.
-This is needed for the dynamic GDBMHash PMC.
+Determines whether the platform supports gdbm. This is needed for the dynamic
+GDBMHash PMC.
=cut
View
@@ -7,8 +7,8 @@ config/auto/jit - JIT Capability
=head1 DESCRIPTION
-Determines the CPU architecture, the operating system, and whether there
-is JIT capability available.
+Determines the CPU architecture, the operating system, and whether there is JIT
+capability available.
=cut
View
@@ -7,9 +7,8 @@ config/auto/m4 - Check whether GNU m4 works
=head1 DESCRIPTION
-Determines whether GNU m4 exists on the system.
-It is OK when it doesn't exist. Currently GNU m4 is only used for doublechecking
-Parrot m4.
+Determines whether GNU m4 exists on the system. It is OK when it doesn't exist.
+Currently GNU m4 is only used for doublechecking Parrot m4.
=cut
@@ -7,8 +7,7 @@ config/auto/python - Check whether python is there
=head1 DESCRIPTION
-Determines whether python is there.
-Checks also whether we have Python 2.4.
+Determines whether python is there. Checks also whether we have Python 2.4.
=head1 TODO
@@ -7,10 +7,9 @@ config/gen/config_h.pm - Configuration Header
=head1 DESCRIPTION
-Generates F<include/parrot/config.h> with platform-specific
-configuration values, F<include/parrot/has_header.h> with
-platform-specific header information, and
-F<include/parrot/feature.h> with information on optional
+Generates F<include/parrot/config.h> with platform-specific configuration
+values, F<include/parrot/has_header.h> with platform-specific header
+information, and F<include/parrot/feature.h> with information on optional
features.
=cut
@@ -7,8 +7,9 @@ config/gen/config_pm.pm - Record configuration data
=head1 DESCRIPTION
-Writes the C<Parrot::Config> Perl module, the F<runtime/parrot/library/config.fpmc>
-generator program, and the F<myconfig> file.
+Writes the C<Parrot::Config> Perl module, the
+F<runtime/parrot/library/config.fpmc> generator program, and the F<myconfig>
+file.
=cut
@@ -5,8 +5,8 @@ Parrot::Config - Parrot Configuration Data
=head1 DESCRIPTION
This file is generated by F<config/gen/config_pm.pl> from
-F<config/gen/config_pm/Config_pm.in>. It contains the C<%PConfig> hash
-which is exported.
+F<config/gen/config_pm/Config_pm.in>. It contains the C<%PConfig> hash which is
+exported.
=cut
@@ -7,8 +7,7 @@ config/gen/makefiles.pm - Build files
=head1 DESCRIPTION
-Generates the various F<Makefile>s and other files needed to
-build Parrot.
+Generates the various F<Makefile>s and other files needed to build Parrot.
=cut
@@ -3,13 +3,13 @@
=head1 NAME
-tools/build/dynclasses.pl - Build script for dynamic PMCs
+tools/build/dynclasses.pl - Build script for dynamic PMCs
=head1 DESCRIPTION
This file is generated by F<config/gen/makefiles.pl> from
-F<config/gen/makefiles/dynclasses_pl.in>.
-This script is used for building dynamic PMCs.
+F<config/gen/makefiles/dynclasses_pl.in>. This script is used for building
+dynamic PMCs.
=cut
@@ -7,8 +7,8 @@ config/gen/revision.pm - Parrot's configure revision
=head1 DESCRIPTION
-Determines parrot's SVN revision. In a release, there
-are no .svn directories, so this field is empty.
+Determines parrot's SVN revision. In a release, there are no .svn directories,
+so this field is empty.
=cut
@@ -7,8 +7,8 @@ config/init/hints.pm - Platform Hints
=head1 DESCRIPTION
-Loads the platform and local hints files, modifying the defaults set up
-in F<config/init/default.pm>.
+Loads the platform and local hints files, modifying the defaults set up in
+F<config/init/default.pm>.
=cut
@@ -7,12 +7,12 @@ config/init/miniparrot.pm - Miniparrot configuration
=head1 DESCRIPTION
-Modifies settings to match miniparrot (ANSI C Parrot)'s needs. This step primarily
-overwrites a lot of settings in the Configure database to disable JIT and match ANSI
-characteristics.
+Modifies settings to match miniparrot (ANSI C Parrot)'s needs. This step
+primarily overwrites a lot of settings in the Configure database to disable
+JIT and match ANSI characteristics.
-Centralizing these settings will (hopefully) allow for an eventual move away from using
-Configure at all for miniparrot builds.
+Centralizing these settings will (hopefully) allow for an eventual move away
+from using Configure at all for miniparrot builds.
=cut
@@ -7,9 +7,8 @@ config/init/optimize.pm - Optimization
=head1 DESCRIPTION
-Enables optimization by adding the appropriate flags for the local
-platform to the C<CCFLAGS>.
-Should this be part of config/inter/progs.pm ? XXX
+Enables optimization by adding the appropriate flags for the local platform to
+the C<CCFLAGS>. Should this be part of config/inter/progs.pm ? XXX
=cut
@@ -7,9 +7,9 @@ config/inter/progs.pm - C Compiler and Linker
=head1 DESCRIPTION
-Asks the user which compiler, linker, shared library builder, C
-libraries, lexical analyzer generator and parser generator to use. Also
-whether debugging should be enabled.
+Asks the user which compiler, linker, shared library builder, C libraries,
+lexical analyzer generator and parser generator to use. Also whether debugging
+should be enabled.
=cut
@@ -7,13 +7,12 @@ config/inter/shlibs.pm - Flags for shared libraries.
=head1 DESCRIPTION
-Asks the user which flags are needed for compiling position-independent
-code for use in shared libraries. Eventually, other
-shared-library-related prompts may end up here.
+Asks the user which flags are needed for compiling position-independent code
+for use in shared libraries. Eventually, other shared-library-related prompts
+may end up here.
-This is a separate unit from config/inter/progs.pm because the answers
-depend on which compiler is in use. Thus it should come after the
-gccversion test.
+This is a separate unit from config/inter/progs.pm because the answers depend
+on which compiler is in use. Thus it should come after the gccversion test.
=cut
@@ -7,8 +7,8 @@ config/inter/types.pm - Sizes for Parrot Types
=head1 DESCRIPTION
-Asks the user which size integer, floating-point number and opcode types
-should be.
+Asks the user which size integer, floating-point number and opcode types should
+be.
=cut
@@ -155,8 +155,8 @@ Dump config keys.
=item Parrot::Configure::Data->clean()
-Delete keys matching /^TEMP_/ from config. These are used only temporarly
-e.g. as file lists for Makefile generation.
+Delete keys matching /^TEMP_/ from config. These are used only temporarly e.g.
+as file lists for Makefile generation.
=cut
@@ -171,10 +171,10 @@ sub clean
=item Parrot::Configure::Data->settrigger($key, $trigger, $cb)
-Set a callback on C<$key> named C<$trigger>. Multiple triggers can be
-set on a given key. When the key is set via C<set> or C<add> then all
-callbacks that are defined will be called. Triggers are passed the
-key and value that was set after it has been changed.
+Set a callback on C<$key> named C<$trigger>. Multiple triggers can be set on a
+given key. When the key is set via C<set> or C<add> then all callbacks that
+are defined will be called. Triggers are passed the key and value that was set
+after it has been changed.
=cut
Oops, something went wrong.

0 comments on commit 6f5b538

Please sign in to comment.