Simo Sorce wrote: > On Tue, 2009-11-10 at 08:46 -0500, Stephen Gallagher wrote: >> -----BEGIN PGP SIGNED MESSAGE----- >> Hash: SHA1 >> >> On 11/10/2009 08:38 AM, Simo Sorce wrote: >>> On Tue, 2009-11-10 at 10:54 +1000, David O'Brien wrote: >>>> Simo Sorce wrote: >>>> >>>>>> Please update manpages for ldap_purge_cache timeout, as well as the >>>>>> SSSDConfig API configuration files. >>>>> Like for other timeouts I'd like to keep this undocumented for now. >>>>> I added the option for the API configuration file. >>>> What's the scope of this preference? Should I be leaving all timeout >>>> variables out of the doc for now? >>> It determines how often the purge task is run (unless enumeration is on, >>> in which case the purge task is run right after an enumeration). >>> This is how I set it up atm. We may decide to decouple enumeration and >>> purge task eventually. Or run the purge task less frequently. >>> (I was actually thinking of using the purge cache timeout to do a full >>> enumeration once in a while instead of the partial enumeration after the >>> first one we do now). >>> >>> Simo. >>> >> I think David was asking whether we should leave all mention of thes >> various timeout values out of the documentation. > > No we should probably document some in the main section, and maybe later > on have an appendix where we document the ones that normally really > shouldn't be touched with big warnings that changing them w/o > understanding the consequences is bad ? > > If an appendix like that is not welcome then we should make a list of > timeouts we won't document for now. > > Simo. > Yes, that was the question I was asking. Sorry I wasn't a bit clearer.
I don't see any issues with putting timeouts and any other variables that users should be more wary of in an appendix or a general reference. Putting all information in the User Guide will just bloat the User Guide with info that users won't want, need, or care about, and maybe even open the door to "accidents". This could be the beginning of a Reference Guide. -- David O'Brien Red Hat Asia Pacific +61 7 3514 8189 http://freeipa.org/page/DocumentationPortal http://git.fedorahosted.org/git/ipadocs.git "The most valuable of all talents is that of never using two words when one will do." Thomas Jefferson _______________________________________________ sssd-devel mailing list sssd-devel@lists.fedorahosted.org https://fedorahosted.org/mailman/listinfo/sssd-devel