This keyword appears to be missing in the index (3.7 RC7 Windows help).

Post a reply to this message

On 08/25/2013 08:47 AM, Christian Froeschlin wrote:
> This keyword appears to be missing in the index (3.7 RC7 Windows help).

I see the appropriate indexintery tag: {{#indexentry:photons, 
pass_through}} at the beginning of the paragraph that starts talking 
about pass_through:

http://wiki.povray.org/content/Reference:Photons#Shooting_Photons_at_an_Object

Post a reply to this message

James Holsenback wrote:

> I see the appropriate indexintery tag: {{#indexentry:photons, 
> pass_through}} at the beginning of the paragraph that starts talking 
> about pass_through:

you are right, this helped me find it in the index, it is included
as a sub-entry of photons. However, it seems that sub-entries are not
located when typing into the "Type in the keyword to find" box. This
makes it hard to find the correct entry looking for something specific,
and is probably the reason why many entries appear in pairs like

{{#indexentry:pattern, agate}}
{{#indexentry:agate, pattern}}

The first one ensures that you find a list of patterns under
the index entry for pattern, the second one allows you to find
information about agate when looking for that.

Of course, this looks a bit redundant and cumbersome. Maybe the
script that generates the manual from wiki could be adapted to
automatically "mirror" all entry-subentry items?

Post a reply to this message

On 08/25/2013 07:08 PM, Christian Froeschlin wrote:
> James Holsenback wrote:
>
>> I see the appropriate indexintery tag: {{#indexentry:photons,
>> pass_through}} at the beginning of the paragraph that starts talking
>> about pass_through:
>
> you are right, this helped me find it in the index, it is included
> as a sub-entry of photons. However, it seems that sub-entries are not
> located when typing into the "Type in the keyword to find" box. This
> makes it hard to find the correct entry looking for something specific,
> and is probably the reason why many entries appear in pairs like
>
> {{#indexentry:pattern, agate}}
> {{#indexentry:agate, pattern}}
>
> The first one ensures that you find a list of patterns under
> the index entry for pattern, the second one allows you to find
> information about agate when looking for that.
>
> Of course, this looks a bit redundant and cumbersome. Maybe the
> script that generates the manual from wiki could be adapted to
> automatically "mirror" all entry-subentry items?

OK .. looked right past sub-entry portion of that tag!

Since windows version is only platform that has search-able index, that 
is done as a post process of the information that I pull from the wiki 
and pass on to Chris. I /was/ asked to do this on my end, and at the 
time I declined. Since then we've had a number of users point out some 
problems with the results. Given his (Chris) workload I doubt it will be 
addressed any time soon. Perhaps I /should/ re-think my position. LOL 
... I /may/ be the best chance of making that happen. Here's what I'm 
going to do in the short term ... I'll add (don't want to replace 
current entries) pass_through as a non sub-entry type tag

Post a reply to this message

James Holsenback wrote:

> I'll add pass_through as a non sub-entry type tag

note that the same issue applies to most (all?) current
subentries of photons (adc_bailout, autostop, collect,
dispersion, expand_threhsolds, gather, jitter, load_file,
max_trace_level, media, pass_through, radius, save_file,
spacing, spacing_multiplier, target).

Some of the above do appear top-level in the index but from
another context (and without photons subentry), e.g. max_trace_level
and adc_bailout.

Also I wonder if those are all keywords and if they should
then all appear as subentries under "keywords".

Post a reply to this message

On 08/28/2013 06:12 PM, Christian Froeschlin wrote:
> James Holsenback wrote:
>
>> I'll add pass_through as a non sub-entry type tag
>
> note that the same issue applies to most (all?) current
> subentries of photons (adc_bailout, autostop, collect,
> dispersion, expand_threhsolds, gather, jitter, load_file,
> max_trace_level, media, pass_through, radius, save_file,
> spacing, spacing_multiplier, target).

I /did/ get the others on the same page that pass_through appeared:
http://wiki.povray.org/content?title=Reference:Photons&curid=2316&diff=8115&oldid=7544

will give it an honest effort to pick up the others ... i'm waiting on 
other changes and i'll have to re-gen docs sets for 3.7.0 release anyways

> Also I wonder if those are all keywords and if they should
> then all appear as subentries under "keywords".

sorry ... requires more time that what i have. noted for future repair 
is the best i can do for now.

Post a reply to this message