Add option to disable justification (Debian bug #440047).

* src/man.c (options, parse_opt): Accept --no-justification. Reset
  corresponding variable with -D.
  (disable_justification): New function.
  (display): Append disable_justification to the decompressor
  pipeline if --no-justification is used.
* man/man1/man.man1 (SYNOPSIS, Controlling formatted output):
  Document --no-justification.
* NEWS: Document this.

1 files changed, 15 insertions, 0 deletions

diff --git a/man/man1/man.man1 b/man/man1/man.man1
index 1b6bb7fd..24cb9e17 100644
--- a/man/man1/man.man1
+++ b/man/man1/man.man1
@@ -50,6 +50,7 @@
 .RB [\| \-E
 .IR encoding \|]
 .RB [\| \-\-no\-hyphenation \|]
+.RB [\| \-\-no\-justification \|]
 .RB [\| \-p
 .IR string \|]
 .RB [\| \-t \|]
@@ -1006,6 +1007,20 @@ documentation instead; for instance, you can put "\e%" inside a word to
 indicate that it may be hyphenated at that point, or put "\e%" at the start
 of a word to prevent it from being hyphenated.
 .TP
+.if !'po4a'hide' .B \-\-no\-justification
+Normally,
+.B nroff
+will automatically justify text to both margins.
+This option disables full justification, leaving justified only to the left
+margin, sometimes called "ragged-right" text.
+
+If you are writing a manual page and simply want to prevent
+.B nroff
+from justifying certain paragraphs, do not use this option, but consult the
+.B nroff
+documentation instead; for instance, you can use the ".na", ".nf", ".fi",
+and ".ad" requests to temporarily disable adjusting and filling.
+.TP
 .BI \-p\  string ,\ \-\-preprocessor= string
 Specify the sequence of preprocessors to run before
 .B nroff