summaryrefslogtreecommitdiff
path: root/textproc/par/DESCR
diff options
context:
space:
mode:
Diffstat (limited to 'textproc/par/DESCR')
-rw-r--r--textproc/par/DESCR19
1 files changed, 19 insertions, 0 deletions
diff --git a/textproc/par/DESCR b/textproc/par/DESCR
new file mode 100644
index 00000000000..98b0e2236d5
--- /dev/null
+++ b/textproc/par/DESCR
@@ -0,0 +1,19 @@
+ Par is a filter which copies its input to its output, changing all
+ white characters (except newlines) to spaces, and reformatting
+ each paragraph. Paragraphs are separated by protected, blank, and
+ bodiless lines (see the Terminology section for definitions), and
+ optionally delimited by indentation (see the d option in the Options
+ section).
+
+ Each output paragraph is generated from the corresponding input
+ paragraph as follows:
+
+ 1) An optional prefix and/or suffix is removed from each input
+ line.
+ 2) The remainder is divided into words (separated by spaces).
+ 3) The words are joined into lines to make an eye-pleasing
+ paragraph.
+ 4) The prefixes and suffixes are reattached.
+
+ If there are suffixes, spaces are inserted before them so that they
+ all end in the same column.