Brief re-work and FAQ import.

diff --git a/doc/guide/admin/aspell.en.pws b/doc/guide/admin/aspell.en.pws
index 4b03e178e8f9d90a8ebf59ab634f8db5cce436f4..40ac78d6224bbeadc05f3ae1b6d7a2a4e3f285cd 100644 (file)
--- a/doc/guide/admin/aspell.en.pws
+++ b/doc/guide/admin/aspell.en.pws
@@ -1,4 +1,4 @@
-personal_ws-1.1 en 1419 
+personal_ws-1.1 en 1425 
 nattrsets
 inappropriateAuthentication
 api
@@ -8,8 +8,8 @@ reqEnd
 olcOverlayConfig
 shoesize
 olcTLSCACertificateFile
-CGI
 cdx
+CGI
 DCE
 DAP
 attributename
@@ -20,8 +20,8 @@ kurt
 authzID
 authzid
 authzId
-DAs
 ddd
+DAs
 userApplications
 BNF
 attrs
@@ -32,8 +32,8 @@ ldapport
 hallvard
 ASN
 acknowledgements
-Chu
 ava
+Chu
 monitorCounter
 del
 DDR
@@ -84,13 +84,13 @@ olcModulePath
 maxentries
 authc
 seeAlso
-searchbase
 searchBase
+searchbase
 realnamingcontext
-dn's
-DNs
-DN's
 dns
+DN's
+DNs
+dn's
 dereference
 sortKey
 authzTo
@@ -155,8 +155,8 @@ INADDR
 compareDN
 sizelimit
 unixODBC
-APIs
 blen
+APIs
 attrsOnly
 attrsonly
 slappasswd
@@ -192,8 +192,8 @@ basedn
 argv
 gss
 schemachecking
-whoami
 WhoAmI
+whoami
 syslogd
 dataflow
 subentries
@@ -234,8 +234,8 @@ pwdExpireWarning
 localstatedir
 sockbuf
 PENs
-ipv
 IPv
+ipv
 ghenry
 hyc
 multimaster
@@ -268,8 +268,8 @@ intermediateResponse
 myOID
 structuralObjectClass
 integerMatch
-openldap
 OpenLDAP
+openldap
 moddn
 rewriteEngine
 AVAs
@@ -288,8 +288,8 @@ bool
 logins
 jts
 memberAttr
-newpasswdfile
 newPasswdFile
+newpasswdfile
 ucdata
 LLL
 confdir
@@ -316,8 +316,8 @@ caseExactMatch
 olcSizeLimit
 Bourne
 attr
-objectidentifier
 objectIdentifier
+objectidentifier
 refint
 msgtype
 OBJEXT
@@ -367,8 +367,8 @@ Autoconf
 alloc
 PDU
 OLF
-inetorgperson
 inetOrgPerson
+inetorgperson
 deleteoldrdn
 monitorCounterObject
 pid
@@ -427,9 +427,9 @@ OTP
 entrylimit
 attrdescN
 logold
-pos
-sbi
 PRD
+sbi
+pos
 reqEntries
 pre
 bvals
@@ -455,8 +455,8 @@ telephonenumber
 telephoneNumber
 DLDAP
 peernamestyle
-Sep
 SHA
+Sep
 filename
 rpath
 argsfile
@@ -483,10 +483,11 @@ typedef
 olcDbIDLcacheSize
 ostring
 mwrscdx
-SMD
 UCD
+SMD
 cancelled
 crit
+organizationalUnit
 lucyB
 slp
 rdns
@@ -495,8 +496,8 @@ TGT
 modulepath
 quickstart
 mySNMP
-tgz
 UDP
+tgz
 RDBMs
 rdbms
 Matic
@@ -515,9 +516,9 @@ olcDbConfig
 refreshDone
 ssf
 replogfile
-rwm
-TOC
 vec
+TOC
+rwm
 LDAPDN
 compareAttrDN
 endmacro
@@ -525,15 +526,15 @@ tls
 repl
 monitoringslapd
 referralsp
-tmp
 SRP
+tmp
 olcDbNosync
 conns
 SSL
 PDkzODdASFxOQ
 SRV
-rwx
 sss
+rwx
 deallocators
 Contribware
 URLlist
@@ -648,14 +649,15 @@ groupstyle
 ldapsearch
 cp
 displayName
-eg
 bv
+eg
 olcBackendConfig
-dn
 fd
+dn
 LDAPSync
 olcReplicationInterval
 fG
+gidNumber
 fi
 eq
 FIPS
@@ -735,8 +737,8 @@ sn
 ru
 UG
 ss
-su
 TP
+su
 reqMethod
 XLIBS
 PhotoObject
@@ -753,8 +755,8 @@ xf
 param
 MChAODQ
 caseExactIA
-Vu
 Za
+Vu
 idlecachesize
 ws
 errSleepTime
