parallel_tutorial added to git.

This commit is contained in:
Ole Tange 2013-08-17 18:43:30 +02:00
parent 6961852117
commit bcd08d5a2c
10 changed files with 2675 additions and 44 deletions

12
README
View file

@ -44,9 +44,9 @@ document.
Full installation of GNU Parallel is as simple as: Full installation of GNU Parallel is as simple as:
wget http://ftpmirror.gnu.org/parallel/parallel-20130722.tar.bz2 wget http://ftpmirror.gnu.org/parallel/parallel-20130817.tar.bz2
bzip2 -dc parallel-20130722.tar.bz2 | tar xvf - bzip2 -dc parallel-20130817.tar.bz2 | tar xvf -
cd parallel-20130722 cd parallel-20130817
./configure && make && make install ./configure && make && make install
@ -55,9 +55,9 @@ Full installation of GNU Parallel is as simple as:
If you are not root you can add ~/bin to your path and install in If you are not root you can add ~/bin to your path and install in
~/bin and ~/share: ~/bin and ~/share:
wget http://ftpmirror.gnu.org/parallel/parallel-20130722.tar.bz2 wget http://ftpmirror.gnu.org/parallel/parallel-20130817.tar.bz2
bzip2 -dc parallel-20130722.tar.bz2 | tar xvf - bzip2 -dc parallel-20130817.tar.bz2 | tar xvf -
cd parallel-20130722 cd parallel-20130817
./configure --prefix=$HOME && make && make install ./configure --prefix=$HOME && make && make install
Or if your system lacks 'make' you can simply copy src/parallel Or if your system lacks 'make' you can simply copy src/parallel

20
configure vendored
View file

