[Date Prev][Date Next] [Chronological] [Thread] [Top]

(ITS#7411) ldap_get_option.3: Warning from "groff" about a tab in the manual



Full_Name: Bjarni Ingi Gislason
Version: 2.4.32
OS: GNU/Linux
URL: 
Submission from: (NULL) (130.208.164.54)


Software: openldap
Version: 2.4.32
File: doc/man/ldap_get_option.3
Patch: Yes

  From "groff -b -ww -z -mandoc ldap_get_option.3":

groff: ldap_get_option.3: stdin:456: warning: tab character in unquoted macro
argument

#
  Output from "nroff" should (usually) have only the left margin adjusted
(".ad l").  Otherwise the space between words can be too long.

  Output for a manual should (usually) have the right margin ragged
(".ad l"), as it is not (usually) intended for a book or other professional
printing medium.
#
#
  Each sentence should begin in a new line.

a) The space between sentences is different between formatters.

b) Changes in one line do then not affect others, and do therefore not
appear as changed in the output of "diff".

#
  Sometimes a small change in space between a roman and an italic
character is needed (use ".RI" or ".IR" macros).

#
  Remove spaces at end of lines.

#

  Patch:

--- ldap_get_option.3   2012-07-31 16:39:26.000000000 +0000
+++ /tmp/ldap_get_option.3.new  2012-10-09 21:27:10.240593613 +0000
@@ -453,7 +453,7 @@
 .BR "char ***" .
 The caller must not free or otherwise muck with it.
 .TP
-.B LDAP_OPT_X_SASL_NOCANON
+.B LDAP_OPT_X_SASL_NOCANON
 Sets/gets the NOCANON flag.
 When unset, the hostname is canonicalized.
 .BR invalue