@@ -776,8 +778,8 @@ ZZ
 entryCSNs
 dlopen
 continuated
-newsuperior
 newSuperior
+newsuperior
 Preprocessor
 XXLIBS
 deallocate
@@ -829,6 +831,7 @@ contrib
 FQDNs
 bjorn
 myLDAP
+peercred
 SNMP
 myObjectClass
 thru
@@ -848,6 +851,7 @@ ldapbis
 attributeoptions
 serverID
 memberof
+memberOf
 pseudorootpw
 CFLAGS
 substr
@@ -864,8 +868,8 @@ modifyAttrDN
 dcedn
 olcOverlay
 exop
-berelement
 BerElement
+berelement
 olcRootDN
 octetString
 SampleLDAP
@@ -874,8 +878,8 @@ PostgreSQL
 bvstr
 filesystem
 pathtest
-objectClass
 objectclass
+objectClass
 submatches
 newrdn
 armijo
@@ -889,8 +893,8 @@ modifyDN
 syncuser
 Masarati
 LDAPSyntax
-oldpasswdfile
 oldPasswdFile
+oldpasswdfile
 reqDN
 SSFs
 ietf
@@ -913,8 +917,8 @@ reqId
 setspec
 scanf
 TLSv
-distinguishedname
 distinguishedName
+distinguishedname
 BerVarray
 caseIgnoreSubstrin
 ldapwhoami
@@ -942,8 +946,8 @@ slaptest
 zeilenga
 WebUpdate
 numericoid
-changelog
 ChangeLog
+changelog
 creatorsName
 ascii
 wahl
@@ -967,14 +971,15 @@ rootDSE
 dsaparam
 cachefree
 UMich's
+uidNumber
 schemadir
 attribute's
 extern
 varchar
-olcDbCacheSize
 olcDbCachesize
-authcid
+olcDbCacheSize
 authcID
+authcid
 POSIX
 hnPk
 ldapext
@@ -993,8 +998,8 @@ reqStart
 sasldb
 somevalue
 LIBRELEASE
-starttls
 StartTLS
+starttls
 LDAPSchemaExtensionItem
 reqReferral
 shtool
@@ -1005,8 +1010,8 @@ portnumber
 subjectAltName
 errObject
 valsort
-bervals
 berval's
+bervals
 derefFindingBaseObj
 checkpointed
 keytab
@@ -1027,8 +1032,8 @@ README
 memcalloc
 inet
 saslargs
-givenname
 givenName
+givenname
 olcDbMode
 pidfile
 olcLimits
@@ -1036,8 +1041,8 @@ memvfree
 tuple
 superset
 directoryString
-proxyTemplate
 proxytemplate
+proxyTemplate
 wildcards
 monitoredObject
 TTLs
@@ -1050,8 +1055,8 @@ bvalues
 reqResult
 impl
 outvalue
-returnCode
 returncode
+returnCode
 attributeDescription
 attrval
 dnssrv
@@ -1074,20 +1079,20 @@ uncached
 ldapapiinfo
 groupOfUniqueNames
 dhparam
-slapd's
 slapds
+slapd's
 inputfile
 RDBMSes
 wildcard
 Locator
-errAbsObject
 errABsObject
+errAbsObject
 SASL's
 html
 searchResultDone
 olcBdbConfig
-ldapmod
 LDAPMod
+ldapmod
 olcHidden
 userPassword
 TLSRandFile
@@ -1115,10 +1120,10 @@ cacertdir
 queryid
 Warper
 XDEFS
-urls
 URL's
-postalAddress
+urls
 postaladdress
+postalAddress
 passwd
 plugins
 george
@@ -1132,16 +1137,16 @@ ursula
 LDAPModifying
 slapdconfig
 dnSubtreeMatch
-olcSaslSecProps
 olcSaslSecprops
+olcSaslSecProps
 auditModify
 groupOfNames
 jensen
 reloadHint
 prepending
 olcGlobal
-matchingRule
 matchingrule
+matchingRule
 SmVuc
 MSSQL
 hostnames
@@ -1155,9 +1160,9 @@ whsp
 realusers
 dnstyle
 suffixalias
-proxyAttrset
-proxyAttrSet
 proxyattrset
+proxyAttrSet
+proxyAttrset
 pwdMustChange
 ldif
 bvfree
@@ -1168,8 +1173,8 @@ pwdAttribute
 PRNGD
 LDAPRDN
 entryUUIDs
-proxycache
 proxyCache
+proxycache
 SERATGCgaGBYWGDEjJR
 noanonymous
 accessee
@@ -1222,8 +1227,8 @@ passwdfile
 errMatchedDN
 everytime
 mkdep
-olcDbindex
 olcDbIndex
+olcDbindex
 syntaxOID
 reqData
 databasetype
