POV-Ray : Newsgroups : povray.documentation.inbuilt : Document -CC/+CC command line and Create_Continue_Trace_Log ini opt. : Re: Document -CC/+CC command line and Create_Continue_Trace_Loginiopt. Server Time
29 May 2023 12:23:34 EDT (-0400)
  Re: Document -CC/+CC command line and Create_Continue_Trace_Loginiopt.  
From: Jim Holsenback
Date: 8 Dec 2016 11:35:11
Message: <58498bbf$1@news.povray.org>
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 
"Note" instead

> 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

Copyright 2003-2023 Persistence of Vision Raytracer Pty. Ltd.