POV-Ray : Newsgroups : povray.beta-test : More minor, minor doc issues Server Time
31 Jul 2024 06:19:54 EDT (-0400)
  More minor, minor doc issues (Message 6 to 15 of 15)  
<<< Previous 5 Messages Goto Initial 10 Messages
From: Chris Cason
Subject: Re: More minor, minor doc issues
Date: 18 Sep 2001 22:11:23
Message: <3ba7fecb@news.povray.org>
"Anders K." <and### [at] f2scom> wrote in message news:3ba7bbdd$1@news.povray.org...
> No, but why would ActiveX change the place in the page that the links point
> to?

HTML Help uses an ActiveX control in the index pane, and the symptom of having
it disabled (at least for one pre-beta tester) was exactly as you described.
Entries would take you to the top of a page but never to a point within it.

What is your version of IE ?

-- Chris


Post a reply to this message

From: Anders K 
Subject: Re: More minor, minor doc issues
Date: 19 Sep 2001 08:39:58
Message: <3ba8921e$1@news.povray.org>
> HTML Help uses an ActiveX control in the index pane, and the symptom of
having
> it disabled (at least for one pre-beta tester) was exactly as you
described.
> Entries would take you to the top of a page but never to a point within
it.

Oh; that's not exactly what I was saying. For example, with #break in the
index, the link currently points to position [B] below; I think it should
point to position [A] so you can see the heading.

  [A] 6.2.6.3  The #switch, #case, #range and #break Directives

  [B] A more powerful conditional is the #switch directive. The syntax is as
follows...

But I guess Ingo has a reason for pointing it to [B]. That's fine; it
doesn't really matter that much.

> What is your version of IE ?

IE 6.0, HTML Help 1.3.

Anders


Post a reply to this message

From: Chris Cason
Subject: Re: More minor, minor doc issues
Date: 19 Sep 2001 09:27:08
Message: <3ba89d2c@news.povray.org>
> Oh; that's not exactly what I was saying. For example, with #break in the
> index, the link currently points to position [B] below; I think it should
> point to position [A] so you can see the heading.

This is just the way the doc generator works. I'd like to change it but it's
not trivial. I'll see what I can do.

-- Chris


Post a reply to this message

From: Glen Berry
Subject: Re: More minor, minor doc issues
Date: 20 Sep 2001 00:00:41
Message: <SF+pO+3qPmm8ydgkqlqFaoeQDhih@4ax.com>
On Tue, 18 Sep 2001 17:26:03 -0400, "Anders K." <and### [at] f2scom>
wrote:

>> > Lots of the index links take me just below a section heading. For
>> > example, the first entry in the index, "#break". Shouldn't they take
>> > me just above the section heading instead?
>>
>> Do you have ActiveX disabled ?
>
>No, but why would ActiveX change the place in the page that the links point
>to?

I get the same sort of behaviour. The index link for "pi" is even
worse. It seems to make no difference whether I enable ActiveX or not.

I must admit that until I installed POV 3.5, I didn't use Internet
Exploder for anything, and I only installed IE5 to have access to the
POV help files. I saw several settings in the "Internet Security"
menus that affected ActiveX. I tried changing all of them, and I
couldn't change the behaviour of POV's help system. I suppose it's
possible that I didn't change the proper setting in some menu,
somewhere, but I doubt it.

<The following is margainly on topic for this thread, but I felt it
needed to be said.>

For what it's worth, I really don't like having POV-Ray rely on
Internet Explorer at all. My computer and I lived very happily without
IE5, and had intended to do so for the rest of eternity - until POV
3.5 for Windows came out, at least. 

It's almost as bad as when I recently tried to update Norton
Anti-Virus and it wanted me to install some sort of Windows Scripting
(or something like that), just so Norton Anti-Virus could protect me
from it! Now I can't upgrade my virus checker any more, without adding
this additional Microsoft "junk" software to my system, which I'll
never use, only so Norton can try its best to protect me from it.

Overall, The POV-Team has done an excellent job with POV-Ray for
Windows 3.5, and I certainly appreciate their efforts. I just wanted
to be on record as not appreciating this particular aspect of the
POV-Ray help implementation.


Thanks for reading,
Glen


Post a reply to this message

From: Anders K 
Subject: Re: More minor, minor doc issues
Date: 20 Sep 2001 08:36:20
Message: <3ba9e2c4$1@news.povray.org>
> I get the same sort of behaviour. The index link for "pi" is even
> worse. It seems to make no difference whether I enable ActiveX or not.

I don't think this is really a bug. In the case if pi, I think it would be
better if the link pointed to 6.1.3.4.1, Constant Identifiers, so that you
can see the whole definition of pi, not just what it's used for. But it
really doesn't matter that much.


Post a reply to this message

From: Chris Cason
Subject: Re: More minor, minor doc issues
Date: 20 Sep 2001 11:30:43
Message: <3baa0ba3@news.povray.org>
> Overall, The POV-Team has done an excellent job with POV-Ray for
> Windows 3.5, and I certainly appreciate their efforts. I just wanted
> to be on record as not appreciating this particular aspect of the
> POV-Ray help implementation.