@@ -1271,8 +1276,8 @@ bitstring
 ACLs
 berptr
 olcModuleLoad
-attributetype
 attributeType
+attributetype
 auditModRDN
 cacert
 freebuf
@@ -1323,23 +1328,23 @@ preallocated
 syntaxes
 memberURL
 monitorRuntimeConfig
-bindDn
-bindDN
 binddn
+bindDN
+bindDn
 methodp
 timelimitExceeded
 pwdInHistory
 LTSTATIC
-requestors
 requestor's
+requestors
 LDAPCONF
 saslauthd
 MKDEPFLAG
 gecos
 entryUUID
-gnutls
-GNUtls
 GnuTLS
+GNUtls
+gnutls
 postread
 timeval
 DHAVE
@@ -1360,8 +1365,8 @@ entryTtl
 LDAPControl
 pwdMinLength
 ldapcompare
-readonly
 readOnly
+readonly
 RANDFILE
 attrlist
 aci
@@ -1385,8 +1390,8 @@ userid
 Kumar
 AES
 bdb
-manageDSAit
 ManageDsaIT
+manageDSAit
 bindpw
 monitorContainer
 pEntry
@@ -1397,8 +1402,9 @@ objectIdentifierMatch
 Blowfish
 mkln
 numericStringSubstringsMatch
-openssl
+testgroup
 OpenSSL
+openssl
 ModName
 cacheable
 freeit
@@ -1407,8 +1413,8 @@ ber
 ali
 mandir
 changetype
-CAs
 CA's
+CAs
 typeA
 bvecfree
 ODBC

diff --git a/doc/guide/admin/troubleshooting.sdf b/doc/guide/admin/troubleshooting.sdf
index 7c80f55e5bc54b46ee8565e1b00e0efd9e61b788..43d77c3d89e14249a5d573ae3db69a7673032a4f 100644 (file)
--- a/doc/guide/admin/troubleshooting.sdf
+++ b/doc/guide/admin/troubleshooting.sdf
@@ -5,9 +5,11 @@
 H1: Troubleshooting
 
 If you're having trouble using OpenLDAP, get onto the
-OpenLDAP-Software mailing list. 
+OpenLDAP-Software mailing list, or:
 
-Browse the list archives at {{URL:http://www.openldap.org/lists/}} 
+* Browse the list archives at {{URL:http://www.openldap.org/lists/#archives}} 
+* Search the FAQ at {{URL:http://www.openldap.org/faq/}}
+* Search the Issue Tracking System at {{URL:http://www.openldap.org/its/}}
 
 Chances are the problem has been solved and explained in detail many times before.
 
@@ -16,13 +18,6 @@ H2: User or Software errors?
 More often than not, an error is caused by a configuration problem or a misunderstanding
 of what you are trying to implement and/or achieve. 
 
-Sometimes you may encounter an actual OpenLDAP bug, in which case please visit 
-our Issue Tracking system {{URL:http://www.openldap.org/its/}} and report it there, 
-providing as much information as possible.
-
-Note: Our Issue Tracking system is {{B:NOT}} for OpenLDAP {{B:Support}}, please join our
-mailing Lists: {{URL:http://www.openldap.org/lists/}} for that
-
 We will now attempt to discuss common user errors.
 
 H2: Checklist
@@ -51,6 +46,25 @@ posting to the list, or in the rare circumstances of reporting a bug.
 .{{S: }}
 +{{B: Have your certificates expired?}}
 
+H2: OpenLDAP Bugs
+
+Sometimes you may encounter an actual OpenLDAP bug, in which case please visit 
+our Issue Tracking system {{URL:http://www.openldap.org/its/}} and report it.
+However, make sure it's not already a known bug or a common user problem.
+
+* bugs in historic versions of OpenLDAP will not be considered;
+* bugs in released versions that are no longer present in HEAD code, 
+either because they have been fixed or because they no longer apply, 
+will not be considered as well;
+* bugs in distributions of OpenLDAP software that are not related to the 
+software as provided by OpenLDAP will not be considered; in those cases please 
+refer to the distributor.
+
+Note: Our Issue Tracking system is {{B:NOT}} for OpenLDAP {{B:Support}}, please join our
+mailing Lists: {{URL:http://www.openldap.org/lists/}} for that.
+
+The information you should provide in your bug report is discussed in our FAQ-O-MATIC at
+{{URL:http://www.openldap.org/faq/data/cache/59.html}}
 
 H2: 3rd party software error
 
@@ -80,6 +94,7 @@ might want to try out some of the following to track down the cause of your prob
   information useful to list members on issues
 * Running {{slapd -d -1}} can often track down fairly simple issues, such as 
   missing schemas and incorrect file permissions for the {{slapd}} user to things like certs
+* Check your logs for errors, as discussed at {{URL:http://www.openldap.org/faq/data/cache/358.html}}
 
 H2: Commercial Support