POV-Ray : Newsgroups : povray.documentation.inbuilt : new documentation feature Server Time
20 Apr 2024 08:01:29 EDT (-0400)
  new documentation feature (Message 1 to 4 of 4)  
From:
Subject: new documentation feature
Date: 15 Mar 2002 14:01:43
Message: <ptg49ugv91jviq4r63quukl1m16hljek9t@4ax.com>
In current (13) beta of 3.5 we can find in changes list "Changed lots of
jumptargets in a way that using the exact keyword in the index always leads to
the SDL section (I hope).". I like this change. It makes geting help faster.
But can I have feature about naming then ? Can we have different names for
builded tokens and standard macro set ? I were confused when I hit F1 on
"Interpolate" and got help for "interpolate". Idea were lost in this case :-(

ABX


Post a reply to this message

From: ingo
Subject: Re: new documentation feature
Date: 15 Mar 2002 16:01:28
Message: <Xns91D2E0684C7A2seed7@povray.org>

Skiba wrote: 

> But can I have feature about naming then ?
> Can we have different names for builded tokens and standard macro set
> ? I were confused when I hit F1 on "Interpolate" and got help for
> "interpolate". Idea were lost in this case :-( 

Somewhere in the process of building the docs all capitals are lost, so 
I can't make a difference between macro's, functions and identifiers. 
Also there are several identifiers that are shared among features.
So I chose to always go to an identifier, if there are more than one 
use, the most obvious is chosen (IMO). For the others "sub-items" are 
made for the index.
For your example, in the index you'll find:

interpolate   --> jumps to SDL (and works with F1)
    	macro      --> jumps to math.inc (doesn't work with F1)

If I remeber weel, there ar only four or five macros that share aname 
with an identifier.

Ingo


Post a reply to this message

From: ingo
Subject: Re: new documentation feature
Date: 15 Mar 2002 16:11:35
Message: <Xns91D2E21F77948seed7@povray.org>

wrote:

> I like this change. It makes geting help faster.
> 

Oh, before you start checking them all ;)

background
camera
color
fog
internal
rainbow

don't work properly yet.

Ingo


Post a reply to this message

From: Vadim Sytnikov
Subject: Re: new documentation feature
Date: 18 Mar 2002 11:00:15
Message: <3c960f0f$1@news.povray.org>

> In current (13) beta of 3.5 we can find in changes list "Changed lots of
> jumptargets in a way that using the exact keyword in the index always
leads to
> the SDL section (I hope).". I like this change. It makes geting help
faster.
> But can I have feature about naming then ? Can we have different names for
> builded tokens and standard macro set ? I were confused when I hit F1 on
> "Interpolate" and got help for "interpolate". Idea were lost in this case
:-(

I would like to add that I like the change so-o-o much that I would live
with these little deficiencies you mention, provided that I retain the
feature as a whole... (many thanks, Ingo).


Post a reply to this message

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