Well, you can complain to Microsoft; they abandoned enhancing or fixing their
old help system (which is FULL of bugs) many years ago. HTML Help is their
'official' help system now, and it depends on IE ...

So, really, we have no choice (using the old help format for any sort of
sophisticated help is just too painful, unless you have an expensive add-
on toolkit of some sort, and even then, it's not crash-hot).

-- Chris

Microsoft: because choices are confusing.


Post a reply to this message

From: Bill DeWitt
Subject: Re: More minor, minor doc issues
Date: 20 Sep 2001 13:09:38
Message: <3baa22d2$1@news.povray.org>
"Chris Cason" <newsadmin@-despam-povray.org> wrote :
>
> Microsoft: because choices are confusing.

    <chuckle>


Post a reply to this message

From: Jan Walzer
Subject: Re: More minor, minor doc issues
Date: 20 Sep 2001 13:26:30
Message: <3baa26c6$1@news.povray.org>
> Microsoft: because choices are confusing.


May  I use this for my .signature ?

--
Jan Walzer <jan### [at] lzernet>


Post a reply to this message

From: Chris Cason
Subject: Re: More minor, minor doc issues
Date: 21 Sep 2001 06:18:45
Message: <3bab1405@news.povray.org>
"Jan Walzer" <jan### [at] lzernet> wrote in message news:3baa26c6$1@news.povray.org...
>
> > Microsoft: because choices are confusing.
>
>
> May  I use this for my .signature ?

sure ... I didn't invent it myself, I saw it somewhere sometime and it just stuck
in my mind.

-- Chris

I tried an internal modem once, but it hurt when I walked.


Post a reply to this message

From: Anders K 
Subject: Re: More minor, minor doc issues
Date: 6 Jan 2002 11:43:05
Message: <3c387e99$1@news.povray.org>
I know this is a really old thread, but several of these doc bugs are still
here in beta 9.

> When I double-click on most of the index items, the "Locate",
> "Previous", and "Next" buttons become disabled, which is slightly
> annoying.

> In Section 6.0, "Scene Description Language":
> > For details on those five items see section "Language Directives",
> > section "Objects",
>            ^^^^^^^
> The link here only includes Object and not the s, and the link points
> to "References to 'object'", instead of section 6.5 as it should.

> In Section 7.13.4, "shapesq.inc":
> > Bicorn
> >     [...]
> >     y^2 - (x^2 + z^2) y^2 - (x^2 + z^2 + 2 y - 1)^2 =
>
> Equals what? :-)

> In Section 7.18.3, "Woods:" (the colons from these section titles
> probably shouldn't be here, for consistency):
> > Dark_Wood
> >     Dark wood with a,ish hue to it.
>
> Huh? :-)

> MISSING HTML LINKS
> In these cases, the text pointed to should probably be a link, but
> isn't.

> In Section 1.11.8, "Bug Reporting via our News Server"
> > See http://www.povray.org/groups.html for information about [...]
>       ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
> In Section 8.2.1, "Contacting the authors":
> > [...] via the internet at http://www.povray.org/.
>                             ^^^^^^^^^^^^^^^^^^^^^^
> In Section 8.3.1.3, "Apple  Macintosh" (the section title appears to
> contain a double space):
> > Apple's web site <http://developer.apple.com/sdk/>
>                    ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
> In Section 8.3.2.1, "World Wide Website www.povray.org"
> > For more information about the server see
> > http://www.povray.org/groups.html.
>   ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
> In Section 8.3.2.2, "Books, Magazines and CD-ROMs"
> > You can always find the latest information on what is available at
> > our web site www.povray.org.
>                ^^^^^^^^^^^^^^

> PRESENT TENSE REFERENCES TO EARLIER VERSIONS

> In Section 3.4.13, Text Object:
> > Now, for POV-Ray 3.0, a new primitive has been introduced that can
> > use any TrueType font to create text objects.

> In Section 6.2.2.1, "Declaring identifiers" (should this be
> capitalized?), and Section 6.2.5, "The #version Directive":
> > This semi-colon is introduced in POV-Ray version 3.1.

> In Section 6.5, "Objects":
> > The "Interior" is a feature introduced in POV-Ray 3.1.

> In Section 6.6, "Interior":
> > Introduced in POV-Ray 3.1 is an object modifier statement called
> > interior.

Anders

--
light_source{6#macro A(B)#declare C=mod(E B);#declare E=(E-C)/B;C#end
#macro B(E)#while(E)#if(A(8)=7)#declare D=D+2.8;#else#if(C<3)cylinder
{0(C=<1 2>).2translate<D+C*A(2)A(4)#else intersection{torus{1 .2}box{
-y 2}rotate<-1 0C+1>*90translate<D+1A(2)*2+1#end-2 13>finish{specular
1}pigment{red 1}}#end#end#end#local D=-8;1}B(445000298)B(519053970)B(
483402386)B(1445571258)B(77778740)B(541684549)B(42677491)B(70)


Post a reply to this message

<<< Previous 5 Messages Goto Initial 10 Messages

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