Issue 7411 - ldap_get_option.3: Warning from "groff" about a tab in the manual
Summary: ldap_get_option.3: Warning from "groff" about a tab in the manual
Status: VERIFIED FIXED
Alias: None
Product: OpenLDAP
Classification: Unclassified
Component: documentation (show other issues)
Version: 2.4.32
Hardware: All All
: --- normal
Target Milestone: ---
Assignee: OpenLDAP project
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2012-10-10 20:13 UTC by bjarniig@rhi.hi.is
Modified: 2014-08-01 21:04 UTC (History)
0 users

See Also:


Attachments

Note You need to log in before you can comment on or make changes to this issue.
Description bjarniig@rhi.hi.is 2012-10-10 20:13:48 UTC
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

Comment 1 Howard Chu 2012-10-11 15:38:33 UTC
changed notes
changed state Open to Test
moved from Incoming to Documentation
Comment 2 Quanah Gibson-Mount 2012-10-12 18:52:25 UTC
changed notes
changed state Test to Release
Comment 3 Quanah Gibson-Mount 2013-03-05 02:18:04 UTC
changed notes
changed state Release to Closed
Comment 4 OpenLDAP project 2014-08-01 21:04:12 UTC
fixed in master
fixed in RE24