Date: Mon, 3 Mar 2014 07:02:46 +0000 (UTC) From: Sunpoet Po-Chuan Hsieh <sunpoet@FreeBSD.org> To: ports-committers@freebsd.org, svn-ports-all@freebsd.org, svn-ports-head@freebsd.org Subject: svn commit: r346858 - in head/sysutils/moreutils-parallel: . files Message-ID: <201403030702.s2372koI069324@svn.freebsd.org>
next in thread | raw e-mail | index | archive | help
Author: sunpoet Date: Mon Mar 3 07:02:46 2014 New Revision: 346858 URL: http://svnweb.freebsd.org/changeset/ports/346858 QAT: https://qat.redports.org/buildarchive/r346858/ Log: - Update manpage - Bump PORTREVISION for package change Submitted by: sunpoet (myself) Approved by: eadler (maintainer) Modified: head/sysutils/moreutils-parallel/Makefile head/sysutils/moreutils-parallel/files/parallel.1 Modified: head/sysutils/moreutils-parallel/Makefile ============================================================================== --- head/sysutils/moreutils-parallel/Makefile Mon Mar 3 05:43:38 2014 (r346857) +++ head/sysutils/moreutils-parallel/Makefile Mon Mar 3 07:02:46 2014 (r346858) @@ -3,6 +3,7 @@ PORTNAME= moreutils-parallel PORTVERSION= 0.51 +PORTREVISION= 1 CATEGORIES= sysutils MASTER_SITES= DEBIAN MASTER_SITE_SUBDIR= pool/main/m/moreutils Modified: head/sysutils/moreutils-parallel/files/parallel.1 ============================================================================== --- head/sysutils/moreutils-parallel/files/parallel.1 Mon Mar 3 05:43:38 2014 (r346857) +++ head/sysutils/moreutils-parallel/files/parallel.1 Mon Mar 3 07:02:46 2014 (r346858) @@ -1,107 +1,84 @@ -.\" -*- coding: us-ascii -*- -.if \n(.g .ds T< \\FC -.if \n(.g .ds T> \\F[\n[.fam]] -.de URL -\\$2 \(la\\$1\(ra\\$3 -.. -.if \n(.g .mso www.tmac -.TH parallel 1 2009-07-02 "" "" -.SH NAME -parallel \- run programs in parallel -.SH SYNOPSIS -'nh -.fi -.ad l -\fBparallel\fR \kx -.if (\nx>(\n(.l/2)) .nr x (\n(.l/5) -'in \n(.iu+\nxu -[options] [command] \fB--\fR [argument ...] -'in \n(.iu-\nxu -.ad b -'hy -'nh -.fi +'\" t +.\" Title: parallel +.\" Author: Joey Hess +.\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>; +.\" Date: 2009-07-02 +.\" Manual: moreutils +.\" Source: moreutils +.\" Language: English +.\" +.TH "PARALLEL" "1" "2009\-07\-02" "moreutils" "moreutils" +.\" ----------------------------------------------------------------- +.\" * Define some portability stuff +.\" ----------------------------------------------------------------- +.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +.\" http://bugs.debian.org/507673 +.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html +.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +.ie \n(.g .ds Aq \(aq +.el .ds Aq ' +.\" ----------------------------------------------------------------- +.\" * set default formatting +.\" ----------------------------------------------------------------- +.\" disable hyphenation +.nh +.\" disable justification (adjust text to left margin only) .ad l -\fBparallel\fR \kx -.if (\nx>(\n(.l/2)) .nr x (\n(.l/5) -'in \n(.iu+\nxu -[options] \fB--\fR [command ...] -'in \n(.iu-\nxu -.ad b -'hy -.SH DESCRIPTION -\fBparallel\fR runs the specified command, -passing it a single one of the specified arguments. This is -repeated for each argument. Jobs may be run in -parallel. The default is to run one job per CPU. -.PP -If no command is specified before the --, -the commands after it are instead run in parallel. -.SH OPTIONS -.TP -\*(T<\fB\-j maxjobs\fR\*(T> -Use to limit the number of jobs -that are run at the same time. -.TP -\*(T<\fB\-l maxload\fR\*(T> -Wait as needed to avoid starting -new jobs when the system's load average -is not below the specified limit. -.TP -\*(T<\fB\-i\fR\*(T> -Normally the command is passed the -argument at the end of its command line. With -this option, any instances of "{}" in -the command are replaced with the argument. -.TP -\*(T<\fB\-n\fR\*(T> -Number of arguments to pass to a -command at a time. Default is 1. -Incompatible with -i -.SH EXAMPLE -'nh -.fi -.ad l -\fBparallel sh -c "echo hi; sleep 2; echo bye" -- 1 2 3\fR \kx -.if (\nx>(\n(.l/2)) .nr x (\n(.l/5) -'in \n(.iu+\nxu -'in \n(.iu-\nxu -.ad b -'hy -.PP -This runs three subshells that each print a message, delay, -and print another message. If your system has multiple -CPUs, parallel will run some of the jobs in parallel, -which should be clear from the order the messages are -output. +.\" ----------------------------------------------------------------- +.\" * MAIN CONTENT STARTS HERE * +.\" ----------------------------------------------------------------- +.SH "NAME" +parallel \- run programs in parallel +.SH "SYNOPSIS" +.HP \w'\fBparallel\fR\fB\-\-\fR\ 'u +\fBparallel\fR [options] [command]\fB\-\-\fR [argument\ \&.\&.\&.] +.HP \w'\fBparallel\fR\fB\-\-\fR\ 'u +\fBparallel\fR [options]\fB\-\-\fR [command\ \&.\&.\&.] +.SH "DESCRIPTION" .PP -'nh -.fi -.ad l -\fBparallel -j 3 ufraw -o processed -- *.NEF\fR \kx -.if (\nx>(\n(.l/2)) .nr x (\n(.l/5) -'in \n(.iu+\nxu -'in \n(.iu-\nxu -.ad b -'hy +\fBparallel\fR +runs the specified command, passing it a single one of the specified arguments\&. This is repeated for each argument\&. Jobs may be run in parallel\&. The default is to run one job per CPU\&. .PP -This runs three ufraw processes at the same time until -all of the NEF files have been processed. +If no command is specified before the \-\-, the commands after it are instead run in parallel\&. +.SH "OPTIONS" .PP -'nh -.fi -.ad l -\fBparallel -j 3 -- ls df "echo hi"\fR \kx -.if (\nx>(\n(.l/2)) .nr x (\n(.l/5) -'in \n(.iu+\nxu -'in \n(.iu-\nxu -.ad b -'hy +\fB\-j maxjobs\fR +.RS 4 +Use to limit the number of jobs that are run at the same time\&. +.RE +.PP +\fB\-l maxload\fR +.RS 4 +Wait as needed to avoid starting new jobs when the system\*(Aqs load average is not below the specified limit\&. +.RE +.PP +\fB\-i\fR +.RS 4 +Normally the command is passed the argument at the end of its command line\&. With this option, any instances of "{}" in the command are replaced with the argument\&. +.RE .PP -This runs three independent commands in parallel. +\fB\-n\fR +.RS 4 +Number of arguments to pass to a command at a time\&. Default is 1\&. Incompatible with \-i +.RE +.SH "EXAMPLE" +.PP +.HP \w'\fBparallel\ sh\ \-c\ "echo\ hi;\ sleep\ 2;\ echo\ bye"\ \-\-\ 1\ 2\ 3\fR\ 'u \fBparallel sh \-c "echo hi; sleep 2; echo bye" \-\- 1 2 3\fR +.PP +This runs three subshells that each print a message, delay, and print another message\&. If your system has multiple CPUs, parallel will run some of the jobs in parallel, which should be clear from the order the messages are output\&. +.PP +.HP \w'\fBparallel\ \-j\ 3\ ufraw\ \-o\ processed\ \-\-\ *\&.NEF\fR\ 'u \fBparallel \-j 3 ufraw \-o processed \-\- *\&.NEF\fR +.PP +This runs three ufraw processes at the same time until all of the NEF files have been processed\&. +.PP +.HP \w'\fBparallel\ \-j\ 3\ \-\-\ ls\ df\ "echo\ hi"\fR\ 'u \fBparallel \-j 3 \-\- ls df "echo hi"\fR +.PP +This runs three independent commands in parallel\&. .SH "EXIT STATUS" -Its exit status is the combination of the exit statuses of each -command ran, ORed together. (Thus, if any one command -exits nonzero, \fBparallel\fR as a whole will exit nonzero.) -.SH AUTHOR +.PP +Its exit status is the combination of the exit statuses of each command ran, ORed together\&. (Thus, if any one command exits nonzero, +\fBparallel\fR +as a whole will exit nonzero\&.) +.SH "AUTHOR" +.PP Tollef Fog Heen
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201403030702.s2372koI069324>