@ -1,6 +1,6 @@
#! /bin/sh #! /bin/sh
# Guess values for system-dependent variables and create Makefiles. # Guess values for system-dependent variables and create Makefiles.
# Generated by GNU Autoconf 2.68 for parallel 20130722. # Generated by GNU Autoconf 2.68 for parallel 20130817.
# #
# Report bugs to <bug-parallel@gnu.org>. # Report bugs to <bug-parallel@gnu.org>.
# #
@ -559,8 +559,8 @@ MAKEFLAGS=
# Identity of this package. # Identity of this package.
PACKAGE_NAME='parallel' PACKAGE_NAME='parallel'
PACKAGE_TARNAME='parallel' PACKAGE_TARNAME='parallel'
PACKAGE_VERSION='20130722' PACKAGE_VERSION='20130817'
PACKAGE_STRING='parallel 20130722' PACKAGE_STRING='parallel 20130817'
PACKAGE_BUGREPORT='bug-parallel@gnu.org' PACKAGE_BUGREPORT='bug-parallel@gnu.org'
PACKAGE_URL='' PACKAGE_URL=''
@ -1176,7 +1176,7 @@ if test "$ac_init_help" = "long"; then
# Omit some internal or obsolete options to make the list less imposing. # Omit some internal or obsolete options to make the list less imposing.
# This message is too long to be a string in the A/UX 3.1 sh. # This message is too long to be a string in the A/UX 3.1 sh.
cat <<_ACEOF cat <<_ACEOF
\`configure' configures parallel 20130722 to adapt to many kinds of systems. \`configure' configures parallel 20130817 to adapt to many kinds of systems.
Usage: $0 [OPTION]... [VAR=VALUE]... Usage: $0 [OPTION]... [VAR=VALUE]...
@ -1242,7 +1242,7 @@ fi
if test -n "$ac_init_help"; then if test -n "$ac_init_help"; then
case $ac_init_help in case $ac_init_help in
short | recursive ) echo "Configuration of parallel 20130722:";; short | recursive ) echo "Configuration of parallel 20130817:";;
esac esac
cat <<\_ACEOF cat <<\_ACEOF
@ -1309,7 +1309,7 @@ fi
test -n "$ac_init_help" && exit $ac_status test -n "$ac_init_help" && exit $ac_status
if $ac_init_version; then if $ac_init_version; then
cat <<\_ACEOF cat <<\_ACEOF
parallel configure 20130722 parallel configure 20130817
generated by GNU Autoconf 2.68 generated by GNU Autoconf 2.68
Copyright (C) 2010 Free Software Foundation, Inc. Copyright (C) 2010 Free Software Foundation, Inc.
@ -1326,7 +1326,7 @@ cat >config.log <<_ACEOF
This file contains any messages produced by compilers while This file contains any messages produced by compilers while
running configure, to aid debugging if configure makes a mistake. running configure, to aid debugging if configure makes a mistake.
It was created by parallel $as_me 20130722, which was It was created by parallel $as_me 20130817, which was
generated by GNU Autoconf 2.68. Invocation command line was generated by GNU Autoconf 2.68. Invocation command line was
$ $0 $@ $ $0 $@
@ -2141,7 +2141,7 @@ fi
# Define the identity of the package. # Define the identity of the package.
PACKAGE='parallel' PACKAGE='parallel'
VERSION='20130722' VERSION='20130817'
cat >>confdefs.h <<_ACEOF cat >>confdefs.h <<_ACEOF
@ -2704,7 +2704,7 @@ cat >>$CONFIG_STATUS <<\_ACEOF || ac_write_fail=1
# report actual input values of CONFIG_FILES etc. instead of their # report actual input values of CONFIG_FILES etc. instead of their
# values after options handling. # values after options handling.
ac_log=" ac_log="
This file was extended by parallel $as_me 20130722, which was This file was extended by parallel $as_me 20130817, which was
generated by GNU Autoconf 2.68. Invocation command line was generated by GNU Autoconf 2.68. Invocation command line was
CONFIG_FILES = $CONFIG_FILES CONFIG_FILES = $CONFIG_FILES
@ -2766,7 +2766,7 @@ _ACEOF
cat >>$CONFIG_STATUS <<_ACEOF || ac_write_fail=1 cat >>$CONFIG_STATUS <<_ACEOF || ac_write_fail=1
ac_cs_config="`$as_echo "$ac_configure_args" | sed 's/^ //; s/[\\""\`\$]/\\\\&/g'`" ac_cs_config="`$as_echo "$ac_configure_args" | sed 's/^ //; s/[\\""\`\$]/\\\\&/g'`"
ac_cs_version="\\ ac_cs_version="\\
parallel config.status 20130722 parallel config.status 20130817
configured by $0, generated by GNU Autoconf 2.68, configured by $0, generated by GNU Autoconf 2.68,
with options \\"\$ac_cs_config\\" with options \\"\$ac_cs_config\\"

View file

@ -1,4 +1,4 @@
AC_INIT([parallel], [20130722], [bug-parallel@gnu.org]) AC_INIT([parallel], [20130817], [bug-parallel@gnu.org])
AM_INIT_AUTOMAKE([-Wall -Werror foreign]) AM_INIT_AUTOMAKE([-Wall -Werror foreign])
AC_CONFIG_HEADERS([config.h]) AC_CONFIG_HEADERS([config.h])
AC_CONFIG_FILES([ AC_CONFIG_FILES([

View file

@ -1,11 +1,15 @@
bin_SCRIPTS = parallel sem sql niceload bin_SCRIPTS = parallel sem sql niceload
man_MANS = parallel.1 sem.1 sql.1 niceload.1 man_MANS = parallel.1 sem.1 sql.1 niceload.1 parallel_tutorial.1
doc_DATA = parallel.html sem.html sql.html niceload.html parallel.texi sem.texi sql.texi niceload.texi doc_DATA = parallel.html sem.html sql.html niceload.html parallel_tutorial.html parallel.texi sem.texi sql.texi niceload.texi parallel_tutorial.texi
parallel.1: parallel.pod Makefile parallel.1: parallel.pod Makefile
pod2man --release='$(PACKAGE_VERSION)' --center='$(PACKAGE_NAME)' \ pod2man --release='$(PACKAGE_VERSION)' --center='$(PACKAGE_NAME)' \
--section=1 $(srcdir)/parallel.pod > $(srcdir)/parallel.1 --section=1 $(srcdir)/parallel.pod > $(srcdir)/parallel.1
parallel_tutorial.1: parallel_tutorial.pod Makefile
pod2man --release='$(PACKAGE_VERSION)' --center='$(PACKAGE_NAME)' \
--section=1 $(srcdir)/parallel_tutorial.pod > $(srcdir)/parallel_tutorial.1
sem.1: sem.pod Makefile sem.1: sem.pod Makefile
pod2man --release='$(PACKAGE_VERSION)' --center='$(PACKAGE_NAME)' \ pod2man --release='$(PACKAGE_VERSION)' --center='$(PACKAGE_NAME)' \
--section=1 $(srcdir)/sem.pod > $(srcdir)/sem.1 --section=1 $(srcdir)/sem.pod > $(srcdir)/sem.1
@ -18,12 +22,13 @@ niceload.1: niceload.pod Makefile
pod2man --release='$(PACKAGE_VERSION)' --center='$(PACKAGE_NAME)' \ pod2man --release='$(PACKAGE_VERSION)' --center='$(PACKAGE_NAME)' \
--section=1 $(srcdir)/niceload.pod > $(srcdir)/niceload.1 --section=1 $(srcdir)/niceload.pod > $(srcdir)/niceload.1
parallel.html: parallel.pod Makefile # Depending on parallel.html to avoid stupid pod2html race condition
pod2html $(srcdir)/parallel.pod > $(srcdir)/parallel.html parallel_tutorial.html: parallel_tutorial.pod Makefile parallel.html
pod2html $(srcdir)/parallel_tutorial.pod > $(srcdir)/parallel_tutorial.html
rm -f $(srcdir)/pod2htm* rm -f $(srcdir)/pod2htm*
# Depending on parallel.html to avoid stupid pod2html race condition # Depending on parallel_tutorial.html to avoid stupid pod2html race condition
sem.html: sem.pod Makefile parallel.html sem.html: sem.pod Makefile parallel_tutorial.html
pod2html $(srcdir)/sem.pod > $(srcdir)/sem.html pod2html $(srcdir)/sem.pod > $(srcdir)/sem.html
rm -f $(srcdir)/pod2htm* rm -f $(srcdir)/pod2htm*
@ -41,6 +46,10 @@ parallel.texi: parallel.pod
# If pod2texi is not installed: Forget about it # If pod2texi is not installed: Forget about it
pod2texi --output=$(srcdir)/parallel.texi $(srcdir)/parallel.pod || true pod2texi --output=$(srcdir)/parallel.texi $(srcdir)/parallel.pod || true
parallel_tutorial.texi: parallel_tutorial.pod
# If pod2texi is not installed: Forget about it
pod2texi --output=$(srcdir)/parallel_tutorial.texi $(srcdir)/parallel_tutorial.pod || true
sem.texi: sem.pod sem.texi: sem.pod
# If pod2texi is not installed: Forget about it # If pod2texi is not installed: Forget about it
pod2texi --output=$(srcdir)/sem.texi $(srcdir)/sem.pod || true pod2texi --output=$(srcdir)/sem.texi $(srcdir)/sem.pod || true
@ -56,9 +65,9 @@ niceload.texi: niceload.pod
sem: parallel sem: parallel
ln -fs parallel sem ln -fs parallel sem
DISTCLEANFILES = parallel.html sem.html sql.html niceload.html DISTCLEANFILES = parallel.html sem.html sql.html niceload.html parallel_tutorial.html
EXTRA_DIST = parallel sem sql niceload \ EXTRA_DIST = parallel sem sql niceload \
parallel.1 sem.1 sql.1 niceload.1 \ parallel.1 sem.1 sql.1 niceload.1 parallel_tutorial.1 \
parallel.html sem.html sql.html niceload.html \ parallel.html sem.html sql.html niceload.html parallel_tutorial.1 \
sem.pod parallel.pod niceload.pod \ sem.pod parallel.pod niceload.pod parallel_tutorial.pod \
parallel.texi sem.texi sql.texi niceload.texi parallel.texi sem.texi sql.texi niceload.texi parallel_tutorial.texi

View file

@ -175,14 +175,14 @@ top_build_prefix = @top_build_prefix@
top_builddir = @top_builddir@ top_builddir = @top_builddir@
top_srcdir = @top_srcdir@ top_srcdir = @top_srcdir@
bin_SCRIPTS = parallel sem sql niceload bin_SCRIPTS = parallel sem sql niceload
man_MANS = parallel.1 sem.1 sql.1 niceload.1 man_MANS = parallel.1 sem.1 sql.1 niceload.1 parallel_tutorial.1
doc_DATA = parallel.html sem.html sql.html niceload.html parallel.texi sem.texi sql.texi niceload.texi doc_DATA = parallel.html sem.html sql.html niceload.html parallel_tutorial.html parallel.texi sem.texi sql.texi niceload.texi parallel_tutorial.texi
DISTCLEANFILES = parallel.html sem.html sql.html niceload.html DISTCLEANFILES = parallel.html sem.html sql.html niceload.html parallel_tutorial.html
EXTRA_DIST = parallel sem sql niceload \ EXTRA_DIST = parallel sem sql niceload \
parallel.1 sem.1 sql.1 niceload.1 \ parallel.1 sem.1 sql.1 niceload.1 parallel_tutorial.1 \
parallel.html sem.html sql.html niceload.html \ parallel.html sem.html sql.html niceload.html parallel_tutorial.1 \
sem.pod parallel.pod niceload.pod \ sem.pod parallel.pod niceload.pod parallel_tutorial.pod \
parallel.texi sem.texi sql.texi niceload.texi parallel.texi sem.texi sql.texi niceload.texi parallel_tutorial.texi
all: all-am all: all-am
@ -492,6 +492,10 @@ parallel.1: parallel.pod Makefile
pod2man --release='$(PACKAGE_VERSION)' --center='$(PACKAGE_NAME)' \ pod2man --release='$(PACKAGE_VERSION)' --center='$(PACKAGE_NAME)' \
--section=1 $(srcdir)/parallel.pod > $(srcdir)/parallel.1 --section=1 $(srcdir)/parallel.pod > $(srcdir)/parallel.1
parallel_tutorial.1: parallel_tutorial.pod Makefile
pod2man --release='$(PACKAGE_VERSION)' --center='$(PACKAGE_NAME)' \
--section=1 $(srcdir)/parallel_tutorial.pod > $(srcdir)/parallel_tutorial.1
sem.1: sem.pod Makefile sem.1: sem.pod Makefile
pod2man --release='$(PACKAGE_VERSION)' --center='$(PACKAGE_NAME)' \ pod2man --release='$(PACKAGE_VERSION)' --center='$(PACKAGE_NAME)' \
--section=1 $(srcdir)/sem.pod > $(srcdir)/sem.1 --section=1 $(srcdir)/sem.pod > $(srcdir)/sem.1
@ -504,12 +508,13 @@ niceload.1: niceload.pod Makefile
pod2man --release='$(PACKAGE_VERSION)' --center='$(PACKAGE_NAME)' \ pod2man --release='$(PACKAGE_VERSION)' --center='$(PACKAGE_NAME)' \
--section=1 $(srcdir)/niceload.pod > $(srcdir)/niceload.1 --section=1 $(srcdir)/niceload.pod > $(srcdir)/niceload.1
parallel.html: parallel.pod Makefile # Depending on parallel.html to avoid stupid pod2html race condition
pod2html $(srcdir)/parallel.pod > $(srcdir)/parallel.html parallel_tutorial.html: parallel_tutorial.pod Makefile parallel.html
pod2html $(srcdir)/parallel_tutorial.pod > $(srcdir)/parallel_tutorial.html
rm -f $(srcdir)/pod2htm* rm -f $(srcdir)/pod2htm*
# Depending on parallel.html to avoid stupid pod2html race condition # Depending on parallel_tutorial.html to avoid stupid pod2html race condition
sem.html: sem.pod Makefile parallel.html sem.html: sem.pod Makefile parallel_tutorial.html
pod2html $(srcdir)/sem.pod > $(srcdir)/sem.html pod2html $(srcdir)/sem.pod > $(srcdir)/sem.html
rm -f $(srcdir)/pod2htm* rm -f $(srcdir)/pod2htm*
@ -527,6 +532,10 @@ parallel.texi: parallel.pod
# If pod2texi is not installed: Forget about it # If pod2texi is not installed: Forget about it
pod2texi --output=$(srcdir)/parallel.texi $(srcdir)/parallel.pod || true pod2texi --output=$(srcdir)/parallel.texi $(srcdir)/parallel.pod || true
parallel_tutorial.texi: parallel_tutorial.pod
# If pod2texi is not installed: Forget about it
pod2texi --output=$(srcdir)/parallel_tutorial.texi $(srcdir)/parallel_tutorial.pod || true
sem.texi: sem.pod sem.texi: sem.pod
# If pod2texi is not installed: Forget about it # If pod2texi is not installed: Forget about it
pod2texi --output=$(srcdir)/sem.texi $(srcdir)/sem.pod || true pod2texi --output=$(srcdir)/sem.texi $(srcdir)/sem.pod || true

View file

@ -24,7 +24,7 @@
use strict; use strict;
use Getopt::Long; use Getopt::Long;
$Global::progname="niceload"; $Global::progname="niceload";
$Global::version = 20130722; $Global::version = 20130817;
Getopt::Long::Configure("bundling","require_order"); Getopt::Long::Configure("bundling","require_order");
get_options_from_array(\@ARGV) || die_usage(); get_options_from_array(\@ARGV) || die_usage();
if($opt::version) { if($opt::version) {

View file

@ -731,7 +731,7 @@ sub get_options_from_array {
sub parse_options { sub parse_options {
# Returns: N/A # Returns: N/A
# Defaults: # Defaults:
$Global::version = 20130816; $Global::version = 20130817;
$Global::progname = 'parallel'; $Global::progname = 'parallel';
$Global::infinity = 2**31; $Global::infinity = 2**31;
$Global::debug = 0; $Global::debug = 0;

2613
src/parallel_tutorial.1 Normal file

File diff suppressed because it is too large Load diff

View file

@ -120,8 +120,8 @@
<p>This tutorial shows off much of GNU Parallel's functionality. The <p>This tutorial shows off much of GNU Parallel's functionality. The
tutorial is meant to learn the options in GNU Parallel. The tutorial tutorial is meant to learn the options in GNU Parallel. The tutorial
is not to show realistic examples from the real world.</p> is not to show realistic examples from the real world.</p>
<p>Spend XX minutes on walking through the tutorial. Your commandline <p>Spend an hour on walking through the tutorial. Your commandline will
will love you for it.</p> love you for it.</p>
<p> <p>
</p> </p>
<hr /> <hr />

View file

@ -556,7 +556,7 @@ $Global::Initfile && unlink $Global::Initfile;
exit ($err); exit ($err);
sub parse_options { sub parse_options {
$Global::version = 20130722; $Global::version = 20130817;
$Global::progname = 'sql'; $Global::progname = 'sql';
# This must be done first as this may exec myself # This must be done first as this may exec myself