On 12/8/2016 8:41 AM, William F Pokorny wrote:
> "Documentation indicates:"
> The list starts off with a set of 4 features our documentation has as
> available which are not in 3.7. I think the documentation should
> probably indicate these as Deprecated for the time being.
> The two undocumented features near the bottom of the block should
> probably be restored to the documentation and also listed as Deprecated.
> Our code allows them to exist - and they no doubt do - in old ini files.
i see from wiki history that i removed these back in sep 2013. besides
the feature listing there was also some narrative as well. rather than
restore all that and document as deprecated ... how about a well placed
> Just below the block, in parens, I wonder about the text we have in the
> documentation about the very old and long gone Buffer_output and
> Buffer_Size options. Thinking it should just be deleted - yep, I missed
> documenting where I saw that text...
besides the content there's only a couple of other places that need to
be touched to just get rid of it altogether ... nuke it?
> I've used the term "Deprecated" to be consistent with other
> documentation, but I believe all options marked this way are "Deprecated
> and Non-functional." Perhaps we should better indicate this.
i'm ok with this term mainly because it /is/ consistent with what's been
done so far ... only possible drawback is confusion with /deprecated/
keyword. as long as <code> is used when taking about keyword and <em> is
used otherwise i think we should be fine
Post a reply to this message